WhatsApp কথোপকথন স্বয়ংক্রিয়ভাবে CRM-এ পাঠান
স্বয়ংক্রিয়ভাবে WhatsApp কথোপকথন CRM-এ পাঠাতে, আপনার ব্যাকএন্ডে বা একটি ওয়ার্কফ্লো টুলে আসা মেসেজগুলো সাইন করা ওয়েবহুক হিসেবে পৌঁছান, ফোন নম্বর দিয়ে কন্টাক্ট খুঁজুন বা তৈরি করুন, এবং সেই কন্টাক্টে মেসেজটি একটি অ্যাক্টিভিটি হিসেবে লগ করুন। অ্যাক্টিভিটির অনন্য কী হিসেবে WhatsApp মেসেজ আইডি ব্যবহার করুন, যাতে একটি পুনরায় পাঠানো ডেলিভারি দ্বিতীয় রেকর্ড তৈরি না করে, বরং একই রেকর্ড আপডেট করে।
easyCoexistence আপনার অ্যাপে রাখা WhatsApp Business নম্বরটিকে Coexistence-এর মাধ্যমে Meta-র Cloud API-এর সাথে যুক্ত করে।
ফরওয়ার্ড করা POST-এর হেডারে ডেলিভারি আইডি থাকে, যা ওই ডেলিভারির প্রতিটি পুনঃচেষ্টায় একই থাকে।
7 বার ফরওয়ার্ড চেষ্টার পুরো সময়কাল, প্রায় 1, 5, 30, 120, 360 ও 1,440 মিনিট পর পর।
একটি Call my ওয়েবহুক ধাপ আপনার URL-কে একবার কল করে; টাইমআউট বা ত্রুটি হলে রান ব্যর্থ হয় এবং আপনাকে ইমেইল পাঠানো হয়।
ব্যবসা-পরিসরের ইউজার আইডি, যেমন US.13491208655302741918, ফোন নম্বরের পাশে বা বদলে user_id ও from_user_id-তে পাঠানো হয়।
অটোমেশন রান লগ ট্রিগার করা মেসেজ, উত্তর এবং প্রতিটি ধাপ কতদিন রাখে।
কোন ইভেন্টগুলো CRM-এ পৌঁছানো উচিত?
Coexistence নম্বরের একটি কথোপকথন তিন ধরনের মেসেজ নিয়ে গঠিত, আর দুটি রুট সেগুলো বহন করে। প্রতি নম্বরে সেট করা Forward URL পাঠায় গ্রাহকরা যা লেখেন এবং আপনার টিম WhatsApp Business অ্যাপে যা টাইপ করে, Meta-র মূল ইভেন্ট হিসেবে; আপনার CRM উত্তর না দেওয়া পর্যন্ত এগুলো আবার চেষ্টা করা হয়। অটোমেশনের পাঠানো উত্তর API-এর মাধ্যমে Meta-তে যায়, যা শুধু লেখা ছাড়া ডেলিভারি স্ট্যাটাস হিসেবে জানায়; সেই উত্তরের শব্দগুলো লগ করতে অটোমেশনের শেষে একটি Call my ওয়েবহুক ধাপ যোগ করুন, যার ইতিহাসে রানটির সদ্য পাঠানো উত্তর থাকে। একটি এন্ডপয়েন্টই দুটোই নিতে পারে: ধাপের জন্য X-EC-Event হেডার automation.step পড়ে, আর ফরওয়ার্ডের জন্য পড়ে Meta-র ফিল্ডের নাম।
কীভাবে WhatsApp প্রেরককে CRM কন্টাক্টের সাথে মেলাবেন?
ফোন নম্বর দিয়ে, স্বাভাবিকীকৃত (normalised) রূপে। WhatsApp দেশের কোড সহ শুধু সংখ্যা পাঠায়, প্লাস চিহ্ন ছাড়া, যেমন 5511987654321; এটি ফরওয়ার্ডে messages[].from-এ আসে এবং Call my ওয়েবহুক ধাপে contact.wa_id-তে। CRM-এ মানুষের টাইপ করা রেকর্ডে থাকে +55 11 98765-4321 বা (11) 98765-4321, তাই শুধু সংখ্যার রূপে একটি আলাদা প্রপার্টি রাখুন এবং সেটির উপর খুঁজুন। কিছু না মিললে WhatsApp প্রোফাইলের নাম ও নম্বর দিয়ে নতুন কন্টাক্ট তৈরি করুন।
ব্যবসা-পরিসরের ইউজার আইডিও সংরক্ষণ করুন। যে ব্যবহারকারীর WhatsApp ইউজারনেম আছে এবং 30 দিন আপনার নম্বরের সাথে যোগাযোগ হয়নি, তার ক্ষেত্রে শুধু BSUID থাকতে পারে from_user_id ও contacts[].user_id-তে। ফরওয়ার্ডে এটি আসে; Call my ওয়েবহুক ধাপে আসে ফোন নম্বর।
প্রতিটি CRM রেকর্ডে কী থাকবে?
একটি কন্টাক্টে শনাক্তকারীগুলো, এবং প্রতিটি মেসেজের জন্য একটি অ্যাক্টিভিটি, যাতে থাকে দিক, টেক্সট, সময় ও একটি অনন্য কী। নিচের মানচিত্রে দেখানো হয়েছে প্রতি রুটে কোন মান কোথায় থাকে। ফরওয়ার্ডে মেসেজের সময় Meta থেকে আসে Unix সেকেন্ডে; Call my ওয়েবহুক ধাপ ISO তারিখ পাঠায়। মিডিয়া ফরওয়ার্ডে আসে একটি ধরন ও একটি আইডি হিসেবে, আর Call my ওয়েবহুক ধাপে আসে [image]-এর মতো প্লেসহোল্ডার ক্যাপশনসহ; তাই ফাইল সংরক্ষণের চেষ্টা না করে একটি ছোট লেবেল লগ করুন।
| Forwarded event (value is Meta's) | Call my webhook step | |
|---|---|---|
| Contact phone | messages[].from | contact.wa_id |
| Contact name | contacts[].profile.name | contact.name |
| BSUID | contacts[].user_id, messages[].from_user_id | Not sent |
| Activity text | text.body, or the media type | message.text and history[].text |
| Direction | messages = in, smb_message_echoes = out | history[].direction: in, out or echo |
| Time | timestamp, Unix seconds | message.at and history[].at, ISO 8601 |
| Unique key | messages[].id (wamid) | message.id; run_id for history entries |
কীভাবে পুনঃচেষ্টায় ডুপ্লিকেট ঠেকাবেন?
দ্রুত উত্তর দিন, তারপর সবকিছুর কী দিন। ফরওয়ার্ড যদি 10 সেকেন্ডের মধ্যে 2xx না পায়, তবে একই X-EC-Delivery আইডি দিয়ে সর্বোচ্চ 7 বার চেষ্টা করা হয়; তাই 12 সেকেন্ড নেয় এমন একটি CRM কল দুবার চলবে, যদি না অ্যাক্টিভিটি wamid-এ upsert করা হয়। আগে 200 উত্তর দিন এবং CRM-এর কাজ একটি কিউ বা ব্যাকগ্রাউন্ড জবে করুন।
Call my ওয়েবহুক ধাপটি পুনরায় চেষ্টা হয় না, এবং Meta-র নিজের পুনরাবৃত্ত ডেলিভারি অটোমেশন চালানোর আগেই ফিল্টার হয়, তাই প্রতি মেসেজে এটি আপনাকে সর্বোচ্চ একবার কল করে। এর ইতিহাসের এন্ট্রিতে কোনো মেসেজ আইডি থাকে না: স্বয়ংক্রিয় উত্তরগুলোকে run_id ও তার অবস্থানের সাথে কী দিন। Try it থেকে পরীক্ষা আসে dry_run true সহ নমুনা কন্টাক্ট 15550000000 দিয়ে; এগুলো বাদ দিন, যাতে পরীক্ষার রান কখনো CRM রেকর্ড না বানায়।
Node.js-এ রিসিভার কেমন দেখায়?
একটি Express রুট দুই ধরনের ইভেন্টই নেয়। এটি কাঁচা বডি পড়ে, X-EC-Event হেডার দেখে সঠিক সিক্রেট বেছে নেয়, X-EC-Signature যাচাই করে, সঙ্গে সঙ্গে 200 উত্তর দেয় এবং কাজটি একটি ব্যাকগ্রাউন্ড ফাংশনে দেয়। crm অবজেক্টটি আপনার CRM-এর API ক্লায়েন্টের প্রতিনিধিত্ব করে: শুধু সংখ্যার ফোন নম্বরে কন্টাক্টের upsert, এবং তার অনন্য কীতে অ্যাক্টিভিটির upsert। একই কাঠামো n8n ওয়ার্কফ্লোতেও কাজ করে, সিগনেচারের জন্য একটি Code নোড এবং তারপর আপনার CRM-এর নোডগুলো।
import express from "express";
import crypto from "node:crypto";
const FORWARD_SECRET = process.env.EC_FORWARD_SECRET; // the number's, shown once with the Forward URL
const STEP_SECRET = process.env.EC_STEP_SECRET; // the automation's Signing secret
function signed(req, secret) {
const m = /^t=(\d+),v1=([0-9a-f]{64})$/.exec(req.get("X-EC-Signature") || "");
if (!m || Math.abs(Date.now() / 1000 - Number(m[1])) > 300) return false;
const mac = crypto.createHmac("sha256", secret).update(m[1] + "." + req.body).digest();
return crypto.timingSafeEqual(mac, Buffer.from(m[2], "hex"));
}
const app = express();
app.post("/whatsapp/crm", express.text({ type: "application/json" }), (req, res) => {
const kind = req.get("X-EC-Event"); // automation.step, or Meta's field name for a forward
if (!signed(req, kind === "automation.step" ? STEP_SECRET : FORWARD_SECRET)) return res.status(401).end();
res.json({}); // no reply field: nothing is sent to the customer
handle(kind, JSON.parse(req.body)).catch(console.error);
});
async function handle(kind, body) {
if (kind === "messages") {
for (const m of body.value.messages ?? []) { // statuses are skipped
const c = (body.value.contacts ?? []).find((x) => x.wa_id === m.from);
const contact = await crm.upsertContact({ phone: m.from, bsuid: m.from_user_id, name: c?.profile?.name });
await crm.upsertActivity({ key: m.id, contact, direction: "in", text: m.text?.body ?? "[" + m.type + "]", at: new Date(m.timestamp * 1000) });
}
} else if (kind === "smb_message_echoes") {
for (const m of body.value.message_echoes ?? []) {
const contact = await crm.upsertContact({ phone: m.to, bsuid: m.to_user_id });
await crm.upsertActivity({ key: m.id, contact, direction: "out", text: m.text?.body ?? "[" + m.type + "]", at: new Date(m.timestamp * 1000) });
}
} else if (kind === "automation.step" && !body.dry_run) {
const contact = await crm.upsertContact({ phone: body.contact.wa_id, name: body.contact.name });
const sentAfter = body.history.filter((h) => h.direction === "out" && h.at >= body.message.at);
for (const [i, h] of sentAfter.entries()) {
await crm.upsertActivity({ key: body.run_id + ":" + i, contact, direction: "out", text: h.text, at: new Date(h.at) });
}
}
}
app.listen(3000);AI যা শিখেছে তা দিয়ে CRM কি লিডটি আপডেট করতে পারে?
হ্যাঁ, আপনার ওয়ার্কফ্লোতে। Call my ওয়েবহুক ধাপের সাথে আসা চ্যাটে থাকে আপনার AI-এর করা প্রশ্ন ও গ্রাহকের উত্তরগুলো, তাই n8n-এর একটি মডেল নোড বা আপনার ব্যাকএন্ডের একটি কল প্রয়োজন, বাজেট, সময় বা অবস্থান বের করে লিডের ফিল্ডে লিখতে পারে এবং তারপর তার স্টেজ সরাতে পারে। কোনো উত্তর ফেরত দেবেন না, কারণ গ্রাহক AI-এর বার্তাটি ইতিমধ্যে পেয়েছেন। ওয়ার্কফ্লো যখন সিদ্ধান্ত নেয় একটি লিড কল পাওয়ার যোগ্য, তখন এটি একজন বিক্রয়কর্মীর জন্য একটি টাস্ক তৈরি করতে পারে বা টিমকে সতর্ক করতে পারে। অথবা তথ্য বের করার কাজ easyCoexistence-কেই করতে দিন: একটি এজেন্ট বা একটি AI saves details ধাপ প্রয়োজন, বাজেট ও সময় কন্টাক্টের ফিল্ডে লেখে, এবং একটি Call an API ধাপ {{contact.budget}} ধরনের টোকেন তার বডিতে ব্যবহার করে সেগুলো আপনার CRM-এ পাঠাতে পারে। লিড যাচাইয়ের পৃষ্ঠায় সেই সেটআপের ইন্টারভিউ নির্দেশনা ও পেলোড আছে।
কীভাবে সেট আপ করবেন
- Send the number's messages through easyCoexistenceOn the number's page, the Where incoming messages go card must be set to Through easyCoexistence; choose it if it shows Straight to your system.
- Deploy the receiverPublish the endpoint or n8n workflow on public HTTPS, with the CRM upserts keyed on the phone and the message id.
- Save the Forward URLPaste the receiver's URL into Forward URL (optional), click Save forward URL and store the signing secret shown once.
- Log automated repliesIn each automation that replies, add Call my webhook as the last step with the same URL, save, and copy that automation's Signing secret.
- Check one real conversationWrite to the number from another phone, let the automation answer, reply from the app, and confirm three activities on the contact: in, automated out and phone out.
সাধারণ ভুলগুলো
- ফ্রি টেক্সট ফোন ফিল্ড দিয়ে CRM-এ খোঁজা। WhatsApp-এর শুধু সংখ্যার ফরম্যাট প্রায়ই মানুষের টাইপ করা রূপের সাথে মেলে না, এবং প্রতিটি মিসে একটি ডুপ্লিকেট কন্টাক্ট তৈরি হয়; স্বাভাবিকীকৃত শুধু-সংখ্যার প্রপার্টিতে খুঁজুন।
- ফরওয়ার্ডের উত্তর দেওয়ার আগে CRM-এ কল করা। যে CRM 10 সেকেন্ডের বেশি নেয়, তাতে easyCoexistence পুনরায় চেষ্টা করে, এবং wamid-এ upsert না থাকলে অ্যাক্টিভিটি দুবার লগ হয়।
- শুধু ফরওয়ার্ড লগ করে স্বয়ংক্রিয় উত্তর তাতে আশা করা। API-এর পাঠানো উত্তর লেখা ছাড়া স্ট্যাটাস হিসেবে ফিরে আসে; উত্তরের পরে একটি Call my ওয়েবহুক ধাপ শব্দগুলো বহন করে।
- পরীক্ষাকে CRM পর্যন্ত পৌঁছাতে দেওয়া। Try it সত্যিই dry_run true সহ আপনার URL-এ কল করে, নমুনা কন্টাক্ট 15550000000 সহ; যেকোনো upsert-এর আগে এই ইভেন্টগুলো বাদ দিন।
এর Forward URL গ্রাহকের মেসেজ ও ফোনের উত্তরগুলো Meta-র মূল ইভেন্ট হিসেবে আপনার CRM-এ পাঠায়, প্রতি নম্বরে সাইন করা, এবং CRM বন্ধ থাকলে প্রায় 33 ঘণ্টা পর্যন্ত পুনরায় চেষ্টা করে; একটি Call my ওয়েবহুক ধাপ স্বয়ংক্রিয় উত্তরগুলো যোগ করে। ফরওয়ার্ডিং ও অটোমেশন প্ল্যানের অন্তর্ভুক্ত। প্রতি নম্বরে প্রতি মাসে US$ 9 থেকে US$ 0.75 পর্যন্ত, নম্বর যোগ করার সাথে সাথে কমে, প্রথম 3 দিন ফ্রি ট্রায়াল।
প্রায়শই জিজ্ঞাসিত প্রশ্ন
কোন CRM-এর সাথে এটি কাজ করে?
API আছে এমন যেকোনো CRM, আপনার নিজের ব্যাকএন্ডের মাধ্যমে বা n8n, Make বা Zapier-এর মতো ওয়ার্কফ্লো টুলের মাধ্যমে, যেখানে এর জন্য নোড আছে। HubSpot-এর একটি Communications অবজেক্ট আছে যার একটি WhatsApp চ্যানেল টাইপ রয়েছে, যা এসব মেসেজ লগ করার জন্য তৈরি; HubSpot পৃষ্ঠায় কলটি দেখানো আছে।
আমার টিম কি CRM থেকে গ্রাহকদের উত্তর দিতে পারবে?
শুধু যদি CRM Meta-র Cloud API দিয়ে পাঠায়, নম্বরের সেন্ড এন্ডপয়েন্ট এবং get_api_credentials থেকে পাওয়া টোকেন ব্যবহার করে: গ্রাহকের শেষ মেসেজের 24 ঘণ্টার মধ্যে ফ্রি টেক্সট, তারপর একটি অনুমোদিত টেমপ্লেট। এসব মেসেজ ফোনে অ্যাপের চ্যাট থ্রেডেও দেখা যায়।
পুরনো কথোপকথন কি CRM-এ লোড করা যাবে?
শুধু Meta-র history import-এর মাধ্যমে, যা প্রতি সংযোগে একবার, সংযোগের 24 ঘণ্টার মধ্যে সংরক্ষিত একটি সরাসরি ওয়েবহুক ডেস্টিনেশনে 6 মাস পর্যন্ত একে-এক চ্যাট পাঠায়। "Through easyCoexistence" সেট করা একটি নম্বর ফরওয়ার্ডিং শুরুর মুহূর্ত থেকে লগ করে।
easyCoexistence পথে কী কী জমা রাখে?
ফরওয়ার্ড করা পরিবর্তনগুলো পুনরায় চেষ্টার জন্য সারিতে রাখা হয় এবং 7 দিন পর মুছে ফেলা হয়। easyCoexistence-এর মধ্য দিয়ে যাওয়া নম্বরে মেসেজের টেক্সট Conversations ও AI কনটেক্সটের জন্য আপনার বেছে নেওয়া সময় পর্যন্ত, 30, 90 বা 365 দিন, থেকে যায়, আর রান লগ 30 দিন রাখা হয়। স্থায়ী রেকর্ড রাখে CRM।
আরও পড়ুন
শুরু করতে প্রস্তুত?
মাস নয়, কয়েক মিনিটেই WhatsApp Coexistence সেট আপ করুন। ফোনে অ্যাপটি কাজ করতে থাকে।
ফ্রি ট্রায়াল শুরু করুনযাচাই করা হয়েছে