L'API e-mail de Vonage est désormais disponible en bêta ouverte

Nous sommes ravis d'annoncer que l' l'API e-mail de Vonage est désormais en bêta ouverte, accessible à tous les clients du service géré en tant que canal au sein de l’ Messages API Vonage.

Les développeurs n'ont plus besoin de faire appel à un prestataire tiers pour intégrer d'autres canaux de messagerie, tels que les SMS, WhatsApp ou Viber, à l'envoi d'e-mails. Comme il s'agit simplement d'ajouter un canal supplémentaire, vous pouvez l'utiliser avec les mêmes identifiants d'authentification et les mêmes webhooks que ceux déjà en place dans votre application Messages API. Génial !

À la suite de cette annonce, nous allons passer en revue les fonctionnalités disponibles et vous expliquer comment effectuer votre premier appel d'API pour la tester.

Pour commencer

Avant de pouvoir commencer à utiliser la messagerie électronique, vous devrez effectuer la configuration de l'authentification de votre domaine. Vous pouvez découvrir comment procéder, mais en résumé : l'ajout et la configuration des enregistrements DNS auprès de votre fournisseur permettent aux services de savoir que Vonage est autorisé à envoyer des messages en votre nom. Une fois cette étape franchie, vous devrez configurer votre authentification auprès de Vonage, ce que nous allons vous expliquer ci-dessous.

Authentification Vonage

Security FirstSi vous ne disposez pas encore d'un mécanisme d'authentification, vous devrez en configurer un. Commencez par créer une nouvelle application Vonage dans le Tableau de bord, puis téléchargez votre clé privée :

L'authentification Vonage nécessitera un token JWT ; vous pouvez créer un JWT Vonage à l'aide de l'interface CLI de Vonage. Pour l'installer, vous devez disposer de Node.js, ce qui vous permettra d’utiliser un gestionnaire de paquets tel que npm ou yarn. Une fois Node installé, installez la CLI Vonage au niveau global :

npm install -g @vonage/cli

Ensuite, dans le même répertoire que le fichier que vous avez téléchargé private.key, utilisez votre application_id pour générer un JWT :

vonage jwt create --app_id <your_app_id> --private-key ./private.key

L'interface CLI vous renverra un jeton JWT que vous pourrez utiliser.

Envoyez votre premier e-mail

Vous aurez besoin de cURL (qui est généralement fourni avec la plupart des systèmes d'exploitation). Dans la ligne de commande, collez cette commande cURL et remplacez le $JWT par celle que vous venez de créer.

curl -X POST https://api-eu.nexmo.com/v1/messages \
  -H "Authorization: Bearer $JWT" \
  -H "Content-Type: application/json" \
  -d '{
    "channel": "email",
    "from": "sender@yourdomain.com",
    "to": "recipient@example.com",
    "message_type": "text",
    "text": "Hello! Your order has been confirmed.",
    "email": {
      "subject": "Order Confirmation"
    }
  }'

Cela enverra un e-mail en texte brut, mais le champ « message_type » vous permet également d'envoyer du code HTML ; par exemple :

curl -X POST https://api-eu.nexmo.com/v1/messages \
  -H "Authorization: Bearer $JWT" \
  -H "Content-Type: application/json" \
  -d '{
    "channel": "email",
    "from": "sender@yourdomain.com",
    "to": "recipient@example.com",
    "message_type": "html",
    "html": {
      "body": "<h1>Order Confirmed</h1><p>Thank you for your purchase. Your order is on its way!</p>"
    },
    "email": {
      "subject": "Order Confirmation"
    }
  }'

Une fonctionnalité très pratique est la possibilité d'imbriquer ces deux types de contenu à l'aide de la balise type de message », ce qui vous permet de disposer de solutions de secours pour assurer la compatibilité avec différents terminaux :

curl -X POST https://api-eu.nexmo.com/v1/messages \
  -H "Authorization: Bearer $JWT" \
  -H "Content-Type: application/json" \
  -d '{
    "channel": "email",
    "from": "Your Brand <sender@yourdomain.com>",
    "to": "recipient@example.com",
    "message_type": "content",
    "content": [
      { "type": "text", "text": "Your order has been confirmed." },
      { "type": "html", "body": "<p>Your order has been <strong>confirmed</strong>.</p>" }
    ],
    "email": {
      "subject": "Order Confirmation"
    }
  }'

Une fois qu'un message a été envoyé à l'API, vous devriez recevoir une 202 réponse contenant un message_uuid, comme c'est le cas avec les autres canaux.

Configuration des webhooks

Les webhooks vous permettront de recevoir des notifications : il existe cinq statuts de livraison qui correspondent à ceux des autres canaux : delivered, rejected, undeliverable, read, et submitted. Vous aurez besoin d’un framework back-end pour pouvoir lire les messages entrants, ce qui n’est pas l’objet de cette annonce, mais l’une des fonctionnalités très pratiques est que si vous installez ngrok, vous pouvez utiliser la CLI Vonage comme wrapper pour qu’elle remplace temporairement votre domaine local pour les livraisons de webhooks de l’application (ce sont celles que vous pouvez voir dans le panneau « Applications » du tableau de bord) par une adresse ngrok locale suivie du chemin que vous avez indiqué. Par exemple, si les événements de l’application sont configurés pour être http:///example.com/webhooks/status, et que vous exécutez la commande pour ouvrir votre tunnel avec l’interface CLI :

vonage tunnel ngrok "<your-application-id>" --port=8000

Cela lancera ngrok et modifiera votre domaine local pour qu'il devienne quelque chose comme https://sa9s8d.ngrok.app/webhooks/status. Très pratique pour tester votre intégration. Une notification de statut entrante ressemblera à ceci :

{
  "message_uuid": "aaaaaaaa-bbbb-4ccc-8ddd-0123456789ab",
  "from": "sender@yourdomain.com",
  "to": "recipient@example.com",
  "timestamp": "2026-06-01T10:00:01.000Z",
  "status": "delivered",
  "channel": "email"
}

Fonctionnalités et cas d'utilisation

Campagnes

Auparavant, si vous souhaitiez mener une campagne marketing utilisant à la fois les SMS (avec un service tel que 10DLC) et d’e-mails, vous deviez recourir à un service de messagerie électronique distinct. Désormais, si vous menez une campagne marketing utilisant plusieurs canaux de diffusion, vous pouvez utiliser la Messages API pour étendre votre campagne à l’échelle dont vous avez besoin.

Suivi

Sur les marchés verticaux tels que la logistique ou le commerce électronique, on préfère généralement envoyer des demandes de confirmation ou des accusés de réception par e-mail plutôt que par d'autres canaux de communication. L'introduction de l'e-mail comme canal de communication permet désormais cela.

Authentification et sécurité

Le canal « E-mail » est utilisé dans notre Verify API lorsque l'envoi d'un mot de passe à usage unique (OTP) est requis (et peut également être utilisé en complément d'autres canaux tels que les SMS ou WhatsApp). Notez qu'il s'agit également d'une fonctionnalité en version bêta. Cependant, grâce au canal e-mail de la Messages API, vous pouvez également intégrer Messages à votre propre infrastructure d'authentification, par exemple pour envoyer des e-mails de vérification de compte ou de réinitialisation de mot de passe.

Solutions de repli

Messages dispose déjà d'une fonctionnalité de secours pour la livraison ; ainsi, l'ajout de l'e-mail comme canal vous permet désormais de tenter de transmettre des informations essentielles par plusieurs moyens afin de garantir une meilleure confirmation de réception. J’ai déjà mentionné que le commerce en ligne est un marché vertical typique où l’e-mail serait utilisé ; voici donc un exemple de situation où vous souhaitez envoyer une confirmation d’achat via WhatsApp (car l’utilisateur final l’a désigné comme moyen de communication préféré), mais que la livraison ne peut être effectuée (l’utilisateur final a passé commande dans une zone non prise en charge ou il n’y a pas de couverture mobile) et que, par conséquent, la confirmation est envoyée par e-mail :

{
  "template": {
    "name": "order_confirmation",
    "parameters": [{ "type": "text", "text": "ORD-12345" }]
  },
  "workflow": [
    {
      "channel": "whatsapp",
      "from": "15551234567",
      "to": "15559876543"
    },
    {
      "channel": "email",
      "from": "orders@yourdomain.com",
      "to": "customer@example.com",
      "message_type": "html",
      "html": { "body": "<p>Your order ORD-12345 is confirmed!</p>" },
      "email": { "subject": "Order Confirmation - ORD-12345" }
    }
  ]
}

À venir

Le lancement de cette version en bêta ouverte n'est qu'un début ; nous avons de nombreuses fonctionnalités prévues dans notre feuille de route avant sa mise en service générale (GA) :

• 3e trimestre 2026 (lancement officiel) : Prise en charge des e-mails entrants, prise en charge des pièces jointes, adresses IP dédiées, intégration en libre-service via le tableau de bord client, intégration à Verify (e-mail comme solution de secours pour les codes OTP)

• 4e trimestre 2026 : Modèles d'e-mails dynamiques, personnalisation et balises dynamiques, intégration de Conversation Connect (interface utilisateur du gestionnaire de campagnes)

• 2027+ : Analyses avancées, tests A/B, gestion des contacts et automatisation complète du marketing

Conclusion

Que ce soit pour envoyer des confirmations de commande, des mots de passe à usage unique (OTP) ou pour mettre en place des workflows de basculement omnicanal, l'ajout du canal « E-mail » à la Messages API offre aux développeurs davantage d'options et de possibilités pour intégrer des communications dans leurs applications.

Prêt à vous lancer ? Consultez la documentation destinée aux développeurs et contactez votre Account Manager pour faire enregistrer votre nom de domaine.