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
• Beta-Zugang zum E-Mail-Kanal

E-Mail-Onboarding

So richten Sie die E-Mail-API ein:

1. Geben Sie Ihrem Account Manager die folgenden Informationen:
   • Ihr Vonage API-Schlüssel
   • Die benutzerdefinierte(n) Domain(s), die Sie für den Versand verwenden möchten (zum Beispiel, yourdomain.com)
   • Ihre bevorzugte Region für die Domain-Verifizierung (US, EU, oder APAC)
2. Ihr Account Manager leitet diese Informationen an das interne Team weiter, um den Onboarding-Prozess einzuleiten.
3. Vonage stellt die DNS-Einträge bereit, die Sie Ihrer Domain hinzufügen müssen. Siehe Einrichtung der Domänenauthentifizierung.
4. Nachdem Sie die DNS-Einstellungen aktualisiert haben, lassen Sie sich den Abschluss des Vorgangs von Ihrem Account-Betreuer bestätigen. Die DNS-Überprüfung kann bis zu 72 Stunden dauern.
5. Fügen Sie DNS-Einträge umgehend hinzu. Sollte die Propagierung länger als erwartet dauern, erstellen Sie bitte ein Support-Ticket oder wenden Sie sich an Ihren Account-Betreuer.
6. Sobald die Überprüfung erfolgreich abgeschlossen ist, benachrichtigt Vonage Ihren Account-Manager und Sie können mit dem Versand von E-Mails über die Messages API beginnen.

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.

Fragen Sie Ihren Account-Manager, ob Sie diese erweiterten Optionen während der Einführungsphase benötigen.

Senden Sie Ihre erste E-Mail

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

Vonage-Application erstellen (optional)

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.

1. 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.

2. 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.

3. 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.

4. 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.

5. 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.

6. Spam-Beschwerden

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.

7. Qualität der Angebote

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.

Für aktuelle Preisinformationen wenden Sie sich bitte an Ihren Account-Betreuer.

Weitere Informationen

• Verstehen von E-Mail-Nachrichten
• Messages API-Referenz