Validation des destinataires
Avant de livrer un email, Mailiqo vérifie que le destinataire existe et est joignable. Cela protège votre réputation d'envoi : chaque bounce l'abîme, et une mauvaise réputation envoie vos emails en spam même quand ils sont légitimes.
Il y a deux niveaux de vérification :
| Ce qu'elle fait | Coût | |
|---|---|---|
| Basique | Format, domaine, enregistrements MX et résultats déjà connus | Incluse dans tous les plans |
| Avancée | Vérifie aussi la boîte mail auprès du serveur de destination | Un crédit par nouvelle vérification ; réutiliser un résultat valide est gratuit |
Si vous n'avez plus de crédits, l'envoi n'est pas bloqué : les destinataires restants sont vérifiés avec la validation basique.
D'où vient la configuration
La configuration vit sur chaque domaine d'envoi, et vous la définissez dans l'espace client, dans l'onglet Délivrabilité du domaine. Elle s'applique de la même façon à l'API, à SMTP et aux envois depuis l'espace client.
Ce qui est toujours vérifié
Le format de l'adresse, les enregistrements MX du domaine et le résultat des vérifications précédentes s'appliquent à chaque envoi, quelle que soit la configuration : ils protègent votre réputation et ne peuvent pas être désactivés. Ce que vous configurez ci-dessous est la profondeur de la vérification et la sévérité de la décision.
Elle a trois parties :
Vérification avancée — quand la boîte mail est sondée sur le serveur de destination. C'est la partie qui utilise un crédit de validation.
| Valeur | Comportement |
|---|---|
NEVER | La boîte mail n'est jamais sondée ; seule la vérification basique s'exécute |
UNKNOWN_ONLY | Seul ce qui n'est pas déjà vérifié et à jour est sondé |
ALWAYS | Sondée à chaque envoi, sans réutiliser les vérifications précédentes |
Seule une vérification avancée marque un destinataire comme connu : une vérification basique ne confirme pas la boîte mail, elle n'enregistre donc pas le sondage.
Sévérité — quels résultats sont acceptés pour poursuivre.
| Valeur | Comportement |
|---|---|
SOFT (préventive) | Écarte les adresses invalides et tout résultat douteux que vous avez marqué à bloquer |
STRICT (restrictive) | Seuls les destinataires confirmés comme valides sont acceptés |
Résultats bloqués — quels cas douteux vous voulez écarter quand le niveau est préventif. Par défaut, rien n'est bloqué : un résultat douteux est quand même envoyé. Cochez seulement ce que vous préférez écarter.
| Résultat | Ce que cela signifie |
|---|---|
catch_all | Le domaine accepte n'importe quelle adresse, la boîte mail ne peut donc pas être confirmée |
risky | L'adresse existe mais présente des signes de faible qualité ou de spam trap |
unknown | Le serveur de destination n'a pas répondu à temps |
Tout ce qui est invalid est toujours écarté, quelle que soit la configuration.
Ajuster la validation pour un seul envoi
Si un envoi mérite plus d'attention que d'habitude — une confirmation de commande, une réinitialisation de mot de passe — vous pouvez l'ajuster dans la requête elle-même avec l'objet validation. Il est facultatif : sans lui, la configuration du domaine s'applique.
Où il s'utilise
L'objet validation et force_validation sont acceptés sur les deux endpoints d'envoi : POST /mailing/send et POST /mailing/send-template.
Il n'y a pas d'équivalent SMTP : les envois SMTP utilisent toujours la configuration du domaine. Et si ce que vous voulez est vérifier des adresses sans rien leur envoyer, c'est l' API de validation que vous cherchez.
{
"from": "[email protected]",
"to": "[email protected]",
"subject": "Confirmez votre commande",
"body_html": "<p>Merci pour votre achat.</p>",
"validation": {
"mode": "always",
"level": "restrictive"
}
}| Champ | Valeurs | Description |
|---|---|---|
mode | unknown_only, always | Quand la boîte mail est sondée |
level | preventive, restrictive | Niveau d'exigence |
block | liste parmi catch_all, risky, unknown | Résultats douteux que vous écartez pour cet envoi |
Correspondance avec la configuration du domaine
L'espace client et la requête nomment les mêmes choses de deux façons différentes. Ce tableau les relie :
| Configuration du domaine | Valeur dans la requête | Effet |
|---|---|---|
Vérification avancée NEVER | (non disponible) | Une requête ne peut que renforcer, jamais désactiver |
Vérification avancée UNKNOWN_ONLY | mode: "unknown_only" | Sonde seulement ce qui n'est pas déjà vérifié |
Vérification avancée ALWAYS | mode: "always" | Sonde à chaque envoi |
Sévérité SOFT (préventive) | level: "preventive" | Écarte les adresses invalides et ce que vous mettez dans block |
Sévérité STRICT (restrictive) | level: "restrictive" | N'accepte que les destinataires confirmés comme valides |
| Résultats bloqués | block: ["catch_all", "risky", "unknown"] | Ajoutés à ce que le domaine bloque déjà |
Les valeurs sont insensibles à la casse. Pour compatibilité, soft et strict sont aussi acceptés dans les deux champs, mais ils ne signifient pas la même chose dans chacun (mode: "strict" équivaut à always, tandis que level: "strict" équivaut à restrictive). Utilisez unknown_only/always et preventive/restrictive, qui sont sans ambiguïté.
Un envoi ne peut que renforcer
L'ajustement n'assouplit jamais la configuration du domaine. Si votre domaine sonde déjà à chaque envoi et que la requête demande unknown_only, il reste à always. Et block ne fait qu'ajouter : si votre domaine bloque déjà risky, un envoi ne peut pas lever ce blocage en l'omettant.
C'est pourquoi never n'est pas accepté depuis la requête : un envoi peut demander plus de vérification, jamais moins.
Une valeur non reconnue renvoie 400 avec le code 1419.
force_validation
force_validation: true lance une nouvelle vérification de chaque destinataire pendant l'envoi, au lieu de le résoudre avec un résultat antérieur. C'est le raccourci de validation.mode: "always", il consomme donc un crédit par destinataire vérifié.
Il ne change pas le niveau d'exigence de la vérification : forcer une vérification n'assouplit jamais la politique d'envoi. Et s'il ne vous reste plus de crédits, l'envoi n'est pas bloqué : la vérification sera basique, et le résultat l'indique avec advanced: false.
Une relivraison technique du même envoi ne vérifie ni ne facture de nouveau : le résultat déjà stocké par cette opération est récupéré.
Lire le résultat
La validation avancée a lieu pendant l'envoi, après que l'API vous a déjà répondu. C'est pourquoi la réponse de POST /send ne porte aucun résultat par destinataire : quand vous la recevez, la vérification n'a pas encore eu lieu.
Ce que la réponse renvoie bien, ce sont les destinataires écartés avant la mise en file, dans rejected_recipients, avec leur motif : mauvais format, ou un résultat précédent que votre configuration n'accepte pas.
Le résultat complet vit dans le détail de chaque destinataire :
GET /v1/mailing/email-message/{uuid}{
"status": "success",
"data": {
"uuid": "9f1c...",
"recipient_email": "[email protected]",
"status": "rejected",
"validation": {
"checked": true,
"pending": false,
"advanced": true,
"reused": false,
"classification": "catch_all",
"reason": "Mailbox not verifiable",
"reason_code": "mailbox_not_verifiable",
"checked_at": "2026-01-01T10:29:07+00:00"
}
}
}| Champ | Description |
|---|---|
checked | Un résultat de validation est déjà disponible |
pending | Il a été marqué pour vérification et l'envoi ne l'a pas encore validé |
advanced | La vérification a sondé la boîte mail. Elle décrit la portée technique, pas la facturation |
reused | Le résultat a réutilisé une de vos vérifications encore valide, sans consommer de crédit |
classification | valid, catch_all, risky, unknown ou invalid. null si pas encore vérifié |
reason | Motif lisible renvoyé par le validateur. null si pas encore vérifié |
reason_code | Code stable du motif. null si pas encore vérifié |
checked_at | Date de la vérification, pas de l'envoi : réutiliser un résultat antérieur ne la renouvelle pas |
L'objet validation est toujours présent. Quand il n'y a pas encore de résultat, checked vaut false et les champs de résultat reviennent à null.
Quand la validation écarte un destinataire, son status devient rejected et le motif apparaît aussi dans error_message.
Vous obtenez l'UUID de chaque destinataire dans email_messages en appelant GET /email-request/{uuid}. Interrogez chacun avec GET /email-message/{uuid} pour lire son bloc validation : s'il est encore pending, ce qui a été checked, et si la vérification était advanced.
Crédits de validation
Vous êtes facturé pour l'exécution d'une nouvelle vérification avancée, quel que soit le canal : API d'envoi, SMTP, API de validation ou espace client. Consulter ou réutiliser une de vos vérifications encore valide ne consomme aucun crédit supplémentaire, et la vérification basique n'en consomme jamais.
Une vérification exécutée est facturée même si elle conclut que l'adresse est invalide ou laisse le résultat en unknown : ce que vous payez est la vérification, pas le verdict. Si une défaillance interne l'empêche d'aboutir, le crédit est restitué.
Les crédits viennent de deux sources :
- Inclus dans votre plan : ils se renouvellent chaque mois et expirent à la clôture du cycle.
- Achetés en packs : ils expirent 12 mois après l'achat.
Ceux qui expirent le plus tôt sont toujours utilisés en premier, les crédits du plan sont donc dépensés avant les crédits achetés. Vous pouvez consulter votre solde et acheter des packs depuis l'espace client, et activer la recharge automatique pour qu'un pack soit acheté quand le solde passe sous le minimum que vous fixez.
Si vous demandez une validation avancée sur un envoi et que vous n'avez plus de crédits, l'envoi n'est pas bloqué : la vérification redescend en basique et le résultat le signale avec validation.advanced à false. Sur l'API de validation, l'absence de crédits rejette bien la requête.
