Conectați-văÎncepeți perioada de probă gratuită
Meta Tech Provider

Salvați mesajele și contactele WhatsApp în Google Sheets automat

Pentru a salva automat mesajele WhatsApp Business în Google Sheets, trimiteți-le ca HTTP POST semnate către un instrument de automatizare precum n8n, Make sau Zapier, iar pasul lor Google Sheets adaugă un rând pentru fiecare mesaj: ora, direcția, numărul de telefon, numele, textul și ID-ul mesajului. A doua filă, indexată după numărul de telefon, păstrează un rând pentru fiecare contact, actualizat atunci când scrie din nou.

easyCoexistence conectează numărul WhatsApp Business pe care îl păstrați în aplicație la Cloud API de la Meta prin Coexistence.

7 attempts

Livrările redirecționate sunt reîncercate după aproximativ 1, 5, 30, 120, 360 și 1.440 de minute când URL-ul dvs. eșuează.

10 s

Cât timp așteaptă un POST redirecționat un răspuns 2xx înainte ca livrarea să fie reîncercată.

60 / min

Cereri de scriere ale Google Sheets API permise pe minut pe utilizator pe proiect; 300 pe proiect.

Redirect

Ieșirea aplicației web Apps Script este redirecționată către un URL de unică folosință la script.googleusercontent.com.

No headers

Obiectul de eveniment doPost al Apps Script expune corpul și parametrii, nu anteturile cererii HTTP.

Ce rută ar trebui să completeze foaia?

Există două rute pentru un număr ale cărui mesaje trec prin easyCoexistence, iar ele răspund unor nevoi diferite. Forward URL, setat o singură dată pentru fiecare număr, transmite evenimentele originale ale Meta, indiferent dacă vreo automatizare răspunde: mesajele clienților, răspunsurile pe care echipa le scrie în aplicația WhatsApp Business și stările livrărilor. Este ruta pentru un jurnal complet al mesajelor. Un pas Call my webhook din interiorul unei automatizări se declanșează doar pentru mesajele pe care automatizarea le alege și transmite conversația recentă, inclusiv răspunsul pe care automatizarea tocmai l-a trimis. Se potrivește pentru o foaie cu clienți potențiali, comenzi sau cereri pe care le gestionează o automatizare. Ambele sunt semnate, cu secrete diferite.

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

Ce câmpuri sosesc și ce coloane ar trebui să aibă foaia?

Un POST redirecționat include o singură modificare Meta: id (livrarea), event (numele câmpului Meta, precum messages sau smb_message_echoes), received_at, connection (ID-ul numărului dvs., phone și phone_number_id) și value, exact cum l-a trimis Meta. În value, messages conțin ce au scris clienții, iar message_echoes conțin ce a scris echipa dvs. la telefon. Numerele de telefon sosesc ca cifre cu prefixul de țară și fără semnul plus; păstrați coloana aceea ca text simplu, ca Sheets să nu o transforme într-un număr. Un utilizator cu un nume de utilizator WhatsApp poate sosi cu un ID de utilizator legat de firmă alături de număr sau în locul lui, așa că păstrați o coloană pentru el.

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

Cum construiți jurnalul de mesaje în n8n?

Trei noduri. Un nod Webhook cu HTTP Method POST, Respond setat la Immediately și Production URL salvat ca Forward URL al numărului. Un nod Code care verifică X-EC-Signature cu secretul de redirecționare și transformă evenimentul în rânduri, omițând stările livrărilor. Un nod Google Sheets cu operațiunea Append or Update Row, Column to match on setat la Message id, astfel încât o livrare reîncercată rescrie același rând în loc să adauge unul nou.

Secretul de redirecționare apare o singură dată, când salvați Forward URL; dacă se pierde, faceți clic pe New secret și lipiți noul secret. n8n Cloud permite modulul crypto în nodurile Code; n8n self-hosted are nevoie de 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 }));

Cum păstrați un rând pentru fiecare contact?

Adăugați un al doilea nod Google Sheets pe o filă Contacts, tot cu Append or Update Row, potrivit pe Phone. Mapați numărul de telefon, numele din profil, ID-ul utilizatorului, ora și textul ultimului mesaj. Primul mesaj de la un număr creează rândul; cele ulterioare actualizează coloanele de nume și de ultimul contact, astfel încât fila funcționează și ca listă a celor care au scris și când. Păstrați notițele scrise de mână pe o filă separată, căutate după telefon, ca fluxul de lucru să nu le suprascrie niciodată.

Contactele salvate în agenda telefonului nu ajung pe această cale. Meta le trimite, împreună cu conversațiile de până la 6 luni, doar către o destinație webhook directă salvată în 24 de ore de la conectarea numărului.

Poate Apps Script să primească mesajele direct?

Nu curat, așa că puneți un instrument de automatizare în fața foii. Google servește răspunsul unei aplicații web Apps Script printr-o redirecționare către un URL de unică folosință script.googleusercontent.com, iar easyCoexistence nu urmează redirecționările. Redirecționarea 302 contează ca livrare eșuată: un Forward URL este reîncercat de până la 7 ori, iar fiecare reîncercare rulează din nou doPost și scrie încă un rând, în timp ce un pas Call my webhook eșuează și vă trimite un e-mail. doPost nici nu poate citi anteturile cererii, deci verificarea X-EC-Signature este imposibilă acolo.

Apps Script rămâne o alegere bună pentru sensul invers, adică trimiterea șabloanelor aprobate din rândurile unei foi, subiect pe care pagina despre integrarea cu Google Sheets îl acoperă cu cod.

Pot Make sau Zapier să completeze foaia în schimb?

Da. În Make, porniți scenariul cu Webhooks > Custom webhook și adăugați Google Sheets > Add a Row; în Zapier, folosiți Webhooks by Zapier cu Catch Raw Hook, care păstrează anteturile, apoi Google Sheets > Create Spreadsheet Row. Ambele răspund imediat la POST cu un 2xx, ceea ce are nevoie o redirecționare în cele 10 secunde. Mapați aceleași câmpuri ca mai sus din value.messages și filtrați evenimentele a căror value conține statuses în loc de messages.

Tratați URL-ul hook-ului ca pe o parolă, pentru că oricine îl deține poate trimite rânduri. Dacă planul dvs. include un pas de cod, verificați acolo X-EC-Signature cu aceeași rețetă HMAC folosită în nodul n8n.

Cum evitați rândurile duplicate sau lipsă?

Duplicatele apar din reîncercări. O redirecționare care nu a primit un 2xx în 10 secunde este trimisă din nou cu același antet X-EC-Delivery și același id în corp, iar mesajele din interior își păstrează wamid-ul, așa că potrivirea pe Message id face reîncercarea inofensivă. Pe ruta pasului webhook, testele din Try it sosesc cu dry_run true: trimiteți-le pe o filă de test sau eliminați-le.

Rândurile lipsă vin din limita de scriere a Google. Sheets API permite 60 de cereri de scriere pe minut pe utilizator pe proiect, iar o credențială n8n înseamnă un utilizator; un val de răspunsuri după o campanie de șabloane poate depăși limita și primi HTTP 429. Activați Retry On Fail în setările nodului Google Sheets sau strângeți mesajele câteva secunde și adăugați-le într-o singură cerere.

Cum să îl configurați

  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.

Greșeli frecvente

  • Verificarea unei redirecționări cu Signing secret al unei automatizări sau invers. Forward URL este semnat cu secretul de redirecționare al numărului, iar Call my webhook cu cel propriu al automatizării; alegeți secretul după antetul X-EC-Event.
  • Adăugarea unui rând pentru fiecare POST fără cheie. O livrare reîncercată după un răspuns lent scrie același mesaj de două ori; folosiți Append or Update Row potrivit pe ID-ul mesajului.
  • Scrierea stărilor livrărilor ca mesaje. Evenimentul messages transportă și stările sent, delivered și read în value.statuses, care nu au text și creează rânduri goale.
  • Salvarea unui URL de aplicație web Apps Script ca Forward URL. Redirecționarea sa contează drept eșec, deci fiecare dintre cele 7 încercări rulează din nou doPost și adaugă un rând duplicat.
Faceți acest lucru cu EasyCoexistence

Cu automatizările pornite, un Forward URL transmite evenimentele originale ale Meta către fluxul dvs. de lucru, semnate cu un secret pe care îl dețineți doar dvs. și reîncercate când URL-ul dvs. este indisponibil, iar un pas Call my webhook trimite ce a gestionat o automatizare, împreună cu răspunsul ei. Ambele sunt incluse în plan. De la US$ 9 până la US$ 0,75 per număr pe lună, scăzând pe măsură ce adăugați numere, cu primele 3 zile gratuite.

Întrebări frecvente

Foaia primește mesajele pe care echipa mea le scrie la telefon?

Da, prin Forward URL. Răspunsurile scrise în aplicația WhatsApp Business sosesc ca evenimente smb_message_echoes, cu numărul clientului în to. Răspunsurile trimise de automatizări vin doar ca stări ale livrărilor, deci înregistrați textul lor dintr-un pas Call my webhook plasat după răspuns.

Pot încărca conversațiile existente în foaie?

Nu pe un număr ale cărui mesaje trec prin easyCoexistence. Meta trimite conversațiile one-to-one de până la 6 luni doar către o destinație webhook directă salvată în 24 de ore de la conectare, o singură dată pentru fiecare conexiune. Un număr direcționat prin easyCoexistence înregistrează din momentul în care este salvat Forward URL.

easyCoexistence păstrează o copie a mesajelor?

Parțial. Pe un număr direcționat prin easyCoexistence, cu automatizările pornite, textul mesajelor se păstrează perioada aleasă de dvs., 30, 90 sau 365 de zile (implicit 90), și apare în Conversații; livrările redirecționate se rețin până la 7 zile pentru reîncercări, iar jurnalele de rulare 30 de zile. Foaia este copia dvs. permanentă.

Poate AI-ul meu citi foaia ca să răspundă clienților?

Nu dintr-un pas Reply with AI, care citește doar Instructions și conversația. Un agent AI poate căuta informații printr-un instrument HTTP personalizat, iar un pas Call my webhook sau Call an API poate trimite întrebarea către un flux de lucru care caută răspunsul în foaie și îl returnează ca răspuns.

Continuați să citiți

Gata să începeți?

Configurați WhatsApp Coexistence în câteva minute, nu luni. Aplicația continuă să funcționeze pe telefon.

Începeți perioada de probă gratuită

Verificat la