Lieferscheine

Wenn Sie eine erfolgreiche Anfrage an die SMS API stellen, wird ein Array von message Objekte, eines für jede Nachricht. Idealerweise haben diese einen status von 0und zeigt damit den Erfolg an. Dies bedeutet jedoch nicht, dass Ihre Nachricht die Empfänger erreicht hat. Es bedeutet nur, dass Ihre Nachricht erfolgreich in die Warteschlange für den Versand gestellt wurde.

Vonage's adaptives Routing identifiziert dann den besten Träger für Ihre Nachricht. Wenn der ausgewählte Träger die Nachricht zugestellt hat, sendet er eine Lieferschein (DLR).

Um DLRs in Ihrer Bewerbung zu erhalten, müssen Sie eine Webhook an die Vonage sie senden soll. Alternativ können Sie auch die Reports API um regelmäßig Ihre Aufzeichnungen herunterzuladen, einschließlich des Zustellungsstatus jeder einzelnen Nachricht.

Wie Lieferscheine funktionieren

Lieferscheine sind entweder:

• Träger - zurückgegeben, wenn der Dienstanbieter die Nachricht erhält
• Hörer - zurückgegeben, wenn das Handgerät des Benutzers die Nachricht empfängt

Nicht alle DLRs garantieren, dass das Ziel Ihre Nachricht erhalten hat. Einige Zustellungsbestätigungen stellen den erfolgreichen Abschluss nur einer Phase des Zustellungsprozesses dar, wie z. B. die Weiterleitung der Nachricht an einen anderen Betreiber. Andere Zustellbestätigungen sind Fälschungen. Aus diesem Grund kann Vonage nicht vollständig garantieren, dass eine DLR korrekt ist. Es hängt von der Länder an die Sie Nachrichten senden, und die beteiligten Anbieter.

Wenn Ihre Nachricht länger ist, als sie in einer einzigen SMS gesendet werden kann, werden die Nachrichten verkettet. Sie sollten für jeden Teil der verketteten SMS eine Betreiber-DLR erhalten. Die DLRs der Handgeräte für eine verkettete Nachricht sind verzögert. Das liegt daran, dass das Zielhandgerät jeden Teil der verketteten Nachricht verarbeiten muss, bevor es den Empfang der gesamten Nachricht bestätigen kann.

Verständnis des Lieferscheins

Dies ist ein typisches DLR:

{
  "err-code": "0",
  "message-timestamp": "2018-10-25 12:10:29",
  "messageId": "0B00000127FDBC63",
  "msisdn": "447547232824",
  "network-code": "23410",
  "price": "0.03330000",
  "scts": "1810251310",
  "status": "delivered",
  "to": "Vonage"
}

Die wichtigsten Bereiche sind status und err-code da diese Ihnen mitteilen, ob Ihre Nachricht zugestellt wurde und, falls nicht, was schief gelaufen ist.

DLR-Statusmeldungen

Die status im DLR zeigt Ihnen an, ob Ihre SMS erfolgreich zugestellt wurde. Mögliche Werte sind:

DLR-Fehlercodes

Die err-code Feld im DLR liefert detailliertere Informationen und kann bei der Fehlersuche nach einer fehlgeschlagenen Zustellung helfen. Ein Code ungleich Null bedeutet, dass die Nachricht nicht zugestellt werden konnte.

Verwendung der SMS API in Kampagnen

Bevor Sie Ihre Messaging-Kampagne starten, überprüfen Sie die Leitfaden für länderspezifische Merkmale für die Länder, in die Sie senden. Wenn das Land, in das Sie senden, keine zuverlässigen DLRs liefert, verwenden Sie die Conversion API um Vonage mehr Datenpunkte zu liefern und das beste Routing zu gewährleisten.

Optional können Sie bestimmte Kunden oder Kampagnen identifizieren, indem Sie jeder gesendeten Nachricht eine Referenz beifügen. Diese werden in die Empfangsbestätigung aufgenommen. Geben Sie die von Ihnen gewählte Referenz in die Anfrage ein, indem Sie eine client-ref Parameter mit bis zu 40 Zeichen.

Andere Ressourcen

• Webhooks-Leitfaden - eine ausführliche Anleitung zur Verwendung von Webhooks mit der Vonage-Plattform
• Warum wurde meine SMS nicht zugestellt? - nützliche Tipps zur Fehlersuche