Eingehende SMS

Um eingehende SMS zu empfangen, erstellen Sie eine Webhook-Endpunkt und konfigurieren Sie Ihr Konto auf der Registerkarte API-Einstellungen der Seite Vonage Dashboard für Entwickler.

Alle Nachrichten, die an eine Ihrer virtuellen Vonage-Nummern gesendet werden, werden mit einer

GET
- oder
POST
-Anfrage an Ihren Webhook gesendet. Wenn Sie eine Nachricht über Ihren Webhook empfangen, müssen Sie eine 200 OK oder 204 No Content Antwort. Wenn Sie dies nicht tun, geht Vonage davon aus, dass Sie die Nachricht nicht erhalten haben und sendet sie in den nächsten 24 Stunden erneut.

Verkettete Nachrichten erfordern besondere Aufmerksamkeit. Siehe verkettete eingehende Nachrichten.

Anatomie einer eingehenden Nachricht

Nachrichten werden als JSON-Objekt mit den folgenden Eigenschaften an Ihren Webhook-Endpunkt gesendet:

Schlüssel Wert Erforderlich
type Mögliche Werte sind:
  • text - Standardtext
  • unicode - eine Textnachricht, die Unicode-Zeichen enthält
  • binary - eine binäre Nachricht
 Ja
to Die Rufnummer, an die die Nachricht gesendet wurde zu. Dies ist Ihre virtuelle Nummer. Ja
msisdn Die Rufnummer, an die diese eingehende Nachricht gesendet wurde von. Ja
messageId Die eindeutige Kennung von Vonage für diese Nachricht. Ja
message-timestamp Die UTC±00:00 Zeitpunkt, an dem Vonage begonnen hat, diese eingehende Nachricht an Ihren Webhook-Endpunkt zu senden, im folgenden Format: YYYY-MM-DD HH:MM:SS. Ja
timestamp Die Unix-Zeitstempel Darstellung von message-timestamp. Nein
nonce Eine zufällige Zeichenkette, die ein zusätzliches Element der Unvorhersehbarkeit in die Signatur der Anfrage einbringt. Sie verwenden die nonce und timestamp Parameter mit Ihrem gemeinsamen Geheimnis, um die Signatur für eingehende Nachrichten zu berechnen und zu validieren. Wenn Ihre Nachrichten unterzeichnet

Für Nachrichten des Typs text oder unicode

Wenn die type ist text oder unicodewerden die folgenden Eigenschaften in der Anfrage an Ihren Webhook-Endpunkt angezeigt.

Schlüssel Wert
text Der Nachrichtentext für diese eingehende Nachricht.
keyword Das erste Wort im Nachrichtentext. Dies wird in der Regel bei Kurzcodes verwendet.

Für Nachrichten des Typs binary

Wenn die type ist binarywerden die folgenden Eigenschaften in der Anfrage an Ihren Webhook-Endpunkt angezeigt.

Schlüssel Wert
data Der Inhalt dieser Nachricht
udh Die hexadezimale Kodierung Benutzerdaten-Kopfzeile

Für verkettete eingehende Nachrichten

Wenn eine an Ihre virtuelle Nummer gesendete Nachricht innerhalb der maximal zulässigen Länge einer einzelnen Nachricht liegt, erscheinen die folgenden Eigenschaften nicht in der Anfrage an Ihren Webhook-Endpunkt.

Wenn die Nachricht länger ist als die maximal zulässige Anzahl von Zeichen in einer einzelnen Nachricht, erhalten Sie die Nachricht in Teilen und die folgenden Eigenschaften erscheinen in der Anfrage.

Verwenden Sie die concat-ref, concat-total und concat-part Eigenschaften, um die Nachricht aus den einzelnen Teilen zusammenzusetzen.

Nicht alle Netzbetreiber unterstützen verkettete Nachrichten. Wenn der Betreiber die Verkettung nicht unterstützt, wird die concat Feld ist in der Nutzlast nicht vorhanden.

Schlüssel Wert
concat true
concat-ref Die Transaktionsreferenz. Alle Teile dieser Nachricht haben dies gemeinsam concat-ref.
concat-total Die Anzahl der Teile in dieser verketteten Nachricht.
concat-part Die Nummer dieses Teils der Nachricht. Der erste Teil der Nachricht lautet 1.