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 comment fonctionne le canal Email, ce qui est pris en charge dans la version bêta actuelle et les concepts clés que vous devez comprendre avant de construire avec ce canal.
La version bêta se concentre sur les cas d'utilisation du courrier électronique transactionnel et comprend les fonctionnalités suivantes :
- Courrier électronique sortant un à un - envoyez un seul courrier électronique à un seul destinataire par demande d'API.
- Texte simple et contenu HTML - utiliser
message_type: "text"pour du texte brut oumessage_type: "html"pour les courriels HTML. - Cas d'utilisation transactionnelle - confirmations de commandes, réinitialisations de mots de passe, avis d'expédition et autres messages automatisés similaires.
- État de la livraison via des webhooks - recevez des mises à jour d'état en utilisant le même modèle de webhook que les autres canaux de l'API Messages.
- Envoi régional - envoyez des courriels via des points d'extrémité géo-spécifiques alignés sur la région de votre domaine vérifié.
Intégration du courrier électronique à l'API Messages
Le courrier électronique est intégré en tant que nouveau canal dans le modèle existant de l'API Messages. Aucun nouveau point de terminaison de base n'est introduit - vous utilisez le même point de terminaison /v1/messages 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.
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.