AM vous permet d’envoyer des e-mails depuis votre propre domaine avec une signature DKIM correcte pour améliorer la délivrabilité.
Les templates, le suivi de livraison et la gestion des bounces sont intégrés.
Envoi d’e-mails
Envoi direct
POST /api/accounts/:account_id/email-messages/send
Envoyez avec un contenu explicite :
- Contacts From/To/CC/BCC
- Objet et corps (texte + HTML)
Envoi par template
POST /api/accounts/:account_id/email-messages/send-template
Envoyez via un template avec substitution de variables ({{name}} → “Jane”).
Identités e-mail
Les identités e-mail sont des adresses d’expéditeur approuvées pour un compte.
| Opération | Endpoint |
|---|---|
| Créer | POST /api/accounts/:account_id/email-identities |
| Lister | GET /api/accounts/:account_id/email-identities |
| Mettre à jour | PATCH /api/email-identities/:email_identity_id |
| Supprimer | DELETE /api/email-identities/:email_identity_id |
Domaines et DKIM
Flux de configuration
- Enregistrer le domaine :
POST /api/accounts/:account_id/domains - Lancer les vérifications :
POST /api/domains/:domain_id/checks - Créer une clé DKIM :
POST /api/domains/:domain_id/dkim-keys - Activer la clé DKIM :
PATCH /api/dkim-keys/:dkim_key_id
Enregistrements DNS
| Record | Name | Purpose |
|---|---|---|
| TXT | _acme.mail.example.com | Propriété du domaine |
| TXT | selector._domainkey.mail.example.com | Clé publique DKIM |
Vérifications de domaine
AM vérifie :
- Les enregistrements TXT de propriété
- La configuration CNAME
- Les enregistrements A
- Les certificats TLS
- SPF, DKIM, DMARC, BIMI
- Les enregistrements MX
Templates d’e-mail
Créez des templates réutilisables avec variables :
Subject: Welcome, {{name}}!
Hi {{name}},
Your account {{account_name}} is ready.
| Opération | Endpoint |
|---|---|
| Créer | POST /api/accounts/:account_id/email-templates |
| Lister | GET /api/accounts/:account_id/email-templates |
| Obtenir | GET /api/email-templates/:email_template_id |
| Mettre à jour | PATCH /api/email-templates/:email_template_id |
| Supprimer | DELETE /api/email-templates/:email_template_id |
Suivi de livraison
Les événements suivent le cycle de vie d’un e-mail. event_type est spécifique au fournisseur, mais les valeurs courantes incluent :
| Event | Description |
|---|---|
queued | Accepté pour livraison |
sent | Remis au MTA destinataire |
bounced | Échec de livraison permanent |
APIs des messages et événements
| Opération | Endpoint |
|---|---|
| Lister les messages | GET /api/accounts/:account_id/email-messages |
| Rechercher des messages | POST /api/accounts/:account_id/email-messages/search |
| Supprimer par recherche | POST /api/accounts/:account_id/email-messages/search-delete |
| Obtenir un message | GET /api/email-messages/:email_message_id |
| Lister les événements | GET /api/accounts/:account_id/email-message-events |
| Rechercher des événements | POST /api/accounts/:account_id/email-message-events/search |
| Supprimer des événements par recherche | POST /api/accounts/:account_id/email-message-events/search-delete |
Gestion des bounces
Les hard bounces créent automatiquement des blocages d’adresses e-mail pour protéger votre réputation d’expéditeur.
| Opération | Endpoint |
|---|---|
| Lister les blocages | GET /api/accounts/:account_id/email-address-bans |
| Créer un blocage | POST /api/accounts/:account_id/email-address-bans |
| Supprimer un blocage | DELETE /api/accounts/:account_id/email-address-bans/:email_address_ban_id |
Liés
- Domaine - Configuration de domaine
- Clé DKIM - Clés de signature
- Identité e-mail - Expéditeurs approuvés
- Message e-mail - Enregistrements de messages
- Template d’e-mail - Templates