Odoo 19.0 Community · Persistant

mailing.mailing : champs, relations et API

Le modèle mailing.mailing (« E-mail Marketing ») est un modèle persistant déclaré par le module E-mail Marketing, puis enrichi par 4 autres modules. Il expose 118 champs, dont 84 déclarés directement sur le modèle ; 12 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.mailing
Libellé: E-mail Marketing
Type: Persistant (models.Model)
Table SQL: mailing_mailing
Module d'origine: E-mail Marketing (mass_mailing)
Étendu par: marketing_card, mass_mailing_crm, mass_mailing_sms, mass_mailing_sale
Tri par défaut (_order): calendar_date DESC
Champ d'affichage (_rec_name): subject
Hérite de (mixins): mail.thread mail.activity.mixin mail.render.mixin utm.source.mixin

Champs du modèle

84 champs propres, 28 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

118 champs affichés sur 118

Nom technique	Libellé	Type	Détails
ab_testing_completed	Ab Testing Completed	`boolean`	related : `campaign_id.ab_testing_completed`
ab_testing_description	Description du test A/B	`html`	calculé
ab_testing_enabled	Autoriser les tests A/B Si cette option est cochée, les destinataires seront informés par e-mail une seule fois pour l'ensemble de la campagne. Vous pouvez ainsi envoyer différents e-mails en publipostage à des destinataires sélectionnés au hasard et tester l'efficacité de la fonction de publipostage, sans créer de messages en double.	`boolean`
ab_testing_is_winner_mailing	Est le gagnant de cette campagne	`boolean`	calculé
ab_testing_mailings_count	Ab Testing Mailings Count	`integer`	related : `campaign_id.ab_testing_mailings_count`
ab_testing_mailings_sms_count	Ab Testing Mailings Sms Count	`integer`	related : `campaign_id.ab_testing_mailings_sms_count` ajouté par SMS Marketing (`mass_mailing_sms`)
ab_testing_pc	Pourcentage de test A/B Pourcentage des contacts qui seront contactés. Les destinataires seront choisis au hasard.	`integer`
ab_testing_schedule_datetime	Ab Testing Schedule Datetime	`datetime`	related : `campaign_id.ab_testing_schedule_datetime`
ab_testing_sms_winner_selection	Ab Testing Sms Winner Selection	`selection`	related : `campaign_id.ab_testing_sms_winner_selection` ajouté par SMS Marketing (`mass_mailing_sms`)
ab_testing_winner_selection	Ab Testing Winner Selection	`selection`	related : `campaign_id.ab_testing_winner_selection`
active	Actif	`boolean`
attachment_ids	Pièces jointes	`many2many` → ir.attachment
body_arch	Corps	`html`
body_html	Corps converti pour être envoyé par e-mail	`html`
body_plaintext	Corps du SMS	`text`	calculé, stocké ajouté par SMS Marketing (`mass_mailing_sms`)
bounced	Rejeté	`integer`	calculé
bounced_ratio	Taux de rebond	`float`	calculé
calendar_date	Date calendrier Date à laquelle l'e-mail a été ou sera envoyé.	`datetime`	calculé, stocké
campaign_id	Campagne UTM	`many2one` → utm.campaign
canceled	Annulé	`integer`	calculé
card_campaign_id	Campagne de cartes	`many2one` → card.campaign	ajouté par Carte Marketing (`marketing_card`)
card_requires_sync_count	La carte nécessite une synchronisation	`integer`	calculé ajouté par Carte Marketing (`marketing_card`)
clicked	Cliqué	`integer`	calculé
clicks_ratio	Nombre de clics	`float`	calculé
color	Couleur	`integer`
contact_list_ids	Listes de diffusion	`many2many` → mailing.list
crm_lead_count	Nombre de pistes/opportunités	`integer`	calculé ajouté par E-mail marketing auprès des pistes / opportunités (`mass_mailing_crm`)
delivered	Délivré	`integer`	calculé
email_from	Adresse d'envoi	`char`	calculé, stocké
expected	Prévu	`integer`	calculé
failed	Échec	`integer`	calculé
favorite	Favori	`boolean`
favorite_date	Date favorite Quand cet envoi a été ajouté aux favoris	`datetime`	calculé, stocké
is_ab_test_sent	A/B test est envoyé	`boolean`	calculé
is_body_empty	Est un corps vide	`boolean`	calculé
keep_archives	Conserver les archives	`boolean`
kpi_mail_required	E-mail KPI nécessaire	`boolean`
link_trackers_count	Compteur des trackers de liens	`integer`	calculé
mail_server_available	Serveur d'e-mail disponible Champ technique pour savoir si l'utilisateur a activé l'option de serveur de messagerie sortant dans les paramètres	`boolean`	calculé
mail_server_id	Serveur de messagerie Utilisez un serveur de messagerie spécifique en priorité. Sinon, Odoo utilise le premier serveur de messagerie sortant disponible (en fonction de leur séquence), comme c'est le cas pour les e-mails ordinaires.	`many2one` → ir.mail_server
mailing_domain	Domaine	`char`	calculé, stocké
mailing_filter_count	# Filtres favoris	`integer`	calculé
mailing_filter_domain	Filtre de domaine favori	`char`	related : `mailing_filter_id.mailing_domain`
mailing_filter_id	Filtre favori	`many2one` → mailing.filter	calculé, stocké
mailing_model_id	Modèle de destinaire	`many2one` → ir.model	requiscalculé, stocké
mailing_model_name	Nom de modèle de destinataires	`char`	lecture seule related : `mailing_model_id.model`
mailing_model_real	Modèle réel de destinataires	`char`	calculé
mailing_on_mailing_list	Sur la base des listes de diffusion	`boolean`	calculé
mailing_trace_ids	Statistiques de e-mails	`one2many` → mailing.trace	inverse : `mass_mailing_id`
mailing_type	Type d'envoi	`selection`	requis Valeurs : `mail` (E-mail)
mailing_type_description	Description du type d'envoi	`char`	calculé
medium_id	Médium Medium UTM : mode de livraison (e-mail, SMS, ...)	`many2one` → utm.medium	calculé, stocké
next_departure	Date planifiée	`datetime`	calculé
next_departure_is_past	Le prochain départ est passé	`boolean`	calculé
opened	Ouvert	`integer`	calculé
opened_ratio	Taux d'ouverture	`float`	calculé
pending	En attente	`integer`	calculé
preview	Aperçu Catchy preview sentence that encourages recipients to open this email. In most inboxes, this is displayed next to the subject. Keep it empty if you prefer the first characters of your email content to appear instead.	`char`
process	Traiter	`integer`	calculé
received_ratio	Taux de réception	`float`	calculé
replied	Répondu	`integer`	calculé
replied_ratio	Taux de réponse	`float`	calculé
reply_to	Adresse de réponse Adresse de réponse préférée	`char`	calculé, stocké
reply_to_mode	Mode réponse Fil : les réponses vont au document cible. E-mail : les réponses sont acheminées vers un e-mail donné.	`selection`	calculé, stocké Valeurs : `update` (Abonnés destinataires), `new` (Adresse e-mail spécifiée)
sale_invoiced_amount	Montant facturé	`integer`	calculé ajouté par E-mail marketing sur les commandes clients (`mass_mailing_sale`)
sale_quotation_count	Nombre de devis	`integer`	calculé ajouté par E-mail marketing sur les commandes clients (`mass_mailing_sale`)
schedule_date	Planifié pour	`datetime`	calculé, stocké
schedule_type	Planifier	`selection`	requis Valeurs : `now` (Envoyer maintenant), `scheduled` (Envoyer le)
scheduled	Planifié	`integer`	calculé
sent	Envoyé	`integer`	calculé
sent_date	Date d'envoi	`datetime`
sms_allow_unsubscribe	Inclure un lien de désinscription	`boolean`	ajouté par SMS Marketing (`mass_mailing_sms`)
sms_force_send	Envoyer directement Envoyez le SMS immédiatement au lieu de le mettre dans la file d'attente. À utiliser à vos risques et périls.	`boolean`	ajouté par SMS Marketing (`mass_mailing_sms`)
sms_has_insufficient_credit	Crédits IAP insuffisants	`boolean`	calculé ajouté par SMS Marketing (`mass_mailing_sms`)
sms_has_unregistered_account	Compte IAP non enregistré	`boolean`	calculé ajouté par SMS Marketing (`mass_mailing_sms`)
sms_subject	Titre For an email, the subject your recipients will see in their inbox. For an SMS, the internal title of the message.	`char`	related : `subject` ajouté par SMS Marketing (`mass_mailing_sms`)
sms_template_id	Modèle SMS	`many2one` → sms.template	ajouté par SMS Marketing (`mass_mailing_sms`)
state	Statut	`selection`	requis Valeurs : `draft` (Brouillon), `in_queue` (Dans la file d'attente), `sending` (En cours d'envoi), `done` (Envoyé)
subject	Sujet	`char`	requis
total	Total	`integer`	calculé
use_exclusion_list	Utiliser la liste d’exclusion Empêcher l’envoi de messages à des contacts sur liste noire. Désactivez uniquement si nécessaire.	`boolean`
use_leads	Utiliser les pistes	`boolean`	calculé ajouté par E-mail marketing auprès des pistes / opportunités (`mass_mailing_crm`)
user_id	Responsable	`many2one` → res.users
warning_message	Message d'avertissement Message d'avertissement affiché dans le formulaire d'envoi.	`char`	calculé
activity_calendar_event_id	Activité suivante de l'événement du calendrier	`many2one` → calendar.event	calculé hérité de mail.activity.mixin
activity_date_deadline	Date limite de l'activité à venir	`date`	lecture seulecalculé hérité de mail.activity.mixin
activity_exception_decoration	Indicateur d’exception d’activité Type d'activité d'exception enregistrée.	`selection`	calculé Valeurs : `warning` (Alerte), `danger` (Erreur) hérité de mail.activity.mixin
activity_exception_icon	Icône Icône pour indiquer une activité d'exception.	`char`	calculé hérité de mail.activity.mixin
activity_ids	Activités	`one2many` → mail.activity	inverse : `res_id` hérité de mail.activity.mixin
activity_state	Statut de l'activité Status based on activities Overdue: Due date is already passed Today: Activity date is today Planned: Future activities.	`selection`	calculé Valeurs : `overdue` (En retard), `today` (Aujourd'hui), `planned` (Planifié) hérité de mail.activity.mixin
activity_summary	Résumé de l'activité suivante	`char`	related : `activity_ids.summary` hérité de mail.activity.mixin
activity_type_icon	Icône de type d'activité	`char`	related : `activity_ids.icon` hérité de mail.activity.mixin
activity_type_id	Type d'activités à venir	`many2one` → mail.activity.type	related : `activity_ids.activity_type_id` hérité de mail.activity.mixin
activity_user_id	Utilisateur responsable	`many2one` → res.users	lecture seulecalculé hérité de mail.activity.mixin
has_message	A un message	`boolean`	calculé hérité de mail.thread
lang	Langue Langue de traduction optionnelle (code ISO) à sélectionner lors de l’envoi d’un e-mail. Si elle n’est pas définie, la langue principale du partenaire sera utilisée. Il s’agit généralement d’une expression de remplacement indiquant la langue appropriée, par exemple : {{ object.partner_id.lang }}.	`char`	hérité de mail.render.mixin
message_attachment_count	Nombre de pièces jointes	`integer`	calculé hérité de mail.thread
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
my_activity_date_deadline	Échéance de mon activité	`date`	lecture seulecalculé hérité de mail.activity.mixin
name	Nom	`char`	related : `source_id.name` hérité de utm.source.mixin
rating_ids	Évaluations	`one2many` → rating.rating	inverse : `res_id` hérité de mail.thread
render_model	Modèle de rendu	`char`	calculé hérité de mail.render.mixin
source_id	Source	`many2one` → utm.source	requis hérité de utm.source.mixin
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

card.campaign : card_campaign_id
ir.attachment : attachment_ids
ir.mail_server : mail_server_id
ir.model : mailing_model_id
mailing.filter : mailing_filter_id
mailing.list : contact_list_ids
mailing.trace : mailing_trace_ids
res.users : user_id
sms.template : sms_template_id
utm.campaign : campaign_id
utm.medium : medium_id

Champs d'autres modèles qui pointent ici

link.tracker : mass_mailing_id
link.tracker.click : mass_mailing_id
mail.compose.message : mass_mailing_id
mail.mail : mailing_id
mailing.list : mailing_ids
mailing.mailing.schedule.date : mass_mailing_id
mailing.mailing.test : mass_mailing_id
mailing.sms.test : mailing_id
mailing.trace : mass_mailing_id
sms.composer : mailing_id
sms.sms : mailing_id
utm.campaign : ab_testing_winner_mailing_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.mailing/search_read" \
  -H "Authorization: bearer $ODOO_API_KEY" \
  -H "X-Odoo-Database: votre-base" \
  -H "Content-Type: application/json" \
  -d '{"domain":[],"fields":["subject","mailing_model_id","mailing_type","schedule_type","state"],"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.mailing/search_read",
    headers=headers,
    json={"domain": [], "fields": ["subject","mailing_model_id","mailing_type","schedule_type","state"], "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-mailing">mailing.mailing (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