WhatsApp-berichten en contacten automatisch opslaan in Google Sheets
Om WhatsApp Business-berichten automatisch naar Google Sheets op te slaan, stuur je ze als ondertekende HTTP POST-verzoeken naar een automatiseringstool zoals n8n, Make of Zapier. Laat de Google Sheets-stap van die tool per bericht een rij toevoegen: tijd, richting, telefoonnummer, naam, tekst en Message id. Een tweede tabblad met het telefoonnummer als sleutel houdt één rij per contact bij, die wordt bijgewerkt wanneer die persoon opnieuw schrijft.
easyCoexistence koppelt het WhatsApp Business-nummer dat je in de app houdt aan de Cloud API van Meta via Coexistence.
Doorgestuurde leveringen worden opnieuw geprobeerd na ongeveer 1, 5, 30, 120, 360 en 1.440 minuten wanneer je URL faalt.
Hoe lang een doorgestuurde POST wacht op een 2xx-antwoord voordat die levering opnieuw wordt geprobeerd.
Schrijfverzoeken aan de Google Sheets API die per minuut per gebruiker per project zijn toegestaan; 300 per project.
De uitvoer van een Apps Script-webapp wordt doorgestuurd naar een eenmalige URL op script.googleusercontent.com.
Het doPost-gebeurtenisobject van Apps Script geeft de body en parameters, niet de HTTP-verzoekheaders.
Welke route moet de spreadsheet vullen?
Op een nummer waarvan de berichten via easyCoexistence lopen, bestaan twee routes, die verschillende behoeften dekken. De Forward URL, één keer per nummer ingesteld, geeft de originele Meta-gebeurtenissen door, of er nu een automatisering antwoordt of niet: berichten van klanten, de antwoorden die je team typt in de WhatsApp Business-app en de leverstatussen. Dit is de route voor een volledig berichtenlogboek. Een stap Call my webhook binnen een automatisering wordt alleen geactiveerd voor de berichten die die automatisering selecteert, en bevat de recente chat, inclusief het antwoord dat de automatisering net heeft verstuurd. Dat past bij een spreadsheet met leads, bestellingen of verzoeken die één automatisering afhandelt. Beide zijn ondertekend, met verschillende geheimen.
| Forward URL (per number) | Call my webhook step (per automation) | |
|---|---|---|
| Fires on | Any message event on the number, with or without automations | Only messages that automation is picked for |
| Carries | Meta's original value: messages, phone replies, statuses | The message, the contact and up to 10 recent messages |
| Automated replies | Delivery statuses only, without the text | In history, direction out |
| Retries | 7 attempts over about 33 hours | One attempt |
| Signed with | The number's forward secret, shown once | The automation's Signing secret |
| Set in | Number page, Where incoming messages go card | The automation editor, or create_automation |
Welke velden komen binnen, en welke kolommen moet de spreadsheet hebben?
Een doorgestuurde POST omvat één Meta-wijziging: id (de levering), event (de veldnaam van Meta, zoals messages of smb_message_echoes), received_at, connection (het id van je nummer, phone en phone_number_id) en value, precies zoals Meta die verstuurde. In value bevatten messages wat klanten schreven en message_echoes wat je team op de telefoon typte. Telefoonnummers komen aan als cijfers met landcode en zonder plusteken; sla die kolom op als platte tekst, zodat Sheets er geen getal van maakt. Een gebruiker met een WhatsApp-gebruikersnaam kan naast het nummer, of in plaats daarvan, een business-scoped user ID aanleveren, dus houd daar een kolom voor vrij.
Hoe bouw je het berichtenlogboek in n8n?
Drie nodes. Een Webhook-node met HTTP Method POST, Respond ingesteld op Immediately, en de Production URL opgeslagen als de Forward URL van het nummer. Een Code-node die X-EC-Signature controleert met het forward-geheim en de gebeurtenis omzet in rijen, waarbij leverstatussen worden overgeslagen. Een Google Sheets-node met de bewerking Append or Update Row, Column to match on ingesteld op Message id, zodat een opnieuw verstuurde levering dezelfde rij bijwerkt in plaats van er één toe te voegen.
Het forward-geheim verschijnt één keer, wanneer je de Forward URL opslaat; als je het kwijt bent, klik je op New secret en plak je het nieuwe. n8n Cloud staat de crypto-module toe in Code-nodes; zelfgehoste n8n heeft NODE_FUNCTION_ALLOW_BUILTIN=crypto nodig.
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 }));Hoe houd je één rij per contact bij?
Voeg een tweede Google Sheets-node toe op een tabblad Contacts, ook met Append or Update Row, afgestemd op Phone. Stel de velden in voor telefoonnummer, profielnaam, user ID, de tijd en de tekst van het laatste bericht. Het eerste bericht van een nummer maakt de rij aan; latere berichten werken de naam- en laatste-contactkolommen bij, zodat het tabblad ook dient als lijst van wie wanneer schreef. Houd handmatige notities op een apart tabblad, opgezocht op telefoonnummer, zodat de workflow ze nooit overschrijft.
De contacten die in het adresboek van de telefoon staan, komen zo niet binnen. Meta stuurt die, met tot 6 maanden chats, alleen naar een directe webhook-bestemming die binnen 24 uur na het koppelen van het nummer is opgeslagen.
Kan Apps Script de berichten rechtstreeks ontvangen?
Niet goed, dus zet een workflowtool voor de spreadsheet. Google levert het antwoord van een Apps Script-webapp via een redirect naar een eenmalige script.googleusercontent.com-URL, en easyCoexistence volgt geen redirects. De 302 telt als mislukte levering: een doorgestuurde levering wordt maximaal 7 keer opnieuw geprobeerd, en elke poging voert doPost opnieuw uit en schrijft weer een rij, terwijl een stap Call my webhook mislukt en je een e-mail stuurt. doPost kan ook geen HTTP-verzoekheaders lezen, dus de controle op X-EC-Signature is daar onmogelijk.
Apps Script blijft wel geschikt voor de andere richting: goedgekeurde templates versturen vanuit rijen van een spreadsheet, wat de pagina over de Google Sheets-integratie met code behandelt.
Kunnen Make of Zapier in plaats daarvan de spreadsheet vullen?
Ja. In Make start je het scenario met Webhooks > Custom webhook en voeg je Google Sheets > Add a Row toe; in Zapier gebruik je Webhooks by Zapier met Catch Raw Hook, die de headers bewaart, gevolgd door Google Sheets > Create Spreadsheet Row. Beide beantwoorden de POST meteen met een 2xx, wat een doorgestuurde levering nodig heeft binnen de 10 seconden. Stel dezelfde velden in als hierboven, uit value.messages, en filter gebeurtenissen eruit waarvan value statuses bevat in plaats van berichten.
Behandel de hook-URL als een wachtwoord, want wie hem heeft kan rijen toevoegen. Als je abonnement een codestap bevat, controleer dan X-EC-Signature daar met hetzelfde HMAC-recept als in de n8n-node.
Hoe voorkom je dubbele of ontbrekende rijen?
Dubbele rijen ontstaan door herhalingen. Een levering die binnen 10 seconden geen 2xx kreeg, wordt opnieuw verstuurd met dezelfde X-EC-Delivery-header en hetzelfde id in de body, en de berichten erin behouden hun wamid. Matchen op Message id maakt een herhaling dus onschadelijk. Bij de route via de webhook-stap zijn tests vanuit Try it voorzien van dry_run true: stuur ze naar een testtabblad of verwijder ze.
Ontbrekende rijen komen door Google's schrijfquota. De Sheets API staat 60 schrijfverzoeken per minuut per gebruiker per project toe, en één n8n-credential is één gebruiker; een uitbarsting van antwoorden na een templatecampagne kan dat overschrijden en HTTP 429 opleveren. Zet Retry On Fail aan in de instellingen van de Google Sheets-node, of verzamel berichten enkele seconden en voeg ze in één verzoek toe.
Zo stel je het in
- 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.
- 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.
- 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.
- 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.
Veelgemaakte fouten
- Een levering controleren met het Signing secret van een automatisering, of omgekeerd. De Forward URL wordt ondertekend met het forward-geheim van het nummer en Call my webhook met dat van de automatisering zelf; kies het geheim op basis van de X-EC-Event-header.
- Een rij per POST toevoegen zonder sleutel. Een levering die na een trage reactie opnieuw wordt verstuurd, schrijft hetzelfde bericht twee keer; gebruik Append or Update Row, afgestemd op het Message id.
- Leverstatussen als berichten wegschrijven. Het messages-event bevat ook de statussen sent, delivered en read in value.statuses; die hebben geen tekst en maken lege rijen.
- Een Apps Script-webapp-URL opslaan als Forward URL. De redirect telt als mislukking, dus elk van de 7 pogingen voert doPost opnieuw uit en voegt een dubbele rij toe.
Met Automations aan stuurt een Forward URL de originele Meta-gebeurtenissen door naar je workflow, ondertekend met een geheim dat alleen jij bezit en opnieuw geprobeerd wanneer je URL niet bereikbaar is. Een stap Call my webhook stuurt wat een automatisering afhandelde, met het antwoord. Beide zijn inbegrepen in het abonnement. Van US$ 9 tot US$ 0,75 per nummer per maand, dalend naarmate je nummers toevoegt, met de eerste 3 dagen gratis.
Veelgestelde vragen
Krijgt de spreadsheet ook de berichten die mijn team op de telefoon typt?
Ja, via de Forward URL. Antwoorden die in de WhatsApp Business-app worden getypt, komen binnen als smb_message_echoes-gebeurtenissen, met het nummer van de klant in to. Antwoorden die automatiseringen versturen komen alleen terug als leverstatussen, dus log hun tekst via een stap Call my webhook die na het antwoord staat.
Kan ik mijn bestaande chats in de spreadsheet laden?
Niet op een nummer waarvan de berichten via easyCoexistence lopen. Meta stuurt tot 6 maanden één-op-één-chats alleen naar een directe webhook-bestemming die binnen 24 uur na het koppelen is opgeslagen, eenmalig per verbinding. Een nummer dat via easyCoexistence loopt, logt vanaf het moment dat de Forward URL is opgeslagen.
Bewaart easyCoexistence een kopie van de berichten?
Gedeeltelijk. Op een nummer dat via easyCoexistence loopt met Automations aan wordt de berichttekst bewaard voor de periode die je kiest, 30, 90 of 365 dagen (standaard 90), en getoond in Conversations; doorgestuurde leveringen worden tot 7 dagen vastgehouden voor nieuwe pogingen, en de runlogs 30 dagen. De spreadsheet is jouw permanente kopie.
Kan mijn AI de spreadsheet lezen om klanten te antwoorden?
Niet vanuit een stap Reply with AI, die alleen zijn Instructions en de chat leest. Een AI-agent kan dingen opzoeken via een eigen HTTP-tool, en een stap Call my webhook of Call an API kan de vraag naar een workflow sturen die het antwoord in de spreadsheet opzoekt en terugstuurt als antwoord.
Lees verder
Klaar om te beginnen?
Stel WhatsApp Coexistence in enkele minuten in, niet maanden. De app blijft op je telefoon werken.
Start je gratis proefperiodeGeverifieerd op