Erste Schritte mit E-Mail

Die Vonage Messages API unterstützt E-Mail als Kanal, sodass Sie Transaktions-E-Mails über denselben API-Vertrag versenden können, den Sie bereits für andere Messaging-Kanäle nutzen.

Voraussetzungen

Bevor Sie beginnen, vergewissern Sie sich, dass Sie alles haben:

• A Vonage API-Konto
• Ihr API-Schlüssel und Ihr API-Geheimnis aus dem Vonage-API-Dashboard
• Eine Absenderdomain, die Sie im DNS verwalten können

E-Mail-Onboarding

Führen Sie die Domain-Einrichtung direkt im Vonage-Kunden-Dashboard durch:

1. Anmelden. Melden Sie sich bei der Vonage Kunden Dashboard.
2. Open-Domain-Authentifizierung. Gehen Sie zu Nachrichten > E-Mail > Domain-Authentifizierung.
3. E-Mail-Zugang beantragen. Reichen Sie im Dashboard einen Antrag ein und geben Sie dabei den API-Schlüssel an, den Sie verwenden möchten. Wenn Sie einen API-Schlüssel für ein Subaccount verwenden, geben Sie sowohl den Haupt-API-Schlüssel als auch den API-Schlüssel für das Subaccount an. Vonage benachrichtigt Sie, sobald der Antrag bearbeitet wurde und die Option zur Domain-Authentifizierung verfügbar ist.
4. Fügen Sie Ihre Absenderdomain hinzu. Wählen Sie „Domäne authentifizieren“, geben Sie die Domäne ein und wählen Sie die Region aus, die Ihren Nutzern oder Ihrer Infrastruktur am nächsten liegt: EU, USA oder APAC. Eine Domäne kann nur in einer Region verifiziert werden.
5. Kopieren Sie die DNS-Einträge. Das Dashboard generiert die erforderlichen DNS-Einträge. Kopieren Sie jeden Wert genau so, wie er angezeigt wird.
6. Aktualisieren Sie Ihre DNS-Einstellungen. Fügen Sie die Einträge über Ihren Domain-Anbieter hinzu. Die DNS-Verbreitung kann bis zu 72 Stunden dauern.
7. Bestätigen Sie die Überprüfung. Kehren Sie zum Dashboard zurück und überwachen Sie den Status. Wenn sich der Status ändert zu Verifiziert, dann ist die Domain einsatzbereit.
8. Die Domain mit einer Anwendung verknüpfen. Verknüpfen Sie die verifizierte Domain mit einer Vonage-Application, indem Sie die Anweisungen im nächsten Abschnitt befolgen.

Ihre Domain mit einer Vonage-Application verknüpfen

Nachdem Ihre Domain verifiziert wurde, verknüpfen Sie sie mit einer Vonage-Application, damit eingehende E-Mails und Webhook-Ereignisse korrekt weitergeleitet werden.

Durch die Verknüpfung der Domain wird Folgendes ermöglicht:

• Weiterleitung eingehender E-Mails an den Webhook Ihrer Anwendung.
• Konfigurieren von Inbound- und Status-URLs auf Anwendungsebene.
• Verwendung einer sicheren JWT-Authentifizierung, die auf die Anwendung beschränkt ist.

So verknüpfen Sie eine verifizierte Domain:

1. Offene Applications. Melden Sie sich beim Vonage-Kunden-Dashboard an und wechseln Sie zum Bereich „Applications“.
2. Wählen Sie die Anwendung aus. Öffnen Sie die Vonage-Application, die Sie mit der verifizierten Domain nutzen möchten.
3. Nachrichten aktivieren. Stellen Sie sicher, dass die Funktion „Nachrichten“ für die Anwendung aktiviert ist.
4. Die Domain verknüpfen. Wählen Sie „Domain verknüpfen“, wählen Sie die verifizierte Domain aus und bestätigen Sie die Verknüpfung.
5. Webhooks konfigurieren. Legen Sie die Eingangs-URL und die Status-URL der Applications fest.
6. Verify the setup. Vergewissern Sie sich, dass die Domain als verknüpft angezeigt wird und dass die Webhook-URLs korrekt sind.

Regel für die Verknüpfung von Domänen: With an application, multiple domains can be linked, but each domain can be linked only to one application.

Einrichtung der Domänenauthentifizierung

Bevor Sie E-Mails versenden können, müssen Sie Ihre Absenderdomain authentifizieren. Die Domain-Authentifizierung verbessert die Zustellbarkeit und ermöglicht es E-Mail-Anbietern, zu Verify, ob Vonage berechtigt ist, in Ihrem Namen E-Mails zu versenden.

Die Authentifizierung wird durch das Hinzufügen von DNS-Einträgen zu Ihrer Domain abgeschlossen. Diese Einträge ermöglichen:

• SPF (Sender Policy Framework) zur Autorisierung der Versandinfrastruktur von Vonage.
• DKIM (DomainKeys Identified Mail) zur kryptografischen Signierung ausgehender E-Mail-Inhalte.
• DMARC (Domain-based Message Authentication, Reporting and Conformance) zur Festlegung von Richtlinien und Berichtsverfahren bei Authentifizierungsfehlern.

Große E-Mail-Anbieter wie Google, Microsoft und Yahoo stützen sich bei der Entscheidung, ob Nachrichten zugestellt, abgelehnt oder gefiltert werden, auf diese Standards.

Weitere Informationen finden Sie unter Faktoren, die die Zustellbarkeit Ihrer E-Mails beeinflussen.

Zu konfigurierende DNS-Einträge

Vonage stellt die genauen Werte während des Onboardings bereit. Die folgende Tabelle zeigt die erwartete Datensatzstruktur:

Bewährte Verfahren zur Authentifizierung

• Konfigurieren Sie alle von Vonage bereitgestellten DKIM-Einträge für jede sendende Domain.
• Beginnen Sie mit DMARC p=none Während der Überwachungsphase sollten Sie zunächst weniger strenge Richtlinien anwenden und diese erst dann verschärfen, wenn Sie dazu bereit sind.
• Fügen Sie Vonage mithilfe von include:msg.vonage.com.
• Falls Sie bereits über einen SPF-Eintrag verfügen, fügen Sie den Vonage-Eintrag einfach an, anstatt bestehende Einträge zu ersetzen.

Beispiel:

• Bestehender SPF: v=spf1 include:example.com ~all
• Aktualisierter Lichtschutzfaktor: v=spf1 include:example.com include:msg.vonage.com ~all

Erweiterte DNS-Optionen

• Klicken Sie hier, um das Tracking-DNS zu öffnen: Vonage kann zusätzliche CNAME-Einträge für die Tracking-Konfiguration bereitstellen.
• Benutzerdefiniert mail from / Return-Path: Vonage unterstützt die benutzerdefinierte Konfiguration des Return-Paths und stellt möglicherweise zusätzliche MX- und TXT-Einträge bereit.

Sie können die erweiterten DNS-Optionen über das Kunden-Dashboard auswählen.

Senden Sie Ihre erste E-Mail

Sobald Ihre Domain verifiziert ist, können Sie E-Mails über die Messages API versenden.

Erstellen einer Vonage-Applikation

Um die Messages API nutzen zu können, benötigen Sie eine Vonage-Application, bei der die Messages-Funktion aktiviert ist.

1. Gehe zu Erstellen einer Applikation im Vonage Dashboard.
2. Geben Sie einen Anwendungsnamen ein.
3. Klicken Sie auf Öffentlichen und privaten Schlüssel generieren und bewahren Sie den privaten Schlüssel sicher auf.
4. Unter Fähigkeitenaktivieren Nachrichten.
5. Richten Sie Ihre Webhooks für die Inbound-URL und die Status-URL ein.
6. Klicken Sie auf Neue Anwendung generieren.

Weitere Informationen finden Sie unter Erstellen einer Vonage-Applikation.

Legen Sie Ihre ersetzbaren Werte fest

Verwenden Sie die folgenden Variablen in den Beispielen und ersetzen Sie sie durch Ihre eigenen Werte:

Erzeugen eines JWT

Die Messages API verwendet die JWT-Authentifizierung. Erstellen Sie vor dem Aufruf der API ein JWT unter Verwendung Ihrer Anwendungs-ID und Ihres privaten Schlüssels.

Eine Text-E-Mail senden

{
   "channel": "email",
   "from": "sender@example.com",
   "to": "recipient@example.com",
   "message_type": "text",
   "text": "Email body text",
   "email": {
      "subject": "Email subject"
   }
}

Im Erfolgsfall enthält die API-Antwort message_uuid:

{
   "message_uuid": "aaaaaaaa-bbbb-cccc-dddd-0123456789ab"
}

Eine HTML-E-Mail senden

{
   "channel": "email",
   "from": "sender@example.com",
   "to": "recipient@example.com",
   "message_type": "html",
   "html": {
      "body": "<p>Email body html</p>"
   },
   "email": {
      "subject": "Email subject"
   }
}

E-Mail-Größenbeschränkungen

Der E-Mail-Textkörper unterstützt bis zu 100 KB pro API-Anfrage. Wenn der Textkörper diese Grenze überschreitet, gibt die Anfrage einen Fehler zurück.

Die Messages API erzwingt zudem eine auf Netzwerkebene geltende Begrenzung der Nutzdatenmenge auf 200 KB.

Lieferstatus prüfen

Nach dem Versenden einer E-Mail sendet Vonage Statusaktualisierungen zu der von Ihnen konfigurierten Status-URL.

Faktoren, die die Zustellbarkeit Ihrer E-Mails beeinflussen

Die E-Mail-Zustellbarkeit bezeichnet die Fähigkeit einer E-Mail-Nachricht, den Posteingang des Empfängers zu erreichen.

Delivery und deliverability sind unterschiedlich:

• „Zustellung“ bedeutet, dass der empfangende Mailserver die Nachricht angenommen hat.
• Zustellbarkeit bedeutet, dass die Nachricht im Posteingang landet und nicht im Spam-Ordner oder abgelehnt wird.

Modell der geteilten Verantwortung

Die Zustellbarkeit von E-Mails liegt in der gemeinsamen Verantwortung von Vonage und dem Kunden.

Domänenauthentifizierung

Die Domain-Authentifizierung ist einer der wichtigsten Faktoren für die Zustellbarkeit.

• DKIM signiert den Inhalt der Nachricht.
• DMARC legt die Vorgehensweise bei Authentifizierungsfehlern fest.
• SPF autorisiert vertrauenswürdige Absender.

Diese Standards helfen E-Mail-Anbietern dabei, die Identität des Absenders und die Integrität der Nachricht zu Verify.

Absender-Reputation

E-Mail-Anbieter überprüfen kontinuierlich die Reputation von Domains und IP-Adressen.

Ein schlechter Ruf kann folgende Folgen haben:

• Einordnung in den Spam-Ordner
• Vorübergehende Drosselung
• Ablehnung einer Nachricht
• Geringere Platzierung im Posteingang

Die Reputation wird durch Spam-Beschwerden, Bounce-Raten, die Regelmäßigkeit des Versands, die Nutzerinteraktion und die Qualität der Nachrichten beeinflusst.

Bewährte Praktiken:

• Senden Sie Ihre Nachrichten nur an Empfänger, die diese erwarten.
• Vermeiden Sie plötzliche Spitzen beim Versandvolumen.
• Entfernen Sie regelmäßig inaktive Empfänger.
• Überwachen Sie die Absprung- und Beschwerdequoten.

Qualität der E-Mail-Inhalte

E-Mail-Anbieter bewerten zudem die Qualität der Nachrichteninhalte.

Defekte Links, verdächtige Anhänge, übermäßig viele reine Bildinhalte oder übergroße Datenmengen können die Zustellbarkeit beeinträchtigen.

Bewährte Praktiken:

• Verwenden Sie vertrauenswürdige Domains in Links.
• Achten Sie darauf, dass der Inhalt Ihrer Nachricht klar, relevant und gut strukturiert ist.
• Achten Sie auf ein ausgewogenes Verhältnis zwischen Text und Bildern.
• Überprüfen Sie die Anhänge und achten Sie darauf, dass die Größe der Nutzdaten innerhalb der zulässigen Grenzen bleibt.

Einbindung der Empfänger

E-Mail-Anbieter nutzen Signale zur Empfängerinteraktion, um die Platzierung im Posteingang zu steuern.

Zu den positiven Signalen zählen das Öffnen von E-Mails, Klicks, Antworten sowie das Verschieben von Nachrichten aus dem Spam-Ordner in den Posteingang. Zu den negativen Signalen zählen Beschwerden, das sofortige Löschen sowie langfristige Inaktivität.

Ein höheres Engagement verbessert in der Regel die Reputation des Absenders.

Bounce-Management

Hard- und Soft-Bounces wirken sich unterschiedlich auf die Reputation des Absenders aus.

• Hard Bounce: dauerhafter Fehler (z. B. ungültige Adresse oder nicht vorhandener Empfänger).
• Soft-Bounce: vorübergehender Fehler (z. B. volles Postfach oder vorübergehendes Serverproblem).

Vonage verarbeitet Bounce-Ereignisse automatisch und steuert das Unterdrückungsverhalten, um wiederholte Zustellversuche an Empfänger zu reduzieren, an die eine Zustellung dauerhaft nicht möglich ist.

Beschwerden wegen Spam

Spam-Beschwerden gehören zu den stärksten negativen Vertrauenssignalen, die von E-Mail-Anbietern herangezogen werden.

Hohe Beschwerdequoten können folgende Folgen haben:

• Geringere Platzierung im Posteingang
• Vorübergehende Sperren
• Dauerhafter Rufschaden

Bewährte Praktiken:

• Senden Sie die E-Mail nur an Nutzer, die sich dafür angemeldet haben.
• Geben Sie Ihre Organisation eindeutig an.
• Machen Sie die Abmeldung einfach und gut sichtbar.
• Kommen Sie Abmeldeanfragen unverzüglich nach.

Vonage verarbeitet Spam-Vorfälle und unterbindet den erneuten Versand an die betroffenen Empfänger.

Qualität der Liste

Veraltete, ungültige oder gekaufte Empfängerlisten beeinträchtigen die Zustellbarkeit erheblich.

Die Qualität der Liste verschlechtert sich zunehmend:

• Hard Bounces
• Spam-Beschwerden
• Abmeldungen

Bewährte Praktiken:

• Sammeln Sie Adressen über gültige Opt-in-Verfahren.
• Ungültige Empfänger schnell entfernen.
• Beseitigen Sie regelmäßig inaktive Empfänger.
• Kaufen Sie niemals E-Mail-Listen.

E-Mail-Preise

Die Preise für die E-Mail-API basieren auf einem Abonnementmodell und sind in verschiedenen Stufen erhältlich. Jede Stufe umfasst eine feste Anzahl von E-Mails; für jede weitere E-Mail fallen Mehrkosten an.

Aktuelle Preisinformationen finden Sie unter die Seite „Preise für die E-Mail-API“ oder wenden Sie sich an Ihren Account-Betreuer.

Weitere Informationen

• Verstehen von E-Mail-Nachrichten
• Eingehende E-Mails verstehen
• Messages API-Referenz