WhatsApp মেসেজ ও কন্টাক্ট স্বয়ংক্রিয়ভাবে Google Sheets-এ সেভ করুন
WhatsApp Business মেসেজ স্বয়ংক্রিয়ভাবে Google Sheets-এ সেভ করতে, সেগুলো সাইন করা HTTP POST হিসেবে n8n, Make বা Zapier-এর মতো একটি অটোমেশন টুলে পাঠান, এবং তার Google Sheets ধাপকে প্রতি মেসেজের জন্য একটি সারি যোগ করতে দিন: সময়, দিক, ফোন নম্বর, নাম, টেক্সট ও মেসেজ আইডি। ফোন নম্বরের উপর ভিত্তি করে একটি দ্বিতীয় ট্যাব প্রতি কন্টাক্টের জন্য একটি সারি রাখে, যা তারা আবার লিখলে আপডেট হয়।
easyCoexistence আপনার অ্যাপে রাখা WhatsApp Business নম্বরটি Coexistence-এর মাধ্যমে Meta-র Cloud API-এর সাথে সংযুক্ত করে।
আপনার URL ব্যর্থ হলে ফরওয়ার্ড করা ডেলিভারি প্রায় 1, 5, 30, 120, 360 ও 1,440 মিনিট পরে আবার চেষ্টা করা হয়।
ফরওয়ার্ড করা POST একটি 2xx উত্তরের জন্য কতক্ষণ অপেক্ষা করে, তার আগে ওই ডেলিভারি আবার চেষ্টা করা হয়।
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 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-এ মেসেজ লগ কীভাবে তৈরি করবেন?
তিনটি নোড। একটি `Webhook` নোড, HTTP Method POST, Respond সেট Immediately, এবং তার Production URL সেভ হয় নম্বরের Forward URL হিসেবে। একটি `Code` নোড, যা X-EC-Signature যাচাই করে forward সিক্রেট দিয়ে এবং ইভেন্টটিকে সারিতে রূপান্তর করে, ডেলিভারি স্ট্যাটাস বাদ দিয়ে। একটি Google Sheets নোড, Append or Update Row অপারেশনে, Column to match on সেট মেসেজ আইডি-তে, যাতে রিট্রাই করা ডেলিভারি একই সারি আবার লেখে, নতুন সারি যোগ না করে।
forward সিক্রেট একবারই দেখানো হয়, যখন আপনি 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 }));প্রতি কন্টাক্টের জন্য একটি সারি কীভাবে রাখবেন?
কন্টাক্টস ট্যাবে আরেকটি Google Sheets নোড যোগ করুন, একইভাবে Append or Update Row সহ, Phone-এর সাথে মিলিয়ে। ফোন, প্রোফাইল নাম, ইউজার আইডি, সময় এবং সর্বশেষ মেসেজের টেক্সট ম্যাপ করুন। একটি নম্বর থেকে প্রথম মেসেজ তার সারি তৈরি করে; পরেরগুলো নাম এবং সর্বশেষ যোগাযোগের কলাম আপডেট করে, তাই ট্যাবটি কে কখন লিখেছে তার তালিকাও হয়। হাতে লেখা নোট আলাদা ট্যাবে রাখুন, ফোন নম্বর দিয়ে খুঁজে, যাতে ওয়ার্কফ্লো কখনো সেগুলো ওভাররাইট না করে।
ফোনের ঠিকানা বইয়ে সেভ করা কন্টাক্টগুলো এভাবে আসে না। 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-এ `Webhooks by Zapier`-এর সাথে Catch Raw Hook ব্যবহার করুন, যা হেডার রাখে, তারপর `Google Sheets > Create Spreadsheet Row`। দুটিই POST-এর উত্তর একবারে একটি 2xx দিয়ে দেয়, যা একটি ফরওয়ার্ডের 10 সেকেন্ডের মধ্যে দরকার। value.messages থেকে উপরের মতো একই ফিল্ড ম্যাপ করুন, এবং যেসব ইভেন্টের value-তে messages-এর বদলে statuses থাকে সেগুলো ফিল্টার করে বাদ দিন।
হুক URL-কে পাসওয়ার্ডের মতো গণ্য করুন, কারণ যার কাছে এটি আছে সে সারি পোস্ট করতে পারে। আপনার প্ল্যানে কোড ধাপ থাকলে সেখানে n8n নোডের একই HMAC পদ্ধতি দিয়ে X-EC-Signature যাচাই করুন।
ডুপ্লিকেট বা বাদ পড়া সারি কীভাবে এড়াবেন?
ডুপ্লিকেট আসে রিট্রাই থেকে। যে ফরওয়ার্ড 10 সেকেন্ডের মধ্যে 2xx পায়নি, সেটি একই X-EC-Delivery হেডার ও বডিতে একই id সহ আবার পাঠানো হয়, এবং ভেতরের মেসেজগুলো তাদের wamid ধরে রাখে, তাই মেসেজ আইডির সাথে মিলিয়ে নিলে রিট্রাই ক্ষতিহীন হয়। ওয়েবহুক-ধাপের রুটে, 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 সিক্রেট দিয়ে সাইন হয়, আর `“Call my webhook”` অটোমেশনের নিজের দিয়ে; X-EC-Event হেডার দেখে সিক্রেট বাছুন।
- কী ছাড়া প্রতি POST-এ একটি সারি যোগ করা। ধীর উত্তরের পর রিট্রাই করা ডেলিভারি একই মেসেজ দুবার লেখে; মেসেজ আইডির সাথে মিলিয়ে 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 সেট আপ করুন। ফোনে অ্যাপটি কাজ করতে থাকে।
ফ্রি ট্রায়াল শুরু করুনযাচাই করা হয়েছে