لاگ اِن کریںفری ٹرائل شروع کریں
easyCoexistence آفیشل APIs

کسٹمر کا WhatsApp یا سوشل کنکشن کب منقطع ہوتا ہے، یہ کیسے جانیں

easyCoexistence جب کسی کسٹمر کا WhatsApp نمبر کنیکٹ ہو، منقطع ہو، ہٹایا جائے یا معطل ہو، تو آپ کے پلیٹ فارم کو دستخط شدہ اسٹیٹس ایونٹ بھیجتا ہے۔ ایک WhatsApp نمبر connection.connected، Meta کی وجہ کے ساتھ connection.disconnected، connection.removed، connection.suspended یا connection.token_missing بھیجتا ہے؛ سوشل اکاؤنٹ انہی کے مساوی channel.* ایونٹس بھیجتا ہے، لیکن token_missing کے بغیر۔ ہر ایونٹ X-EC-Signature کے ساتھ دستخط شدہ JSON POST ہوتا ہے، اور آپ کا اینڈ پوائنٹ 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.*، اس لیے نمبروں کے لیے لکھا گیا ریسیور چینل ایونٹس کو نام سے چھوڑ سکتا ہے۔ اینڈ پوائنٹ ڈیش بورڈ میں 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؛ اور connection آبجیکٹ جس میں id، external_ref، connect_session_id، phone، name، waba_id، phone_number_id، status اور token_ready ہوتے ہیں۔ کچھ ایونٹس اوپر کی سطح کا ایک فیلڈ بھی شامل کرتے ہیں: connection.disconnected اور connection.suspended پر reason، detected_by جو health_check ہو جب easyCoexistence کی اپنی وقفے وقفے سے ہونے والی جانچ نے منقطع ہونا پکڑا، نہ کہ Meta کے ویب ہک نے، اور connect_session_id جب کنیکٹ سیشن نے ایونٹ بنایا۔

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 نہیں ہوتا، کیونکہ سوشل سائن ان ہمیشہ کسٹمر کا اپنا ٹوکن دیتا ہے، اور کنیکٹ سیشن سے آنے والا 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 دن کا اصول۔ نیا کنیکٹ سیشن نمبر کو دوبارہ کنیکٹ کرتا ہے۔
  • 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 گھنٹے تک بڑھتے وقفوں کے ساتھ دوبارہ کوشش کیا جاتا ہے، کل 7 کوششیں، تقریباً 33 گھنٹے میں، اس سے پہلے کہ وہ ختم کر دیا جائے۔ ڈیلیوریاں صرف ایسے HTTPS پتے پر جاتی ہیں جو عوامی IP پر حل ہوتا ہو۔ جو ایونٹ ایسے وقت ہو جب کوئی اینڈ پوائنٹ سیٹ نہ ہو وہ کبھی قطار میں نہیں لگتا، اور اینڈ پوائنٹ ہٹانے سے ہر زیرِ التوا ڈیلیوری رک جاتی ہے۔

ہر id ایک بار کیوں ہینڈل کریں اور occurred_at کیوں چیک کریں؟

کیونکہ دوبارہ کوشش ڈیلیوری کو ہو بہو دہراتی ہے، باڈی اور X-EC-Delivery دونوں میں ایک ہی id کے ساتھ، اور دوبارہ کوشش والا ایونٹ کسی نئے ایونٹ کے بعد بھی پہنچ سکتا ہے۔ جن id پر آپ عمل کر چکے ہیں انہیں محفوظ کریں اور دہرائے گئے کو چھوڑ دیں۔ پھر occurred_at کا موازنہ اس کنکشن کی آخری ریکارڈ شدہ اسٹیٹ سے کریں، یا کسی ممکنہ پرانے ایونٹ پر عمل سے پہلے GET /connections/{id} یا GET /channels/{id} پڑھیں۔

نمبر منقطع ہونے پر پلیٹ فارم کو کیا کرنا چاہیے؟

وجہ کے مطابق عمل کریں۔ PRIMARY_INACTIVITY کے بعد کسٹمر سے کہیں کہ WhatsApp Business ایپ کھولے، اور اسی نمبر کے لیے نیا کنیکٹ سیشن بھیجیں۔ اسی WhatsApp Business اکاؤنٹ پر دوبارہ کنیکٹ کرنے سے اس کا connection ID برقرار رہتا ہے، آپ کا ویب ہک منزل واپس لگتا ہے اور connection.connected بھیجا جاتا ہے، جس کے بعد آپ اس کی اسناد دوبارہ پڑھتے ہیں؛ connection.token_missing اس کے برعکس بتاتا ہے کہ اس عمل میں Meta نے ٹوکن جاری نہیں کیا۔ Meta منقطع ہونے کے پیچھے کا account_update صرف ایپ کے اپنے کال بیک کو بھیجتا ہے، آپ کے URL کو کبھی نہیں، اس لیے یہی ایونٹ ہے جس سے آپ کا پلیٹ فارم اس کے بارے میں جانتا ہے۔

سوشل اکاؤنٹ منقطع ہونے پر پلیٹ فارم کو کیا کرنا چاہیے؟

channel.disconnected پر، اسی چینل کے ساتھ نیا کنیکٹ سیشن اسی channel ID کے تحت اکاؤنٹ کو دوبارہ سائن ان کرتا ہے۔ 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 دن تک استعمال نہ ہوئی ہو۔ اس کسٹمر کے لیے نیا کنیکٹ سیشن نمبر کو دوبارہ کنیکٹ کرتا ہے۔

کیا اسٹیٹس ایونٹس میں میسجز شامل ہوتے ہیں؟

نہیں۔ یہ کنکشن کی اسٹیٹس کا احاطہ کرتے ہیں۔ نمبر کے میسجز Meta سے اس کی اپنی ویب ہک منزل پر جاتے ہیں، اور سوشل کمنٹس اور DMs ہر چینل کی منزل پر۔

ایونٹس URL کہاں سیٹ کیا جاتا ہے؟

ڈیش بورڈ میں Profile، پھر Developers کے تحت، یا MCP ٹول set_partner_events_url سے۔ دستخطی سیکریٹ ایک بار دکھایا جاتا ہے، اور URL دوبارہ محفوظ کرنے سے نیا دستخطی سیکریٹ جاری ہوتا ہے۔

اگر میں صرف نمبر ہینڈل کرتا ہوں تو کیا میں چینل ایونٹس نظرانداز کر سکتا ہوں؟

جی ہاں۔ channel.* ایونٹس کے اپنے نام ہیں اور connection کی بجائے channel آبجیکٹ رکھتے ہیں، اس لیے ریسیور ہر ایسا ایونٹ چھوڑ سکتا ہے جس کا نام connection سے شروع نہ ہو۔

مزید پڑھیں

گاہکوں کے WhatsApp میسجز اور سوشل کمنٹس ویب ہک کے ذریعے کیسے وصول کریںہر کنکشن کا اپنا ویب ہک: WhatsApp میسجز Meta سے براہ راست، URL کی خفیہ کلید سے تصدیق شدہ، اور سوشل کمنٹس اور DMs X-EC-Signature کے ساتھ دستخط شدہ۔گاہک کے API ٹوکن کیسے حاصل کریں: WhatsApp، Instagram اور TikTok کے لیےWhatsApp نمبر اور ہر سوشل اکاؤنٹ کے کریڈینشلز کال کیا لوٹاتی ہے، فیلڈ بہ فیلڈ، اور ٹوکن کی تبدیلی اور token_ready کیسے کام کرتے ہیں۔API کے ذریعے WhatsApp Business ایپ کی چیٹ ہسٹری اور رابطے امپورٹ کریںCoexistence کے ذریعے WhatsApp Business ایپ کے رابطے اور 180 دن تک کی چیٹس امپورٹ کریں: ہسٹری ویب ہکس، chunk_order، progress اور ایرر کوڈ 2593109 کی تفصیل۔صارفین کے WhatsApp، Instagram اور TikTok پر AI ایجنٹ پروڈکٹ کیسے بنائیںپارٹنر API، اپنے ماڈل اور ہر نیٹ ورک کے قواعد کے ساتھ صارفین کے WhatsApp، Instagram، Facebook اور TikTok پر AI ایجنٹ پروڈکٹ بنائیں۔account_update ویب ہک اور ہر ڈس کنکشن کی وجہaccount_update کنکشن کی حالت بدلنے کی اطلاع دیتا ہے۔ Meta کی بھیجی تمام ڈس کنکشن وجوہ، ان کے مطلب اور قابل بحالی وجوہ یہاں ہیں۔نمبر نے کام کرنا بند کر دیا: وجہ کیسے معلوم کریںان خرابیوں کی ترتیب وار چیک لسٹ: ٹوکن، ویب ہک اوور رائڈ، غیر فعالیت پر کنکشن ختم ہونا، کوالٹی اور اکاؤنٹ کی پابندی۔

دو منٹ میں اپنا پہلا چینل کنیکٹ کریں۔

کسی پلیٹ فارم کے ریویو کا انتظار نہیں۔ WhatsApp، Instagram، TikTok یا کوئی اور چینل کنیکٹ کریں، پھر اپنے AI سے پوسٹ کرنے، جواب دینے یا رپورٹ بنانے کو کہیں اور اسے کام کرتے دیکھیں۔

  • 3 دن مفت
  • کسی بھی وقت منسوخ کریں
  • صرف آفیشل API
  • 24/7 نگرانی

تصدیق شدہ تاریخ