API کے ذریعے WhatsApp Business ایپ کی چیٹ ہسٹری اور رابطے امپورٹ کریں
Coexistence کے ذریعے جڑا WhatsApp Business ایپ نمبر اپنے موجودہ رابطے اور 180 دن تک کی ون ٹو ون چیٹس آن بورڈنگ کے 24 گھنٹوں کے اندر API کو ایک بار بھیج سکتا ہے۔ رابطے smb_app_state_sync ویب ہکس کے طور پر آتے ہیں اور چیٹس history ویب ہکس کے طور پر، metadata.chunk_order کی ترتیب سے چنکس میں۔ metadata.progress کی قدر 100 ہونے پر امپورٹ مکمل ہو جاتا ہے۔ چیٹ شیئر کرنی ہے یا نہیں، یہ فیصلہ کاروبار ایپ میں کرتا ہے۔
easyCoexistence آپ کے گاہکوں کے WhatsApp Business ایپ نمبرز کو Coexistence کے ذریعے جوڑتا ہے اور جیسے ہی آپ کا ویب ہک لگتا ہے، Meta سے ان کے رابطے اور چیٹ ہسٹری مانگتا ہے، تاکہ ہسٹری سیدھی آپ کے endpoint پر پہنچے اور راستے میں کچھ محفوظ نہ ہو، اور ہر نمبر 24/7 مانیٹر ہو۔
کاروبار کے Cloud API پر آن بورڈ ہونے کی تاریخ سے گن کر، ہسٹری ویب ہکس کتنے پیچھے تک کی ہسٹری پہنچاتے ہیں۔
آن بورڈنگ کے بعد وہ مدت جس میں کاروبار کے رابطے اور میسج ہسٹری ہم وقت کیے جانے چاہئیں۔
ایرر کوڈ جو ہسٹری ویب ہک پر آتا ہے جب کاروبار نے WhatsApp Business ایپ میں ہسٹری شیئرنگ بند کر رکھی ہو۔
ہم وقت سازی ہر بار کتنی بار چل سکتی ہے؛ اسے دہرانے کے لیے گاہک کو offboard کرنا اور Embedded Signup دوبارہ مکمل کرنا ہوگا۔
وہ progress قدر جو ہم وقت سازی کے مکمل ہونے کو ظاہر کرتی ہے۔
امپورٹ کیسے شروع ہوتا ہے؟
نمبر پر ویب ہک URL کے ساتھ۔ جب کنیکٹ سیشن پر webhook_url پہلے سے سیٹ ہو کر نمبر جڑتا ہے، یا کنیکشن کے 24 گھنٹوں کے اندر PUT /connections/{id}/webhook سے آپ اسے سیٹ کریں، تو easyCoexistence Meta سے ڈیٹا ایک بار مانگتا ہے: پہلے رابطوں کے لیے sync_type smb_app_state_sync کے ساتھ، پھر چیٹس کے لیے history، یہی وہ ترتیب ہے جو Meta دستاویز میں درج کرتا ہے۔ نمبر کے ایونٹ لاگ میں history_sync_requested ریکارڈ ہوتا ہے، جس میں سپورٹ کے لیے Meta کی request_id ویلیوز ہوتی ہیں، یا history_sync_failed وجہ کے ساتھ۔
رابطوں کے ویب ہکس میں کیا ہوتا ہے؟
فیلڈ smb_app_state_sync، جس کی value میں state_sync array ہوتا ہے۔ ہر آئٹم کی type contact ہوتی ہے، اس کا contact object ہوتا ہے جس میں full_name، first_name اور phone_number شامل ہیں، action کی قدر add یا remove ہوتی ہے، اور metadata.timestamp ہوتا ہے۔ remove میں نام شامل نہیں کیے جاتے۔ امپورٹ کے بعد بھی Meta یہ ویب ہکس بھیجتا رہتا ہے جب بھی کاروبار WhatsApp Business ایپ میں کوئی رابطہ شامل، تبدیل یا حذف کرے، تاکہ آپ کی ایڈریس بک فون کے ساتھ ہم قدم رہے۔
میسج ہسٹری کے ویب ہکس میں کیا ہوتا ہے؟
فیلڈ history، جس کی value میں history array ہوتا ہے۔ ہر آئٹم میں metadata ہوتا ہے، جس میں phase، chunk_order اور progress شامل ہیں، اور threads ہوتے ہیں، ہر گاہک کے لیے ایک۔ thread id گاہک کا نمبر ہے، اور messages میں وہ ون ٹو ون گفتگو ہوتی ہے، آنے والے اور جانے والے دونوں، جن میں from بتاتا ہے کہ کس طرف سے بھیجا گیا۔ ہر میسج میں id، timestamp، type، اس کا مواد type کے نام کے تحت، اور history_context.status ہوتا ہے، جیسے READ یا DELIVERED۔ گروپ چیٹس شامل نہیں ہیں۔
{
"object": "whatsapp_business_account",
"entry": [
{
"id": "<WABA_ID>",
"changes": [
{
"field": "history",
"value": {
"messaging_product": "whatsapp",
"metadata": { "display_phone_number": "<BUSINESS_NUMBER>", "phone_number_id": "<PHONE_NUMBER_ID>" },
"history": [
{
"metadata": { "phase": 1, "chunk_order": 3, "progress": 42 },
"threads": [
{
"id": "<CUSTOMER_NUMBER>",
"messages": [
{
"from": "<CUSTOMER_NUMBER>",
"id": "wamid.<ID>",
"timestamp": "1790726400",
"type": "text",
"text": { "body": "<MESSAGE_TEXT>" },
"history_context": { "status": "READ" }
}
]
}
]
}
]
}
}
]
}
]
}میڈیا میسجز کیسے امپورٹ ہوتے ہیں؟
پہلے placeholder کے طور پر۔ میڈیا میسج کی type media_placeholder آتی ہے، بغیر مواد اور بغیر میڈیا ID کے۔ پھر Meta الگ ہسٹری ویب ہکس بھیجتا ہے جن میں میڈیا IDs ہوتی ہیں، لیکن صرف ان میڈیا کے لیے جو آن بورڈنگ کے 14 دن کے اندر بھیجے گئے ہوں؛ ان فائلوں کو گاہک کے ٹوکن کے ساتھ Meta سے حاصل کریں۔ اس سے پرانا میڈیا placeholder ہی رہتا ہے، اس لیے اسے ایک ایسی اٹیچمنٹ کے طور پر دکھائیں جو دستیاب نہیں، تاکہ تھریڈ میں خالی جگہ نہ رہے۔
چنکس کس ترتیب سے آتے ہیں، اور امپورٹ کب مکمل ہوتا ہے؟
ضروری نہیں کہ ترتیب سے آئیں۔ Meta چیٹس کو تین مرحلوں میں تقسیم کرتا ہے، سب سے نئی سے شروع: مرحلہ 0 آن بورڈنگ سے ایک دن پہلے کا ہے، مرحلہ 1 90 دن پیچھے تک جاتا ہے اور مرحلہ 2 180 دن تک۔ چنکس بے ترتیب آ سکتے ہیں، اس لیے انہیں metadata.chunk_order سے ترتیب دیں۔ metadata.progress پوری ہم وقت سازی کا فیصد ہے، اور 100 کا مطلب ہے کہ یہ مکمل ہو گئی؛ صرف مرحلے کا نمبر یہ نہیں بتاتا کہ کوئی مرحلہ ختم ہو گیا۔
اگر کاروبار چیٹس شیئر کرنے سے انکار کر دے تو؟
کنیکشن کے دوران WhatsApp Business ایپ کاروبار سے پوچھتی ہے کہ وہ چیٹ ہسٹری شیئر کرے یا نہیں۔ انکار ایک history ویب ہک کے طور پر آتا ہے، جس میں کوئی messages نہیں ہوتے اور errors array ہوتا ہے۔ اس array کا code 2593109 ہے، اور اس کا عنوان ہے History sync is turned off by the business from the WhatsApp Business App، یعنی کاروبار نے ہسٹری ہم وقت سازی بند کر رکھی ہے۔ رابطے پھر بھی آتے ہیں، اور نمبر جڑنے کے لمحے سے لائیو میسجز معمول کے مطابق آتے رہتے ہیں۔
کیا امپورٹ دوبارہ چل سکتا ہے؟
اسی کنیکشن پر نہیں۔ Meta ہر ہم وقت سازی ایک بار اجازت دیتا ہے، آن بورڈنگ کے 24 گھنٹوں کے اندر، اور اسے دوبارہ نہیں چلایا جا سکتا۔ دوبارہ چلانے کے لیے گاہک کو نمبر منقطع کر کے دوبارہ کنیکٹ کرنا ہوگا، جو ایک نئی آن بورڈنگ شمار ہوتی ہے: اگر ویب ہک URL محفوظ ہو تو easyCoexistence دوبارہ امپورٹ مانگتا ہے، اس لیے ہر میسج کی id کی بنیاد پر ڈپلیکیٹ ختم کریں۔ 14 دن کے قاعدے کے بعد واپس آنے والا نمبر بھی اسی میں شامل ہے۔
گاہک کو کنیکٹ لنک بھیجنے سے پہلے کیا تیار ہونا چاہیے؟
آپ کا endpoint، چالو اور جواب دیتا ہوا۔ ویب ہک URL لگاتے وقت Meta اس URL کو اپنے GET handshake سے جانچتا ہے، اور امپورٹ کی درخواست اس کے بالکل بعد ایک بار ہوتی ہے۔ اگر handshake ناکام ہو جائے تو نمبر پھر بھی جڑ جاتا ہے مگر بغیر ویب ہک URL کے، سیشن کی last_error وجہ بتاتی ہے، اور اس وقت تک کچھ امپورٹ نہیں ہوتا جب تک آپ endpoint درست نہ کریں اور 24 گھنٹوں کے اندر PUT /connections/{id}/webhook سے اسے سیٹ نہ کریں۔ جس نمبر کا webhook_url نہ ہو اسے امپورٹ بالکل نہیں ملتا، کیونکہ easyCoexistence کو بھیجا گیا مواد ضائع ہو جاتا ہے۔
اسے کیسے سیٹ اپ کریں
- Prepare the endpointDeploy an HTTPS URL with a random secret in its path that answers Meta's GET handshake and accepts bodies up to 3 MB.
- Create the connect sessionPOST /connect-sessions with webhook_url and webhook_verify_token, then send the customer the url it returns.
- Store contacts and chatsUpsert contacts from smb_app_state_sync, and insert history messages keyed on their id, sorted by chunk_order.
- Wait for progress 100Treat the import as finished when metadata.progress reaches 100, or as declined when a history webhook carries error 2593109.
عام غلطیاں
- بڑے ہسٹری چنکس کو مسترد کرنا۔ Meta کے payloads 3 MB تک جا سکتے ہیں، جبکہ Express ڈیفالٹ میں JSON صرف 100 KB تک پارس کرتا ہے، اس لیے حد بڑھائیں ورنہ چنکس ناکام ہوں گے اور Meta انہیں دوبارہ بھیجتا رہے گا۔
- چنکس کو آمد کی ترتیب سے پروسیس کرنا۔ وہ بے ترتیب آ سکتے ہیں، اس لیے metadata.chunk_order سے ترتیب دیں اور امپورٹ کو مکمل کہنے سے پہلے progress 100 کا انتظار کریں۔
- ڈپلیکیٹ چیک کیے بغیر ہسٹری محفوظ کرنا۔ لائیو میسجز امپورٹ سے اوورلیپ ہو سکتے ہیں اور دوبارہ کنکشن پر امپورٹ دوبارہ چلتا ہے، اس لیے ہر میسج کو اس کی id سے شناخت کریں۔
- endpoint کے Meta handshake کا جواب دینے سے پہلے کنیکٹ لنک بھیجنا۔ اس صورت میں ویب ہک URL لاگو نہیں ہوتا، اور اگر آپ 24 گھنٹوں کے اندر اسے سیٹ نہ کریں تو نمبر کی ہسٹری کبھی امپورٹ نہیں ہوتی۔
فی کنکشن فی ماہ US$ 9 سے US$ 0.75 تک، جیسے جیسے آپ کنکشن بڑھائیں قیمت کم ہوتی ہے، پہلے 3 دن مفت۔
اکثر پوچھے جانے والے سوالات
WhatsApp چیٹ ہسٹری امپورٹ کتنے پیچھے تک جاتی ہے؟
نمبر کے Cloud API پر آن بورڈ ہونے سے پہلے 180 دن تک، جس میں دونوں سمتوں کی ون ٹو ون چیٹس شامل ہیں۔
کیا گروپ چیٹس امپورٹ ہوتی ہیں؟
نہیں۔ Meta وہ میسجز چھوڑ دیتا ہے جو گروپ چیٹ کا حصہ ہوں۔
کیا گاہک کی پرانی WhatsApp چیٹس میرے ویب ہک تک پہنچیں گی؟
ہاں، 180 دن تک کی ون ٹو ون چیٹس، آن بورڈنگ کے 24 گھنٹوں کے اندر ایک بار بھیجی جاتی ہیں، اگر کاروبار ایپ میں انہیں شیئر کرنے کا فیصلہ کرے۔
کیا easyCoexistence امپورٹ کی گئی چیٹس کی کاپی رکھتا ہے؟
نہیں۔ Meta ہسٹری کو سیدھا آپ کے webhook_url پر بھیجتا ہے، لائیو میسجز کی طرح، اور راستے میں کچھ محفوظ نہیں ہوتا۔
مزید پڑھیں
دو منٹ میں اپنا پہلا چینل کنیکٹ کریں۔
کسی پلیٹ فارم کے ریویو کا انتظار نہیں۔ WhatsApp، Instagram، TikTok یا کوئی اور چینل کنیکٹ کریں، پھر اپنے AI سے پوسٹ کرنے، جواب دینے یا رپورٹ بنانے کو کہیں اور اسے کام کرتے دیکھیں۔
- 3 دن مفت
- کسی بھی وقت منسوخ کریں
- صرف آفیشل API
- 24/7 نگرانی
تصدیق شدہ تاریخ