WhatsApp मैसेज को Google Sheets में लॉग करें और शीट से भेजें

हर WhatsApp मैसेज एक पंक्ति कैसे बनता है?

Meta नंबर पर आने वाला हर मैसेज आपके तय किए वेबहुक डेस्टिनेशन पर भेजता है। यहाँ यह n8n का Webhook नोड है, जो Meta के पुष्टि अनुरोध का जवाब भी देता है। अगला नोड Google Sheets है, जिसमें Append Row ऑपरेशन पेलोड के फ़ील्ड कॉलम में मैप करता है: भेजने वाले का नंबर, प्रोफ़ाइल नाम, टेक्स्ट, WhatsApp मैसेज आईडी, टाइमस्टैंप और प्राप्त करने वाले फ़ोन नंबर की आईडी।

अगर आप चाहते हैं कि रीट्राई से कोई नुकसान न हो, तो सीधे Append की जगह मैसेज आईडी पर आधारित Append or Update Row इस्तेमाल करें। Meta को लगे कि डिलीवरी फ़ेल हुई है तो वह मैसेज दोबारा भेजता है, और आईडी को कुंजी बनाने से दूसरी डिलीवरी उसी पंक्ति का अपडेट बन जाती है।

Coexistence नंबर पर WhatsApp Business ऐप से टाइप किए गए जवाब उसी वेबहुक पर smb_message_echoes इवेंट के रूप में आते हैं। उन्हें direction कॉलम के साथ लॉग करें, तो शीट में दोनों तरफ़ की बातचीत रहती है।

Sheets का कोटा कहाँ अड़चन बनता है?

प्रति उपयोगकर्ता लिखने पर। Sheets API प्रति प्रोजेक्ट प्रति मिनट 300 और प्रति उपयोगकर्ता प्रति प्रोजेक्ट प्रति मिनट 60 लिखने के अनुरोध देता है, और n8n का एक क्रेडेंशियल एक उपयोगकर्ता गिना जाता है। इसलिए हर मैसेज पर एक पंक्ति जोड़ने वाला वर्कफ़्लो लगातार लगभग एक मैसेज प्रति सेकंड संभाल सकता है।

ज़्यादातर दुकानों के नंबर के लिए यह काफ़ी है। ब्रॉडकास्ट टेम्पलेट के बाद, जब कुछ सौ ग्राहक कुछ ही मिनटों में जवाब देते हैं, तब यह काफ़ी नहीं रहता। तब API 429 Too Many Requests लौटाता है, और रीट्राई के बिना पंक्तियाँ गुम हो जाती हैं।

दो उपाय हैं, और दोनों में से कोई एक काफ़ी है। Google Sheets नोड पर प्रतीक्षा के साथ रीट्राई चालू करें, जो Google की अपनी सलाह के अनुसार धीरे-धीरे बढ़ते अंतराल पर दोबारा कोशिश करता है। या बैच बनाएँ: n8n से तीस सेकंड तक मैसेज इकट्ठा करवाएँ और उन्हें एक ही अनुरोध में जोड़ें, जिससे कई लिखाइयाँ एक बन जाती हैं।

शीट से टेम्पलेट कैसे भेजें?

Apps Script से, शीट के Extensions मेनू में। एक फ़ंक्शन उन पंक्तियों को पढ़ता है जो अभी नहीं भेजी गईं, हर एक के लिए UrlFetchApp से Cloud API के मैसेज एंडपॉइंट को कॉल करता है, और लौटा हुआ मैसेज आईडी और समय पंक्ति में लिख देता है। इसे टाइम-ड्रिवन ट्रिगर हर कुछ मिनट में चला सकता है, या आप कस्टम मेनू से हाथ से चला सकते हैं।

एक्सेस टोकन को कोड में रखने के बजाय स्क्रिप्ट प्रॉपर्टी में रखें, ताकि स्क्रिप्ट देख सकने वाला हर व्यक्ति उसे न देख पाए।

कोटा याद रखें। सामान्य Google खाते को एक दिन में 20,000 URL Fetch कॉल मिलते हैं और Workspace खाते को 100,000, और हर एक्ज़ीक्यूशन छह मिनट बाद रुक जाता है। पंक्तियों को छोटे हिस्सों में प्रोसेस करें और आगे बढ़ने से पहले हर पंक्ति को भेजी हुई चिह्नित करें, ताकि रुका हुआ रन वहीं से फिर शुरू हो और कुछ दोबारा न भेजे।

function sendPending() {
  const token = PropertiesService.getScriptProperties().getProperty("WHATSAPP_TOKEN");
  const sheet = SpreadsheetApp.getActive().getSheetByName("Send");
  const rows = sheet.getDataRange().getValues();
  for (let i = 1; i < rows.length; i++) {
    const [phone, name, sentAt] = rows[i];
    if (sentAt) continue;
    const res = UrlFetchApp.fetch("https://graph.facebook.com/v23.0/<PHONE_NUMBER_ID>/messages", {
      method: "post",
      contentType: "application/json",
      headers: { Authorization: "Bearer " + token },
      payload: JSON.stringify({
        messaging_product: "whatsapp", to: String(phone), type: "template",
        template: { name: "order_ready", language: { code: "en" },
          components: [{ type: "body", parameters: [{ type: "text", text: name }] }] },
      }),
    });
    sheet.getRange(i + 1, 3).setValue(new Date());
  }
}

आम गड़बड़ियाँ

• मैसेज आईडी पर कुंजी के बिना जोड़ना। तब Meta की रीट्राई एक ही मैसेज को दो पंक्तियों में लिख देती है।
• जवाबों की बाढ़ के दौरान एक ही क्रेडेंशियल से हर मैसेज पर एक पंक्ति लिखना। प्रति उपयोगकर्ता प्रति मिनट 60 लिखाइयों की सीमा 429 लौटाती है और पंक्तियाँ खो जाती हैं।
• जिन लोगों ने 24 घंटे से नहीं लिखा, उन्हें शीट से फ़्री टेक्स्ट भेजना। उस विंडो के बाहर केवल मंज़ूर टेम्पलेट ही डिलीवर होता है।

अक्सर पूछे जाने वाले सवाल

पढ़ना जारी रखें