AnmeldenKostenlose Testphase starten
Meta Tech Provider

WhatsApp-Nachrichten und Kontakte automatisch in Google Sheets speichern

Um WhatsApp-Business-Nachrichten automatisch in Google Sheets zu speichern, senden Sie sie als signierte HTTP-POST-Anfragen an ein Automatisierungstool wie n8n, Make oder Zapier. Dessen Google-Sheets-Schritt fügt pro Nachricht eine Zeile hinzu: Uhrzeit, Richtung, Telefonnummer, Name, Text und Message id. Ein zweites Tabellenblatt mit der Telefonnummer als Schlüssel führt eine Zeile pro Kontakt, die aktualisiert wird, sobald er erneut schreibt.

easyCoexistence verbindet die WhatsApp-Business-Nummer, die Sie in der App behalten, über Coexistence mit der Cloud API von Meta.

7 attempts

Weitergeleitete Zustellungen werden nach etwa 1, 5, 30, 120, 360 und 1,440 Minuten wiederholt, wenn Ihre URL fehlschlägt.

10 s

Wie lange eine weitergeleitete POST-Anfrage auf eine 2xx-Antwort wartet, bevor diese Zustellung wiederholt wird.

60 / min

Erlaubte Schreibanfragen an die Google Sheets API pro Minute, pro Nutzer und Projekt; 300 pro Projekt.

Redirect

Die Ausgabe einer Apps-Script-Web-App wird an eine einmalige URL unter script.googleusercontent.com umgeleitet.

No headers

Das Ereignisobjekt doPost von Apps Script stellt den Body und die Parameter bereit, nicht aber die HTTP-Header der Anfrage.

Welcher Weg soll das Sheet befüllen?

Für eine Nummer, deren Nachrichten über easyCoexistence laufen, gibt es zwei Wege, die unterschiedliche Anforderungen erfüllen. Die Forward URL, die einmal pro Nummer eingerichtet wird, leitet die ursprünglichen Ereignisse von Meta weiter, unabhängig davon, ob eine Automatisierung antwortet: Kundennachrichten, die Antworten, die Ihr Team in der WhatsApp Business App tippt, und Zustellstatus. Sie ist der Weg für ein vollständiges Nachrichtenprotokoll. Ein Schritt Call my webhook innerhalb einer Automatisierung wird nur für die Nachrichten ausgelöst, die diese Automatisierung auswählt, und enthält den letzten Chatverlauf, einschließlich der Antwort, die die Automatisierung gerade gesendet hat. Er eignet sich für ein Sheet mit Leads, Bestellungen oder Anfragen, die eine Automatisierung bearbeitet. Beide sind signiert, mit unterschiedlichen Geheimnissen.

Forward URL (per number)Call my webhook step (per automation)
Fires onAny message event on the number, with or without automationsOnly messages that automation is picked for
CarriesMeta's original value: messages, phone replies, statusesThe message, the contact and up to 10 recent messages
Automated repliesDelivery statuses only, without the textIn history, direction out
Retries7 attempts over about 33 hoursOne attempt
Signed withThe number's forward secret, shown onceThe automation's Signing secret
Set inNumber page, Where incoming messages go cardThe automation editor, or create_automation

Welche Felder kommen an, und welche Spalten sollte das Sheet haben?

Eine weitergeleitete POST-Anfrage enthält eine Meta-Änderung: id (die Zustellung), event (Metas Feldname, etwa messages oder smb_message_echoes), received_at, connection (die ID Ihrer Nummer, phone und phone_number_id) und value, genau so, wie Meta es gesendet hat. In value enthalten messages, was Kunden geschrieben haben, und message_echoes, was Ihr Team am Telefon getippt hat. Telefonnummern kommen als Ziffern mit Ländervorwahl und ohne Pluszeichen an; speichern Sie diese Spalte als reinen Text, damit Sheets sie nicht in eine Zahl umwandelt. Ein Nutzer mit WhatsApp-Benutzernamen kann neben der Nummer oder statt ihr eine geschäftsbezogene User-ID mitliefern. Halten Sie deshalb eine Spalte dafür bereit.

Timemessages[].timestamp, Unix seconds, converted to a date
Directionin for messages, out for smb_message_echoes
Phonemessages[].from, or message_echoes[].to for your replies
User IDmessages[].from_user_id, the BSUID, when Meta sends it
Namecontacts[].profile.name, the customer's WhatsApp profile name
Texttext.body, a button's text, or [image] with its caption
Message idmessages[].id, the wamid: the key that stops duplicates
Your numberconnection.phone, to tell several numbers apart

Wie bauen Sie das Nachrichtenprotokoll in n8n auf?

Drei Knoten. Ein Webhook-Knoten mit HTTP Method POST, Respond auf Immediately gesetzt und seiner Production URL, gespeichert als Forward URL der Nummer. Ein Code-Knoten, der X-EC-Signature mit dem Forward-Geheimnis prüft und das Ereignis in Zeilen umwandelt, wobei Zustellstatus übersprungen werden. Ein Google-Sheets-Knoten mit der Operation Append or Update Row, Column to match on auf Message id gesetzt, sodass eine wiederholte Zustellung dieselbe Zeile aktualisiert, statt eine neue hinzuzufügen.

Das Forward-Geheimnis wird nur einmal angezeigt, wenn Sie die Forward URL speichern; geht es verloren, klicken Sie auf New secret und fügen Sie das neue ein. n8n Cloud erlaubt das Modul crypto in Code-Knoten; selbst gehostetes n8n benötigt NODE_FUNCTION_ALLOW_BUILTIN=crypto.

n8n Code node (Run Once for All Items): verify a forward and return rows
const crypto = require('crypto');
const SECRET = 'whsec_...'; // the number's forward secret, shown once when you saved the Forward URL

const { headers, body } = $input.first().json;
const sig = /^t=(\d+),v1=([0-9a-f]{64})$/.exec(headers['x-ec-signature'] || '');
if (!sig || Math.abs(Date.now() / 1000 - Number(sig[1])) > 300) throw new Error('Bad or stale signature');
// n8n has parsed the body; it was sent as compact JSON, so JSON.stringify rebuilds the signed bytes.
const mac = crypto.createHmac('sha256', SECRET).update(sig[1] + '.' + JSON.stringify(body)).digest();
if (!crypto.timingSafeEqual(mac, Buffer.from(sig[2], 'hex'))) throw new Error('Bad signature');

const { event, connection, value } = body;
const names = Object.fromEntries((value.contacts || []).map((c) => [c.wa_id, c.profile?.name || '']));
const textOf = (m) => m.text?.body ?? m.button?.text ?? m.interactive?.button_reply?.title
  ?? m.interactive?.list_reply?.title ?? ('[' + m.type + '] ' + (m[m.type]?.caption || '')).trim();
const row = (m, direction, phone) => ({
  time: new Date(Number(m.timestamp) * 1000).toISOString(), direction, phone,
  user_id: m.from_user_id || '', name: names[phone] || '', text: textOf(m),
  message_id: m.id, number: connection.phone,
});

let rows = [];
if (event === 'messages') rows = (value.messages || []).map((m) => row(m, 'in', m.from || ''));   // statuses skipped
if (event === 'smb_message_echoes') rows = (value.message_echoes || []).map((m) => row(m, 'out', m.to || ''));
return rows.map((json) => ({ json }));

Wie behalten Sie eine Zeile pro Kontakt?

Fügen Sie einen zweiten Google-Sheets-Knoten auf einem Tabellenblatt Contacts hinzu, ebenfalls mit Append or Update Row, abgeglichen über Phone. Ordnen Sie Telefonnummer, Profilname, User-ID, Uhrzeit und Text der letzten Nachricht zu. Die erste Nachricht einer Nummer legt ihre Zeile an; spätere aktualisieren Name und die Spalten für den letzten Kontakt, sodass das Tabellenblatt zugleich eine Liste ist, wer wann geschrieben hat. Halten Sie handschriftliche Notizen auf einem separaten Tabellenblatt, das über die Telefonnummer gesucht wird, damit der Workflow sie nie überschreibt.

Die Kontakte aus dem Adressbuch des Telefons kommen so nicht an. Meta sendet sie mit bis zu 6 Monaten Chats nur an ein direktes Webhook-Ziel, das innerhalb von 24 Stunden nach dem Verbinden der Nummer gespeichert wurde.

Kann Apps Script die Nachrichten direkt empfangen?

Nicht sauber, deshalb setzen Sie ein Workflow-Tool vor das Sheet. Google liefert die Antwort einer Apps-Script-Web-App über eine Weiterleitung an eine einmalige URL unter script.googleusercontent.com aus, und easyCoexistence folgt keinen Weiterleitungen. Die 302-Weiterleitung zählt als fehlgeschlagene Zustellung: Eine weitergeleitete Zustellung wird bis zu 7 Mal wiederholt, und jede Wiederholung führt doPost erneut aus und schreibt eine weitere Zeile, während ein Schritt Call my webhook fehlschlägt und Ihnen eine E-Mail sendet. doPost kann außerdem keine Header der Anfrage lesen, sodass die Prüfung von X-EC-Signature dort unmöglich ist.

Apps Script bleibt eine gute Wahl für die umgekehrte Richtung, also das Senden freigegebener Templates aus Zeilen eines Sheets; die Seite zur Google-Sheets-Integration behandelt das mit Code.

Können Make oder Zapier stattdessen das Sheet befüllen?

Ja. In Make starten Sie das Szenario mit Webhooks > Custom webhook und fügen Google Sheets > Add a Row hinzu; in Zapier verwenden Sie Webhooks by Zapier mit Catch Raw Hook, das die Header behält, und danach Google Sheets > Create Spreadsheet Row. Beide beantworten die POST-Anfrage sofort mit einer 2xx-Antwort, was eine Weiterleitung innerhalb ihrer 10 Sekunden braucht. Ordnen Sie dieselben Felder wie oben aus value.messages zu und filtern Sie Ereignisse heraus, deren value statt messages statuses enthält.

Behandeln Sie die Hook-URL wie ein Passwort, denn wer sie kennt, kann Zeilen einfügen. Wenn Ihr Tarif einen Code-Schritt enthält, prüfen Sie dort X-EC-Signature mit demselben HMAC-Verfahren wie im n8n-Knoten.

Wie vermeiden Sie doppelte oder fehlende Zeilen?

Doppelte entstehen durch Wiederholungen. Eine Weiterleitung, die innerhalb von 10 Sekunden keine 2xx-Antwort erhält, wird mit demselben X-EC-Delivery-Header und derselben id im Body erneut gesendet; die enthaltenen Nachrichten behalten ihre wamid. Der Abgleich über Message id macht eine Wiederholung daher harmlos. Bei der Route über den Webhook-Schritt kommen Tests aus Try it mit dry_run true an: leiten Sie sie in ein Testtabellenblatt um oder verwerfen Sie sie.

Fehlende Zeilen entstehen durch das Schreibkontingent von Google. Die Sheets API erlaubt 60 Schreibanfragen pro Minute, pro Nutzer und Projekt, und eine n8n-Anmeldung entspricht einem Nutzer; ein Schwall von Antworten nach einer Template-Kampagne kann das überschreiten und HTTP 429 auslösen. Aktivieren Sie Retry On Fail in den Einstellungen des Google-Sheets-Knotens oder sammeln Sie Nachrichten einige Sekunden lang und fügen Sie sie in einer Anfrage an.

So richten Sie es ein

  1. Check the number's modeOn the number's page, the card Where incoming messages go must show Through easyCoexistence. If it shows Straight to your system, choose Through easyCoexistence.
  2. Build the workflowWebhook node (POST, Respond Immediately), the Code node above, then Google Sheets with Append or Update Row matched on Message id. Activate it and copy the Production URL.
  3. Save the Forward URLPaste the Production URL into Forward URL (optional) and click Save forward URL. Copy the signing secret shown once into the Code node.
  4. Send a test messageFrom another phone, write to your number and reply to it from the WhatsApp Business app. Two rows should appear: one in, one out.

Häufige Fehler

  • Eine Weiterleitung mit dem Signing secret einer Automatisierung prüfen oder umgekehrt. Die Forward URL wird mit dem Forward-Geheimnis der Nummer signiert, Call my webhook mit dem eigenen der Automatisierung; wählen Sie das Geheimnis anhand des Headers X-EC-Event.
  • Eine Zeile pro POST ohne Schlüssel anhängen. Eine nach langsamer Antwort wiederholte Zustellung schreibt dieselbe Nachricht zweimal; verwenden Sie Append or Update Row mit Abgleich über die Message id.
  • Zustellstatus als Nachrichten schreiben. Das Ereignis messages enthält auch die Statuswerte sent, delivered und read in value.statuses; diese haben keinen Text und erzeugen leere Zeilen.
  • Eine Apps-Script-Web-App-URL als Forward URL speichern. Ihre Weiterleitung zählt als Fehler, sodass jeder der 7 Versuche doPost erneut ausführt und eine doppelte Zeile hinzufügt.
Mit EasyCoexistence

Mit aktivierten Automatisierungen leitet eine Forward URL die ursprünglichen Ereignisse von Meta an Ihren Workflow weiter, signiert mit einem Geheimnis, das nur Sie besitzen, und wiederholt, wenn Ihre URL nicht erreichbar ist. Ein Schritt Call my webhook sendet, was eine Automatisierung bearbeitet hat, samt ihrer Antwort. Beides ist im Tarif enthalten. Von US$ 9 bis US$ 0.75 pro Nummer und Monat, sinkend mit jeder weiteren Nummer, mit einer kostenlosen Testphase von 3 Tagen.

Häufig gestellte Fragen

Bekommt das Sheet die Nachrichten, die mein Team am Telefon tippt?

Ja, über die Forward URL. Antworten, die in der WhatsApp Business App getippt werden, kommen als smb_message_echoes-Ereignisse mit der Nummer des Kunden in to an. Antworten, die Automatisierungen senden, kommen nur als Zustellstatus zurück; protokollieren Sie deren Text daher über einen Schritt Call my webhook nach der Antwort.

Kann ich meine bestehenden Chats in das Sheet laden?

Nicht bei einer Nummer, deren Nachrichten über easyCoexistence laufen. Meta sendet bis zu 6 Monate Einzelchats nur an ein direktes Webhook-Ziel, das innerhalb von 24 Stunden nach dem Verbinden gespeichert wurde, und zwar einmal pro Verbindung. Eine über easyCoexistence geleitete Nummer protokolliert ab dem Moment, in dem die Forward URL gespeichert wird.

Speichert easyCoexistence eine Kopie der Nachrichten?

Teilweise. Bei einer Nummer, die über easyCoexistence läuft und bei der Automatisierungen aktiviert sind, wird der Nachrichtentext für den von Ihnen gewählten Zeitraum aufbewahrt, 30, 90 oder 365 Tage (standardmäßig 90), und in Conversations angezeigt; weitergeleitete Zustellungen werden bis zu 7 Tage für Wiederholungen vorgehalten, und Ausführungsprotokolle 30 Tage. Das Sheet ist Ihre dauerhafte Kopie.

Kann meine KI das Sheet lesen, um Kunden zu antworten?

Nicht über einen Schritt Reply with AI, der nur seine Instructions und den Chat liest. Ein KI-Agent kann Informationen über ein benutzerdefiniertes HTTP-Tool abrufen, und ein Schritt Call my webhook oder Call an API kann die Frage an einen Workflow senden, der die Antwort im Sheet nachschlägt und sie als Antwort zurückgibt.

Weiterlesen

Bereit für den Start?

Richten Sie WhatsApp Coexistence in wenigen Minuten statt Monaten ein. Die App funktioniert weiterhin auf dem Telefon.

Kostenlose Testphase starten

Verifiziert am