Spremanje WhatsApp poruka i kontakata u Google Sheets automatski
Za automatsko spremanje WhatsApp Business poruka u Google Sheets šaljite ih kao potpisane HTTP POST zahtjeve alatu za automatizaciju poput n8n, Make ili Zapier, a njihov korak za Google Sheets dodaje red po poruci: vrijeme, smjer, broj telefona, ime, tekst i ID poruke. Druga kartica s ključem na broju telefona vodi jedan red po kontaktu i ažurira ga kad vam kontakt ponovno napiše.
easyCoexistence povezuje broj WhatsApp Business koji držite u aplikaciji preko Coexistencea na Meta Cloud API.
Proslijeđene isporuke ponovno se šalju nakon otprilike 1, 5, 30, 120, 360 i 1.440 minuta kad vaš URL ne uspije.
Koliko dugo proslijeđeni POST čeka odgovor 2xx prije nego što se isporuka ponovno pošalje.
Zahtjevi za pisanje u Google Sheets API dopušteni su po minuti po korisniku po projektu; 300 po projektu.
Odgovor web aplikacije Apps Scripta preusmjerava se na jednokratni URL na script.googleusercontent.com.
Objekt događaja doPost u Apps Scriptu izlaže tijelo i parametre, ali ne HTTP zaglavlja zahtjeva.
Koja ruta treba puniti tablicu?
Na broju čije poruke prolaze kroz easyCoexistence postoje dvije rute koje odgovaraju različitim potrebama. Forward URL, postavljen jednom po broju, prosljeđuje Metine izvorne događaje bez obzira na to odgovara li automatizacija: poruke kupaca, odgovore koje vaš tim upisuje u aplikaciji WhatsApp Business i statuse isporuke. To je ruta za potpuni zapisnik poruka. Korak Call my webhook unutar automatizacije okida se samo za poruke koje ta automatizacija odabere i nosi nedavni razgovor, uključujući odgovor koji je automatizacija upravo poslala. Pogodan je za tablicu potencijalnih kupaca, narudžbi ili zahtjeva koje obrađuje jedna automatizacija. Obje su potpisane, s različitim tajnim ključevima.
| 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 |
Koja polja stižu i koje stupce tablica treba imati?
Proslijeđeni POST omotava jednu Meta promjenu: id (isporuku), event (Metin naziv polja, npr. messages ili smb_message_echoes), received_at, connection (id vašeg broja, phone i phone_number_id) i value, točno onako kako ga je Meta poslala. U value messages sadrže ono što su kupci napisali, a message_echoes ono što je vaš tim upisao na telefonu. Brojevi telefona stižu kao znamenke s pozivnim brojem države i bez znaka plus; taj stupac spremite kao običan tekst da ga Sheets ne pretvori u broj. Korisnik s WhatsApp korisničkim imenom može stići s ID-om korisnika ograničenim na poslovni račun, uz broj ili umjesto njega, pa zadržite stupac i za njega.
Kako u n8n izgraditi zapisnik poruka?
Tri čvora. Čvor Webhook s HTTP Method POST, Respond postavljen na Immediately i njegov Production URL spremljen kao Forward URL broja. Čvor Code koji provjerava X-EC-Signature s tajnim ključem za proslijeđivanje i događaje pretvara u redove, preskačući statuse isporuke. Čvor Google Sheets s operacijom Append or Update Row, a Column to match on postavljenim na ID poruke, pa ponovljena isporuka prepisuje isti red umjesto da doda novi.
Tajni ključ za proslijeđivanje prikazuje se jednom, kad spremite Forward URL; ako ga izgubite, kliknite New secret i zalijepite novi. n8n Cloud dopušta modul crypto u čvorovima Code; n8n instaliran na vlastitom poslužitelju treba NODE_FUNCTION_ALLOW_BUILTIN=crypto.
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 }));Kako zadržati jedan red po kontaktu?
Dodajte drugi čvor Google Sheets na kartici Kontakti, također s Append or Update Row, uparen na telefon. Mapirajte telefon, ime profila, ID korisnika, vrijeme i tekst najnovije poruke. Prva poruka s broja stvara njegov red; kasnije poruke ažuriraju ime i stupce zadnjeg kontakta, pa kartica služi i kao popis tko je i kad pisao. Ručne bilješke držite na zasebnoj kartici, pretraženoj po telefonu, da ih tijek rada nikad ne prepiše.
Kontakti spremljeni u imenik telefona ovako ne stižu. Meta ih šalje, s do 6 mjeseci razgovora, samo na izravno odredište webhooka spremljeno u roku od 24 sata od povezivanja broja.
Može li Apps Script izravno primati poruke?
Ne na čist način, pa ispred tablice stavite alat za tijekove rada. Google poslužuje odgovor web aplikacije Apps Scripta preusmjeravanjem na jednokratni URL na script.googleusercontent.com, a easyCoexistence ne slijedi preusmjeravanja. Odgovor 302 računa se kao neuspjela isporuka: proslijeđivanje se ponovno pokušava do 7 puta, a svaki pokušaj ponovno pokreće doPost i upisuje još jedan red; korak Call my webhook ne uspijeva i šalje vam e-poštu. doPost također ne može čitati zaglavlja zahtjeva, pa je provjera X-EC-Signature tamo nemoguća.
Apps Script ostaje dobar za suprotan smjer: slanje odobrenih predložaka iz redaka tablice, što stranica za integraciju Google Sheets opisuje kodom.
Mogu li Make ili Zapier umjesto toga puniti tablicu?
Mogu. U Make-u pokrenite scenarij s Webhooks > Custom webhook i dodajte Google Sheets > Add a Row; u Zapieru koristite Webhooks by Zapier s Catch Raw Hook, koji zadržava zaglavlja, zatim Google Sheets > Create Spreadsheet Row. Oba odgovaraju na POST odmah s 2xx, što proslijeđivanje traži unutar 10 sekundi. Mapirajte ista polja kao gore iz value.messages i filtrirajte događaje čija value nosi statuses umjesto messages.
URL hooka tretirajte kao lozinku, jer tko ga ima može upisivati redove. Ako vaš plan uključuje korak s kodom, tamo provjerite X-EC-Signature istim HMAC postupkom kao u čvoru n8n.
Kako izbjeći duple ili izgubljene redove?
Duplikati nastaju pri ponovnim pokušajima. Proslijeđivanje koje ne dobije 2xx unutar 10 sekundi šalje se ponovno s istim zaglavljem X-EC-Delivery i istim id-om u tijelu, a poruke unutar njega zadržavaju svoj wamid, pa uparivanje na ID poruke čini ponovni pokušaj bezopasnim. Kod koraka Call my webhook testovi iz Try it stižu s dry_run true: usmjerite ih na testnu karticu ili ih odbacite.
Redovi koji nedostaju nastaju zbog ograničenja zapisa Googlea. Sheets API dopušta 60 zahtjeva za pisanje po minuti po korisniku po projektu, a jedna n8n vjerodajnica jedan je korisnik; nalet odgovora nakon kampanje predložaka može to premašiti i dobiti HTTP 429. Uključite Retry On Fail u postavkama čvora Google Sheets ili skupljajte poruke nekoliko sekundi i dodajte ih jednim zahtjevom.
Kako ga postaviti
- 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.
Uobičajene pogreške
- Provjera proslijeđivanja tajnim ključem automatizacije ili obratno. Forward URL potpisuje se tajnim ključem broja za proslijeđivanje, a Call my webhook vlastitim ključem automatizacije; ključ birajte prema zaglavlju X-EC-Event.
- Dodavanje retka za svaki POST bez ključa. Isporuka koja se ponovno pošalje nakon sporog odgovora upisuje istu poruku dvaput; koristite Append or Update Row uparen na ID poruke.
- Upisivanje statusa isporuke kao poruka. Događaj messages nosi i statuse sent, delivered i read u value.statuses, koji nemaju tekst i stvaraju prazne redove.
- Spremanje URL-a web aplikacije Apps Scripta kao Forward URL. Njezino preusmjeravanje računa se kao neuspjeh, pa svaki od 7 pokušaja ponovno pokreće doPost i dodaje duplikat reda.
Uz uključene automatizacije, Forward URL prosljeđuje Metine izvorne događaje vašem tijeku rada, potpisane tajnim ključem koji držite samo vi i ponovno šaljući kad je vaš URL nedostupan, a korak Call my webhook šalje ono što je automatizacija obradila, zajedno s njezinim odgovorom. Oba su uključena u plan. Od US$ 9 do US$ 0,75 po broju mjesečno, a pada kako dodajete brojeve, s prvih 3 dana besplatno.
Često postavljana pitanja
Dobiva li tablica poruke koje moj tim upisuje na telefonu?
Da, preko Forward URL-a. Odgovori upisani u aplikaciji WhatsApp Business stižu kao događaji smb_message_echoes, s brojem kupca u polju to. Odgovori koje šalju automatizacije vraćaju se samo kao statusi isporuke, pa njihov tekst zapišite iz koraka Call my webhook postavljenog nakon odgovora.
Mogu li u tablicu učitati postojeće razgovore?
Ne na broju čije poruke prolaze kroz easyCoexistence. Meta šalje do 6 mjeseci razgovora jedan na jedan samo na izravno odredište webhooka spremljeno u roku od 24 sata od povezivanja, jednom po vezi. Broj usmjeren kroz easyCoexistence zapisuje od trenutka kad spremite Forward URL.
Čuva li easyCoexistence kopiju poruka?
Djelomično. Na broju usmjerenom kroz easyCoexistence s uključenim automatizacijama tekst poruka čuva se onoliko dana koliko odaberete, 30, 90 ili 365 (zadano 90), i prikazuje se u Razgovorima; proslijeđene isporuke drže se do 7 dana radi ponovnih pokušaja, a zapisi pokretanja 30 dana. Tablica je vaša trajna kopija.
Može li moj AI čitati tablicu da odgovori kupcima?
Ne iz koraka Reply with AI, koji čita samo svoje Instructions i razgovor. AI agent može tražiti podatke putem prilagođenog HTTP alata, a korak Call my webhook ili Call an API može poslati pitanje tijeku rada koji potraži odgovor u tablici i vrati ga kao odgovor.
Nastavite čitati
Spremni za početak?
Postavite WhatsApp Coexistence u nekoliko minuta, a ne mjeseci. Aplikacija i dalje radi na telefonu.
Započnite besplatno probno razdobljeProvjereno na