কোনো গ্রাহকের WhatsApp বা সোশ্যাল সংযোগ বিচ্ছিন্ন হলে কীভাবে জানবেন
গ্রাহকের সংযোগ যুক্ত হলে, বিচ্ছিন্ন হলে, মুছে ফেলা হলে বা স্থগিত হলে easyCoexistence আপনার প্ল্যাটফর্মে স্বাক্ষরযুক্ত স্ট্যাটাস ইভেন্ট পাঠায়। WhatsApp নম্বরের জন্য পাঠানো হয় connection.connected, Meta-র কারণসহ connection.disconnected, connection.removed, connection.suspended অথবা connection.token_missing। সোশ্যাল অ্যাকাউন্টের জন্য একই ধরনের channel.* ইভেন্ট পাঠানো হয়, তবে token_missing ছাড়া। প্রতিটি ইভেন্ট একটি JSON POST হিসেবে যায়, X-EC-Signature দিয়ে স্বাক্ষরিত হয়, এবং আপনার এন্ডপয়েন্ট 2xx উত্তর না দেওয়া পর্যন্ত প্রায় 33 ঘণ্টা ধরে ক্রমশ বিরতি বাড়িয়ে আবার পাঠানো হয়।
PRIMARY_INACTIVITY: Meta-র কারণ, যখন প্রাথমিক ডিভাইস প্রায় 14 দিন নিষ্ক্রিয় ছিল, ফলে একটি Coexistence নম্বরের সংযোগ বিচ্ছিন্ন হয়।
COMPANION_INACTIVITY: Meta-র কারণ, যখন একটি সহযোগী ডিভাইস প্রায় 30 দিন নিষ্ক্রিয় ছিল।
যে ওয়েবহুক বিচ্ছিন্নতার খবর দেয়, Meta সেটি সবসময় অ্যাপের ডিফল্ট কলব্যাক URL-এ পাঠায়, কখনো ওভাররাইড-এ নয়।
কোনো 2xx-বহির্ভূত উত্তরের পর একটি স্ট্যাটাস ইভেন্ট কতবার চেষ্টা করা হয়, 1 মিনিট থেকে 24 ঘণ্টার ব্যবধানে, প্রায় 33 ঘণ্টা ধরে।
একটি স্ট্যাটাস ইভেন্টে এন্ডপয়েন্ট যে সর্বপুরাতন স্বাক্ষরিত টাইমস্ট্যাম্প t গ্রহণ করবে, এবং HMAC যাচাই ধ্রুব-সময়ের তুলনায়।
কী কী স্ট্যাটাস ইভেন্ট আছে?
নয়টি, দুটি পরিবারে, যারা একটি এন্ডপয়েন্ট ও একটি স্বাক্ষরের গোপন কী ভাগ করে। নম্বরের জন্য connection.* এবং সোশ্যাল অ্যাকাউন্টের জন্য channel.* ব্যবহৃত হয়, তাই নম্বরের জন্য লেখা রিসিভার channel ইভেন্ট নাম ধরে এড়িয়ে যেতে পারে। ড্যাশবোর্ডে Profile, তারপর Developers-এ এন্ডপয়েন্ট সেট করুন, অথবা MCP টুল set_partner_events_url দিয়ে। স্বাক্ষরের গোপন কী URL সংরক্ষণের সময় একবারই দেখানো হয়।
একটি সংযোগ ইভেন্টে কী থাকে?
ডেলিভারির id, একটি UUID; ইভেন্টের নাম; ISO 8601 ফরম্যাটে occurred_at; এবং id, external_ref, connect_session_id, phone, name, waba_id, phone_number_id, status ও token_ready সহ একটি connection অবজেক্ট। কিছু ইভেন্টে উপরের স্তরে একটি অতিরিক্ত ফিল্ড যোগ হয়: connection.disconnected ও connection.suspended-এ reason; detected_by, যা health_check হয় যখন easyCoexistence-এর নিজস্ব পর্যায়ক্রমিক পরীক্ষায় বিচ্ছিন্নতা ধরা পড়ে, Meta-র ওয়েবহুকে নয়; এবং connect_session_id, যখন একটি connect session ইভেন্টটি তৈরি করে।
{
"id": "5c2a9e70-…",
"event": "connection.disconnected",
"occurred_at": "2026-10-31T10:15:02.114Z",
"connection": {
"id": "<CONNECTION_ID>",
"external_ref": "customer_4821",
"connect_session_id": "cs_…",
"phone": "+55 11 9…",
"name": "Clínica Sorriso",
"waba_id": "<WABA_ID>",
"phone_number_id": "<PHONE_NUMBER_ID>",
"status": "disconnected",
"token_ready": true
},
"reason": "PRIMARY_INACTIVITY"
}একটি চ্যানেল ইভেন্টে কী থাকে?
একই কাঠামো, তবে connection-এর জায়গায় একটি channel অবজেক্ট। এটি GET /channels/{id}-এর দৃশ্য: id, channel (নেটওয়ার্ক), external_ref, connect_session_id, name, username, external_id, status, token_ready, webhook_url, disconnected_reason, last_checked_at এবং created_at। চ্যানেলে token_missing নেই, কারণ সোশ্যাল সাইন-ইন সবসময় গ্রাহকের নিজস্ব টোকেন দেয়। connect session থেকে আসা channel.connected-এ উপরের স্তরেও connect_session_id থাকে।
{
"id": "0b7e41d2-…",
"event": "channel.disconnected",
"occurred_at": "2026-10-31T10:15:02.114Z",
"channel": {
"id": "<CHANNEL_ID>",
"channel": "tiktok",
"external_ref": "customer_4821",
"connect_session_id": "cs_…",
"name": "Clínica Sorriso",
"username": "clinicasorriso",
"external_id": "<TIKTOK_OPEN_ID>",
"status": "disconnected",
"token_ready": false,
"webhook_url": "https://hooks.example.com/social",
"disconnected_reason": "<THE_NETWORK'S_MESSAGE>",
"last_checked_at": "2026-10-31T10:15:02.000Z",
"created_at": "2026-10-28T16:40:09.000Z"
}
}বিচ্ছিন্নতার কারণগুলোর অর্থ কী?
connection.disconnected-এর reason হলো Meta তার account_update ওয়েবহুকের disconnection_info-তে যে কোড দেয় সেটি, যা নম্বরের জন্য WhatsApp Business অ্যাপ ও Cloud API উভয়ের ক্ষেত্রেই অন্তর্ভুক্ত হয়। Meta কোনো কারণ না দিলে এটি null। Meta-র রেফারেন্সের কোডগুলো:
PRIMARY_INACTIVITY: WhatsApp Business অ্যাপ চালানো ফোনটি প্রায় 14 দিন নিষ্ক্রিয় ছিল, অর্থাৎ 14 দিনের নিয়ম। একটি নতুন connect session নম্বরটিকে আবার সংযুক্ত করে।ACCOUNT_DISCONNECTED: Meta-র প্রয়োগ-ব্যবস্থা বা গ্রাহকের কারণে অ্যাকাউন্টের সংযোগ বিচ্ছিন্ন হয়েছে; গ্রাহক অ্যাক্সেস সরিয়ে দিয়ে থাকতে পারেন, বা অ্যাকাউন্ট মুছে থাকতে পারেন।COMPANION_INACTIVITY: একটি সহযোগী ডিভাইস প্রায় 30 দিন নিষ্ক্রিয় ছিল।BUSINESS_DOWNGRADE: নম্বরটি সাধারণ ভোক্তা WhatsApp অ্যাপে নিবন্ধিত ছিল।CHANGE_NUMBERওUSER_RE_REGISTERED: গ্রাহক নম্বরটি বদলেছেন, অথবা নতুন ডিভাইসে আবার নিবন্ধন করেছেন।
একটি স্ট্যাটাস ইভেন্টের সঙ্গে কোন হেডার আসে?
পাঁচটি, প্রতিটি চেষ্টায়: Content-Type application/json, User-Agent easyCoexistence-webhooks/1, ইভেন্টের নামসহ X-EC-Event, বডির সঙ্গে একই id-সহ X-EC-Delivery এবং X-EC-Signature। স্বাক্ষরটি t=<unix>,v1=<hex> আকারে থাকে, যেখানে v1 হলো t, একটি ডট এবং কাঁচা বডির HMAC-SHA256, যা আপনার অ্যাকাউন্টের স্বাক্ষরের গোপন কী দিয়ে তৈরি এবং যা whsec_ দিয়ে শুরু হয়। প্রতিটি চেষ্টা নতুনভাবে স্বাক্ষরিত হয়, তাই একই বডির পুনঃচেষ্টায় নতুন t থাকে।
import hashlib, hmac, json, os, time
SECRET = os.environ["EC_EVENTS_SECRET"].encode() # whsec_..., shown once in Profile > Developers
def verify(raw: bytes, header: str) -> bool:
parts = dict(p.split("=", 1) for p in header.split(",") if "=" in p)
t, v1 = parts.get("t", ""), parts.get("v1", "")
if not t.isdigit() or abs(time.time() - int(t)) > 300:
return False # missing, or more than 5 minutes off
mac = hmac.new(SECRET, t.encode() + b"." + raw, hashlib.sha256).hexdigest()
return hmac.compare_digest(mac, v1)
def handle(raw: bytes, headers) -> int:
if not verify(raw, headers.get("X-EC-Signature", "")):
return 401
event = json.loads(raw)
if already_processed(event["id"]): # the X-EC-Delivery id, the same on every retry
return 200
enqueue(event) # act on event["event"]; the latest occurred_at wins
return 200ব্যর্থ ডেলিভারি কীভাবে আবার পাঠানো হয়?
প্রথম চেষ্টাটি ইভেন্ট ঘটার সঙ্গে সঙ্গেই যায়। 2xx-বহির্ভূত উত্তর, 10 সেকেন্ডের মধ্যে উত্তর না আসা, নেটওয়ার্ক ত্রুটি বা রিডাইরেক্ট ব্যর্থতা হিসেবে গণ্য হয়। তখন ইভেন্টটি ক্রমশ বাড়তে থাকা বিরতিতে, 1 মিনিট থেকে 24 ঘণ্টা পর্যন্ত, মোট সাতবার, প্রায় 33 ঘণ্টা ধরে আবার চেষ্টা করা হয়; তারপর বাদ দেওয়া হয়। ডেলিভারি শুধু এমন একটি HTTPS ঠিকানায় যায় যা একটি পাবলিক IP ঠিকানায় রেজল্ভ হয়। যখন কোনো এন্ডপয়েন্ট সেট থাকে না, তখন ঘটা ইভেন্ট কিউতে জমা রাখা হয় না, এবং এন্ডপয়েন্ট সরিয়ে দিলে অপেক্ষমান সবকিছু বন্ধ হয়।
কেন প্রতিটি id একবার প্রক্রিয়া করতে হবে এবং occurred_at যাচাই করতে হবে?
কারণ পুনঃচেষ্টা ডেলিভারিটি হুবহু পুনরাবৃত্তি করে, বডিতে ও X-EC-Delivery-তে একই id সহ। আর কারণ পুনঃচেষ্টা করা ইভেন্ট একটি নতুন ইভেন্টের পরে পৌঁছাতে পারে। প্রক্রিয়া করা id-গুলো সংরক্ষণ করুন এবং পুনরাবৃত্তি এড়িয়ে যান। তারপর occurred_at-কে ওই সংযোগের শেষ সংরক্ষিত অবস্থার সঙ্গে তুলনা করুন, অথবা পুরোনো হতে পারে এমন ইভেন্টে কাজ করার আগে GET /connections/{id} বা GET /channels/{id} পড়ুন।
নম্বর বিচ্ছিন্ন হলে একটি প্ল্যাটফর্মের কী করা উচিত?
কারণ অনুযায়ী ব্যবস্থা নিন। PRIMARY_INACTIVITY-এর পরে গ্রাহককে WhatsApp Business অ্যাপ খুলতে বলুন এবং একই নম্বরের জন্য তাদের একটি নতুন connect session পাঠান। একই WhatsApp Business Account-এ আবার সংযুক্ত করলে এর connection ID অপরিবর্তিত থাকে, আপনার ওয়েবহুক গন্তব্য ফিরে আসে এবং connection.connected পাঠানো হয়; তখন এর ক্রেডেনশিয়াল আবার পড়ুন। connection.token_missing মানে ওই দফায় Meta কোনো টোকেন দেয়নি। বিচ্ছিন্নতার সঙ্গে জড়িত account_update Meta শুধু অ্যাপের নিজস্ব কলব্যাকে পাঠায়, আপনার URL-এ নয়; তাই এই ইভেন্টই আপনার প্ল্যাটফর্মকে তা জানায়।
সোশ্যাল অ্যাকাউন্ট বিচ্ছিন্ন হলে একটি প্ল্যাটফর্মের কী করা উচিত?
channel.disconnected-এ একই channel ID-এর অধীনে একটি নতুন connect session চ্যানেলটিকে আবার সাইন ইন করায়। channel.removed মানে অ্যাক্সেস চলে গেছে: টোকেন ভুলে যাওয়া হয় এবং যেকোনো ওয়েবহুক গন্তব্য মুছে ফেলা হয়, তাই গ্রাহক পুনরায় সংযুক্ত করলে গন্তব্য আবার সেট করুন। স্থগিত নম্বর বা চ্যানেল আপনার সাবস্ক্রিপশন আবার সক্রিয় হলে একবার পুনরায় সংযুক্ত করলেই ফিরে আসে।
সাধারণ ভুলগুলো
- পুনঃচেষ্টাকে নতুন ইভেন্ট ধরা। এতে বডিতে ও X-EC-Delivery-তে একই id থাকে, তাই প্রক্রিয়া করা id-গুলো রেকর্ড করুন, নইলে একটি বিচ্ছিন্নতা একজন গ্রাহককে দুবার সতর্ক করতে পারে।
- আগমনের ক্রমে ইভেন্ট প্রয়োগ করা। পুনঃচেষ্টা করা ইভেন্ট একটি নতুন ইভেন্টের পরে পৌঁছাতে পারে, তাই occurred_at তুলনা করুন, অথবা কাজ করার আগে সংযোগটি পড়ুন।
- একটি বানান ভুল ঠিক করতে ব্যাকএন্ড আপডেট না করে ইভেন্টের URL আবার সংরক্ষণ করা। সংরক্ষণ করলে নতুন স্বাক্ষরের গোপন কী তৈরি হয়, আর আপনার এন্ডপয়েন্ট সেটি ব্যবহার না করা পর্যন্ত প্রতিটি ডেলিভারি যাচাইয়ে ব্যর্থ হয়।
- উত্তর দেওয়ার আগে কাজ করা। যে হ্যান্ডলার 10 সেকেন্ডের বেশি নেয় তা ব্যর্থ ধরা হয় এবং ইভেন্ট ফিরে আসে, তাই আগে 2xx উত্তর দিন, পরে প্রক্রিয়া করুন।
easyCoexistence প্রতিটি গ্রাহকের WhatsApp নম্বর ও সোশ্যাল অ্যাকাউন্ট সারাক্ষণ পর্যবেক্ষণ করে, এবং কোনোটি যুক্ত, বিচ্ছিন্ন, মুছে বা স্থগিত হলে আপনার প্ল্যাটফর্মে একটি স্বাক্ষরযুক্ত ইভেন্ট পাঠায়; বিচ্ছিন্ন নম্বরের জন্য Meta-র কারণসহ। প্রতি সংযোগে প্রতি মাসে US$ 9 থেকে US$ 0.75, সংযোগ বাড়ালে কমে; প্রথম 3 দিন ফ্রি।
প্রায়শই জিজ্ঞাসিত প্রশ্ন
PRIMARY_INACTIVITY মানে কী?
এটি Meta-র কারণ, যখন একটি Coexistence নম্বরের WhatsApp Business অ্যাপ প্রাথমিক ডিভাইসে প্রায় 14 দিন ব্যবহার হয়নি, আর সেই কারণে নম্বরটির সংযোগ বিচ্ছিন্ন হয়। ওই গ্রাহকের জন্য একটি নতুন connect session নম্বরটিকে আবার সংযুক্ত করে।
স্ট্যাটাস ইভেন্টে কি মেসেজ থাকে?
না। এগুলো একটি সংযোগের স্ট্যাটাস নিয়ে। নম্বরের মেসেজ Meta থেকে তার নিজস্ব ওয়েবহুক গন্তব্যে যায়, আর সোশ্যাল মন্তব্য ও DM প্রতিটি চ্যানেলের গন্তব্যে।
ইভেন্টের URL কোথায় সেট করব?
ড্যাশবোর্ডে Profile, তারপর Developers-এ, অথবা MCP টুল set_partner_events_url দিয়ে। স্বাক্ষরের গোপন কী একবারই দেখানো হয়, এবং URL আবার সংরক্ষণ করলে একটি নতুন কী তৈরি হয়।
শুধু নম্বর নিয়ে কাজ করলে কি চ্যানেল ইভেন্ট উপেক্ষা করতে পারি?
হ্যাঁ। channel.* ইভেন্টের নিজস্ব নাম আছে এবং connection-এর বদলে একটি channel অবজেক্ট থাকে, তাই রিসিভার connection দিয়ে শুরু না হওয়া নামের যেকোনো ইভেন্ট এড়িয়ে যেতে পারে।
আরও পড়ুন
দুই মিনিটে আপনার প্রথম চ্যানেল সংযুক্ত করুন।
প্ল্যাটফর্মের রিভিউয়ের জন্য অপেক্ষা করতে হবে না। WhatsApp, Instagram, TikTok বা অন্য কোনো চ্যানেল সংযুক্ত করুন, তারপর আপনার AI-কে পোস্ট করতে, রিপ্লাই দিতে বা রিপোর্ট দিতে বলুন, আর নিজের চোখে দেখুন কীভাবে কাজ করে।
- 3 দিন ফ্রি
- যেকোনো সময় বাতিল করুন
- শুধুমাত্র অফিশিয়াল API
- 24/7 পর্যবেক্ষণ
যাচাই করা হয়েছে