লগ ইনফ্রি ট্রায়াল শুরু করুন
easyCoexistence অফিসিয়াল API

কোনো গ্রাহকের 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 ঘণ্টা ধরে ক্রমশ বিরতি বাড়িয়ে আবার পাঠানো হয়।

~14 days

PRIMARY_INACTIVITY: Meta-র কারণ, যখন প্রাথমিক ডিভাইস প্রায় 14 দিন নিষ্ক্রিয় ছিল, ফলে একটি Coexistence নম্বরের সংযোগ বিচ্ছিন্ন হয়।

~30 days

COMPANION_INACTIVITY: Meta-র কারণ, যখন একটি সহযোগী ডিভাইস প্রায় 30 দিন নিষ্ক্রিয় ছিল।

account_update

যে ওয়েবহুক বিচ্ছিন্নতার খবর দেয়, Meta সেটি সবসময় অ্যাপের ডিফল্ট কলব্যাক URL-এ পাঠায়, কখনো ওভাররাইড-এ নয়।

7 attempts

কোনো 2xx-বহির্ভূত উত্তরের পর একটি স্ট্যাটাস ইভেন্ট কতবার চেষ্টা করা হয়, 1 মিনিট থেকে 24 ঘণ্টার ব্যবধানে, প্রায় 33 ঘণ্টা ধরে।

5 minutes

একটি স্ট্যাটাস ইভেন্টে এন্ডপয়েন্ট যে সর্বপুরাতন স্বাক্ষরিত টাইমস্ট্যাম্প t গ্রহণ করবে, এবং HMAC যাচাই ধ্রুব-সময়ের তুলনায়।

কী কী স্ট্যাটাস ইভেন্ট আছে?

নয়টি, দুটি পরিবারে, যারা একটি এন্ডপয়েন্ট ও একটি স্বাক্ষরের গোপন কী ভাগ করে। নম্বরের জন্য connection.* এবং সোশ্যাল অ্যাকাউন্টের জন্য channel.* ব্যবহৃত হয়, তাই নম্বরের জন্য লেখা রিসিভার channel ইভেন্ট নাম ধরে এড়িয়ে যেতে পারে। ড্যাশবোর্ডে Profile, তারপর Developers-এ এন্ডপয়েন্ট সেট করুন, অথবা MCP টুল set_partner_events_url দিয়ে। স্বাক্ষরের গোপন কী URL সংরক্ষণের সময় একবারই দেখানো হয়।

connection.connectedA number connected, came back after a drop, or got its customer token on a second run.
connection.disconnectedMeta dropped the link; reason carries Meta's code when known.
connection.removedRemoved with DELETE /connections/{id} or from the dashboard.
connection.suspendedYour subscription lapsed; reason names its state.
connection.token_missingConnected without a customer token: it receives, but cannot send yet.
channel.connectedA social account connected, one event per Page when a sign-in brings several.
channel.disconnectedThe network refused the token, or the owner withdrew access.
channel.removedRemoved with DELETE /channels/{id} or from the dashboard, or the owner removed the app on Meta.
channel.suspendedYour subscription lapsed.

একটি সংযোগ ইভেন্টে কী থাকে?

ডেলিভারির 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 ইভেন্টটি তৈরি করে।

connection.disconnected
{
  "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 থাকে।

channel.disconnected
{
  "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 থাকে।

Python: verify, then handle each id once
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 দিয়ে এটি করা

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 মেসেজ ও সোশ্যাল কমেন্ট ওয়েবহুকের মাধ্যমে কীভাবে পাবেনপ্রতিটি সংযোগের জন্য আলাদা ওয়েবহুক: Meta থেকে সরাসরি WhatsApp মেসেজ, URL-এর গোপন কী দিয়ে যাচাই করা, আর সোশ্যাল কমেন্ট ও DM X-EC-Signature দিয়ে স্বাক্ষরিত।WhatsApp, Instagram ও TikTok-এর জন্য গ্রাহকদের API টোকেন কীভাবে পাবেনWhatsApp নম্বর ও প্রতিটি সোশ্যাল অ্যাকাউন্টের ক্রেডেনশিয়াল কল কী ফেরত দেয়, ফিল্ড ধরে ধরে, এবং টোকেন নবায়ন কীভাবে কাজ করে।API-এর মাধ্যমে WhatsApp Business অ্যাপের চ্যাট ইতিহাস ও কন্টাক্ট ইমপোর্ট করার উপায়Coexistence-এর WhatsApp Business অ্যাপ নম্বরের কন্টাক্ট ও 180 দিনের চ্যাট ইমপোর্ট: হিস্ট্রি ওয়েবহুক, chunk_order, প্রগ্রেস ও 2593109।কীভাবে আপনার গ্রাহকের WhatsApp, Instagram ও TikTok-এ একটি AI এজেন্ট প্রোডাক্ট তৈরি করবেনগ্রাহকের WhatsApp, Instagram, Facebook ও TikTok-এ Partner API, নিজস্ব মডেল ও প্রতিটি নেটওয়ার্কের নিয়ম মেনে একটি AI এজেন্ট প্রোডাক্ট তৈরি করুন।account_update ও প্রতিটি সংযোগ বিচ্ছিন্নতার কারণaccount_update সংযোগের অবস্থার পরিবর্তন জানায়। Meta পাঠানো সব বিচ্ছিন্নতার কারণ, অর্থ এবং কোনগুলো ফিরিয়ে আনা যায়।নম্বর কাজ করা বন্ধ করেছে: কারণ জানবেন কীভাবেটোকেন, ওয়েবহুক ওভাররাইড, নিষ্ক্রিয়তায় সংযোগ বিচ্ছিন্ন, মান ও অ্যাকাউন্ট সীমাবদ্ধতা, বাস্তব ঘটনার ক্রমে সাজানো একটি তালিকা।

দুই মিনিটে আপনার প্রথম চ্যানেল সংযুক্ত করুন।

প্ল্যাটফর্মের রিভিউয়ের জন্য অপেক্ষা করতে হবে না। WhatsApp, Instagram, TikTok বা অন্য কোনো চ্যানেল সংযুক্ত করুন, তারপর আপনার AI-কে পোস্ট করতে, রিপ্লাই দিতে বা রিপোর্ট দিতে বলুন, আর নিজের চোখে দেখুন কীভাবে কাজ করে।

  • 3 দিন ফ্রি
  • যেকোনো সময় বাতিল করুন
  • শুধুমাত্র অফিশিয়াল API
  • 24/7 পর্যবেক্ষণ

যাচাই করা হয়েছে