Odoo 19.0 Community · Persistant

ir.mail_server : champs, relations et API

Le modèle ir.mail_server (« Serveur de messagerie ») est un modèle persistant déclaré par le module Base, puis enrichi par 4 autres modules. Il expose 34 champs, dont 20 déclarés directement sur le modèle ; 7 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: ir.mail_server
Libellé: Serveur de messagerie
Type: Persistant (models.Model)
Table SQL: ir_mail_server
Module d'origine: Base (base)
Étendu par: mail, google_gmail, mass_mailing, microsoft_outlook
Tri par défaut (_order): sequence, id
Hérite de (mixins): google.gmail.mixin microsoft.outlook.mixin

Champs du modèle

20 champs propres, 8 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

34 champs affichés sur 34

Nom technique	Libellé	Type	Détails
active	Actif	`boolean`
active_mailing_ids	Les envois actifs utilisant ce serveur de messagerie	`one2many` → mailing.mailing	lecture seule inverse : `mail_server_id` ajouté par E-mail Marketing (`mass_mailing`)
from_filter	Filtre expéditeur Comma-separated list of addresses or domains for which this server can be used. e.g.: "[email protected]" or "odoo.com"	`char`
mail_template_ids	Modèle d'e-mail utilisant ce serveur d'e-mail	`one2many` → mail.template	lecture seule inverse : `mail_server_id` ajouté par Discussion (`mail`)
max_email_size	Taille maximale des e-mails	`float`
name	Nom	`char`	requis
owner_limit_count	Nombre maximal de propriétaires	`integer`	ajouté par Discussion (`mail`)
owner_limit_time	Durée maximale de propriété	`datetime`	ajouté par Discussion (`mail`)
owner_user_id	Détenteur	`many2one` → res.users	ajouté par Discussion (`mail`)
sequence	Priorité Lors qu’aucun serveur spécifique de messagerie n'est demandé pour un e-mail, la priorité la plus haute est utilisée. La priorité par défaut est 10 (petit nombre = priorité élevée)	`integer`
smtp_authentication	S'authentifier avec	`selection`	requis Valeurs : `login` (Nom d'utilisateur), `certificate` (Certificat SSL), `cli` (Interface de ligne de commande)
smtp_authentication_info	Info d'authentification	`text`	calculé
smtp_debug	Débogage Si cette option est activée, la sortie complète des sessions SMTP sera écrite dans le journal du serveur au niveau DEBUG (ceci est très détaillé et peut inclure des informations confidentielles !)	`boolean`
smtp_encryption	Chiffrement de la connexion Choose the connection encryption scheme: - None: SMTP sessions are done in cleartext. - TLS (STARTTLS): TLS encryption is requested at start of SMTP session (Recommended) - SSL/TLS: SMTP sessions are encrypted with SSL/TLS through a dedicated port (default: 465) Choose an additionnal variant for SSL or TLS: - encryption and validation: encrypt the data and authentify the server using its SSL certificate (Recommended) - encryption only: encrypt the data but skip server authentication	`selection`	requis Valeurs : `none` (Aucun), `starttls_strict` (TLS (STARTTLS), chiffrement et validation), `starttls` (TLS (STARTTLS), uniquement chiffrement), `ssl_strict` (4582 - SSL/TLS, chiffrement et validation), `ssl` (4583 - SSL/TLS, uniquement chiffrement)
smtp_host	Serveur SMTP Nom d'hôte ou adresse IP du serveur SMTP	`char`
smtp_pass	Mot de passe Mot de passe d'authentification SMTP optionnel	`char`
smtp_port	Port SMTP Port SMTP : Généralement 465 pour SSL, et 25 ou 587 dans les autres cas.	`integer`
smtp_ssl_certificate	Certificat SSL Certificat SSL utilisé pour l'authentification	`binary`
smtp_ssl_private_key	Clé privée SSL Clé privée SSL utilisée pour l'authentification	`binary`
smtp_user	Nom d'utilisateur Nom d'utilisateur pour l'authentification SMTP optionnel	`char`
google_gmail_access_token	Jeton d'accès	`char`	hérité de google.gmail.mixin
google_gmail_access_token_expiration	Horodatage de l'expiration du jeton d'accès	`integer`	hérité de google.gmail.mixin
google_gmail_refresh_token	Actualiser le jeton	`char`	hérité de google.gmail.mixin
google_gmail_uri	URI L'URL pour générer le code d'autorisation de Google	`char`	calculé hérité de google.gmail.mixin
microsoft_outlook_access_token	Jeton d'accès Outlook	`char`	hérité de microsoft.outlook.mixin
microsoft_outlook_access_token_expiration	Horodatage de l'expiration du jeton d'accès Outlook	`integer`	hérité de microsoft.outlook.mixin
microsoft_outlook_refresh_token	Actualiser le jeton Outlook	`char`	hérité de microsoft.outlook.mixin
microsoft_outlook_uri	Authentification URI L'URL pour générer le code d'autorisation à partir d'Outlook	`char`	calculé hérité de microsoft.outlook.mixin
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

mail.template : mail_template_ids
mailing.mailing : active_mailing_ids
res.users : owner_user_id

Champs d'autres modèles qui pointent ici

mail.compose.message : mail_server_id
mail.message : mail_server_id
mail.template : mail_server_id
mailing.mailing : mail_server_id
res.config.settings : mass_mailing_mail_server_id
res.users : outgoing_mail_server_id
survey.invite : mail_server_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/ir.mail_server/search_read" \
  -H "Authorization: bearer $ODOO_API_KEY" \
  -H "X-Odoo-Database: votre-base" \
  -H "Content-Type: application/json" \
  -d '{"domain":[],"fields":["name","smtp_authentication","smtp_encryption","owner_user_id","active"],"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}/ir.mail_server/search_read",
    headers=headers,
    json={"domain": [], "fields": ["name","smtp_authentication","smtp_encryption","owner_user_id","active"], "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/ir-mail_server">ir.mail_server (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