Verstehen von E-Mail-Nachrichten
Mit dem Vonage Messages API E-Mail-Kanal können Sie E-Mails über die gleiche einheitliche API versenden, die Sie bereits für SMS, WhatsApp, RCS und andere Messaging-Kanäle verwenden.
Auf dieser Seite wird erklärt, wie der E-Mail-Kanal funktioniert, was in der aktuellen Beta-Version unterstützt wird und welche wichtigen Konzepte Sie verstehen müssen, bevor Sie damit arbeiten.
Die Beta-Version konzentriert sich auf transaktionale E-Mail-Anwendungsfälle und umfasst die folgenden Funktionen:
- Eins-zu-eins ausgehende E-Mail - Senden Sie eine einzige E-Mail an einen einzigen Empfänger pro API-Anfrage.
- Einfacher Text und HTML-Inhalt - Verwendung
message_type: "text"für einfachen Text odermessage_type: "html"für HTML-E-Mails. - Transaktionsbezogene Anwendungsfälle - Auftragsbestätigungen, Passwortrücksetzungen, Versandbenachrichtigungen und ähnliche automatische Nachrichten.
- Zustellungsstatus über Webhooks - erhalten Sie Statusaktualisierungen über das gleiche Webhook-Modell wie andere Messages API-Kanäle.
- Regionaler Versand - Senden Sie E-Mails über geospezifische Endpunkte, die auf Ihre verifizierte Domainregion abgestimmt sind.
E-Mail-Integration in Messages API
E-Mail wird als neuer Kanal in das bestehende Messages API-Modell integriert. Es werden keine neuen Basisendpunkte eingeführt - Sie verwenden denselben Endpunkt /v1/messages, den Sie bereits für andere Kanäle verwenden.
Um eine E-Mail zu senden, setzen Sie "channel": "email" in Ihrem Anfragetext. Die message_type Feld akzeptiert "text" für reine Text-E-Mails und "html" für HTML-E-Mails.
E-Mail Anwendungsfälle
Der E-Mail-Kanal ist für transaktionale Anwendungsfälle gedacht, bei denen eine Nachricht durch eine Benutzeraktion oder ein Systemereignis ausgelöst wird. Übliche Beispiele sind:
- Auftragsbestätigungen und Quittungen - Senden Sie sofort nach dem Kauf eine Bestätigungs-E-Mail.
- Kennwortrücksetzung und Account-Überprüfung - zuverlässige Zustellung zeitkritischer Sicherheits-E-Mails.
- Versand- und Lieferbenachrichtigungen - Informieren Sie Ihre Kunden in jeder Phase der Auftragsabwicklung.
- Terminerinnerungen - reduzieren Sie Nichterscheinen mit automatischen Erinnerungs-E-Mails
- Systemwarnungen und -benachrichtigungen - Benachrichtigen Sie Benutzer oder interne Teams in Echtzeit über wichtige Ereignisse.