Hifadhi ujumbe na anwani za WhatsApp kwenye Google Sheets kiotomatiki
Ili kuhifadhi ujumbe wa WhatsApp Business kwenye Google Sheets kiotomatiki, tuma kama HTTP POST zilizosainiwa kwenda zana ya otomatiki kama n8n, Make au Zapier, kisha acha hatua yake ya Google Sheets iongeze safu moja kwa kila ujumbe: muda, mwelekeo, nambari ya simu, jina, maandishi na kitambulisho cha ujumbe. Kichupo cha pili kinachotumia nambari ya simu kama ufunguo kinahifadhi safu moja kwa kila anwani, kinachosasishwa mteja anapoandika tena.
easyCoexistence inaunganisha nambari ya WhatsApp Business unayohifadhi kwenye programu na Cloud API ya Meta kupitia Coexistence.
Uwasilishaji uliosambazwa hujaribiwa tena baada ya takriban dakika 1, 5, 30, 120, 360 na 1,440 endapo URL yako itashindwa.
Muda ambao POST iliyosambazwa husubiri jibu la 2xx kabla uwasilishaji huo kujaribiwa tena.
Maombi ya kuandika kwenye Google Sheets API yanayoruhusiwa kwa dakika, kwa kila mtumiaji, kwa kila mradi; 300 kwa kila mradi.
Matokeo ya programu ya wavuti ya Apps Script yanaelekezwa kwenye URL ya mara moja kwenye script.googleusercontent.com.
Tukio la doPost la Apps Script linaonyesha mwili na vigezo, si vichwa vya ombi la HTTP.
Ni njia gani inapaswa kujaza jedwali?
Kuna njia mbili kwenye nambari ambayo ujumbe wake hupitia easyCoexistence, na zinajibu mahitaji tofauti. Forward URL, inayowekwa mara moja kwa kila nambari, hupitisha matukio halisi ya Meta iwe otomatiki inajibu au la: ujumbe wa wateja, majibu unayoandika timu yako kwenye programu ya WhatsApp Business, na hali za uwasilishaji. Ni njia ya kumbukumbu kamili ya ujumbe. Hatua ya Call my webhook ndani ya otomatiki huwashwa kwa ujumbe ambao otomatiki hiyo huuchagua pekee, na hubeba mazungumzo ya hivi karibuni, pamoja na jibu ambalo otomatiki imelituma. Inafaa kwa jedwali la wateja watarajiwa, oda au maombi ambayo otomatiki moja inayashughulikia. Njia zote mbili zimesainiwa, lakini kila moja ina siri yake tofauti.
| 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 |
Ni sehemu gani zinafika, na jedwali linapaswa kuwa na safu gani?
POST iliyosambazwa hufunga mabadiliko moja ya Meta: id (uwasilishaji), event (jina la sehemu la Meta, kama messages au smb_message_echoes), received_at, connection (muunganisho wa nambari yako, wenye phone na phone_number_id) na value, kama Meta ilivyotuma. Ndani ya value, messages hubeba kile wateja waliandika, na message_echoes hubeba kile timu yako iliandika kwenye simu. Nambari za simu hufika kama tarakimu zenye msimbo wa nchi na bila alama ya plus; hifadhi safu hiyo kama maandishi tupu ili Sheets isibadilishe kuwa nambari. Mtumiaji mwenye jina la mtumiaji la WhatsApp anaweza kufika na user ID ya upeo wa biashara pamoja na nambari, au badala yake, kwa hiyo weka safu kwa ajili yake.
Je, unajengaje kumbukumbu ya ujumbe kwenye n8n?
Nodi tatu. Nodi ya Webhook yenye HTTP Method POST, Respond imewekwa Immediately, na Production URL yake imehifadhiwa kama Forward URL ya nambari. Nodi ya Code inayokagua X-EC-Signature kwa siri ya forward na kugeuza tukio kuwa safu, ikiruka hali za uwasilishaji. Nodi ya Google Sheets yenye operesheni Append au Update Row, na Column to match on imewekwa kwenye kitambulisho cha ujumbe, ili uwasilishaji uliojaribiwa tena uandike upya safu ile ile badala ya kuongeza mpya.
Siri ya forward inaonekana mara moja, unapohifadhi Forward URL; ikipotea, bofya New secret na ubandike mpya. n8n Cloud inaruhusu moduli ya crypto kwenye nodi za Code; n8n ya kujiendesha yenyewe inahitaji 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 }));Unawekaje safu moja kwa kila anwani?
Ongeza nodi ya pili ya Google Sheets kwenye kichupo cha Contacts, pia na Append au Update Row, ikilinganishwa kwenye Phone. Weka simu, jina la wasifu, user ID, muda na maandishi ya ujumbe wa hivi karibuni. Ujumbe wa kwanza kutoka kwa nambari huunda safu yake; ujumbe unaofuata husasisha jina na safu za mawasiliano ya mwisho, hivyo kichupo hufanya kazi pia kama orodha ya nani aliandika na lini. Weka madokezo yaliyoandikwa kwa mkono kwenye kichupo tofauti, yakitafutwa kwa simu, ili mtiririko wa kazi usiwahi kuyafuta.
Anwani zilizohifadhiwa kwenye kitabu cha anwani cha simu hazifiki kwa njia hii. Meta huzituma, pamoja na mazungumzo ya hadi miezi 6, kwa lengwa la moja kwa moja la webhook lililohifadhiwa ndani ya saa 24 tangu nambari ilipounganishwa.
Je, Apps Script inaweza kupokea ujumbe moja kwa moja?
Sio kwa uhakika, kwa hiyo weka zana ya mtiririko wa kazi mbele ya jedwali. Google huhudumia jibu la programu ya wavuti ya Apps Script kupitia uelekezaji kwenye URL ya mara moja ya script.googleusercontent.com, na easyCoexistence haifuati uelekezaji. Jibu la 302 linahesabiwa kama uwasilishaji ulioshindwa: uwasilishaji hujaribiwa tena hadi mara 7, na kila jaribio huendesha doPost tena na kuandika safu nyingine, wakati hatua ya Call my webhook inashindwa na kukutumia barua pepe. doPost pia haiwezi kusoma vichwa vya ombi, kwa hiyo ukaguzi wa X-EC-Signature hauwezekani hapo.
Apps Script bado inafaa kwa mwelekeo mwingine, yaani kutuma kiolezo kilichoidhinishwa kutoka safu za jedwali, ambalo ukurasa wa muunganisho wa Google Sheets unalifafanua kwa msimbo.
Make au Zapier zinaweza kujaza jedwali badala yake?
Ndiyo. Kwenye Make, anzisha scenario kwa Webhooks > Custom webhook kisha ongeza Google Sheets > Add a Row; kwenye Zapier, tumia Webhooks by Zapier na Catch Raw Hook, inayohifadhi vichwa, kisha Google Sheets > Create Spreadsheet Row. Zote mbili hujibu POST papo hapo kwa 2xx, jambo ambalo uwasilishaji unahitaji ndani ya sekunde 10. Weka sehemu zile zile kama hapo juu kutoka value.messages, na chuja matukio ambayo value yake ina statuses badala ya messages.
Chukulia URL ya hook kama nenosiri, kwani yeyote mwenye nayo anaweza kutuma safu. Ikiwa mpango wako unajumuisha hatua ya msimbo, kagua X-EC-Signature hapo kwa mapishi yale yale ya HMAC yaliyotumika kwenye nodi ya n8n.
Unaepukaje safu zilizorudiwa au zilizokosekana?
Marudio hutokana na majaribio upya. Uwasilishaji ambao haukupata 2xx ndani ya sekunde 10 hutumwa tena na kichwa kile kile X-EC-Delivery na id ile ile mwilini, na ujumbe ulio ndani unabaki na wamid yake, kwa hiyo kulinganisha kwenye kitambulisho cha ujumbe kunafanya jaribio upya lisiwe na madhara. Kwenye njia ya hatua ya webhook, majaribio kutoka Try it hufika yakiwa na dry_run true: yaelekeze kwenye kichupo cha majaribio au yatupe.
Safu zinazokosekana hutokana na kikomo cha uandishi cha Google. Sheets API inaruhusu maombi 60 ya kuandika kwa dakika kwa kila mtumiaji kwa kila mradi, na kitambulisho kimoja cha n8n ni mtumiaji mmoja; mlipuko wa majibu baada ya kampeni ya kiolezo unaweza kuvuka kikomo na kupata HTTP 429. Washa Retry On Fail kwenye mipangilio ya nodi ya Google Sheets, au kusanya ujumbe kwa sekunde chache kisha uziongeze kwa ombi moja.
Jinsi ya kuisanidi
- 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.
Makosa ya kawaida
- Kukagua uwasilishaji kwa Signing secret ya otomatiki, au kinyume chake. Forward URL husainiwa kwa forward secret ya nambari na Call my webhook kwa siri ya otomatiki yenyewe; chagua siri kwa kutumia kichwa cha X-EC-Event.
- Kuongeza safu moja kwa kila POST bila ufunguo. Uwasilishaji uliojaribiwa tena baada ya jibu la polepole huandika ujumbe uleule mara mbili; tumia Append au Update Row inayolingana na kitambulisho cha ujumbe.
- Kuandika hali za uwasilishaji kama ujumbe. Tukio la messages pia hubeba hali za sent, delivered na read kwenye value.statuses, ambazo hazina maandishi na huunda safu tupu.
- Kuhifadhi URL ya programu ya wavuti ya Apps Script kama Forward URL. Uelekezaji wake huhesabiwa kama kushindwa, kwa hiyo kila jaribio kati ya 7 huendesha doPost tena na kuongeza safu inayorudiwa.
Otomatiki ikiwashwa, Forward URL hupitisha matukio halisi ya Meta kwenda mtiririko wako wa kazi, yakisainiwa kwa siri ambayo wewe pekee unayo na kujaribiwa tena URL yako ikiwa chini, na hatua ya Call my webhook hutuma kile otomatiki ilichoshughulikia, pamoja na jibu lake. Zote mbili zimejumuishwa kwenye mpango. Kuanzia US$ 9 hadi US$ 0.75 kwa kila nambari iliyounganishwa kwa mwezi, inashuka kadri unavyoongeza nambari, na siku 3 za kwanza bila malipo.
Maswali yanayoulizwa mara kwa mara
Je, jedwali hupokea ujumbe ambao timu yangu inaandika kwenye simu?
Ndiyo, kupitia Forward URL. Majibu yanayoandikwa kwenye programu ya WhatsApp Business hufika kama matukio ya smb_message_echoes, yakiwa na nambari ya mteja kwenye to. Majibu yanayotumwa na otomatiki hurudi kama hali za uwasilishaji pekee, kwa hiyo rekodi maandishi yake kutoka kwenye hatua ya Call my webhook iliyowekwa baada ya jibu.
Naweza kupakia mazungumzo yangu yaliyopo kwenye jedwali?
Si kwenye nambari ambayo ujumbe wake hupitia easyCoexistence. Meta hutuma mazungumzo ya mtu mmoja mmoja ya hadi miezi 6 kwa lengwa la moja kwa moja la webhook pekee, lililohifadhiwa ndani ya saa 24 tangu kuunganisha, mara moja kwa kila muunganisho. Nambari inayopitishwa kupitia easyCoexistence hurekodi kuanzia wakati Forward URL inapohifadhiwa.
Je, easyCoexistence huhifadhi nakala ya ujumbe?
Kwa sehemu. Kwenye nambari inayopita kwenye easyCoexistence yenye otomatiki zimewashwa, maandishi ya ujumbe huhifadhiwa kwa muda unaouchagua, siku 30, 90 au 365 (siku 90 kwa chaguo-msingi), na huonyeshwa kwenye Conversations; uwasilishaji uliosambazwa hushikiliwa hadi siku 7 kwa kujaribu upya, na kumbukumbu za uendeshaji siku 30. Jedwali ndiyo nakala yako ya kudumu.
Je, AI yangu inaweza kusoma jedwali kujibu wateja?
Si kutoka kwenye hatua ya Reply with AI, inayosoma Instructions yake na mazungumzo pekee. Wakala wa AI anaweza kutafuta mambo kupitia zana maalum ya HTTP, na hatua ya Call my webhook au Call an API inaweza kutuma swali kwenye mtiririko wa kazi unaotafuta jibu kwenye jedwali na kulirudisha kama jibu.
Endelea kusoma
Uko tayari kuanza?
Sanidi WhatsApp Coexistence kwa dakika chache, si miezi. Programu inaendelea kufanya kazi kwenye simu.
Anza kipindi cha majaribio bila malipoImethibitishwa kwenye