WhatsApp म्यासेज र सम्पर्कहरू स्वचालित रूपमा Google Sheets मा बचत गर्नुहोस्
WhatsApp Business म्यासेजहरू स्वचालित रूपमा Google Sheets मा बचत गर्न, तिनलाई n8n, Make वा Zapier जस्ता स्वचालन उपकरणमा हस्ताक्षरित HTTP POST मार्फत पठाउनुहोस्। उपकरणको Google Sheets चरणले प्रत्येक म्यासेजका लागि एउटा पङ्क्ति थप्नेछ: समय, दिशा, फोन नम्बर, नाम, पाठ र म्यासेज id। फोन नम्बरमा आधारित दोस्रो ट्याबले प्रत्येक सम्पर्कको एउटा पङ्क्ति राख्छ, जुन उसले फेरि लेख्दा अद्यावधिक हुन्छ।
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 मार्फत सन्देश आउने नम्बरमा दुई रुट छन्, र तिनले फरक आवश्यकता पूरा गर्छन्। फर्वार्ड यूआरएल, जुन प्रति नम्बर एकपटक सेट गरिन्छ, कुनै स्वचालनले जवाफ दिए वा नदिए पनि 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 username भएको प्रयोगकर्ताको नम्बरसँगै, वा नम्बरको सट्टा, व्यवसाय-स्कोप्ड user ID आउन सक्छ, त्यसैले त्यसका लागि पनि स्तम्भ राख्नुहोस्।
n8n मा म्यासेज लग कसरी बनाउने?
तीनवटा नोड। HTTP Method POST भएको वेबहुक नोड, Respond सेट Immediately मा, र यसको Production URL नम्बरको Forward URL का रूपमा सुरक्षित गरिएको। X-EC-Signature लाई forward secret सँग जाँच्ने र इभेन्टलाई पङ्क्तिमा बदल्ने Code नोड, जसले डेलिभरी स्थितिहरू छोड्छ। Append or Update Row अपरेसन, Column to match on मा म्यासेज id सेट गरिएको Google Sheets नोड, ताकि पुनः प्रयास गरिएको डेलिभरीले उही पङ्क्ति फेरि लेख्छ, नयाँ थप्दैन।
Forward 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 मा मिलाएर। फोन, प्रोफाइल नाम, user ID, समय र नवीनतम म्यासेजको पाठ म्याप गर्नुहोस्। कुनै नम्बरबाट पहिलो म्यासेजले त्यसको पङ्क्ति बनाउँछ; पछिका म्यासेजले नाम र अन्तिम-सम्पर्कका स्तम्भहरू अद्यावधिक गर्छन्, त्यसैले ट्याबले कसले कहिले लेख्यो भन्ने सूचीको काम पनि गर्छ। हातले लेखिएका टिप्पणीहरू फोनद्वारा खोजिने छुट्टै ट्याबमा राख्नुहोस्, ताकि वर्कफ्लोले तिनलाई कहिल्यै नओभरराइट नगरोस्।
फोनको सम्पर्क पुस्तिकामा रहेका सम्पर्कहरू यस तरिकाले आउँदैनन्। 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 मा, स्वचालन कस्टम वेबहुक बाट सुरु गर्नुहोस् र Google Sheets > Add a Row थप्नुहोस्; Zapier मा, Zapier द्वारा वेबहुक प्रयोग गर्नुहोस् जसमा Catch Raw Hook छ, जसले हेडर राख्छ, र त्यसपछि Google Sheets > Create Spreadsheet Row। दुवैले POST लाई तुरुन्तै 2xx मा जवाफ दिन्छन्, जुन फर्वार्डलाई 10 सेकेन्डभित्र चाहिन्छ। माथिका फिल्डहरू value.messages बाट उही तरिकामा म्याप गर्नुहोस्, र value मा messages को सट्टा statuses भएका इभेन्टहरू फिल्टर गर्नुहोस्।
हुक यूआरएललाई पासवर्डजस्तै मानिनुहोस्, किनभने त्यो भेटेको जो कोहीले पङ्क्ति पोस्ट गर्न सक्छ। तपाईंको योजनामा Code चरण छ भने, त्यहाँ X-EC-Signature लाई n8n नोडमा प्रयोग गरिएको उही HMAC विधिले जाँच्नुहोस्।
डुप्लिकेट वा हराएका पङ्क्तिहरू कसरी रोक्ने?
डुप्लिकेट पुनः प्रयासबाट आउँछन्। 10 सेकेन्डभित्र 2xx नपाएको फर्वार्ड उही X-EC-Delivery हेडर र शरीरमा उही id सहित फेरि पठाइन्छ, र भित्रका म्यासेजहरूले आफ्नो wamid राख्छन्, त्यसैले म्यासेज id मा मिलाउँदा पुनः प्रयास हानिरहित हुन्छ। वेबहुक-चरण मार्गमा, Try it का परीक्षणहरू dry_run true सहित आउँछन्: तिनलाई परीक्षण ट्याबमा पठाउनुहोस् वा हटाउनुहोस्।
हराएका पङ्क्तिहरू Google को लेखन कोटाबाट आउँछन्। 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.
सामान्य गल्तीहरू
- फर्वार्डलाई स्वचालनको हस्ताक्षर सिक्रेटले जाँच्नु, वा उल्टो। Forward यूआरएल लाई नम्बरको फर्वार्ड सिक्रेटले हस्ताक्षर गरिन्छ र मेरो वेबहुकमा कल गर्ने चरण लाई स्वचालनकै आफ्नो सिक्रेटले; X-EC-Event हेडरले सही सिक्रेट छान्छ।
- कुञ्जीविना प्रत्येक POST मा पङ्क्ति थप्नु। ढिलो उत्तरपछि पुनः पठाइएको डेलिभरीले उही म्यासेज दुई पटक लेख्छ; म्यासेज id मा मिलाएको Append or Update Row प्रयोग गर्नुहोस्।
- डेलिभरी स्थितिहरूलाई म्यासेजको रूपमा लेख्नु। messages इभेन्टले value.statuses मा sent, delivered र read स्थितिहरू पनि बोक्छ, जसमा पाठ हुँदैन र खाली पङ्क्ति बन्छ।
- Apps Script वेब एपको URL लाई Forward URL बनाउनु। यसको पुनर्निर्देशन असफलता मानिन्छ, त्यसैले 7 प्रयासमध्ये प्रत्येकले doPost फेरि चलाउँछ र नक्कल पङ्क्ति थप्छ।
स्वचालन सक्रिय हुँदा, फर्वार्ड यूआरएलले Meta का मूल इभेन्टहरू तपाईंको वर्कफ्लोमा पठाउँछ, जुन तपाईंसँग मात्र भएको गोप्य कुञ्जीले हस्ताक्षरित हुन्छ र तपाईंको यूआरएल बन्द हुँदा पुनः प्रयास हुन्छ; र मेरो वेबहुकमा कल गर्ने चरणले स्वचालनले सम्हालेका म्यासेज आफ्नो उत्तरसहित पठाउँछ। दुवै योजनामा समावेश छन्। प्रति नम्बर प्रति महिना US$ 9 देखि US$ 0.75 सम्म, नम्बर थप्दै जाँदा घट्दै जान्छ, र पहिलो 3 दिन निःशुल्क।
बारम्बार सोधिने प्रश्नहरू
तपाईंको टोलीले फोनमा टाइप गरेका म्यासेज पनि शीटमा आउँछन्?
हो, फर्वार्ड यूआरएल मार्फत। WhatsApp Business एपमा टाइप गरिएका उत्तर smb_message_echoes इभेन्टका रूपमा आउँछन्, ग्राहकको नम्बर to मा राखिएको। स्वचालनद्वारा पठाइएका उत्तर केवल डेलिभरी स्थितिका रूपमा फर्किन्छन्, त्यसैले तिनको पाठ उत्तरपछि राखिएको मेरो वेबहुकमा कल गर्ने चरणबाट लग गर्नुहोस्।
मेरा विद्यमान च्याटहरू शीटमा लोड गर्न सकिन्छ?
easyCoexistence मार्फत सन्देश आउने नम्बरमा होइन। Meta ले 6 महिनासम्मका एक-एक च्याट केवल जडान गरेको 24 घण्टाभित्र सुरक्षित गरिएको सिधा वेबहुक गन्तव्यमा मात्र पठाउँछ, प्रति जडान एकपटक। easyCoexistence मार्फत चल्ने नम्बरले फर्वार्ड यूआरएल सुरक्षित गरेको क्षणदेखि लग राख्छ।
के easyCoexistence ले म्यासेजको प्रतिलिपि राख्छ?
आंशिक रूपमा। easyCoexistence मार्फत चल्ने र स्वचालन सक्रिय भएको नम्बरमा, म्यासेजको पाठ तपाईंले रोजेको अवधिसम्म, 30, 90 वा 365 दिन (पूर्वनिर्धारित 90), राखिन्छ र Conversations मा देखाइन्छ; फर्वार्ड गरिएका डेलिभरी पुनः प्रयासका लागि 7 दिनसम्म राखिन्छन्, र रन लग 30 दिनसम्म। शीट तपाईंको स्थायी प्रतिलिपि हो।
मेरो AI ले ग्राहकलाई उत्तर दिन शीट पढ्न सक्छ?
AI बाट उत्तर दिने चरणबाट होइन, जसले केवल आफ्नो निर्देशन र च्याट पढ्छ। AI एजेन्टले कस्टम HTTP उपकरण मार्फत चीजहरू खोज्न सक्छ, र मेरो वेबहुकमा कल गर्ने वा API मा कल गर्ने चरणले प्रश्न कुनै वर्कफ्लोमा पठाउन सक्छ, जसले शीटमा उत्तर खोज्छ र त्यसलाई उत्तरका रूपमा फर्काउँछ।
पढ्दै जानुहोस्
सुरु गर्न तयार हुनुहुन्छ?
महिनौं होइन, केही मिनेटमै WhatsApp Coexistence सेट अप गर्नुहोस्। एप फोनमा चलिरहन्छ।
निःशुल्क ट्रायल सुरु गर्नुहोस्प्रमाणीकरण गरिएको