Comprendre la messagerie électronique

Le canal de messagerie de l'API Messages de Vonage vous permet d'envoyer des courriels à l'aide de l'API unifiée que vous utilisez déjà pour les SMS, WhatsApp, RCS et d'autres canaux de messagerie.

Cette page explique le fonctionnement du canal « E-mail », les fonctionnalités prises en charge et les concepts clés à maîtriser avant de l'utiliser pour développer une application.

Le canal « E-mail » est axé sur les cas d'utilisation des e-mails transactionnels et comprend les fonctionnalités suivantes :

E-mails sortants — texte brut et HTML
Webhooks relatifs au statut de livraison
Expéditions régionales (UE, États-Unis, APAC)
Authentification en libre-service des noms de domaine via le Tableau de bord client
Liaison d'un domaine à l'application Vonage via le tableau de bord
Journaux et statistiques dans le tableau de bord client
Gestion des retours et des réclamations
Gestion de la liste de suppression
E-mails entrants via un webhook
Adresses IP dédiées
Prise en charge des champs « CC » et « Cci »

Fonctionnement du canal de communication par e-mail

L'e-mail est un canal natif de la Messages API. Il utilise le même /v1/messages point de terminaison, modèle d'authentification JWT et mode de transmission des webhooks via SMS, WhatsApp et RCS.

Flux sortant

Votre application envoie une requête POST /v1/messages avec le canal défini sur « e-mail ». Le moteur de messagerie Vonage achemine le message vers la boîte de réception du destinataire et envoie des mises à jour de livraison à l'URL de statut que vous avez configurée.

Flux entrant

Un expéditeur envoie un e-mail à votre domaine vérifié. L'enregistrement MX du domaine achemine le message vers Vonage, qui identifie le domaine associé et transmet l'événement à l'URL de réception configurée dans l'application Vonage.

Intégration du courrier électronique à l'API Messages

La messagerie électronique est intégrée en tant que nouveau canal au sein du modèle existant de la Messages API. Aucun nouveau point de terminaison de base n'est introduit : vous utilisez les mêmes /v1/messages point de terminaison que vous utilisez déjà pour d'autres canaux.

Pour envoyer un courrier électronique, définissez "channel": "email" dans le corps de votre requête. Les message_type Le champ accepte "text" pour les courriels en texte clair et "html" pour les courriels HTML.

Intégration en libre-service des noms de domaine

L'authentification du domaine s'effectue entièrement en libre-service via le tableau de bord client Vonage. Suivez les étapes ci-dessous pour préparer votre domaine à la messagerie électronique :

Ajoutez votre nom de domaine. Dans le Tableau de bord client, rendez-vous dans Messages > E-mail > Authentification du domaine puis saisissez le nom de domaine que vous souhaitez utiliser.
Configurez les enregistrements DNS. Ajoutez les enregistrements SPF, DKIM et DMARC fournis par Vonage auprès de votre fournisseur DNS.
Patientez jusqu'à ce que la vérification soit effectuée. La vérification DNS peut prendre jusqu'à 72 heures.
Associez le domaine vérifié. Connectez le domaine à une application Vonage pour activer le routage des webhooks et la réception d'e-mails.

Étape suivante : Voir Débuter avec le courrier électronique pour consulter le guide complet d'intégration et de configuration.

E-mails entrants

Le canal « E-mail » prend en charge les messages entrants envoyés à un domaine ou sous-domaine vérifié par Vonage. Vonage reçoit l'e-mail et le transmet à l'application Vonage associée via l'URL entrante configurée.

Exigences clés :

Configurer les enregistrements DNS entrants. Configurez le domaine ou le sous-domaine entrant pour qu'il pointe vers les serveurs de messagerie fournis par Vonage.
Associez le nom de domaine. Associez le domaine vérifié à une application Vonage.
Définissez l'URL d'entrée. Configurez le point de terminaison de l'application qui recevra les événements liés aux e-mails entrants.
Utilisez un sous-domaine dédié. Un sous-domaine tel que reply.example.com permet d'éviter que le routage entrant n'affecte la messagerie d'entreprise sur le domaine racine.
Gérer les messages multi-domaines. Si un e-mail comprend des destinataires appartenant à plusieurs domaines vérifiés, Vonage génère un événement distinct pour chaque destinataire appartenant à un domaine vérifié. Chaque événement possède un UUID de message différent, un CDR distinct et la liste complète des destinataires d'origine.

Journaux et analyses

La section « Journaux et analyses » du tableau de bord client Vonage offre une visibilité en temps réel sur les activités d'envoi et de remise des e-mails.

Les clients disposant d'un accès à l'API de messagerie peuvent utiliser le tableau de bord sans configuration supplémentaire pour consulter l'activité des messages, analyser les résultats de livraison et faciliter le dépannage opérationnel.

Adresses IP dédiées

Par défaut, les e-mails sont envoyés via le pool d'adresses IP partagées de Vonage. Les expéditeurs à fort volume bénéficiant de forfaits éligibles peuvent demander des adresses IP dédiées afin d'isoler la réputation de l'expéditeur et de mieux contrôler la délivrabilité.

Points clés à prendre en compte :

Avantages du forfait : une adresse IP dédiée est incluse dans le forfait « Advanced » dès sa mise à disposition générale.
Capacité supplémentaire : des adresses IP supplémentaires sont disponibles moyennant un supplément unique de 30 $ par adresse IP.
Préparation : Vonage ne gère pas le processus de préparation des adresses IP ; il incombe au client de préparer ses adresses IP dédiées.
Cohérence des volumes : les adresses IP dédiées nécessitent un volume d'envoi stable pour établir et maintenir la réputation de l'expéditeur.

Cas d'utilisation du courrier électronique

Le canal Email est conçu pour les cas d'utilisation transactionnels où un message est déclenché par une action de l'utilisateur ou un événement du système. Les exemples les plus courants sont les suivants :

Confirmations de commande et reçus - envoyez un courriel de confirmation immédiatement après un achat.
Réinitialisation du mot de passe et vérification de l'Account : envoyez en toute fiabilité des courriels de sécurité sensibles au facteur temps.
Avis d'expédition et de livraison - informez vos clients à chaque étape de l'exécution.
Rappels de rendez-vous - réduisez les désistements grâce à des courriels de rappel automatisés
Alertes et notifications du système : informez les utilisateurs ou les équipes internes des événements importants en temps réel.
OTP / Authentification à deux facteurs — l'e-mail comme canal de secours pour Vonage Verify.
Suivi des réponses et gestion des tickets d'assistance — utilisez la messagerie entrante pour recevoir les réponses des clients à vos e-mails automatisés.
Basculement omnicanal — configurez l'e-mail comme solution de secours en cas de défaillance de WhatsApp ou des SMS à l'aide du modèle de basculement de la Messages API.
Notifications KYC / conformité — assurez la transmission fiable des documents de vérification d'identité et des documents réglementaires.
Séquences d'accueil et d'intégration — déclenchez l'envoi d'e-mails d'intégration automatisés depuis votre plateforme.

L'e-mail au cœur de votre stratégie omnicanale

L'e-mail étant un canal natif de la Messages API, vous pouvez l'utiliser parallèlement aux SMS, à WhatsApp et au RCS grâce à une API et à un modèle d'authentification uniformes.

Exemple de workflow de basculement :

Commencez par le canal de votre choix. Envoyez le message initial via WhatsApp.
Passez à l'e-mail. Si le message WhatsApp n'est pas remis dans le délai défini, envoyez un e-mail.
Utilisez les SMS comme solution de secours ultime. Si l'e-mail est rejeté, envoyez une notification par SMS.

Cette approche permet de centraliser la coordination des canaux au sein de la Messages API et réduit la nécessité de gérer des intégrations distinctes avec chaque fournisseur.