WhatsApp පණිවිඩ සහ සම්පර්ක Google Sheets වෙත ස්වයංක්රීයව සුරකින්න
WhatsApp Business පණිවිඩ Google Sheets වෙත ස්වයංක්රීයව සුරැකීමට, ඒවා signed HTTP POST ලෙස n8n, Make හෝ Zapier වැනි automation tool එකකට යවන්න. එහි Google Sheets පියවර මගින් පණිවිඩයකට එක පේළියක් එක් කරයි: වේලාව, දිශාව, දුරකථන අංකය, නම, පෙළ සහ පණිවිඩ අංකය. අංකය මත යතුරු කළ දෙවන tab එකක් එක් සම්පර්කයකට එක පේළියක් තබයි, ඔවුන් නැවත ලියන විට එය යාවත්කාලීන වේ.
easyCoexistence ඔබ යෙදුමේ තබා ගන්නා WhatsApp Business අංකය Coexistence හරහා Meta හි Cloud API වෙත සම්බන්ධ කරයි.
ඔබේ URL අසාර්ථක වුවහොත් forward කළ deliveries මිනිත්තු 1, 5, 30, 120, 360 සහ 1,440 පසු නැවත උත්සාහ කරයි.
forward කළ POST එකක් 2xx පිළිතුරක් බලාපොරොත්තුවෙන් රැඳී සිටින කාලය, ඉන් පසු delivery නැවත උත්සාහ කෙරේ.
Google Sheets API write ඉල්ලීම් මිනිත්තුවකට, එක් user කෙනෙකුට සහ එක් project එකකට අවසර ඇත; project එකකට 300.
Apps Script web app output එක script.googleusercontent.com හි එක් වරක් භාවිත URL එකකට redirect කෙරේ.
Apps Script හි doPost event object මගින් body සහ parameters පමණක් ලබා දෙයි, HTTP request headers නොවේ.
sheet එක පුරවන්නේ කුමන මාර්ගයද?
පණිවිඩ easyCoexistence හරහා පැමිණෙන අංකයක් මත මාර්ග දෙකක් ඇති අතර ඒවා වෙනස් අවශ්යතා සපුරයි. Forward URL එක, අංකයකට එක් වරක් සකසයි, automation එකක් පිළිතුරු දුනත් නොදුනත් Meta හි මුල් events යවයි: ගනුදෙනුකරුවන්ගේ පණිවිඩ, ඔබේ කණ්ඩායම WhatsApp Business app එකේ ටයිප් කරන පිළිතුරු සහ delivery statuses. සම්පූර්ණ පණිවිඩ ලොගයක් සඳහා එය මාර්ගයයි. automation එකක් තුළ ඇති Call my webhook පියවර ක්රියාත්මක වන්නේ එම automation තෝරාගන්නා පණිවිඩ සඳහා පමණි, ඒ වගේම එය automation එක යැවූ පිළිතුර ඇතුළුව මෑත චැට් එක රැගෙන යයි. එක් automation එකක් හසුරුවන leads, orders හෝ requests පේළි සඳහා එය සුදුසුය. දෙකම අත්සන් කර ඇති අතර, විවිධ secrets සහිතය.
| 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 |
ඉන් කුමන fields පැමිණෙන්නේද, සහ sheet එකට කුමන columns තිබිය යුතුද?
forward කළ POST එකක් එක Meta change එකක් wrap කරයි: id (delivery එක), event (Meta හි field නම, උදා messages හෝ smb_message_echoes), received_at, connection (ඔබේ අංකයේ id, phone සහ phone_number_id) සහ value, Meta යැවූ ආකාරයටම. value තුළ messages මගින් ගනුදෙනුකරුවන් ලියූ දේ, message_echoes මගින් ඔබේ කණ්ඩායම දුරකථනයෙන් ටයිප් කළ දේ ගෙන එයි. දුරකථන අංක රට කේතය සමඟ ඉලක්කම් ලෙස පැමිණෙන අතර plus ලකුණක් නැත; එම column එක plain text ලෙස ගබඩා කරන්න, එවිට Sheets එය අංකයක් බවට නොපරිවර්තනය කරයි. WhatsApp username එකක් ඇති පරිශීලකයෙකු අංකය අසල හෝ ඒ වෙනුවට ව්යාපාරයට සීමා වූ user ID එකක් සමඟ පැමිණිය හැකි බැවින්, ඒ සඳහා column එකක් තබා ගන්න.
n8n හි පණිවිඩ ලොගය ගොඩනගන්නේ කෙසේද?
පියවර තුනකි. HTTP Method POST, Respond සැකසූ Immediately ලෙස සහ Production URL එක අංකයේ Forward URL ලෙස සුරකින Webhook node එකක්. X-EC-Signature forward secret සමඟ පරීක්ෂා කර event එක rows බවට හරවන, delivery statuses මඟ හරින Code node එකක්. Column to match on පණිවිඩ අංකය ලෙස සකසූ, Append හෝ Update Row operation සහිත Google Sheets node එකක්, එවිට retry කළ delivery එකක් එක් පේළියක් එකතු කරනවා වෙනුවට එම පේළිම නැවත ලියයි.
forward secret එක Forward URL එක සුරකින විට එක් වරක් පමණක් දිස්වේ; එය නැති වුවහොත්, New secret ක්ලික් කර නව secret එක ඇලවන්න. n8n Cloud හි Code nodes වල crypto module ඉඩ දෙයි; self-hosted n8n සඳහා 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 }));එක් සම්පර්කයකට එක පේළියක් තබා ගන්නේ කෙසේද?
Contacts tab එකක Google Sheets node දෙවනුව එක් කර, එයද Append හෝ Update Row සමඟ, දුරකථන අංකය මත match කරන්න. දුරකථනය, profile නම, user ID, වේලාව සහ අන්තිම පණිවිඩයේ පෙළ map කරන්න. ඔවුන්ගේ පළමු පණිවිඩය එහි පේළිය තනයි; පසුව එන ඒවා නම සහ අන්තිමට සම්බන්ධ වූ column යාවත්කාලීන කරයි, එවිට tab එක ලියා ඇති ආකාරය සහ වේලාව ලැයිස්තුවක් ලෙස ද ක්රියා කරයි. අත්ලියන ටිප්පණි වෙනම tab එකක තබා දුරකථන අංකය අනුව බලන්න, එවිට workflow එය කිසි විටෙක overwrite නොකරයි.
දුරකථනයේ address book එකේ සුරැකි සම්පර්ක මේ ආකාරයෙන් නොපැමිණේ. Meta ඒවා, මාස 6 දක්වා චැට් සමඟ, අංකය සම්බන්ධ කිරීමෙන් පැය 24ක් ඇතුළත සුරකින ලද direct webhook destination එකකට පමණක් යවයි.
Apps Script මගින් පණිවිඩ කෙලින්ම ලබා ගත හැකිද?
නිවැරදිව නොහැක, එබැවින් sheet එක ඉදිරියේ workflow tool එකක් තබන්න. Google Apps Script web app එකක response එක එක් වරක් භාවිත script.googleusercontent.com URL එකකට redirect කර serve කරයි, සහ easyCoexistence redirects අනුගමනය නොකරයි. 302 අසාර්ථක delivery ලෙස ගණන් ගැනේ: forward එකක් උපරිම 7 වතාවක් නැවත උත්සාහ කෙරෙන අතර, සෑම retry එකක්ම doPost නැවත ක්රියාත්මක කර තවත් පේළියක් ලියයි, Call my webhook පියවරක් අසාර්ථක වී ඔබට email එකක් යවයි. doPost ට request headers කියවිය නොහැක, එබැවින් එහි X-EC-Signature පරීක්ෂාව කළ නොහැක.
Apps Script තවමත් අනෙක් දිශාව සඳහා හොඳ ගැළපීමකි: sheet එකේ පේළිවලින් අනුමත template යැවීම, ඒ ගැන Google Sheets integration පිටුව කේතය සමඟ ආවරණය කරයි.
නැවත උත්සාහයන් නිසා පේළි දෙගුණ වීම වළක්වන්නේ කෙසේද?
දෙගුණ පේළි එන්නේ retries වලින්. 2xx එකක් තත්පර 10ක් ඇතුළත නොලැබුණු forward එකක් එම X-EC-Delivery header සහ body එකේ එම id සමඟ නැවත යවයි, ඒ ඇතුළත ඇති පණිවිඩවල wamid එලෙසම පවතී, එබැවින් පණිවිඩ අංකය මත match කිරීම retry එක හානිකර නොකරයි. Webhook-step මාර්ගයේ, Try it වෙතින් පරීක්ෂණ dry_run true සමඟ පැමිණෙයි: ඒවා test tab එකකට යොමු කරන්න හෝ අතහරින්න.
පේළි අතුරුදහන් වන්නේ ඇයි, එය නිවැරදි කරන්නේ කෙසේද?
අතුරුදහන් පේළි එන්නේ Google හි write quota නිසාය. Sheets API එක project එකකට එක් user කෙනෙකුට මිනිත්තුවකට write ඉල්ලීම් 60ක් පමණක් ඉඩ දෙන අතර, එක n8n credential එකක් එක user එකකි; template campaign එකකින් පසු පිළිතුරු පිපිරීමක් එය ඉක්මවා HTTP 429 ලබා දිය හැක. Google Sheets node එකේ සැකසුම් හි Retry On Fail සක්රිය කරන්න, නැතහොත් තත්පර කිහිපයක් පණිවිඩ එකතු කර ඒවා එක ඉල්ලීමකින් append කරන්න.
එය සකසන ආකාරය
- 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.
සාමාන්ය වැරදි
- forward එකක් automation එකේ Signing secret සමඟ පරීක්ෂා කිරීම, හෝ ප්රතිලෝමය. Forward URL එක අංකයේ forward secret සමඟ අත්සන් කර ඇති අතර Call my webhook එක automation එකේම secret එකකින් අත්සන් කර ඇත; secret එක X-EC-Event header මගින් තෝරන්න.
- Key එකක් නැතිව POST එකකට පේළියක් එකතු කිරීම. මන්දගාමී පිළිතුරකින් පසු retry කළ delivery එකක් එම පණිවිඩය දෙවරක් ලියයි; පණිවිඩ අංකය මත match කරන Append හෝ Update Row භාවිත කරන්න.
- Delivery statuses පණිවිඩ ලෙස ලිවීම. messages event එකේ value.statuses තුළ sent, delivered සහ read statuses ද ඇත, ඒවාට text නැති අතර හිස් පේළි සාදයි.
- Apps Script web app URL එකක් Forward URL ලෙස සුරැකීම. එහි redirect එක අසාර්ථකතාවක් ලෙස ගණන් ගැනේ, එබැවින් උත්සාහ 7 න් සෑම එකක්ම doPost නැවත ක්රියාත්මක කර අනුපිටපත් පේළියක් එකතු කරයි.
automations සක්රිය විට, Forward URL එක Meta හි මුල් events ඔබේ workflow වෙත යවන අතර, ඒවා ඔබ පමණක් දන්නා secret එකකින් අත්සන් කර, ඔබේ URL බිඳ වැටුණු විට නැවත උත්සාහ කරයි; Call my webhook පියවර automation එක හසුරුවූ දේ, එහි පිළිතුර සමඟ යවයි. දෙකම සැලසුමට ඇතුළත් වේ. US$ 9 සිට US$ 0.75 දක්වා, එක් අංකයකට මාසිකව, අංක එකතු කරන විට අඩු වේ, පළමු දින 3ක නොමිලේ trial කාලය සහිතව.
නිතර අසන ප්රශ්න
මගේ කණ්ඩායම දුරකථනයෙන් ටයිප් කරන පණිවිඩ sheet එකට ලැබේද?
ඔව්, Forward URL හරහා. WhatsApp Business app එකේ ටයිප් කරන පිළිතුරු smb_message_echoes events ලෙස පැමිණෙන අතර, ගනුදෙනුකරුගේ අංකය to තුළ ඇත. automations මගින් යවන පිළිතුරු delivery statuses ලෙස පමණක් ආපසු පැමිණේ, එබැවින් ඒවායේ පෙළ, පිළිතුර ඉදිරියේ තබන Call my webhook පියවරකින් ලොග කරන්න.
මගේ දැනට ඇති චැට් sheet එකට පටවාගත හැකිද?
පණිවිඩ easyCoexistence හරහා පැමිණෙන අංකයක නොහැක. Meta මාස 6 දක්වා one-to-one චැට් එකම direct webhook destination එකකට පමණක් යවයි, එය සම්බන්ධතාවයට පැය 24ක් ඇතුළත සුරකින ලද, සම්බන්ධතාවයකට එක් වරක්. easyCoexistence හරහා යොමු කරන ලද අංකයක් Forward URL සුරකින මොහොතේ සිට ලොග කරයි.
easyCoexistence පණිවිඩවල පිටපතක් තබා ගන්නේද?
අර්ධවශයෙන්. easyCoexistence හරහා යොමු කරන, automations සක්රිය අංකයක, පණිවිඩ පෙළ ඔබ තෝරන කාලය සඳහා, දින 30, 90 හෝ 365ක් (පෙරනිමිය 90), තබා ගන්නා අතර Conversations හි පෙන්වයි; forward කළ බෙදාහැරීම් නැවත උත්සාහ කිරීම සඳහා දින 7 දක්වා තබා ගන්නා අතර, run logs දින 30ක් තබයි. sheet එක ඔබේ ස්ථිර පිටපතයි.
මගේ AI හට ගනුදෙනුකරුවන්ට පිළිතුරු දීමට sheet එක කියවිය හැකිද?
Reply with AI පියවරෙන් නොහැක, එය කියවන්නේ එහි Instructions සහ චැට් එක පමණි. AI agent කෙනෙකුට custom HTTP tool එකක් හරහා දේවල් සොයා බැලිය හැක, සහ Call my webhook හෝ Call an API පියවරකට ප්රශ්නය workflow එකකට යැවිය හැක, එය sheet එකේ පිළිතුර සොයා එය reply ලෙස ආපසු ලබා දෙයි.
තවදුරටත් කියවන්න
ආරම්භ කිරීමට සූදානම්ද?
WhatsApp Coexistence මිනිත්තු කිහිපයකින් සකසන්න, මාස ගණනකින් නොව. යෙදුම දුරකථනයේ දිගටම ක්රියා කරයි.
නොමිලේ trial කාලය ආරම්භ කරන්නසත්යාපනය කළේ