API کے ذریعے Messenger گفتگو کی ہسٹری پڑھنا
Facebook Page کی Messenger ہسٹری GET /{page-id}/conversations?platform=messenger کے ذریعے پڑھی جاتی ہے، جو ہر گفتگو کی ID اور اس کے آخری اپ ڈیٹ کا وقت دیتی ہے۔ پھر GET /{conversation-id}?fields=messages سے میسج IDs اور GET /{message-id} سے ہر میسج کا بھیجنے والا، وصول کرنے والا، متن اور اٹیچمنٹ حاصل ہوتے ہیں۔ Meta کسی گفتگو کے صرف 20 تازہ ترین میسجز کی تفصیل واپس کرتا ہے، اور ان کالز کے لیے pages_messaging والا Page ٹوکن درکار ہے۔
easyCoexistence کسی Page کے نئے Messenger میسجز آتے ہی آپ کے اینڈ پوائنٹ پر بھیجتا ہے، اور send_social_dm 24 گھنٹے کی ونڈو کے اندر جواب دیتا ہے، Claude، ChatGPT یا آپ کے اپنے کوڈ سے۔
گفتگو کے صرف 20 تازہ ترین میسجز کی تفصیل واپس آتی ہے؛ پرانے میسجز پر ایک خرابی آتی ہے جس میں کہا جاتا ہے کہ میسج ڈیلیٹ ہو چکا ہے۔
ایک ایپ ہر Facebook Page کے لیے Conversations API کی زیادہ سے زیادہ کالز کی تعداد۔
Requests فولڈر کی وہ گفتگوئیں جو اتنی مدت سے فعال نہیں، API کے نتائج سے نکال دی جاتی ہیں۔
گفتگو پڑھنے کے لیے ٹوکن کے پیچھے موجود شخص کے پاس درکار Page ٹاسک۔
Messenger API کی بہت زیادہ کالز پر Page اکاؤنٹ کی خرابی؛ Meta کہتا ہے کچھ دیر رک کر دوبارہ کوشش کریں۔
Page کی گفتگوؤں کی فہرست کیسے حاصل کریں؟
GET /{page-id}/conversations کے ساتھ platform کو messenger پر سیٹ کریں۔ نتیجے میں گفتگو کی IDs کا data array ملتا ہے، جس میں ہر ایک کے ساتھ updated_time (یعنی آخری میسج شامل ہونے کا وقت) ہوتا ہے، اور ایک paging object بھی آتا ہے۔ Meta کے حوالہ میں لکھا ہے کہ اس اینڈ پوائنٹ پر وقت کی بنیاد پر pagination دستیاب نہیں، اس لیے فہرست میں آگے بڑھنے کے لیے paging object کو فالو کریں۔
GET /{page-id}/conversations?platform=messenger
{
"data": [
{ "id": "<CONVERSATION_ID>", "updated_time": "<TIME>" },
{ "id": "<CONVERSATION_ID>", "updated_time": "<TIME>" }
],
"paging": { ... }
}کسی ایک شخص کی گفتگو کیسے تلاش کریں؟
اسی درخواست میں user_id شامل کریں، جس کی قدر اس شخص کا Page-scoped ID ہو۔ Meta اس Page اور اس شخص کے درمیان گفتگو کی ID واپس کرتا ہے۔ یہ وہ سب سے مختصر راستہ ہے جو messages ویب ہک سے، جہاں PSID بطور sender.id آتا ہے، اس کے پیچھے کی ہسٹری تک لے جاتا ہے:
GET /{page-id}/conversations?platform=messenger&user_id=<PSID>
{ "data": [ { "id": "<CONVERSATION_ID>" } ] }گفتگو کے میسجز کیسے پڑھیں؟
دو مرحلوں میں۔ GET /{conversation-id} کے ساتھ fields=messages سے گفتگو کی میسج IDs ملتی ہیں، ہر ایک کے ساتھ created_time، سب سے تازہ پہلے۔ پھر GET /{message-id} کے ساتھ ضرورت کے فیلڈز، جیسے id، created_time، from، to، message اور reply_to، لگا کر ایک میسج کا مواد ملتا ہے۔ ڈیفالٹ فیلڈز id اور created_time ہیں، اور جس فیلڈ میں ڈیٹا نہ ہو وہ جواب سے نکال دیا جاتا ہے۔
کون سے فیلڈز پڑھے جا سکتے ہیں؟
گفتگو اور میسج مختلف فیلڈز ظاہر کرتے ہیں۔ یہ وہ فیلڈز ہیں جو Meta کے حوالوں میں Page میسجنگ کے لیے درج ہیں:
- گفتگو: id،
updated_time، participants اپنی ID، name اور email کے ساتھ، messages، اورis_ownerجب Conversation Routing آن ہو۔ - میسج: id،
created_time، from اور to، ہر ایک ID، name اور email کے ساتھ، اور message، یعنی متن، جو نہ ہو تو خالی ہوتا ہے۔ - attachments: files، images اور videos اپنے CDN URLs کے ساتھ، اور
is_unsupported، جو صرف اس وقت واپس آتا ہے جب میسج میں غیر معاون مواد ہو۔ - reactions،
reply_toجس mid کا جواب دیتا ہے اورis_self_reply، اور shares شیئر شدہ پوسٹس اور ریلز کے لیے۔ - tags: میسج کا فولڈر اور ماخذ، مثلاً inbox، read یا source:chat، جیسی قدریں رکھتا ہے۔
پیچھے کتنا پڑھا جا سکتا ہے؟
IDs کے لیے گفتگو کی پوری تاریخ تک، مگر مواد کے لیے نہیں۔ Meta کی گائیڈ کہتی ہے کہ گفتگو کا اینڈ پوائنٹ گفتگو کے تمام میسج IDs واپس کرتا ہے، جبکہ تفصیل صرف 20 تازہ ترین میسجز کی ملتی ہے؛ پرانے میسج کے لیے پوچھنے پر خرابی آتی ہے کہ میسج ڈیلیٹ ہو چکا ہے۔ Requests فولڈر کی وہ گفتگوئیں جو 30 دن سے غیر فعال ہیں، واپس ہی نہیں آتیں۔
کن اجازتوں اور کاموں کی ضرورت ہے؟
Page access ٹوکن درکار ہے جو کسی ایسے شخص سے لیا گیا ہو جو Page پر MESSAGING یا MODERATE کام کر سکتا ہو، اور اس کے ساتھ pages_manage_metadata، pages_read_engagement اور pages_messaging کی اجازتیں ہوں۔ ایپ، Page یا کاروبار میں کوئی کردار نہ رکھنے والے لوگوں کے ساتھ گفتگو پڑھنے کے لیے Advanced Access درکار ہے، جو Meta App Review کے ذریعے دیتا ہے۔
کالز پر کون سی حدیں لاگو ہوتی ہیں؟
Meta کی ریٹ لمٹس Conversations API کو فی Page 2 کالز فی سیکنڈ دیتی ہیں، اور حد سے زیادہ کالز 613 یا 80006 کے ساتھ واپس آتی ہیں، جن کا پیغام ہے: "There have been too many messenger api calls to this Page account"، یعنی اس Page اکاؤنٹ پر کالز کی تعداد زیادہ ہو گئی ہے۔ ایسا Page جو Meta کی زیادہ حجم والی حد تک پہنچ جائے، مثلاً ایک سیکنڈ میں 40 سے زیادہ میسج بھیجنا، وہ حجم کم ہونے تک اپنی گفتگوئیں فہرست میں نہیں لا سکتا، البتہ کسی ایک گفتگو کے نئے میسجز اب بھی پڑھے جا سکتے ہیں۔
ویب ہک کی بجائے API کب استعمال کریں؟
یہ ماضی کے لیے ہے۔ ویب ہک نئے میسجز ہوتے ہی بھیجتے ہیں، اور Meta نوٹ کرتا ہے کہ پچھلی اطلاعات بعد میں کیوری نہیں کی جا سکتیں، اس لیے Conversations API وہ راستہ ہے جس سے کوئی انٹیگریشن سننا شروع کرنے سے پہلے کے میسجز پڑھتی ہے، یا ڈاؤن ٹائم کے بعد کیچ اپ کرتی ہے۔ Conversation Routing آن ہونے پر is_owner فیلڈ فہرست کو ان گفتگوؤں تک محدود کر دیتا ہے جن کا جواب دینا ایپ کی ذمہ داری ہے، اور Meta ڈاؤن ٹائم کے بعد ریکوری کے لیے یہی تجویز کرتا ہے۔
easyCoexistence Messenger ہسٹری کیسے پڑھتا ہے؟
یہ ہسٹری نہیں پڑھتا۔ Page pages_messaging، pages_manage_metadata اور pages_read_engagement کی اجازتوں کے ساتھ کنیکٹ ہوتا ہے، لیکن کوئی ٹول Conversations API کو کال نہیں کرتا، اور Page ٹوکن حوالے نہیں کیے جاتے۔ نئے میسجز set_social_webhook_destination کے ذریعے آتے ہی آپ کے اینڈ پوائنٹ تک پہنچتے ہیں اور بغیر کاپی رکھے آگے بڑھائے جاتے ہیں، تاکہ آپ کا اپنا سسٹم وہ ہسٹری رکھے جس کی اسے ضرورت ہے۔
عام غلطیاں
- فہرست والی کال میں میسج کا مواد توقع نہ رکھیں۔ گفتگو کا اینڈ پوائنٹ میسج IDs واپس کرتا ہے؛ ہر میسج کے فیلڈز /{message-id} سے پڑھیں۔
- پوری ہسٹری پر بھروسہ نہ کریں۔ تفصیل صرف 20 تازہ ترین میسجز تک ملتی ہے، اس لیے جو ضرورت ہو وہ ویب ہک سے میسجز آتے ہی محفوظ کر لیں۔
- نئے میسجز کے لیے پولنگ نہ کریں۔ فی Page 2 کالز فی سیکنڈ کی حد پر پولنگ لوپ جلد ریٹ لمٹ تک پہنچ جاتا ہے، جبکہ messages ویب ہک میسجز ہوتے ہی بھیجتا ہے۔
- since اور until کے ساتھ تاریخ کے حساب سے گفتگوؤں کی صفحہ بندی نہ کریں۔ conversations اینڈ پوائنٹ پر وقت کی بنیاد پر pagination دستیاب نہیں؛ اس کی بجائے paging object کو فالو کریں۔
Conversations API کے لیے اس کے پاس کوئی ٹول نہیں، اس لیے پرانی ہسٹری Page ان باکس میں پڑھی جاتی ہے۔ قیمت US$ 9 سے US$ 0.75 تک فی کنکشن فی مہینہ ہے، جیسے جیسے کنکشن بڑھتے ہیں قیمت کم ہوتی ہے، اور پہلے 3 دن فری ٹرائل ہے۔
اکثر پوچھے جانے والے سوالات
کیا Conversations API میں Page کے اپنے میسجز شامل ہیں؟
جی ہاں۔ میسج کے from اور to فیلڈز میں شخص یا Page کا نام ہوتا ہے، اس لیے گفتگو کے میسجز دونوں طرف کے ہوتے ہیں۔
کیا میں App Review کے بغیر Messenger گفتگوئیں پڑھ سکتا ہوں؟
ایپ یا Page میں کردار رکھنے والے لوگوں کے لیے Standard Access کافی ہے۔ کسی دوسرے شخص کے ساتھ گفتگو کے لیے App Review کے ذریعے دیا جانے والا Advanced Access درکار ہے۔
کیا Conversations API جواب بھیج سکتا ہے؟
نہیں۔ Meta کا conversation حوالہ کہتا ہے کہ یہ edge شائع نہیں کر سکتا؛ جواب /{page-id}/messages پر Send API کے ذریعے جاتے ہیں۔
کیا easyCoexistence میری Messenger گفتگوئیں محفوظ کرتا ہے؟
ڈیفالٹ کے طور پر نہیں۔ آگے بھیجے گئے ایونٹس بغیر کاپی رکھے آگے بڑھائے جاتے ہیں؛ اگر آٹومیشن آن ہو تو میسج کا متن 7 دن اور آٹومیشن رن لاگز 30 دن تک رکھے جاتے ہیں۔
مزید پڑھیں
دو منٹ میں اپنا پہلا چینل کنیکٹ کریں۔
کسی پلیٹ فارم کے ریویو کا انتظار نہیں۔ WhatsApp، Instagram، TikTok یا کوئی اور چینل کنیکٹ کریں، پھر اپنے AI سے پوسٹ کرنے، جواب دینے یا رپورٹ بنانے کو کہیں اور اسے کام کرتے دیکھیں۔
- 3 دن مفت
- کسی بھی وقت منسوخ کریں
- صرف آفیشل API
- 24/7 نگرانی
تصدیق شدہ تاریخ