WhatsApp mit n8n über die offizielle Cloud API verbinden

Wie erreicht eine WhatsApp-Nachricht einen n8n-Workflow?

Meta liefert jede an die Nummer gesendete Nachricht per HTTP POST an eine von Ihnen angegebene URL. Diese URL ist die gesamte Integration. Platzieren Sie einen n8n Webhook-Node unter einer Produktions-URL, legen Sie ihn als Webhook-Ziel der Nummer fest, und der Workflow läuft bei jeder eingehenden Nachricht.

Die Payload enthält den Absender, den Text oder eine Medienreferenz, einen Zeitstempel und die message id. Danach handelt es sich um einen normalen n8n-Workflow: Verzweigen Sie nach Inhalt, suchen Sie den Kunden, rufen Sie weitere von Ihnen betriebene Dienste auf und entscheiden Sie, ob Sie antworten.

Da dies Coexistence ist, liegt dieselbe Nachricht auch in der WhatsApp Business App auf dem Telefon. Ein Mensch kann antworten. Der Workflow sieht, was der Mensch gesendet hat, und der Mensch sieht, was der Workflow gesendet hat. Dadurch antwortet niemand über die Antwort des anderen.

{
  "from": "14155550188",
  "id": "wamid.HBgLMTQxNTU1NTAxODgVAgAS",
  "timestamp": "1758412800",
  "type": "text",
  "text": { "body": "do you have anything friday?" }
}

Wie sendet der Workflow eine Antwort?

Mit einem HTTP Request-Node gegen die Cloud API, unter Verwendung der phone number id und des access token der Nummer. Beide Werte können Sie im Dashboard oder über den MCP-Connector abrufen, wenn ein Assistent sie für Sie holen soll.

Was Sie senden können, hängt vom Zeitpunkt ab. Innerhalb von 24 Stunden nach der letzten Nachricht des Kunden funktioniert freier Text, und die Antwort entspricht dem, was der Workflow erstellt hat. Außerhalb dieses Zeitfensters wird nur ein von Meta bereits genehmigtes Template zugestellt. Ein Workflow, der ausschließlich freien Text sendet, wirkt im Test perfekt, weil Tests immer Sekunden nach einer Nachricht stattfinden. Beim ersten echten Fall über Nacht bleibt er dann still.

Die robuste Lösung ist eine Verzweigung: Prüfen Sie, wie lange die letzte eingehende Nachricht zurückliegt, und wählen Sie entsprechend freien Text oder ein Template.

Kann n8n auch den MCP-Connector verwenden?

Ja, und n8n ist dabei ungewöhnlich. Sein MCP Client Tool-Node verbindet sich mit einem entfernten MCP-Server und unterstützt OAuth2, was unser Server benötigt. Dadurch kann ein AI Agent-Node in einem Workflow unsere Tools direkt aufrufen.

Das ist wichtig, weil die meisten Automatisierungsplattformen das nicht können. Make und Zapier betreiben jeweils eigene MCP-Server und agieren beide nicht als Client. Daher kann keines von beiden einen Drittanbieter-Server erreichen. n8n kann es.

Geeignet ist der Connector für den handelnden Teil: Ein Agent-Node kann während eines laufenden Workflows entscheiden, eine Nachricht zu senden, die Gesundheit einer Nummer zu prüfen oder den Genehmigungsstatus eines Templates abzurufen. Er kann den Webhook jedoch nicht ersetzen, weil MCP nicht durch eine eingehende Nachricht aufgeweckt werden kann.

Welchen der beiden Wege sollte ein Workflow verwenden?

Beide, für unterschiedliche Teile. Das ist keine Frage der Vorliebe.

Der Webhook startet alles. Ein Kunde schreibt, Meta liefert die Nachricht an Ihren Webhook-Node, und der Workflow läuft. In keinem Tool gibt es ein MCP-Gegenstück dazu, weil das Protokoll aus Anfrage und Antwort besteht und nicht von außen aufgerufen werden kann.

Das MCP Client Tool ist dafür gedacht, dass ein Agent innerhalb dieses Workflows handelt, ohne dass Sie den Aufruf fest codieren. Wenn der Workflow bereits genau weiß, was gesendet werden soll, ist ein HTTP Request-Node gegen die Cloud API einfacher und bietet weniger Fehlerquellen. Wenn ein Agent entscheidet, stellt der Connector ihm die elf Tools und die zugehörigen Regeln aus deren Beschreibungen bereit, einschließlich des 24-Stunden-Fensters.

Was unterscheidet dies von den n8n-WhatsApp-Nodes, die viele bereits verwenden?

Die meisten n8n-WhatsApp-Setups, die Sie finden, basieren auf einem inoffiziellen Gateway, das sich als verknüpftes Gerät anmeldet. Der Einstieg ist einfach, aber die Nummer ist gefährdet, weil dieser Mechanismus gegen die Nutzungsbedingungen von WhatsApp verstößt und Meta das Verkehrsmuster unabhängig von der Bibliothek erkennt.

Der andere häufige Weg ist die offizielle API ohne Coexistence. Sie funktioniert, migriert aber die Nummer. Die WhatsApp Business App funktioniert damit nicht mehr, und das Team, das den ganzen Tag geantwortet hat, muss in ein neues Tool wechseln. Für die meisten kleinen Unternehmen ist das keine Option. Deshalb sind so viele zunächst bei inoffiziellen Gateways gelandet.

Coexistence verbindet die beiden bisher fehlenden Eigenschaften: offizielle API, während das Telefon weiter funktioniert.

Häufige Fehler

• Eine n8n-Test-URL als Webhook-Ziel verwenden. Sie hört nicht mehr zu, sobald der Editor geschlossen wird. Nachrichten werden dann ins Leere geliefert.
• Metas Verifizierungsanfrage nicht beantworten. Meta sendet vor jeder Zustellung einen GET mit einer Challenge. Ein Node, der sie nicht zurückgibt, empfängt nie eine Nachricht.
• Außerhalb des 24-Stunden-Fensters freien Text senden. Aus Sicht des Workflows schlägt dies lautlos fehl. Nur ein genehmigtes Template wird zugestellt.

Häufig gestellte Fragen

Weiterlesen