کسٹمر کا 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 گھنٹے تک بڑھتے وقفوں کے ساتھ دوبارہ بھیجا جاتا ہے۔
PRIMARY_INACTIVITY: Meta کی وہ وجہ جب پرائمری ڈیوائس تقریباً 14 دن تک غیر فعال رہے، جس سے Coexistence نمبر منقطع ہو جاتا ہے۔
COMPANION_INACTIVITY: Meta کی وہ وجہ جب ساتھی ڈیوائس تقریباً 30 دن تک غیر فعال رہے۔
وہ ویب ہک جو منقطع ہونے کی اطلاع دیتا ہے۔ Meta اسے ہمیشہ ایپ کے ڈیفالٹ کال بیک URL پر بھیجتا ہے، کسی اوور رائیڈ پر کبھی نہیں۔
غیر 2xx جواب کے بعد اسٹیٹس ایونٹ کو دوبارہ کتنی بار کوشش کیا جاتا ہے: 1 منٹ سے 24 گھنٹے تک کے وقفوں کے ساتھ، تقریباً 33 گھنٹے میں۔
اسٹیٹس ایونٹ پر اینڈ پوائنٹ جس سب سے پرانے دستخط شدہ ٹائم اسٹیمپ t کو قبول کرے، اور HMAC کا موازنہ مستقل وقت میں ہو۔
کون سے اسٹیٹس ایونٹس ہیں؟
نو ایونٹس، دو گروپس میں، جو ایک ہی اینڈ پوائنٹ اور ایک ہی دستخطی سیکریٹ شیئر کرتے ہیں۔ نمبرز connection.* استعمال کرتے ہیں اور سوشل اکاؤنٹس channel.*، اس لیے نمبروں کے لیے لکھا گیا ریسیور چینل ایونٹس کو نام سے چھوڑ سکتا ہے۔ اینڈ پوائنٹ ڈیش بورڈ میں Profile، پھر Developers کے تحت سیٹ کریں، یا MCP ٹول set_partner_events_url سے؛ دستخطی سیکریٹ URL محفوظ ہونے پر ایک بار دکھایا جاتا ہے۔
کنکشن ایونٹ میں کیا ہوتا ہے؟
ڈیلیوری کا 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 جب کنیکٹ سیشن نے ایونٹ بنایا۔
{
"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 بھی رکھتا ہے۔
{
"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 کے ساتھ اسی باڈی پر جاتی ہے۔
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 ہر کسٹمر کے 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، Instagram، TikTok یا کوئی اور چینل کنیکٹ کریں، پھر اپنے AI سے پوسٹ کرنے، جواب دینے یا رپورٹ بنانے کو کہیں اور اسے کام کرتے دیکھیں۔
- 3 دن مفت
- کسی بھی وقت منسوخ کریں
- صرف آفیشل API
- 24/7 نگرانی
تصدیق شدہ تاریخ