Odoo 19.0 Community · Persistant

mail.mail : champs, relations et API

Le modèle mail.mail (« E-mails sortants ») est un modèle persistant déclaré par le module Discussion, puis enrichi par 1 autre module. Il expose 27 champs, dont 21 déclarés directement sur le modèle ; 2 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: mail.mail
Libellé: E-mails sortants
Type: Persistant (models.Model)
Table SQL: mail_mail
Module d'origine: Discussion (mail)
Étendu par: mass_mailing
Tri par défaut (_order): id desc
Champ d'affichage (_rec_name): subject
Délégation (_inherits): mail.message : les champs de ce modèle sont aussi accessibles, via mail_message_id

Champs du modèle

21 champs propres, 0 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

27 champs affichés sur 27

Nom technique	Libellé	Type	Détails
auto_delete	Suppression automatique Cette option supprime définitivement quelconque trace de l'e-mail après son envoi, y compris du Menu technique dans les Paramètres, afin de préserver de l'espace de stockage dans votre base de données Odoo.	`boolean`
body_content	Contenus textes enrichis	`html`	calculé
body_html	Contenu du texte Message Texte enrichi/HTML	`text`
email_cc	Cc Destinataires en copie carbone	`char`
email_to	Au Destinataires du message (e-mails)	`text`
failure_reason	Motif de l'échec Raison de l'échec. Ceci est souvent l'exception envoyée par le serveur de messagerie, stockée pour faciliter le débogage des e-mails d'incidents.	`text`	lecture seule
failure_type	Type d'échec	`selection`	Valeurs : `unknown` (Erreur inconnue), `mail_spam` (Détecté comme spam), `mail_email_invalid` (Adresse e-mail non valide), `mail_email_missing` (E-mail manquant), `mail_from_invalid` (Adresse d'envoi invalide), `mail_from_missing` (Adresse d'envoi manquante), `mail_smtp` (La connexion a échoué (problème de serveur de messagerie sortant)), `mail_bl` (Adresses sur liste noire), `mail_optout` (Désinscrit), `mail_dup` (E-mail dupliqué)
fetchmail_server_id	Serveur de messagerie entrant	`many2one` → fetchmail.server	lecture seule
headers	En-têtes	`text`
is_notification	Notifications par e-mail Un courrier a été créé pour prévenir les personnes d'un mail.message existant.	`boolean`
mail_message_id	Message	`many2one` → mail.message	requis
mail_message_id_int	ID du message (entier)	`integer`	calculé
mailing_id	E-mail Marketing	`many2one` → mailing.mailing	ajouté par E-mail Marketing (`mass_mailing`)
mailing_trace_ids	Statistiques	`one2many` → mailing.trace	inverse : `mail_mail_id` ajouté par E-mail Marketing (`mass_mailing`)
message_type	Type de message	`selection`	related : `mail_message_id.message_type`
recipient_ids	À (partenaires)	`many2many` → res.partner
references	Références Références du message , tel que les identifiants des messages précédents	`text`	lecture seule
restricted_attachment_count	Pièces jointes limitées	`integer`	calculé
scheduled_date	Date d'envoi planifiée Si cette option est définie, le gestionnaire de file d'attente enverra l'e-mail après la date. Si cette option n'est pas définie, l'e-mail sera envoyé dès que possible. Sauf si un fuseau horaire est spécifié, il est considéré comme étant dans le fuseau horaire UTC.	`datetime`
state	Statut	`selection`	lecture seule Valeurs : `outgoing` (Sortant), `sent` (Envoyé), `received` (Reçu), `exception` (Échec de l'envoi), `cancel` (Annulé)
unrestricted_attachment_ids	Pièces jointes illimitées	`many2many` → ir.attachment	calculé
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

fetchmail.server : fetchmail_server_id
ir.attachment : unrestricted_attachment_ids
mail.message : mail_message_id
mailing.mailing : mailing_id
mailing.trace : mailing_trace_ids
res.partner : recipient_ids

Champs d'autres modèles qui pointent ici

mail.notification : mail_mail_id
mailing.trace : mail_mail_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/mail.mail/search_read" \
  -H "Authorization: bearer $ODOO_API_KEY" \
  -H "X-Odoo-Database: votre-base" \
  -H "Content-Type: application/json" \
  -d '{"domain":[],"fields":["mail_message_id","state","fetchmail_server_id","mailing_id","auto_delete"],"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}/mail.mail/search_read",
    headers=headers,
    json={"domain": [], "fields": ["mail_message_id","state","fetchmail_server_id","mailing_id","auto_delete"], "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/mail-mail">mail.mail (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