Die Vonage-E-Mail-API ist nun in der offenen Beta-Phase verfügbar

Wir freuen uns, bekannt geben zu dürfen, dass die Vonage-E-Mail-API nun in der offenen Beta-Phase istund steht allen Managed-Kunden als Kanal innerhalb der Vonage Messages APIverfügbar ist.

Entwickler müssen nicht mehr auf einen separaten Anbieter zurückgreifen, wenn sie andere Nachrichtenkanäle wie SMS, WhatsApp oder Viber in den E-Mail-Versand integrieren möchten. Da lediglich ein weiterer Kanal hinzugefügt wird, können Sie diesen mit denselben Authentifizierungsdaten und Webhooks nutzen, die bereits in Ihrer Messages API-Anwendung eingerichtet sind. Super!

Im Rahmen unserer Ankündigung werden wir uns ansehen, welche Funktionen verfügbar sind und wie Sie Ihren ersten API-Aufruf durchführen können, um das Ganze zu testen.

Erste Schritte

Bevor Sie E-Mail nutzen können, müssen Sie die Einrichtung der Domain-Authentifizierung abschließen. Wie das geht, erfährst du hier, aber kurz gesagt: Durch das Hinzufügen und Konfigurieren von DNS-Einträgen bei Ihrem Provider wird den Diensten mitgeteilt, dass Vonage berechtigt ist, Nachrichten in Ihrem Namen zu versenden. Sobald Sie dies erledigt haben, müssen Sie Ihre Authentifizierung bei Vonage konfigurieren – wir führen Sie nun Schritt für Schritt durch diesen Vorgang.

Vonage-Authentifizierung

Security FirstFalls Sie noch keinen Authentifizierungsmechanismus eingerichtet haben, müssen Sie diesen einrichten. Erstellen Sie zunächst im Dashboard eine neue Vonage-Application und laden Sie Ihren privaten Schlüssel herunter:

Für die Vonage-Authentifizierung ist ein gültiges JWT Token – Sie können ein Vonage-JWT mithilfe der Vonage-CLI erstellen. Um es zu installieren, muss Node.js installiert sein, sodass Sie einen Paketmanager wie npm oder yarnverwenden können. Sobald Sie Node installiert haben, installieren Sie die Vonage-CLI global:

npm install -g @vonage/cli

Als Nächstes, im selben Verzeichnis wie Ihre heruntergeladene private.key, verwenden Sie Ihre application_id , um ein JWT zu generieren:

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

Die CLI gibt ein JWT-Token zurück, das Sie verwenden können.

Senden Sie Ihre erste E-Mail

Sie benötigen cURL installiert haben (das in der Regel bei den meisten Betriebssystemen mitgeliefert wird). Fügen Sie in der Befehlszeile diesen cURL-Befehl ein und ersetzen Sie das $JWT durch die von Ihnen soeben erstellte Umgebungsvariable.

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"
    }
  }'

Dadurch wird eine E-Mail im Klartext versendet, aber der Feld „message_type“ ermöglicht es Ihnen, auch HTML zu versenden; zum Beispiel:

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"
    }
  }'

Eine praktische Funktion ist, dass man beide Inhaltstypen mithilfe des Inhalts- „message“ verwenden, wodurch Sie Kompatibilitäts-Fallbacks für verschiedene Endgeräte einrichten können:

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"
    }
  }'

Sobald eine Nachricht an die Messages API gesendet wurde, sollten Sie eine 202 Antwort mit einem message_uuid, genau wie bei anderen Kanälen.

Webhooks einrichten

Mit Webhooks können Sie Benachrichtigungen abrufen: Es gibt fünf Zustellstatus, die denen der anderen Kanäle entsprechen: delivered, rejected, undeliverable, read, und submitted. Du benötigst ein Backend-Framework, um eingehende Nachrichten lesen zu können. Das ist zwar nicht Gegenstand dieser Ankündigung, aber eine ziemlich coole Funktion ist, dass du, wenn du ngrokinstallieren, die Vonage-CLI als Wrapper dafür verwenden können, sodass diese vorübergehend Ihre lokale Domain für Webhook-Zustellungen für die Anwendung (diese sehen Sie im Anwendungsbereich auf dem Dashboard) durch eine lokale ngrok-Adresse plus den von Ihnen angegebenen Pfad ersetzt. Wenn die Ereignisse der Anwendungen beispielsweise so konfiguriert sind, dass sie http:///example.com/webhooks/statuskonfiguriert sind und Sie den Befehl zum Öffnen Ihres Tunnels über die CLI ausführen:

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

Dadurch wird ngrok gestartet und Ihre lokale Domäne in etwa wie folgt geändert: https://sa9s8d.ngrok.app/webhooks/status. Das ist sehr praktisch, wenn Sie Ihre Integration testen. Eine eingehende Statusmeldung sieht in etwa so aus:

{
  "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"
}

Funktionen und Anwendungsfälle

Kampagnen

Bisher galt: Wenn Sie eine Marketingkampagne durchführen wollten, bei der sowohl SMS (mit etwas wie 10DLC) als auch E-Mail nutzen wollten, benötigten Sie einen separaten E-Mail-Dienst. Wenn Sie nun eine Marketingkampagne mit mehreren Zustellungsmethoden durchführen möchten, können Sie die Vonage Messages API nutzen, um die Kampagne beliebig groß zu skalieren.

Verfolgung

In vertikalen Märkten wie der Logistik oder dem E-Commerce ist es in der Regel sinnvoll, Bestätigungsanfragen oder Lieferbestätigungen per E-Mail statt über andere Kommunikationskanäle zu versenden. Die Einführung von E-Mail als Kanal macht dies nun möglich.

Authentifizierung und Sicherheit

Der E-Mail-Kanal wird in unserer Verify API verwendet, wenn die Zustellung eines Einmalpassworts (OTP) erforderlich ist (und kann auch zusammen mit anderen Kanälen wie SMS oder WhatsApp genutzt werden). Beachten Sie, dass es sich hierbei ebenfalls um eine Beta-Funktion handelt. Mit einem E-Mail-Kanal in der Messages API können Sie Messages jedoch auch in Ihren eigenen Authentifizierungsstack integrieren, beispielsweise zum Versenden von E-Mails zur Kontobestätigung oder zur Passwortzurücksetzung.

Ausweichlösungen

„Messages“ verfügt bereits über eine Ausweichfunktion für die Zustellung. Durch den zusätzlichen Kanal „E-Mail“ können Sie nun versuchen, wichtige Informationen über mehrere Kanäle zu übermitteln, um eine zuverlässigere Zustellbestätigung zu gewährleisten. Ich habe bereits erwähnt, dass E-Commerce ein typischer vertikaler Markt ist, in dem E-Mail zum Einsatz kommt. Im Folgenden finden Sie ein Beispiel dafür, wann Sie eine Kaufbestätigung über WhatsApp versenden möchten (da der Endnutzer dies als bevorzugte Kommunikationsmethode angegeben hat), die Zustellung jedoch nicht abgeschlossen werden kann (der Endnutzer hat die Bestellung in einem nicht unterstützten Gebiet aufgegeben oder es besteht keine Mobilfunkabdeckung), sodass die Bestätigung per E-Mail versendet wird:

{
  "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" }
    }
  ]
}

Was kommt als Nächstes?

Die Einführung als offene Beta ist erst der Anfang; wir haben noch zahlreiche Funktionen in unserer Roadmap vorgesehen, bevor das Produkt allgemein verfügbar (GA) wird:

• 3. Quartal 2026 (GA): Unterstützung für eingehende E-Mails, Unterstützung für Anhänge, dedizierte IP-Adressen, Self-Service-Onboarding über das Kunden-Dashboard, Verify-Integration (E-Mail als OTP-Fallback)

• 4. Quartal 2026: Dynamische E-Mail-Vorlagen, Personalisierung und dynamische Tags, Integration von Conversation Connect (Benutzeroberfläche des Kampagnenmanagers)

• 2027+: Erweiterte Analysen, A/B-Tests, Kontaktmanagement und vollständige Marketingautomatisierung

Schlussfolgerung

Ganz gleich, ob Sie Bestellbestätigungen oder Einmalpasswörter versenden oder Omnichannel-Failover-Workflows erstellen – durch die Erweiterung der Messages API um den E-Mail-Kanal erhalten Entwickler mehr Möglichkeiten und Flexibilität, um Kommunikationsfunktionen in ihre Applications zu integrieren.

Sind Sie bereit, loszulegen? Werfen Sie einen Blick in die Entwicklerdokumentation und wenden Sie sich an Ihren Account-Manager, um Ihre Domain einzurichten.