Odoo 19.0 Community · Persistant

mailing.contact : champs, relations et API

Le modèle mailing.contact (« Contact de la liste de diffusion ») est un modèle persistant déclaré par le module E-mail Marketing, puis enrichi par 1 autre module. Il expose 39 champs, dont 11 déclarés directement sur le modèle ; 3 champs d'autres modèles pointent vers lui. Retrouvez ci-dessous chaque champ avec son nom technique, son type, son libellé français et ses relations, puis un exemple d'appel à l'API JSON-2 d'Odoo 19.

Voir le code source Rechercher un autre modèle

Fiche d'identité

Nom technique: mailing.contact
Libellé: Contact de la liste de diffusion
Type: Persistant (models.Model)
Table SQL: mailing_contact
Module d'origine: E-mail Marketing (mass_mailing)
Étendu par: mass_mailing_sms
Tri par défaut (_order): name ASC, id DESC
Hérite de (mixins): mail.thread.blacklist properties.base.definition.mixin mail.thread.phone

Champs du modèle

11 champs propres, 22 hérités des mixins et 6 champs automatiques de l'ORM. Cliquez sur un nom pour obtenir le lien direct vers le champ.

Masquer les champs hérités

39 champs affichés sur 39

Nom technique	Libellé	Type	Détails
company_name	Nom de la société	`char`
country_id	Pays	`many2one` → res.country
email	E-mail	`char`
first_name	Prénom	`char`
last_name	Nom	`char`
list_ids	Listes de diffusion	`many2many` → mailing.list
mobile	Mobile	`char`	ajouté par SMS Marketing (`mass_mailing_sms`)
name	Nom	`char`	calculé, stocké
opt_out	Désinscription Drapeau de désinscription pour une liste de diffusion spécifique. Ce champ ne devrait pas être utilisé dans une vue sans une liste de diffusion unique et active.	`boolean`	calculé
subscription_ids	Informations relatives aux inscriptions	`one2many` → mailing.subscription	inverse : `contact_id`
tag_ids	Étiquettes	`many2many` → res.partner.category
email_normalized	E-mail normalisé Ce champ est utilisé pour rechercher un e-mail étant donné que le champ e-mail primaire peut contenir plus que strictement un e-mail.	`char`	calculé, stocké hérité de mail.thread.blacklist
has_message	A un message	`boolean`	calculé hérité de mail.thread
is_blacklisted	Liste noire Si l'adresse e-mail est sur liste noire, le contact ne recevra plus d'e-mail marketing d'aucune liste.	`boolean`	calculé hérité de mail.thread.blacklist
message_attachment_count	Nombre de pièces jointes	`integer`	calculé hérité de mail.thread
message_bounce	Rebond Le compteur du nombre de mails rebondis pour ce contact	`integer`	hérité de mail.thread.blacklist
message_follower_ids	Abonnés	`one2many` → mail.followers	inverse : `res_id` hérité de mail.thread
message_has_error	Erreur d'envoi du message Si coché, certains messages ont une erreur de livraison.	`boolean`	calculé hérité de mail.thread
message_has_error_counter	Nombre d'erreurs Nombre de messages avec des erreurs d'envoi	`integer`	calculé hérité de mail.thread
message_has_sms_error	Erreur d'envoi SMS Si coché, certains messages ont une erreur de livraison.	`boolean`	calculé hérité de mail.thread
message_ids	Messages	`one2many` → mail.message	inverse : `res_id` hérité de mail.thread
message_is_follower	Est un abonné	`boolean`	calculé hérité de mail.thread
message_needaction	Nécessite une action Si coché, de nouveaux messages demandent votre attention.	`boolean`	calculé hérité de mail.thread
message_needaction_counter	Nombre d'actions Nombre de messages nécessitant une action	`integer`	calculé hérité de mail.thread
message_partner_ids	Abonnés (Partenaires)	`many2many` → res.partner	calculé hérité de mail.thread
phone_blacklisted	Le téléphone sur liste noire est fixe Indicates if a blacklisted sanitized phone number is a phone number. Helps distinguish which number is blacklisted when there is both a mobile and phone field in a model.	`boolean`	calculé hérité de mail.thread.phone
phone_mobile_search	Numéro de téléphone	`char`	hérité de mail.thread.phone
phone_sanitized	Numéro nettoyé Champ utilisé pour stocker le numéro de téléphone nettoyé. Aide à accélérer les recherches et comparaisons.	`char`	calculé, stocké hérité de mail.thread.phone
phone_sanitized_blacklisted	Téléphone sur liste noire Si le numéro de téléphone nettoyé est sur liste noire, le contact ne recevra plus de campagnes de mail, d'aucunes listes.	`boolean`	calculé hérité de mail.thread.phone
properties	Propriétés	`properties`	hérité de properties.base.definition.mixin
properties_base_definition_id	Définition de base des propriétés	`many2one` → properties.base.definition	calculé hérité de properties.base.definition.mixin
rating_ids	Évaluations	`one2many` → rating.rating	inverse : `res_id` hérité de mail.thread
website_message_ids	Messages du site web Historique de communication du site web	`one2many` → mail.message	inverse : `res_id` hérité de mail.thread
create_date	Créé le	`datetime`	lecture seuleautomatique
create_uid	Créé par	`many2one` → res.users	lecture seuleautomatique
display_name	Nom affiché	`char`	lecture seulecalculéautomatique
id	ID	`integer`	lecture seuleautomatique
write_date	Dernière mise à jour le	`datetime`	lecture seuleautomatique
write_uid	Dernière mise à jour par	`many2one` → res.users	lecture seuleautomatique

Relations

Modèles liés depuis ce modèle

mailing.list : list_ids
mailing.subscription : subscription_ids
res.country : country_id
res.partner.category : tag_ids

Champs d'autres modèles qui pointent ici

mailing.contact.to.list : contact_ids
mailing.list : contact_ids
mailing.subscription : contact_id

Lire ce modèle par l'API

Exemple d'appel à l'API JSON-2 d'Odoo 19 : lecture des cinq premiers enregistrements avec des champs réels du modèle. Remplacez l'instance, la base et la clé API par les vôtres.

curl

curl -X POST "https://votre-instance.odoo.com/json/2/mailing.contact/search_read" \
  -H "Authorization: bearer $ODOO_API_KEY" \
  -H "X-Odoo-Database: votre-base" \
  -H "Content-Type: application/json" \
  -d '{"domain":[],"fields":["name","country_id","company_name","email","first_name"],"limit":5}'

Python (requests)

import requests

BASE_URL = "https://votre-instance.odoo.com/json/2"
headers = {"Authorization": f"bearer {API_KEY}", "X-Odoo-Database": "votre-base"}

res = requests.post(
    f"{BASE_URL}/mailing.contact/search_read",
    headers=headers,
    json={"domain": [], "fields": ["name","country_id","company_name","email","first_name"], "limit": 5},
)
res.raise_for_status()
print(res.json())

L'accès à l'API externe est réservé à la formule Custom d'Odoo.
XML-RPC et JSON-RPC seront retirés dans Odoo 22 (automne 2028) : préférez JSON-2.
Les droits d'accès et règles d'enregistrement de l'utilisateur de la clé s'appliquent.

Citer cet outil

Vous rédigez un tutoriel, une documentation interne ou une réponse sur un forum ? Copiez ce lien pour renvoyer vos lecteurs vers la fiche à jour.

<a href="https://aidoo.ai/fr/outils/explorateur-modeles-odoo/mailing-contact">mailing.contact (Odoo 19.0)</a>

Sources

Données vérifiées le 23 septembre 2026 · Odoo 19.0 Community

Vous avez un projet Odoo ou souhaitez exploiter votre ERP avec l'IA ? Échangeons

Intégration, développement de modules, connexion de Claude ou ChatGPT à vos données : décrivez-nous votre contexte, nous vous répondons sous 24 heures ouvrées.

Nous contacter Voir une démo