WhatsApp-Bestellnachrichten aus Shopify senden

Wie sendet Shopify Flow eine WhatsApp-Nachricht?

Mit der Aktion Send HTTP request. Sie sendet an eine beliebige URL, mit Headern und einem Body, der Liquid-Variablen aus dem Trigger verwenden kann.

Erstellen Sie einen Workflow mit dem Trigger „Bestellung erstellt“ und fügen Sie Send HTTP request hinzu. Die URL ist der Messages-Endpoint der Cloud API für die Phone-Number-ID der verbundenen Nummer. Ergänzen Sie einen Authorization-Header mit dem Wert Bearer, gefolgt vom Access-Token der Nummer. Das Token speichern Sie als Flow-Secret und verweisen per Secret-Variable darauf. Secret-Werte erscheinen nie in der Flow-Oberfläche und werden in den Ausführungsprotokollen geschwärzt, genau dort gehört ein Token hin. Der Body ist eine Template-Nachricht, mit der Telefonnummer des Kunden im Feld to und den Bestelldetails als Parametern des Templates.

Flow wertet eine 2XX- oder 3XX-Antwort als Erfolg. Meta beantwortet eine gültige Anfrage mit der Nachrichten-ID. Eine erfolgreiche Ausführung bedeutet also, dass Meta die Nachricht angenommen hat.

{
  "messaging_product": "whatsapp",
  "to": "<customer phone, digits only>",
  "type": "template",
  "template": {
    "name": "order_confirmation",
    "language": { "code": "en" },
    "components": [{
      "type": "body",
      "parameters": [{ "type": "text", "text": "{{order.name}}" }]
    }]
  }
}

Warum muss eine Bestellnachricht ein Template sein?

Weil der Shop zuerst schreibt. Das 24-Stunden-Servicefenster von Meta öffnet sich nur, wenn der Kunde der Nummer schreibt. Eine Bestellbestätigung, ein Versandupdate oder eine Erinnerung an einen abgebrochenen Checkout wird davor gesendet. Freitext wird deshalb abgelehnt, und nur ein vorab freigegebenes Template wird zugestellt.

Legen Sie das Template einmal an, in der Kategorie Utility für Bestell- und Versandupdates, und warten Sie die Freigabe ab, bevor Sie den Workflow aktivieren. Name und Sprache im Body der Anfrage müssen exakt zum freigegebenen Template passen, und die Zahl der Parameter muss zu den Platzhaltern passen.

Hinzu kommt die Einwilligung. Meta verlangt ein Opt-in, bevor ein Unternehmen jemandem auf WhatsApp schreibt: Die Person hat ihre Nummer angegeben und zugestimmt, Nachrichten von diesem Unternehmen zu erhalten. Üblich ist ein Kontrollkästchen im Checkout, das dies abfragt. Der Workflow sollte es vor dem Senden prüfen.

Was tun, wenn der Tarif des Shops Send HTTP request nicht enthält?

Nutzen Sie stattdessen einen Shopify-Admin-Webhook. Unter Einstellungen, Benachrichtigungen, Webhooks kann ein Händler für ein Ereignis wie „Bestellung erstellt“ einen Webhook im JSON-Format an eine URL anlegen. Richten Sie ihn auf einen Empfänger: einen n8n-Webhook-Node oder eine Route in PHP, Python oder Node. Der Empfänger liest die Bestellung, prüft die Einwilligung und führt denselben Template-Aufruf an die Cloud API aus.

Unabhängig vom Sendeweg laufen Antworten gleich ab. Antwortet der Kunde auf die Bestellnachricht, landet die Antwort in der WhatsApp Business App auf dem Telefon des Shops, weil die Nummer mit Coexistence arbeitet. Das 24-Stunden-Fenster ist dann für Freitext offen. Ist der Webhook-Endpoint der Nummer gesetzt, erreicht die Antwort auch Ihr System. Auch die Bestellnachricht selbst erscheint in der App, sodass die antwortende Person sieht, worauf der Kunde reagiert.

Häufige Fehler

• Freitext bei der Erstellung einer Bestellung senden. Der Kunde hat nicht geschrieben, deshalb lehnt Meta die Nachricht ab; es muss ein freigegebenes Template sein.
• Die Fehlerbehandlung bei 4XX-Antworten auf Retry lassen. Flow kann bis zu 24 Stunden lang eine Anfrage wiederholen, die Meta nie akzeptieren wird.
• Das Token als Klartext in einen Header schreiben. Speichern Sie es als Flow-Secret, damit es nicht in Oberfläche und Protokollen auftaucht.

Häufig gestellte Fragen

Weiterlesen