Senden von SMS-Nachrichten

Über den messages-Node kannst du SMS-Nachrichten an deine Kund*innen senden.

Bevor du beginnst

Du musst alle Voraussetzungen erfüllen, die im Abschnitt Bevor du beginnst der Nachrichten-Dokumentation aufgeführt sind.

Einschränkungen:

• Eine SMS-Nachricht kann max. 4.096 Zeichen lang sein.

Schritt 1: POST-Anfrage an /messages senden

Du kannst jedem WhatsApp-Benutzer eine SMS-Nachricht senden, sobald du die WhatsApp-ID des*der Benutzer*in hast. Gib text im Feld type an.

POST /v1/messages
{
    "preview_url": false | true,
    "recipient_type": "individual",
    "to": "whatsapp-id",
    "type": "text",
    "text": {
        "body": "your-text-message-content"
    }
}

Weitere Informationen zu Parametern findest du hier:

• Für alle Nachrichtenanforderungen verwendete Parameter
• Parameter für SMS-Nachrichten

Informationen zum Formatieren deiner Nachricht findest du unter Formatierung in SMS-Nachrichten.

URLs in SMS-Nachrichten

Standardmäßig erkennt die mobile WhatsApp-Anwendung URLs und macht sie anklickbar. So fügst du eine URL-Vorschau ein: Gib im Hauptteil der Nachricht "preview_url": true ein, und achte darauf, dass die URL mit http:// oder https:// beginnt. Ein Hostname ist erforderlich, denn IP-Adressen werden nicht zugeordnet.

Beachte, dass die Verwendung von preview_url hier anders ist als in der Cloud API. Siehe Nachrichten in der Dokumentation zur Cloud API

Beispiel

{
    "preview_url": true,
    "to": "whatsapp-id",
    "text": {
        "body": "You have to check out this amazing messaging service https://www.whatsapp.com/"
     }

Wenn du eine URL sendest, entweder mit Vorschau oder ohne, sieht der*die Empfänger*in der Nachricht in den meisten Fällen eine URL, die er anklicken kann.

Die URL-Vorschauansichten werden erst dann dargestellt, wenn eines der folgenden Ereignisse eingetreten ist:

1. Das Unternehmen hat eine Nachrichtenvorlage an den*die Benutzer*in gesendet.
2. Der*die Benutzer*in beginnt eine Unterhaltung mit einem „Zum Chatten klicken“-Link.
3. Der*die Benutzer*in fügt seinem Adressbuch die Telefonnummer des Unternehmens hinzu und beginnt eine Unterhaltung.

Schritt 2: Antwort prüfen

Bei erfolgreich erstellter Nachricht enthält die Antwort ein messages-Objekt mit einer ID für die neu erstellte Nachricht.

{
  "messages": [{
    "id": "gBEGkYiEB1VXAglK1ZEqA1YKPrU"
  }]
}  

Wenn der Vorgang fehlgeschlagen ist, enthält die Antwort eine Fehlermeldung. Weitere Informationen dazu findest du unter Fehler- und Statuscodes.