Prijavite seZapočnite besplatni probni period
Meta Tech Provider

Automatski čuvajte WhatsApp poruke i kontakte u Google Sheets

Da biste WhatsApp Business poruke automatski čuvali u Google Sheets, šaljite ih kao potpisane HTTP POST zahteve alatu za automatizaciju, na primer n8n, Make ili Zapier, a njegov Google Sheets korak neka dodaje red za svaku poruku: vreme, smer, broj telefona, ime, tekst i ID poruke. Drugi list, vezan za broj telefona, čuva jedan red po kontaktu, koji se ažurira kada vam kontakt ponovo piše.

easyCoexistence povezuje WhatsApp Business broj koji držite u aplikaciji sa Metinim Cloud API-jem preko Coexistence.

7 attempts

Prosleđene isporuke se ponavljaju posle otprilike 1, 5, 30, 120, 360 i 1.440 minuta kada vaš URL ne uspe.

10 s

Koliko dugo prosleđeni POST čeka odgovor 2xx pre nego što se isporuka ponovi.

60 / min

Zahtevi za upis u Google Sheets API dozvoljeni po minutu po korisniku po projektu; 300 po projektu.

Redirect

Izlaz Apps Script veb aplikacije preusmerava se na jednokratni URL na script.googleusercontent.com.

No headers

Objekat događaja doPost u Apps Scriptu izlaže telo i parametre, ali ne i HTTP zaglavlja zahteva.

Koja ruta treba da popunjava tabelu?

Na broju čije poruke prolaze kroz easyCoexistence postoje dve rute, i odgovaraju različitim potrebama. Forward URL, podešen jednom po broju, prosleđuje originalne Metine događaje bez obzira na to da li ih automatizacija obrađuje: poruke kupaca, odgovore koje vaš tim unese u aplikaciju WhatsApp Business i statuse isporuke. To je ruta za potpun zapisnik poruka. Korak Call my webhook unutar automatizacije okida se samo za poruke koje ta automatizacija izabere i nosi nedavni razgovor, uključujući odgovor koji je automatizacija upravo poslala. Pogodan je za tabelu potencijalnih klijenata, porudžbina ili zahteva koje obrađuje jedna automatizacija. Obe su potpisane, sa različitim tajnim ključevima.

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

Koja polja stižu i koje kolone tabela treba da ima?

Prosleđeni POST omotava jednu Metinu izmenu: id (isporuku), event (Metin naziv polja, kao messages ili smb_message_echoes), received_at, connection (id vašeg broja, phone i phone_number_id) i value, tačno onako kako ga je Meta poslala. U value, messages sadrže ono što su kupci napisali, a message_echoes sadrže ono što je vaš tim ukucao na telefonu. Brojevi telefona stižu kao cifre sa pozivnim brojem i bez znaka plus; tu kolonu čuvajte kao običan tekst da je Sheets ne pretvori u broj. Korisnik sa WhatsApp korisničkim imenom može stići sa ID-jem korisnika ograničenim na firmu pored broja telefona ili umesto njega, zato držite kolonu i za njega.

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

Kako se gradi zapisnik poruka u n8n?

Tri čvora. Webhook čvor sa HTTP Method POST, Respond podešenim na Immediately i Production URL sačuvanim kao Forward URL broja. Code čvor koji proverava X-EC-Signature pomoću tajnog ključa za prosleđivanje i pretvara događaj u redove, preskačući statuse isporuke. Google Sheets čvor sa operacijom Append or Update Row, Column to match on podešenim na Message id, tako da ponovljena isporuka prepiše isti red umesto da doda novi.

Tajni ključ za prosleđivanje prikazuje se jednom, kada sačuvate Forward URL; ako ga izgubite, kliknite New secret i nalepite novi. n8n Cloud dozvoljava modul crypto u Code čvorovima; n8n na sopstvenom serveru treba 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 }));

Kako čuvate jedan red po kontaktu?

Dodajte drugi Google Sheets čvor na karticu Contacts, takođe sa Append or Update Row, uparen po polju Phone. Mapirajte telefon, ime profila, ID korisnika, vreme i tekst poslednje poruke. Prva poruka sa broja kreira njegov red; kasnije poruke ažuriraju kolone za ime i poslednji kontakt, tako da kartica služi i kao spisak onih koji su pisali i kada. Beleške pisane rukom čuvajte na zasebnoj kartici, pretraženoj po telefonu, da ih tok rada nikada ne prepiše.

Kontakti sačuvani u adresaru telefona ne stižu na ovaj način. Meta ih šalje, sa do 6 meseci razgovora, samo na direktno webhook odredište sačuvano u roku od 24 sata od povezivanja broja.

Može li Apps Script direktno da prima poruke?

Ne baš čisto, zato ispred tabele stavite alat za automatizaciju tokova rada. Google poslužuje odgovor Apps Script veb aplikacije preusmeravanjem na jednokratni URL script.googleusercontent.com, a easyCoexistence ne prati preusmeravanja. Odgovor 302 računa se kao neuspela isporuka: prosleđivanje se ponavlja do 7 puta, a svaki pokušaj ponovo pokreće doPost i upisuje još jedan red, dok korak Call my webhook ne uspe i pošalje vam e-poruku. doPost takođe ne može da čita zaglavlja zahteva, pa je provera X-EC-Signature tu nemoguća.

Apps Script ostaje dobar izbor za suprotan smer, slanje odobrenih šablona iz redova tabele, što stranica o integraciji Google Sheets pokriva kodom.

Mogu li Make ili Zapier da popune tabelu umesto toga?

Mogu. U Make-u pokrenite scenario sa Webhooks > Custom webhook i dodajte Google Sheets > Add a Row; u Zapier-u koristite Webhooks by Zapier sa Catch Raw Hook, koji čuva zaglavlja, zatim Google Sheets > Create Spreadsheet Row. Oba odgovaraju na POST odmah sa 2xx, što prosleđivanje traži u roku od 10 sekundi. Mapirajte ista polja kao gore iz value.messages i filtrirajte događaje čija value sadrži statuses umesto messages.

URL hook-a tretirajte kao lozinku, jer svako ko ga ima može da upisuje redove. Ako vaš plan uključuje korak sa kodom, proverite X-EC-Signature tamo istim HMAC postupkom kao u n8n čvoru.

Kako izbeći duplikate ili nedostajuće redove?

Duplikati nastaju pri ponovnim pokušajima. Prosleđivanje koje nije dobilo 2xx u roku od 10 sekundi šalje se ponovo sa istim zaglavljem X-EC-Delivery i istim id-jem u telu, a poruke unutra zadržavaju svoj wamid, pa uparivanje po Message id čini ponovni pokušaj bezopasnim. Na putu sa korakom webhook, testovi iz Try it stižu sa dry_run true: usmerite ih na test karticu ili ih odbacite.

Nedostajući redovi nastaju zbog Google-ove kvote za upis. Sheets API dozvoljava 60 zahteva za upis u minuti po korisniku po projektu, a jedan n8n akreditiv je jedan korisnik; nagli talas odgovora posle kampanje šablona može da premaši tu kvotu i dobije HTTP 429. Uključite Retry On Fail u podešavanjima čvora Google Sheets ili skupljajte poruke nekoliko sekundi pa ih dodajte u jednom zahtevu.

Kako da podesite

  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.

Česte greške

  • Provera prosleđivanja ključem automatizacije ili obrnuto. Forward URL se potpisuje tajnim ključem za prosleđivanje broja, a Call my webhook sopstvenim ključem automatizacije; ključ birajte prema zaglavlju X-EC-Event.
  • Dodavanje reda za svaki POST bez ključa. Isporuka koja je ponovljena posle sporog odgovora upisuje istu poruku dvaput; koristite Append or Update Row uparen po ID-ju poruke.
  • Upisivanje statusa isporuke kao poruka. Događaj messages takođe nosi statuse sent, delivered i read u value.statuses, koji nemaju tekst i prave prazne redove.
  • Čuvanje URL-a Apps Script veb aplikacije kao Forward URL. Njeno preusmeravanje računa se kao greška, pa svaki od 7 pokušaja ponovo pokreće doPost i dodaje duplikat reda.
Ovo radite uz EasyCoexistence

Kada su automatizacije uključene, Forward URL prosleđuje originalne Metine događaje vašem toku rada, potpisane tajnom koju držite samo vi i ponovo pokušane kada je vaš URL nedostupan, a korak Call my webhook šalje ono što je automatizacija obradila, zajedno sa njenim odgovorom. Oba su uključena u plan. Od US$ 9 do US$ 0.75 po broju mesečno, što pada kako dodajete brojeve, sa besplatnim probnim periodom od prvih 3 dana.

Često postavljana pitanja

Da li tabela dobija poruke koje moj tim ukuca na telefonu?

Da, preko Forward URL. Odgovori ukucani u aplikaciji WhatsApp Business stižu kao smb_message_echoes događaji, sa brojem kupca u polju to. Odgovori poslati iz automatizacija stižu samo kao statusi isporuke, pa njihov tekst beležite iz koraka Call my webhook postavljenog posle odgovora.

Mogu li da učitam postojeće razgovore u tabelu?

Ne na broju čije poruke prolaze kroz easyCoexistence. Meta šalje do 6 meseci razgovora jedan na jedan samo na direktno webhook odredište sačuvano u roku od 24 sata od povezivanja, jednom po vezi. Broj usmeren kroz easyCoexistence beleži od trenutka kada se Forward URL sačuva.

Da li easyCoexistence čuva kopiju poruka?

Delimično. Na broju koji ide kroz easyCoexistence sa uključenim automatizacijama, tekst poruka čuva se onoliko koliko izaberete, 30, 90 ili 365 dana (podrazumevano 90), i prikazuje se u Conversations. Prosleđene isporuke zadržavaju se do 7 dana radi ponovnih pokušaja, a logovi izvršavanja 30 dana. Tabela je vaša trajna kopija.

Može li moj AI da čita tabelu i odgovara kupcima?

Ne iz koraka Reply with AI, koji čita samo svoja Instructions i razgovor. AI agent može da traži podatke preko prilagođenog HTTP alata, a korak Call my webhook ili Call an API može poslati pitanje alatu za automatizaciju, koji u tabeli traži odgovor i vraća ga kao odgovor.

Nastavite sa čitanjem

Spremni da počnete?

Podesite WhatsApp Coexistence za nekoliko minuta, a ne meseci. Aplikacija nastavlja da radi na telefonu.

Započnite besplatni probni period

Provereno na