WhatsApp मैसेज और कॉन्टैक्ट को Google Sheets में अपने आप सेव करें
WhatsApp Business मैसेज को अपने आप Google Sheets में सेव करने के लिए, उन्हें n8n, Make या Zapier जैसे ऑटोमेशन टूल को साइन किए गए HTTP POST के रूप में भेजें। उसका Google Sheets स्टेप हर मैसेज के लिए एक पंक्ति जोड़ देगा: समय, दिशा, फ़ोन नंबर, नाम, टेक्स्ट और मैसेज आईडी। फ़ोन नंबर पर आधारित दूसरा टैब हर कॉन्टैक्ट के लिए एक पंक्ति रखता है, जो उनके फिर से लिखने पर अपडेट होती है।
easyCoexistence आपके ऐप में रखे WhatsApp Business नंबर को Coexistence के ज़रिए Meta के Cloud API से जोड़ता है।
आपका यूआरएल विफल होने पर फ़ॉरवर्ड की गई डिलीवरी लगभग 1, 5, 30, 120, 360 और 1,440 मिनट बाद फिर से भेजी जाती है।
फ़ॉरवर्ड किया गया POST 2xx उत्तर का कितनी देर इंतज़ार करता है, उसके बाद उस डिलीवरी की दोबारा कोशिश होती है।
Google Sheets एपीआई लिखने के अनुरोध प्रति मिनट, प्रति उपयोगकर्ता, प्रति प्रोजेक्ट अनुमत हैं; हर प्रोजेक्ट पर 300।
Apps Script वेब ऐप का आउटपुट एक बार-उपयोग वाले यूआरएल पर script.googleusercontent.com पर रीडायरेक्ट होता है।
Apps Script के doPost इवेंट ऑब्जेक्ट में बॉडी और पैरामीटर दिखते हैं, HTTP अनुरोध हेडर नहीं।
कौन-सा रास्ता शीट को भरेगा?
ऐसे नंबर पर दो रास्ते हैं जिसके मैसेज easyCoexistence से होकर आते हैं, और वे अलग-अलग ज़रूरतें पूरी करते हैं। Forward URL को हर नंबर पर एक बार सेट किया जाता है, और वह Meta के मूल इवेंट आगे भेजता है, चाहे कोई ऑटोमेशन जवाब दे या न दे: ग्राहकों के मैसेज, WhatsApp Business ऐप में आपकी टीम के टाइप किए जवाब, और डिलीवरी स्टेटस। पूरे मैसेज लॉग के लिए यही रास्ता है। ऑटोमेशन के भीतर कॉल माई वेबहुक स्टेप सिर्फ़ उन्हीं मैसेज पर चलता है जिन्हें वह ऑटोमेशन चुनता है, और उसमें हाल की चैट भी आती है, जिसमें ऑटोमेशन द्वारा भेजा गया ताज़ा जवाब शामिल है। यह लीड, ऑर्डर या अनुरोधों की शीट के लिए ठीक है, जिन्हें एक ऑटोमेशन संभालता है। दोनों पर साइन होते हैं, लेकिन उनके सीक्रेट अलग होते हैं।
| 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 change को लपेटता है: id (डिलीवरी), event (Meta का फ़ील्ड नाम, जैसे messages या smb_message_echoes), received_at, connection (आपके नंबर का id, phone और phone_number_id) और value, बिल्कुल वैसा जैसा Meta ने भेजा। value में messages वह होते हैं जो ग्राहकों ने लिखा, और message_echoes वह होते हैं जो आपकी टीम ने फ़ोन पर टाइप किया। फ़ोन नंबर अंकों में आते हैं, देश कोड के साथ और बिना प्लस चिह्न के; वह कॉलम सादे टेक्स्ट के रूप में सेव करें, ताकि Sheets उसे नंबर न बना दे। जिस उपयोगकर्ता का WhatsApp यूज़रनेम है, उसके साथ नंबर के अलावा या उसकी जगह बिज़नेस-स्कोप्ड यूज़र आईडी आ सकती है, इसलिए उसके लिए भी एक कॉलम रखें।
n8n में मैसेज लॉग कैसे बनाएँ?
तीन नोड। एक वेबहुक नोड जिसका HTTP Method POST हो, Respond को Immediately पर सेट करें, और उसका Production URL नंबर के Forward URL के रूप में सेव करें। एक Code नोड जो फ़ॉरवर्ड सीक्रेट के साथ X-EC-Signature जाँचता है और इवेंट को पंक्तियों में बदलता है, डिलीवरी स्टेटस छोड़ते हुए। एक Google Sheets नोड जिसका ऑपरेशन Append or Update Row हो, और Column to match on को Message id पर सेट करें, ताकि दोबारा भेजी गई डिलीवरी नई पंक्ति जोड़ने के बजाय वही पंक्ति फिर से लिखे।
फ़ॉरवर्ड सीक्रेट 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 पर मैच करते हुए। फ़ोन, प्रोफ़ाइल नाम, यूज़र आईडी, समय और नवीनतम मैसेज का टेक्स्ट मैप करें। किसी नंबर का पहला मैसेज उसकी पंक्ति बनाता है; बाद के मैसेज नाम और आख़िरी-संपर्क कॉलम अपडेट करते हैं, इसलिए यह टैब यह सूची भी बन जाता है कि किसने कब लिखा। हाथ से लिखे नोट्स एक अलग टैब पर रखें, जिन्हें फ़ोन से खोजा जाए, ताकि वर्कफ़्लो उन्हें कभी न लिखे।
फ़ोन की एड्रेस बुक में सेव कॉन्टैक्ट इस तरह नहीं आते। Meta उन्हें, 6 महीने तक की चैट के साथ, केवल उस वेबहुक डेस्टिनेशन पर भेजता है जो नंबर कनेक्ट करने के 24 घंटे के भीतर डायरेक्ट सेव हुआ हो।
क्या Apps Script मैसेज सीधे ले सकता है?
सीधे नहीं, इसलिए शीट के आगे एक वर्कफ़्लो टूल रखें। Google किसी Apps Script वेब ऐप का रिस्पॉन्स एक बार-उपयोग वाले यूआरएल script.googleusercontent.com पर रीडायरेक्ट करके देता है, और easyCoexistence रीडायरेक्ट को फ़ॉलो नहीं करता। 302 एक विफल डिलीवरी गिना जाता है: फ़ॉरवर्ड को अधिकतम 7 बार दोबारा भेजा जाता है, और हर दोबारा कोशिश doPost फिर चलाती है और एक और पंक्ति लिखती है, जबकि कॉल माई वेबहुक स्टेप विफल होकर आपको ईमेल करता है। doPost अनुरोध हेडर भी नहीं पढ़ सकता, इसलिए वहाँ X-EC-Signature जाँच संभव नहीं है।
Apps Script दूसरी दिशा के लिए अच्छा विकल्प बना रहता है: शीट की पंक्तियों से स्वीकृत टेम्पलेट भेजना, जिसे Google Sheets इंटीग्रेशन पेज कोड के साथ समझाता है।
क्या इसके बजाय Make या Zapier शीट भर सकते हैं?
हाँ। Make में परिदृश्य “Webhooks > Custom webhook” से शुरू करें और Google Sheets > Add a Row जोड़ें; Zapier में Webhooks by Zapier के साथ Catch Raw Hook का उपयोग करें, जो हेडर रखता है, फिर Google Sheets > Create Spreadsheet Row। दोनों POST का उत्तर तुरंत 2xx से देते हैं, जो फ़ॉरवर्ड को उसके 10 सेकंड के भीतर चाहिए। वही फ़ील्ड value.messages से मैप करें, और उन इवेंट को छानें जिनकी value में messages के बजाय statuses हों।
हुक यूआरएल को पासवर्ड की तरह मानें, क्योंकि जिसके पास वह है, वह पंक्तियाँ पोस्ट कर सकता है। जहाँ आपकी योजना में कोड स्टेप शामिल है, वहाँ n8n नोड में उपयोग किए गए उसी HMAC तरीके से X-EC-Signature जाँचें।
डुप्लिकेट या गायब पंक्तियों से कैसे बचें?
डुप्लिकेट दोबारा कोशिश से आते हैं। जो फ़ॉरवर्ड 10 सेकंड में 2xx नहीं पाता, वह उसी X-EC-Delivery हेडर और बॉडी के उसी id के साथ फिर भेजा जाता है, और उसके अंदर के मैसेज अपना wamid रखते हैं, इसलिए Message id पर मैच करने से दोबारा कोशिश हानिरहित हो जाती है। वेबहुक-स्टेप वाले रास्ते पर Try it से भेजे गए टेस्ट dry_run true के साथ आते हैं: उन्हें टेस्ट टैब पर भेजें या हटा दें।
गायब पंक्तियाँ Google के लिखने के कोटा से आती हैं। Sheets एपीआई प्रति उपयोगकर्ता, प्रति प्रोजेक्ट प्रति मिनट 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 नंबर के फ़ॉरवर्ड सीक्रेट से साइन होता है और कॉल माई वेबहुक ऑटोमेशन के अपने सीक्रेट से; सीक्रेट X-EC-Event हेडर से चुनें।
- कुंजी के बिना हर POST पर पंक्ति जोड़ना। धीमे उत्तर के बाद दोबारा भेजी गई डिलीवरी वही मैसेज दो बार लिखती है; मैसेज आईडी पर मैच करते हुए Append or Update Row उपयोग करें।
- डिलीवरी स्टेटस को मैसेज के रूप में लिखना। messages इवेंट में value.statuses के sent, delivered और read स्टेटस भी आते हैं, जिनमें कोई टेक्स्ट नहीं होता और वे खाली पंक्तियाँ बनाते हैं।
- Apps Script वेब ऐप यूआरएल को Forward URL के रूप में सेव करना। उसका रीडायरेक्ट विफलता गिना जाता है, इसलिए 7 में से हर प्रयास doPost फिर चलाता है और एक डुप्लिकेट पंक्ति जोड़ता है।
ऑटोमेशन चालू होने पर Forward URL Meta के मूल इवेंट आपके वर्कफ़्लो तक पहुँचाता है, जो केवल आपके पास मौजूद सीक्रेट से साइन होते हैं और आपका यूआरएल डाउन होने पर दोबारा भेजे जाते हैं; और कॉल माई वेबहुक स्टेप वह भेजता है जिसे कोई ऑटोमेशन संभालता है, उसके जवाब के साथ। दोनों योजना में शामिल हैं। US$ 9 से US$ 0.75 तक प्रति नंबर प्रति माह, जैसे-जैसे आप नंबर जोड़ते हैं दर घटती है, और पहले 3 दिन मुफ़्त।
अक्सर पूछे जाने वाले सवाल
क्या शीट को वह मैसेज मिलते हैं जो मेरी टीम फ़ोन पर टाइप करती है?
हाँ, Forward URL के ज़रिए। WhatsApp Business ऐप में टाइप किए गए जवाब smb_message_echoes इवेंट के रूप में आते हैं, जिनमें ग्राहक का नंबर to में होता है। ऑटोमेशन द्वारा भेजे गए जवाब केवल डिलीवरी स्टेटस के रूप में लौटते हैं, इसलिए उनका टेक्स्ट जवाब के बाद रखे कॉल माई वेबहुक स्टेप से लॉग करें।
क्या मेरी मौजूदा चैट शीट में लोड कर सकता हूँ?
ऐसे नंबर पर नहीं जिसके मैसेज easyCoexistence से होकर आते हैं। Meta 6 महीने तक की एक-से-एक चैट केवल उस डायरेक्ट वेबहुक डेस्टिनेशन को भेजता है जो कनेक्ट करने के 24 घंटे के भीतर सेव हुआ हो, प्रति कनेक्शन एक बार। easyCoexistence से होकर गुज़रने वाला नंबर Forward URL सेव होने के क्षण से लॉग करता है।
क्या easyCoexistence मैसेज की प्रति रखता है?
आंशिक रूप से। easyCoexistence से होकर जाने वाले और ऑटोमेशन चालू वाले नंबर पर मैसेज का टेक्स्ट आपके चुने हुए समय तक रखा जाता है, 30, 90 या 365 दिन (डिफ़ॉल्ट 90), और Conversations में दिखता है; फ़ॉरवर्ड की गई डिलीवरी दोबारा भेजने के लिए अधिकतम 7 दिन रखी जाती हैं, और रन लॉग 30 दिन। स्थायी प्रति आपकी शीट है।
क्या मेरा AI ग्राहकों के जवाब देने के लिए शीट पढ़ सकता है?
Reply with AI स्टेप से नहीं, जो केवल अपने Instructions और चैट पढ़ता है। AI एजेंट कस्टम HTTP टूल के ज़रिए चीज़ें खोज सकता है, और कॉल माई वेबहुक या Call an API स्टेप सवाल ऐसे वर्कफ़्लो पर भेज सकता है जो शीट में उत्तर खोजकर उसे जवाब के रूप में लौटाए।
पढ़ना जारी रखें
शुरू करने के लिए तैयार हैं?
WhatsApp Coexistence को महीनों में नहीं, मिनटों में कॉन्फ़िगर करें। ऐप्लिकेशन मोबाइल पर काम करता रहता है।
मुफ़्त ट्रायल शुरू करेंइस तारीख को सत्यापित