Envoyer un email

Essayez tout de suite, sans domaine

Pas encore de domaine vérifié ? Zendou fournit une adresse d’expédition de test, prête à l’emploi dès qu’une clé API existe - copiable sur Clés API. Elle n’est pas reproduite ici : ainsi cette page reste toujours exacte, même si Zendou change un jour de domaine d’expédition partagé.

curl -X POST https://api.zendou.app/v1/emails \
  -H "Authorization: Bearer zd_live_votre_cle" \
  -H "Content-Type: application/json" \
  -d '{
    "from": "adresse affichée sur /dashboard/cles-api",
    "to": "vous@votre-adresse-de-compte.gn",
    "subject": "Mon premier email Zendou",
    "html": "<p>Ça marche déjà, avant même de vérifier un domaine.</p>"
  }'

Paramètres du corps

Formats d’adresse

Les champs from, to et replyTo acceptent deux formes : adresse@domaine ou Nom <adresse@domaine>. Le champ to accepte lui aussi les deux formes, avec un seul destinataire. Règles :

• le chevron fermant doit terminer la valeur : rien ne peut suivre > ;
• le nom peut être entre guillemets, et doit l’être s’il contient l’un des caractères " ( ) , : ; < > @ [ \ ], par exemple "Awa, Boutique" <no-reply@boutique-awa.gn> (dans du JSON, les guillemets s’échappent avec \) ;
• la partie avant le @ n’est pas acceptée entre guillemets ;
• le nom d’affichage est limité à 128 caractères (un accent ou un emoji compte pour 1) : au-delà, l’API répond 400 avant tout débit, par exemple « Le nom d’affichage de l’adresse d’expédition est trop long : il ne doit pas dépasser 128 caractères. » ;
• un nom avec des accents (par exemple « Boutique Awa Diallo ») peut être envoyé tel quel : Zendou l’encode pour la messagerie ;
• l’adresse est ramenée en minuscules, et pour from et replyTo le domaine doit être vérifié sur votre compte ;
• le journal, la liste de suppression et le bac à sable travaillent sur l’adresse seule, en minuscules, sans le nom.

"from": "Boutique Awa <no-reply@boutique-awa.gn>",
"replyTo": "support@boutique-awa.gn",
"to": "Awa Diallo <client@exemple.gn>"

En-têtes personnalisés

Le champ headers ajoute des en-têtes à l’email. Règles :

• 20 en-têtes au plus ;
• noms autorisés : List-Unsubscribe, List-Unsubscribe-Post et X-* hors X-SES-* (X- seul est refusé), sans tenir compte de la casse, sans doublon ;
• nom de 126 caractères au plus ;
• valeur en ASCII imprimable uniquement (ni accent, ni saut de ligne), 995 caractères au plus ;
• nom et valeur réunis : 996 caractères au plus.

Toute autre valeur donne une réponse 400 avant tout débit de crédit. Le relais SMTP transmet les en-têtes tels quels, à l’exception de Bcc, Return-Path, Sender et des Resent-*, qu’il retire.

Désinscription en un clic

Pour les envois réguliers (rappels, bilans, lettres d’information), Gmail et Yahoo exigent la désinscription en un clic pour les envois en volume. Ajoutez les deux en-têtes ci-dessous, puis traitez la désinscription de votre côté : Zendou ne gère pas vos listes d’abonnés.

curl -X POST https://api.zendou.app/v1/emails \
  -H "Authorization: Bearer zd_live_votre_cle" \
  -H "Content-Type: application/json" \
  -d '{
    "from": "Boutique Awa <no-reply@boutique-awa.gn>",
    "to": "cliente@exemple.gn",
    "subject": "Votre bilan de la semaine",
    "html": "<p>Voici votre bilan.</p>",
    "headers": {
      "List-Unsubscribe": "<https://boutique-awa.gn/desinscription?id=abc123>, <mailto:desabonnement@boutique-awa.gn>",
      "List-Unsubscribe-Post": "List-Unsubscribe=One-Click"
    }
  }'

Exemple de requête

curl -X POST https://api.zendou.app/v1/emails \
  -H "Authorization: Bearer zd_live_votre_cle" \
  -H "Content-Type: application/json" \
  -d '{
    "from": "Boutique Awa <no-reply@boutique-awa.gn>",
    "to": "cliente@exemple.gn",
    "replyTo": "support@boutique-awa.gn",
    "subject": "Votre commande est confirmée",
    "html": "<p>Merci pour votre commande, elle est en préparation.</p>"
  }'

Exemple de réponse

Toute requête acceptée répond 202 Accepted - y compris quand le destinataire est bloqué : l’email est alors tracé avec le statut suppressed, sans être mis en file ni facturé.

{
  "id": "e_7f3a91c2b8d1",
  "status": "queued"
}

{
  "id": "e_1a2b3c4d5e6f",
  "status": "suppressed"
}

Codes d’erreur

Voir Erreurs pour la référence complète de tous les codes HTTP de l’API, toutes routes confondues.

Statuts d’un email

Un envoi accepté suit normalement le cycle QUEUED → SENT → DELIVERED. Les statuts suivants marquent une sortie de ce cycle :