WhatsApp மெசேஜ்களையும் தொடர்புகளையும் தானாக Google Sheets-இல் சேமிக்கவும்
WhatsApp Business மெசேஜ்களை Google Sheets-இல் தானாக சேமிக்க, அவற்றை n8n, Make அல்லது Zapier போன்ற ஆட்டோமேஷன் கருவிக்கு கையொப்பமிட்ட HTTP POST அனுப்புங்கள். அதன் Google Sheets படி ஒவ்வொரு மெசேஜுக்கும் ஒரு வரியைச் சேர்க்கும்: நேரம், திசை, தொலைபேசி எண், பெயர், உரை மற்றும் `message id`. தொலைபேசி எண்ணை அடிப்படையாகக் கொண்ட இரண்டாவது டேப் ஒவ்வொரு தொடர்புக்கும் ஒரு வரியை வைத்திருக்கும், அவர்கள் மீண்டும் எழுதும்போது அது புதுப்பிக்கப்படும்.
easyCoexistence, நீங்கள் ஆப்பில் வைத்திருக்கும் WhatsApp Business எண்ணை Coexistence வழியாக Meta-வின் Cloud API-உடன் இணைக்கிறது.
உங்கள் URL தோல்வியடையும்போது, ஃபார்வர்டு செய்யப்பட்ட டெலிவரிகள் சுமார் 1, 5, 30, 120, 360 மற்றும் 1,440 நிமிடங்களுக்குப் பிறகு மீண்டும் முயற்சிக்கப்படும்.
2xx பதிலுக்காக ஃபார்வர்டு செய்யப்பட்ட POST எவ்வளவு நேரம் காத்திருக்கும், அதன் பிறகே அந்த டெலிவரி மீண்டும் முயற்சிக்கப்படும்.
Google Sheets API எழுதும் கோரிக்கைகள்: ஒரு பயனருக்கு, ஒரு ப்ராஜெக்டில் நிமிடத்திற்கு அனுமதிக்கப்படும்; ஒரு ப்ராஜெக்டுக்கு 300.
Apps Script வெப் ஆப்ஸ் வெளியீடு script.googleusercontent.com-இல் உள்ள ஒருமுறை மட்டும் பயன்படும் URL-க்கு திருப்பிவிடப்படுகிறது.
Apps Script-இன் doPost நிகழ்வுப் பொருள் உடலையும் அளவுருக்களையும் வெளிப்படுத்தும், HTTP கோரிக்கைத் தலைப்புகளை அல்ல.
எந்த வழி ஷீட்டை நிரப்ப வேண்டும்?
மெசேஜ்கள் easyCoexistence வழியாக வரும் ஒரு எண்ணில் இரண்டு வழிகள் உள்ளன, அவை வெவ்வேறு தேவைகளுக்குப் பதிலளிக்கின்றன. ஒரு எண்ணுக்கு ஒருமுறை அமைக்கப்படும் `Forward URL`, ஒரு ஆட்டோமேஷன் பதிலளிக்கிறதா இல்லையா என்பதைப் பொருட்படுத்தாமல் Meta-வின் அசல் நிகழ்வுகளை அனுப்புகிறது: வாடிக்கையாளர் மெசேஜ்கள், WhatsApp Business ஆப்பில் உங்கள் குழு தட்டச்சு செய்யும் பதில்கள் மற்றும் டெலிவரி ஸ்டேட்டஸ்கள். முழு மெசேஜ் பதிவுக்கு இதுவே வழி. ஒரு ஆட்டோமேஷனுக்குள் உள்ள `Call my webhook` படி, அந்த ஆட்டோமேஷன் தேர்ந்தெடுக்கும் மெசேஜ்களுக்கு மட்டுமே இயங்கும், மேலும் அது அனுப்பிய பதில் உட்பட அண்மைய உரையாடலைக் கொண்டிருக்கும். ஒரு ஆட்டோமேஷன் கையாளும் லீடுகள், ஆர்டர்கள் அல்லது கோரிக்கைகளின் ஷீட்டுக்கு இது பொருந்தும். இரண்டும் கையொப்பமிடப்பட்டவை, ஆனால் வெவ்வேறு ரகசியங்களுடன்.
| 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 |
எந்தப் புலங்கள் வருகின்றன, ஷீட்டில் எந்த நெடுவரிசைகள் இருக்க வேண்டும்?
ஃபார்வர்டு செய்யப்பட்ட POST ஒரு Meta மாற்றத்தை உறையாக்குகிறது: `id` (டெலிவரி), `event` (Meta-வின் புலப் பெயர், எடுத்துக்காட்டாக `messages` அல்லது `smb_message_echoes`), `received_at`, `connection` (உங்கள் எண்ணின் ஐடி, `phone` மற்றும் `phone_number_id`) மற்றும் `value`, Meta அனுப்பியபடியே. `value`-இல், `messages` வாடிக்கையாளர்கள் எழுதியதை வைத்திருக்கும், `message_echoes` உங்கள் குழு தொலைபேசியில் தட்டச்சு செய்ததை வைத்திருக்கும். தொலைபேசி எண்கள் நாட்டுக் குறியீட்டுடன் இலக்கங்களாக வரும், `+` குறி இல்லாமல்; அந்த நெடுவரிசையை சாதாரண உரையாகச் சேமிக்கவும், இல்லையெனில் Sheets அதை எண்ணாக மாற்றிவிடும். WhatsApp பயனர்பெயர் கொண்ட பயனர் எண்ணுடன் அல்லது எண்ணுக்குப் பதிலாக வணிக அளவிலான பயனர் ID உடன் வரலாம், எனவே அதற்கும் ஒரு நெடுவரிசையை வைத்திருங்கள்.
n8n-இல் மெசேஜ் பதிவை எப்படி உருவாக்குவது?
மூன்று நோடுகள். `Method` POST, `Respond` Immediately என அமைக்கப்பட்ட வெப்ஹூக் நோடு, அதன் `Production URL` எண்ணின் `Forward URL`-ஆகச் சேமிக்கப்பட்டது. `X-EC-Signature`-ஐ forward secret உடன் சரிபார்த்து நிகழ்வை வரிகளாக மாற்றும் Code நோடு, டெலிவரி ஸ்டேட்டஸ்களைத் தவிர்க்கும். `Append or Update Row` செயல்பாடும், `Column to match on` `Message id` என அமைக்கப்பட்ட Google Sheets நோடும்; இதனால் மீண்டும் முயற்சிக்கப்பட்ட டெலிவரி புதிய வரி சேர்க்காமல் அதே வரியை மீண்டும் எழுதும்.
Forward secret தோன்றுவது ஒருமுறை மட்டும், `Forward URL`-ஐ சேமிக்கும்போது; அது தொலைந்தால், `New secret` என்பதைக் கிளிக் செய்து புதியதை ஒட்டவும். n8n Cloud, Code நோடுகளில் crypto மாட்யூலை அனுமதிக்கிறது; சொந்த சர்வரில் இயங்கும் 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 டேப்பில் இரண்டாவது Google Sheets நோடைச் சேர்க்கவும், அதுவும் `Append or Update Row`, `Phone`-இல் பொருத்தப்பட்டது. தொலைபேசி, சுயவிவரப் பெயர், பயனர் ID, நேரம் மற்றும் கடைசி மெசேஜின் உரை ஆகியவற்றை வரைபடமாக்கவும். ஒரு எண்ணிலிருந்து முதல் மெசேஜ் அதன் வரியை உருவாக்கும்; பின்னர் வரும் மெசேஜ்கள் பெயர் மற்றும் கடைசித் தொடர்பு நெடுவரிசைகளைப் புதுப்பிக்கும், இதனால் அந்த டேப் யார் எப்போது எழுதினார்கள் என்பதற்கான பட்டியலாகவும் செயல்படும். கையால் எழுதிய குறிப்புகளை தனி டேப்பில் வைத்து, தொலைபேசி மூலம் தேடவும், இதனால் பணிப்பாய்வு அவற்றை ஒருபோதும் மேலெழுதாது.
தொலைபேசியின் முகவரிப் புத்தகத்தில் சேமிக்கப்பட்ட தொடர்புகள் இந்த வழியில் வராது. அவற்றை Meta அனுப்புகிறது, அதிகபட்சம் 6 மாத அரட்டைகளுடன், எண்ணை இணைத்த 24 மணி நேரத்திற்குள் சேமிக்கப்பட்ட நேரடி வெப்ஹூக் இலக்குக்கு மட்டுமே.
Apps Script நேரடியாக மெசேஜ்களைப் பெற முடியுமா?
சரியாக முடியாது, எனவே ஷீட்டுக்கு முன்னால் ஒரு பணிப்பாய்வு கருவியை வைக்கவும். Google, Apps Script வெப் ஆப்ஸின் பதிலை ஒருமுறை மட்டும் பயன்படும் script.googleusercontent.com URL-க்கு திருப்பிவிடுவதன் மூலம் வழங்குகிறது, மேலும் easyCoexistence திருப்பிவிடல்களைப் பின்பற்றாது. அந்த 302, தோல்வியடைந்த டெலிவரியாகக் கணக்கிடப்படும்: ஃபார்வர்டு 7 முறை வரை மீண்டும் முயற்சிக்கப்படும், ஒவ்வொரு மறுமுயற்சியும் doPost-ஐ மீண்டும் இயக்கி மற்றொரு வரியை எழுதும், `Call my webhook` படி தோல்வியடைந்து உங்களுக்கு மின்னஞ்சல் அனுப்பும். doPost கோரிக்கைத் தலைப்புகளையும் படிக்க முடியாது, எனவே அங்கே `X-EC-Signature` சரிபார்ப்பு சாத்தியமில்லை.
Apps Script இன்னும் மற்ற திசைக்கு நல்ல பொருத்தம், அதாவது ஷீட்டின் வரிசைகளிலிருந்து அங்கீகரிக்கப்பட்ட டெம்ப்ளேட்களை அனுப்புவது; அதை Google Sheets ஒருங்கிணைப்புப் பக்கம் குறியீட்டுடன் விளக்குகிறது.
Make அல்லது Zapier ஷீட்டை நிரப்ப முடியுமா?
ஆம். Make-இல், சினாரியோவை `Webhooks > Custom webhook` உடன் தொடங்கி `Google Sheets > Add a Row` சேர்க்கவும்; Zapier-இல், `Catch Raw Hook` உடன் Webhooks by Zapier பயன்படுத்தவும், அது தலைப்புகளை வைத்திருக்கும், பின்னர் `Google Sheets > Create Spreadsheet Row`. இரண்டுமே POST-க்கு உடனடியாக 2xx பதில் அளிக்கும், அது ஃபார்வர்டுக்கு 10 வினாடிகளுக்குள் தேவை. மேலே உள்ள அதே புலங்களை `value.messages`-இலிருந்து வரைபடமாக்கவும், `value`-இல் மெசேஜ்களுக்குப் பதிலாக `statuses` உள்ள நிகழ்வுகளை வடிகட்டவும்.
ஹூக் URL-ஐ கடவுச்சொல்லாகக் கருதுங்கள், ஏனெனில் அதை வைத்திருக்கும் எவரும் வரிகளைப் பதிவிட முடியும். உங்கள் திட்டத்தில் குறியீட்டுப் படி இருந்தால், n8n நோடில் உள்ள அதே HMAC முறையைப் பயன்படுத்தி அங்கே `X-EC-Signature`-ஐச் சரிபார்க்கவும்.
நகல் அல்லது விடுபட்ட வரிகளை எப்படித் தவிர்ப்பது?
நகல்கள் மறுமுயற்சிகளிலிருந்து வருகின்றன. 10 வினாடிகளுக்குள் 2xx கிடைக்காத ஃபார்வர்ட், அதே `X-EC-Delivery` தலைப்புடனும் உடலில் அதே `id`-உடனும் மீண்டும் அனுப்பப்படும், மேலும் உள்ள மெசேஜ்கள் தங்கள் `wamid`-ஐ வைத்திருக்கும்; எனவே `Message id`-இல் பொருத்துவது மறுமுயற்சியை பாதிப்பில்லாததாக்கும். வெப்ஹூக்-ஸ்டெப் வழியில், `Try it`-இலிருந்து வரும் சோதனைகள் `dry_run` true உடன் வரும்: அவற்றை சோதனை டேப்புக்கு அனுப்பவும் அல்லது நீக்கவும்.
விடுபட்ட வரிகள் Google-இன் எழுதும் ஒதுக்கீட்டிலிருந்து வருகின்றன. Sheets API ஒரு பயனருக்கு, ஒரு ப்ராஜெக்டுக்கு நிமிடத்திற்கு 60 எழுதும் கோரிக்கைகளை அனுமதிக்கிறது, மேலும் ஒரு n8n நற்சான்றிதழ் ஒரு பயனர்; டெம்ப்ளேட் பிரச்சாரத்திற்குப் பிறகு பதில்களின் வெடிப்பு அதை மீறி HTTP 429 பெறலாம். Google Sheets நோடின் அமைப்புகளில் `Retry On Fail`-ஐ இயக்கவும், அல்லது சில வினாடிகள் மெசேஜ்களைச் சேகரித்து ஒரே கோரிக்கையில் சேர்க்கவும.
இதை எப்படி அமைப்பது
- 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.
பொதுவான தவறுகள்
- ஃபார்வர்டை ஆட்டோமேஷனின் `Signing secret`-உடன் சரிபார்ப்பது, அல்லது தலைகீழாகச் செய்வது. Forward URL எண்ணின் forward secret-உடனும், `Call my webhook` ஆட்டோமேஷனின் சொந்த ரகசியத்துடனும் கையொப்பமிடப்படும்; `X-EC-Event` தலைப்பை வைத்து ரகசியத்தைத் தேர்ந்தெடுக்கவும்.
- விசை இல்லாமல் ஒவ்வொரு POST-க்கும் ஒரு வரியைச் சேர்ப்பது. மெதுவான பதிலுக்குப் பிறகு மீண்டும் முயற்சிக்கப்பட்ட டெலிவரி அதே மெசேஜை இருமுறை எழுதும்; `message id`-இல் பொருத்தப்பட்ட `Append or Update Row`-ஐப் பயன்படுத்தவும்.
- டெலிவரி ஸ்டேட்டஸ்களை மெசேஜ்களாக எழுதுவது. messages நிகழ்வில் `value.statuses`-இல் sent, delivered மற்றும் read ஸ்டேட்டஸ்களும் உள்ளன; அவற்றுக்கு உரை இல்லை, அவை வெற்று வரிகளை உருவாக்கும்.
- Apps Script வெப் ஆப் URL-ஐ Forward URL ஆக சேமிப்பது. அதன் திருப்பிவிடல் தோல்வியாகக் கணக்கிடப்படும், எனவே 7 முயற்சிகள் ஒவ்வொன்றும் doPost-ஐ மீண்டும் இயக்கி நகல் வரியைச் சேர்க்கும்.
ஆட்டோமேஷன்ஸ் இயக்கத்தில் இருக்கும்போது, Forward URL Meta-வின் அசல் நிகழ்வுகளை உங்கள் பணிப்பாய்வுக்கு அனுப்புகிறது, அவை உங்கள் மட்டுமே வைத்திருக்கும் ரகசியத்துடன் கையொப்பமிடப்பட்டு, உங்கள் URL செயலிழந்திருக்கும்போது மீண்டும் முயற்சிக்கப்படும்; `Call my webhook` படி ஆட்டோமேஷன் கையாண்டதை, அதன் பதிலுடன் அனுப்புகிறது. இரண்டும் திட்டத்தில் சேர்ந்தவை. ஒரு எண்ணுக்கு மாதம் US$ 9 முதல் US$ 0.75 வரை, நீங்கள் எண்ணிக்கையைச் சேர்க்கும்போது குறையும், முதல் 3 நாட்கள் இலவசம்.
அடிக்கடி கேட்கப்படும் கேள்விகள்
எனது குழு ஃபோனில் தட்டச்சு செய்யும் மெசேஜ்கள் ஷீட்டுக்கு வருமா?
ஆம், Forward URL வழியாக. WhatsApp Business ஆப்பில் தட்டச்சு செய்யப்பட்ட பதில்கள் `smb_message_echoes` நிகழ்வுகளாக வரும், `to`-இல் வாடிக்கையாளர் எண்ணுடன். ஆட்டோமேஷன்களால் அனுப்பப்பட்ட பதில்கள் டெலிவரி ஸ்டேட்டஸ்களாக மட்டுமே திரும்பும்; எனவே பதிலுக்குப் பிறகு வைக்கப்பட்ட `Call my webhook` படியிலிருந்து அவற்றின் உரையைப் பதிவு செய்யவும்.
என் ஏற்கனவே உள்ள அரட்டைகளை ஷீட்டில் ஏற்ற முடியுமா?
மெசேஜ்கள் easyCoexistence வழியாக வரும் எண்ணில் முடியாது. Meta, 6 மாதம் வரையிலான ஒருவருக்கு-ஒருவர் அரட்டைகளை, இணைத்த 24 மணி நேரத்திற்குள் சேமிக்கப்பட்ட நேரடி வெப்ஹூக் இலக்குக்கு மட்டுமே அனுப்புகிறது, ஒரு இணைப்புக்கு ஒரு முறை. easyCoexistence வழியாக அனுப்பப்படும் எண், `Forward URL` சேமிக்கப்பட்ட தருணத்திலிருந்து பதிவு செய்கிறது.
easyCoexistence மெசேஜ்களின் நகலை வைத்திருக்கிறதா?
ஓரளவு. easyCoexistence வழியாகச் செல்லும், ஆட்டோமேஷன்ஸ் ஆன் உள்ள எண்ணில், மெசேஜ் உரை நீங்கள் தேர்ந்தெடுக்கும் காலத்திற்கு, 30, 90 அல்லது 365 நாட்களுக்கு (இயல்பாக 90) வைக்கப்பட்டு Conversations-இல் காட்டப்படும்; ஃபார்வர்ட் செய்யப்பட்டவை மீண்டும் முயற்சிக்க 7 நாட்கள் வரை வைக்கப்படும், இயக்கப் பதிவுகள் 30 நாட்களுக்கு வைக்கப்படும். ஷீட்தான் உங்கள் நிரந்தர நகல்.
என் AI வாடிக்கையாளர்களுக்குப் பதிலளிக்க ஷீட்டைப் படிக்க முடியுமா?
`Reply with AI` படியிலிருந்து முடியாது, அது அதன் `Instructions`-ஐயும் அரட்டையையும் மட்டுமே படிக்கும். ஒரு AI முகவர் தனிப்பயன் HTTP கருவி வழியாகத் தகவல்களைத் தேடலாம், மேலும் `Call my webhook` அல்லது `Call an API` படி, கேள்வியை ஒரு பணிப்பாய்வுக்கு அனுப்ப முடியும், அது ஷீட்டில் பதிலைத் தேடி அதை பதிலாகத் திருப்பி அனுப்பும்.
தொடர்ந்து படிக்கவும்
தொடங்கத் தயாரா?
மாதங்கள் ஆகாமல், சில நிமிடங்களில் WhatsApp Coexistence-ஐ அமைக்குங்கள். ஆப்ஸ் போனில் தொடர்ந்து இயங்கும்.
இலவச ட்ரையலைத் தொடங்குங்கள்இதில் சரிபார்க்கப்பட்டது: