WhatsApp පණිවිඩ Google Sheets වෙත සටහන් කර, sheet එකකින් යවන්න

සෑම WhatsApp පණිවිඩයක්ම පේළියක් බවට පත්වන්නේ කෙසේද?

Meta විසින් අංකයේ සෑම පණිවිඩයක්ම ඔබ සකසා ඇති webhook destination එකට යවයි. මෙහි එය n8n Webhook node එකකි, එය Meta ගේ සත්‍යාපන request එකටද ප්‍රතිචාර දක්වයි. ඊළඟ node එක Append Row operation සහිත Google Sheets වන අතර, payload එකේ ක්ෂේත්‍ර තීරු වලට සිතියම්ගත කරයි: යවන්නාගේ අංකය, profile නම, පෙළ, WhatsApp පණිවිඩ id, timestamp සහ පණිවිඩය ලැබුණු phone_number_id.

retry ආරක්ෂිත වීමට සරල append වෙනුවට පණිවිඩ id මත key කළ Append or Update Row භාවිත කරන්න. delivery අසාර්ථක යැයි Meta සිතන විට පණිවිඩය නැවත යවයි. id මත key කළ විට දෙවන delivery එක එම පේළියම යාවත්කාලීන කිරීමක් බවට පත්වේ.

Coexistence අංකයක WhatsApp Business යෙදුමෙන් ටයිප් කරන පිළිතුරු smb_message_echoes event ලෙස එම webhook එකටම ලැබේ. direction තීරුවක් සමඟ ඒවා සටහන් කළහොත් sheet එකේ දෙපස්ම තිබේ.

Sheets quota එක බාධාවක් වන්නේ කොතැනද?

පරිශීලකයෙකුට අදාළ write සීමාවේ. Sheets API මගින් project එකකට විනාඩියකට write request 300ක් සහ project එකකට පරිශීලකයෙකුට විනාඩියකට 60ක් ලබා දේ. n8n credential එකක් යනු එක් පරිශීලකයෙකි. එබැවින් පණිවිඩයකට පේළියක් එක් කරන workflow එකකට අඛණ්ඩව තත්පරයකට පණිවිඩයක් පමණ හසුරුවිය හැක.

බොහෝ කඩ අංක සඳහා එය ප්‍රමාණවත්ය. නමුත් broadcast template එකකින් පසු, පාරිභෝගිකයන් සිය ගණනක් විනාඩි කිහිපයක් තුළ පිළිතුරු දෙන විට එය ප්‍රමාණවත් නොවේ. එවිට API එක 429 Too Many Requests ප්‍රතිචාරය දෙන අතර, retry නොමැති නම් පේළි නැති වේ.

යෝජනා දෙකක් ඇත, ඒවායින් එකක් ප්‍රමාණවත්ය. Google Sheets node එකේ wait සහිත retry සක්‍රිය කරන්න, එය exponential ලෙස back off කරන ලෙස Google ගේම උපදෙසට ගැළපේ. නැතහොත් batch කරන්න: n8n මගින් තත්පර තිහක් පණිවිඩ රැස් කර එක් request එකකින් එක් කරයි, එවිට write බොහොමයක් එකක් බවට පත්වේ.

sheet එකකින් template යවන්නේ කෙසේද?

Apps Script සමඟ, sheet එකේ Extensions මෙනුවෙන්. function එකක් තවම නොයවූ පේළි කියවයි, ඒ සෑම එකකටම UrlFetchApp මගින් Cloud API හි /messages endpoint එක අමතයි, ආපසු ලැබෙන පණිවිඩ id සහ වේලාව පේළියේ ලියයි. time-driven trigger එකකින් එය විනාඩි කිහිපයකට වරක් ධාවනය කළ හැක, නැතහොත් custom මෙනුවකින් අතින් ධාවනය කළ හැක.

script බැලිය හැකි ඕනෑම අයෙකුට access token එක නොපෙනෙන ලෙස, එය කේතයේ නොව script properties තුළ ගබඩා කරන්න.

quota මතක තබා ගන්න. පාරිභෝගික Google ගිණුමකට දිනකට URL Fetch ඇමතුම් 20,000ක් ද Workspace ගිණුමකට 100,000ක් ද ලැබේ, සෑම execution එකක්ම විනාඩි හයකට පසු නතර වේ. පේළි කොටස් වශයෙන් සකසා, ඉදිරියට යාමට පෙර සෑම එකක්ම යවා ඇති බව සලකුණු කරන්න. එවිට නතර වූ ධාවනයක් දෙවරක් යැවීමකින් තොරව නතර වූ තැනින් නැවත ආරම්භ වේ.

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());
  }
}

සාමාන්‍ය වැරදි

• පණිවිඩ id මත key නොමැතිව append කිරීම. එවිට Meta ගේ retry මගින් එකම පණිවිඩය පේළි දෙකක ලියවේ.
• පිළිතුරු රැල්ලක් අතරතුර තනි credential එකකින් පණිවිඩයකට පේළියක් ලිවීම. පරිශීලකයෙකුට විනාඩියකට write 60 සීමාව නිසා 429 ලැබී පේළි නැති වේ.
• පැය 24ක් තුළ ලියා නැති අයට sheet එකෙන් නිදහස් පෙළ යැවීම. එම කාල සීමාවෙන් පිටත ලබා දෙන්නේ අනුමත template පමණි.

නිතර අසන ප්‍රශ්න

තවදුරටත් කියවන්න