AccediInizia la prova gratuita
Meta Tech Provider

Salva automaticamente i messaggi e i contatti di WhatsApp su Google Sheets

Per salvare automaticamente su Google Sheets i messaggi di WhatsApp Business, inviali come POST HTTP firmati a uno strumento di automazione come n8n, Make o Zapier, e lascia che il suo passaggio Google Sheets aggiunga una riga per ogni messaggio: orario, direzione, numero di telefono, nome, testo e ID del messaggio. Una seconda scheda, indicizzata sul numero di telefono, mantiene una riga per contatto, aggiornata quando scrive di nuovo.

easyCoexistence collega il numero WhatsApp Business che tieni nell'app all'API Cloud di Meta tramite Coexistence.

7 attempts

Le consegne inoltrate vengono ritentate dopo circa 1, 5, 30, 120, 360 e 1.440 minuti quando il tuo URL non risponde.

10 s

Quanto attende un POST inoltrato una risposta 2xx prima che la consegna venga ritentata.

60 / min

Richieste di scrittura consentite dall'API di Google Sheets al minuto per utente per progetto; 300 per progetto.

Redirect

L'output di una web app di Apps Script viene reindirizzato a un URL monouso su script.googleusercontent.com.

No headers

L'oggetto evento doPost di Apps Script espone il corpo e i parametri, non le intestazioni della richiesta HTTP.

Quale percorso deve riempire il foglio?

Su un numero i cui messaggi passano da easyCoexistence esistono due percorsi, che rispondono a esigenze diverse. L'URL di inoltro, impostato una volta per numero, trasmette gli eventi originali di Meta che un'automazione risponda o no: i messaggi dei clienti, le risposte che il tuo team digita nell'app WhatsApp Business e gli stati di consegna. È il percorso per un registro completo dei messaggi. Il passaggio Call my webhook all'interno di un'automazione si attiva solo per i messaggi che quell'automazione seleziona, e include la chat recente, compresa la risposta che l'automazione ha appena inviato. Si adatta a un foglio di lead, ordini o richieste gestiti da un'unica automazione. Entrambi sono firmati, con segreti diversi.

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

Quali campi arrivano e quali colonne dovrebbe avere il foglio?

Un POST inoltrato contiene una singola modifica di Meta: id (la consegna), event (il nome del campo di Meta, come messages o smb_message_echoes), received_at, connection (l'id del tuo numero, phone e phone_number_id) e value, esattamente come lo ha inviato Meta. In value, messages contiene ciò che hanno scritto i clienti, mentre message_echoes contiene ciò che il tuo team ha digitato dal telefono. I numeri di telefono arrivano come cifre con il prefisso internazionale e senza il segno più; memorizza quella colonna come testo semplice perché Sheets non la trasformi in numero. Un utente con un nome utente WhatsApp può arrivare con un user ID con ambito aziendale accanto al numero, o al posto suo, quindi tieni una colonna anche per questo.

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

Come si costruisce il registro dei messaggi in n8n?

Tre nodi. Un nodo Webhook con HTTP Method POST, Respond impostato su Immediately e il suo Production URL salvato come Forward URL del numero. Un nodo Code che verifica X-EC-Signature con il forward secret e trasforma l'evento in righe, saltando gli stati di consegna. Un nodo Google Sheets con l'operazione Append or Update Row, Column to match on impostato su Message id, così una consegna ritentata riscrive la stessa riga invece di aggiungerne un'altra.

Il forward secret appare una sola volta, quando salvi il Forward URL; se lo perdi, clicca su New secret e incolla il nuovo. n8n Cloud consente il modulo crypto nei nodi Code; n8n self-hosted richiede 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 }));

Come si mantiene una riga per contatto?

Aggiungi un secondo nodo Google Sheets su una scheda Contacts, anch'esso con Append or Update Row, abbinato su Phone. Mappa il numero di telefono, il nome del profilo, lo user ID, l'orario e il testo dell'ultimo messaggio. Il primo messaggio da un numero crea la sua riga; quelli successivi aggiornano il nome e le colonne dell'ultimo contatto, così la scheda funge anche da elenco di chi ha scritto e quando. Tieni le note scritte a mano su una scheda separata, cercate per numero di telefono, così il workflow non le sovrascrive mai.

I contatti salvati nella rubrica del telefono non arrivano in questo modo. Meta li invia, con fino a 6 mesi di chat, solo a una destinazione webhook diretta salvata entro 24 ore dalla connessione del numero.

Apps Script può ricevere direttamente i messaggi?

Non in modo pulito, quindi metti uno strumento di workflow davanti al foglio. Google serve la risposta di una web app di Apps Script tramite un reindirizzamento a un URL monouso script.googleusercontent.com, e easyCoexistence non segue i reindirizzamenti. Il 302 conta come consegna fallita: un inoltro viene ritentato fino a 7 volte, e ogni tentativo esegue di nuovo doPost e scrive un'altra riga, mentre un passaggio Call my webhook fallisce e ti invia un'e-mail. doPost inoltre non può leggere le intestazioni della richiesta, quindi il controllo X-EC-Signature è impossibile lì.

Apps Script resta una buona scelta per l'altra direzione, cioè l'invio di template approvati dalle righe di un foglio, e la pagina dell'integrazione con Google Sheets la spiega con il codice.

Make o Zapier possono riempire il foglio al posto suo?

Sì. In Make, avvia lo scenario con Webhooks > Custom webhook e aggiungi Google Sheets > Add a Row; in Zapier, usa Webhooks by Zapier con Catch Raw Hook, che mantiene le intestazioni, poi Google Sheets > Create Spreadsheet Row. Entrambi rispondono subito al POST con un 2xx, che è ciò che serve a un inoltro entro i suoi 10 secondi. Mappa gli stessi campi indicati sopra da value.messages, e filtra gli eventi il cui value contiene statuses al posto di messages.

Tratta l'URL dell'hook come una password, perché chiunque lo conosca può inserire righe. Se il tuo piano include un passaggio di codice, verifica lì X-EC-Signature con la stessa ricetta HMAC usata nel nodo n8n.

Come si evitano righe duplicate o mancanti?

I duplicati nascono dai tentativi ripetuti. Un inoltro che non ha ricevuto un 2xx entro 10 secondi viene inviato di nuovo con la stessa intestazione X-EC-Delivery e lo stesso id nel corpo, e i messaggi al suo interno conservano il loro wamid; quindi abbinare su Message id rende innocuo un nuovo tentativo. Sul percorso del passaggio webhook, i test da Try it arrivano con dry_run true: indirizzali a una scheda di prova o eliminali.

Le righe mancanti derivano dal limite di scrittura di Google. L'API di Sheets consente 60 richieste di scrittura al minuto per utente per progetto, e una credenziale n8n corrisponde a un utente; una raffica di risposte dopo una campagna di template può superarlo e ricevere HTTP 429. Attiva Retry On Fail nelle impostazioni del nodo Google Sheets, oppure raccogli i messaggi per alcuni secondi e aggiungili in un'unica richiesta.

Come configurarlo

  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.

Errori comuni

  • Verificare un inoltro con il Signing secret di un'automazione, o viceversa. L'URL di inoltro è firmato con il forward secret del numero e Call my webhook con quello dell'automazione; scegli il segreto in base all'intestazione X-EC-Event.
  • Aggiungere una riga per ogni POST senza una chiave. Una consegna ritentata dopo una risposta lenta scrive lo stesso messaggio due volte; usa Append or Update Row abbinato sul message id.
  • Scrivere gli stati di consegna come messaggi. L'evento messages contiene anche gli stati sent, delivered e read in value.statuses, che non hanno testo e creano righe vuote.
  • Salvare l'URL di una web app di Apps Script come Forward URL. Il suo reindirizzamento conta come errore, quindi ciascuno dei 7 tentativi esegue di nuovo doPost e aggiunge una riga duplicata.
Farlo con EasyCoexistence

Con le automazioni attive, un Forward URL trasmette gli eventi originali di Meta al tuo workflow, firmati con un segreto che solo tu conosci e ritentati quando il tuo URL non è disponibile, e un passaggio Call my webhook invia ciò che un'automazione ha gestito, con la sua risposta. Entrambi sono inclusi nel piano. Da US$ 9 fino a US$ 0.75 per numero al mese, in calo man mano che aggiungi numeri, con i primi 3 giorni di prova gratuita.

Domande frequenti

Il foglio riceve i messaggi che il mio team digita sul telefono?

Sì, tramite il Forward URL. Le risposte digitate nell'app WhatsApp Business arrivano come eventi smb_message_echoes, con il numero del cliente in to. Le risposte inviate dalle automazioni tornano solo come stati di consegna, quindi registra il loro testo da un passaggio Call my webhook posto dopo la risposta.

Posso caricare le mie chat esistenti nel foglio?

Non su un numero i cui messaggi passano da easyCoexistence. Meta invia fino a 6 mesi di chat one-to-one solo a una destinazione webhook diretta salvata entro 24 ore dalla connessione, una volta per connessione. Un numero instradato tramite easyCoexistence registra dal momento in cui salvi il Forward URL.

easyCoexistence conserva una copia dei messaggi?

Parzialmente. Su un numero instradato tramite easyCoexistence con le automazioni attive, il testo dei messaggi viene conservato per il periodo che scegli, 30, 90 o 365 giorni (90 per impostazione predefinita), e mostrato in Conversazioni; gli inoltri consegnati restano in attesa fino a 7 giorni per i nuovi tentativi, e i log di esecuzione per 30 giorni. Il foglio è la tua copia permanente.

La mia AI può leggere il foglio per rispondere ai clienti?

Non da un passaggio Reply with AI, che legge solo le sue Instructions e la chat. Un agente AI può cercare le informazioni tramite uno strumento HTTP personalizzato, e un passaggio Call my webhook o Call an API può inviare la domanda a un workflow che cerca la risposta nel foglio e la restituisce come risposta.

Continua a leggere

Pronto per iniziare?

Configura WhatsApp Coexistence in pochi minuti, non in mesi. L'app continua a funzionare sul telefono.

Inizia la prova gratuita

Verificato il