Awtomatikong i-save ang mga WhatsApp na mensahe at contact sa Google Sheets
Para awtomatikong i-save ang mga WhatsApp Business na mensahe sa Google Sheets, ipadala ang mga ito bilang signed HTTP POST sa isang automation tool gaya ng n8n, Make o Zapier. Ang Google Sheets step nito ang maglalagay ng isang row kada mensahe: oras, direksyon, numero ng telepono, pangalan, text at message id. Ang pangalawang tab, na naka-key sa numero ng telepono, ay nagpapanatili ng isang row kada contact, na ina-update kapag muling nagsulat ang contact.
Ikinokonekta ng easyCoexistence ang WhatsApp Business na numerong itinatago ninyo sa app sa Cloud API ng Meta sa pamamagitan ng Coexistence.
Kapag pumalya ang inyong URL, inuulit ang mga forwarded delivery pagkalipas ng humigit-kumulang 1, 5, 30, 120, 360 at 1,440 minuto.
Gaano katagal naghihintay ang forwarded POST sa 2xx na sagot bago ulitin ang delivery.
Pinapayagang write request sa Google Sheets API kada minuto kada user kada project; 300 kada project.
Ang output ng Apps Script web app ay nire-redirect sa isang one-time URL sa script.googleusercontent.com.
Ang doPost event object ng Apps Script ay naglalantad ng body at mga parameter, hindi ng mga HTTP request header.
Aling route ang dapat magpuno sa sheet?
May dalawang route sa isang numerong ang mga mensahe ay dumadaan sa easyCoexistence, at magkaiba ang tinutugunan ng bawat isa. Ang Forward URL, na itinatakda minsan kada numero, ay ipinapasa ang orihinal na event ng Meta, may sumasagot mang automation o wala: mga mensahe ng customer, mga reply na itina-type ng inyong team sa WhatsApp Business app, at mga delivery status. Ito ang route para sa buong log ng mensahe. Ang Call my webhook step sa loob ng automation ay tumatakbo lamang para sa mga mensaheng pinipili ng automation na iyon, at dala nito ang kamakailang chat, kasama ang reply na katatapos lang ipadala ng automation. Angkop ito sa sheet ng lead, order o request na hinahawakan ng isang automation. Pareho silang may signature, pero magkaiba ang secret.
| 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 |
Anong mga field ang dumarating, at anong column ang dapat meron ang sheet?
Ang forwarded POST ay nagbabalot ng isang Meta change: id (ang delivery), event (pangalan ng field ng Meta, gaya ng messages o smb_message_echoes), received_at, connection (id ng inyong numero, phone at phone_number_id) at value, eksaktong ipinadala ng Meta. Sa loob ng value, ang messages ay naglalaman ng isinulat ng mga customer, at ang message_echoes ay naglalaman ng itinype ng inyong team sa telepono. Dumarating ang mga numero ng telepono bilang digits na may country code at walang plus sign; i-store ang column na iyon bilang plain text para hindi ito gawing numero ng Sheets. Maaaring dumating ang user na may WhatsApp username kasama ang business-scoped user ID sa tabi ng numero, o sa halip na numero, kaya maglaan ng column para dito.
Paano ginagawa ang log ng mensahe sa n8n?
Tatlong node. Isang Webhook node na may HTTP Method POST, Respond na nakatakda sa Immediately, at ang Production URL nito na sine-save bilang Forward URL ng numero. Isang Code node na nagche-check ng X-EC-Signature gamit ang forward secret at ginagawang row ang event, nilalaktawan ang mga delivery status. Isang Google Sheets node na may operation na Append or Update Row, at Column to match on na nakatakda sa Message id, para ang muling ipinadalang delivery ay mag-overwrite sa parehong row sa halip na magdagdag ng bago.
Lalabas ang forward secret nang isang beses lang, kapag sine-save ninyo ang Forward URL; kung mawala ito, i-click ang New secret at i-paste ang bago. Pinapayagan ng n8n Cloud ang crypto module sa mga Code node; kailangan ng self-hosted n8n ang 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 }));Paano panatilihin ang isang row kada contact?
Magdagdag ng pangalawang Google Sheets node sa isang Contacts tab, na Append or Update Row din, na itinutugma sa Phone. I-map ang telepono, ang profile name, ang user ID, ang oras at ang text ng pinakabagong mensahe. Ang unang mensahe mula sa isang numero ay gumagawa ng sariling row; ang mga sumunod ay nag-a-update ng pangalan at ng mga column ng huling contact, kaya nagsisilbi ring listahan kung sino ang sumulat at kailan ang tab. Itago ang mga note na isinulat ng kamay sa hiwalay na tab, na hinahanap sa pamamagitan ng telepono, para hindi kailanman ma-overwrite ng workflow ang mga ito.
Ang mga contact na naka-save sa address book ng telepono ay hindi dumarating sa ganitong paraan. Ipinapadala ito ng Meta, kasama ang hanggang 6 na buwang chat, lamang sa isang direct webhook destination na na-save sa loob ng 24 oras mula nang i-connect ang numero.
Puwede bang direktang tanggapin ng Apps Script ang mga mensahe?
Hindi malinis, kaya maglagay ng workflow tool sa harap ng sheet. Dinadaan ng Google ang sagot ng Apps Script web app sa redirect papunta sa isang one-time na URL sa script.googleusercontent.com, at hindi sumusunod sa mga redirect ang easyCoexistence. Binibilang ang 302 bilang pumalyang delivery: uulitin ang forward hanggang 7 beses, at bawat ulit ay papatakbo muli ng doPost at magsusulat ng panibagong row, habang papalya ang Call my webhook step at magpapadala sa inyo ng email. Hindi rin mabasa ng doPost ang request header, kaya imposible roon ang pagsusuri ng X-EC-Signature.
Nananatiling mahusay na akma ang Apps Script sa kabilang direksyon, ang pagpapadala ng mga naaprubahang template mula sa mga row ng sheet, na sakop ng Google Sheets integration page gamit ang code.
Puwede bang punan ng Make o Zapier ang sheet sa halip?
Oo. Sa Make, simulan ang scenario sa Webhooks > Custom webhook at idagdag ang Google Sheets > Add a Row; sa Zapier, gamitin ang Webhooks by Zapier na may Catch Raw Hook, na nagpapanatili ng mga header, saka ang Google Sheets > Create Spreadsheet Row. Parehong sumasagot agad ng 2xx sa POST, na kailangan ng forward sa loob ng 10 segundo. I-map ang parehong field gaya ng nasa itaas mula sa value.messages, at i-filter palabas ang mga event na ang value ay may statuses sa halip na messages.
Ituring na password ang hook URL, dahil sinumang may hawak nito ay makapag-post ng row. Kung kasama sa plan ninyo ang code step, i-check doon ang X-EC-Signature gamit ang parehong HMAC recipe na ginamit sa n8n node.
Paano maiiwasan ang duplicate o nawawalang row?
Galing sa retry ang mga duplicate. Ang forward na hindi nakakuha ng 2xx sa loob ng 10 segundo ay ipinapadalang muli na may parehong X-EC-Delivery header at parehong id sa body, at nananatili ang wamid ng mga mensaheng nasa loob, kaya ang pagtutugma sa Message id ay ginagawang hindi nakakasama ang retry. Sa route ng webhook step, ang mga test mula sa Try it ay dumarating na may dry_run true: ipadala ang mga ito sa test tab o itapon.
Galing sa write quota ng Google ang mga nawawalang row. Pinapayagan ng Sheets API ang 60 write request kada minuto kada user kada project, at ang isang n8n credential ay isang user; maaaring lumampas dito ang biglaang dagsa ng reply pagkatapos ng template campaign at magresulta sa HTTP 429. I-on ang Retry On Fail sa settings ng Google Sheets node, o mag-ipon ng mga mensahe nang ilang segundo at i-append ang mga ito sa isang request.
Paano ito i-set up
- 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.
Mga karaniwang pagkakamali
- Pagsusuri sa forward gamit ang Signing secret ng automation, o kabaligtaran. Pinipirmahan ang Forward URL ng forward secret ng numero, at ang Call my webhook ng sariling secret ng automation; piliin ang secret ayon sa X-EC-Event header.
- Pagdaragdag ng row kada POST nang walang key. Ang delivery na inulit matapos ang mabagal na sagot ay magsusulat ng parehong mensahe nang dalawang beses; gamitin ang Append or Update Row na itinutugma sa message id.
- Pagsusulat ng delivery status bilang mensahe. Ang messages event ay may dalang sent, delivered at read status sa value.statuses, na walang text at lumilikha ng mga walang lamang row.
- Pag-save ng Apps Script web app URL bilang Forward URL. Ang redirect nito ay binibilang na pagkabigo, kaya ang bawat isa sa 7 attempt ay papatakbo muli ng doPost at magdaragdag ng duplicate na row.
Kapag naka-on ang automation, ipinapasa ng Forward URL ang orihinal na event ng Meta papunta sa inyong workflow, pinipirmahan ng isang secret na kayo lang ang may hawak at inuulit kapag down ang inyong URL, at ipinapadala ng Call my webhook step ang hinawakan ng isang automation, kasama ang reply nito. Kasama ang dalawa sa plan. Mula US$ 9 kada naka-connect na numero kada buwan, bumababa hanggang US$ 0.75 habang dumarami ang numero, at may unang 3 araw na libre.
Mga madalas itanong
Nakukuha ba ng sheet ang mga mensaheng itina-type ng team ninyo sa telepono?
Oo, sa pamamagitan ng Forward URL. Dumarating ang mga reply na itina-type sa WhatsApp Business app bilang smb_message_echoes event, na may numero ng customer sa to. Ang mga reply na ipinadala ng automation ay bumabalik lamang bilang delivery status, kaya i-log ang text nito mula sa Call my webhook step na nakalagay pagkatapos ng reply.
Puwede bang i-load ang mga umiiral na chat sa sheet?
Hindi sa numerong ang mga mensahe ay dumadaan sa easyCoexistence. Ipinapadala ng Meta ang hanggang 6 na buwang one-to-one na chat lamang sa isang direct webhook destination na na-save sa loob ng 24 oras mula nang i-connect, isang beses kada koneksyon. Ang numerong dumadaan sa easyCoexistence ay nagla-log mula sa sandaling na-save ang Forward URL.
Itinatago ba ng easyCoexistence ang kopya ng mga mensahe?
Bahagya. Sa numerong dumadaan sa easyCoexistence na may naka-on na automation, pinananatili ang text ng mensahe sa panahong pipiliin ninyo, 30, 90 o 365 araw (90 bilang default), at ipinapakita ito sa Conversations; ang mga forwarded na paghahatid ay itinatago nang hanggang 7 araw para sa mga pag-ulit, at ang run log nang 30 araw. Ang sheet ang inyong permanenteng kopya.
Mababasa ba ng AI ninyo ang sheet para sumagot sa mga customer?
Hindi mula sa Reply with AI step, na tanging binabasa ang Instructions at ang chat nito. Maaaring maghanap ang isang AI agent sa pamamagitan ng custom HTTP tool, at maaaring ipadala ng Call my webhook o Call an API step ang tanong sa isang workflow na hahanapin ang sagot sa sheet at ibabalik ito bilang reply.
Magpatuloy sa pagbabasa
Handa na po ba kayong magsimula?
I-set up ang WhatsApp Coexistence sa loob ng ilang minuto, hindi buwan. Patuloy na gumagana ang app sa telepono.
Magsimula ng Libreng TrialNa-verify noong