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

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 messages

گفتگو کے صرف 20 تازہ ترین میسجز کی تفصیل واپس آتی ہے؛ پرانے میسجز پر ایک خرابی آتی ہے جس میں کہا جاتا ہے کہ میسج ڈیلیٹ ہو چکا ہے۔

2 per second

ایک ایپ ہر Facebook Page کے لیے Conversations API کی زیادہ سے زیادہ کالز کی تعداد۔

30 days

Requests فولڈر کی وہ گفتگوئیں جو اتنی مدت سے فعال نہیں، API کے نتائج سے نکال دی جاتی ہیں۔

MESSAGING or MODERATE

گفتگو پڑھنے کے لیے ٹوکن کے پیچھے موجود شخص کے پاس درکار Page ٹاسک۔

80006

Messenger API کی بہت زیادہ کالز پر Page اکاؤنٹ کی خرابی؛ Meta کہتا ہے کچھ دیر رک کر دوبارہ کوشش کریں۔

Page کی گفتگوؤں کی فہرست کیسے حاصل کریں؟

GET /{page-id}/conversations کے ساتھ platform کو messenger پر سیٹ کریں۔ نتیجے میں گفتگو کی IDs کا data array ملتا ہے، جس میں ہر ایک کے ساتھ updated_time (یعنی آخری میسج شامل ہونے کا وقت) ہوتا ہے، اور ایک paging object بھی آتا ہے۔ Meta کے حوالہ میں لکھا ہے کہ اس اینڈ پوائنٹ پر وقت کی بنیاد پر pagination دستیاب نہیں، اس لیے فہرست میں آگے بڑھنے کے لیے paging object کو فالو کریں۔

Listing a Page's Messenger conversations
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 آتا ہے، اس کے پیچھے کی ہسٹری تک لے جاتا ہے:

One person's conversation
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 کو فالو کریں۔
EasyCoexistence کے ساتھ یہ کام کرنا

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 دن تک رکھے جاتے ہیں۔

مزید پڑھیں

Messenger Send API: فیس بک پیج سے میسج بھیجنافیس بک پیج POST /{page-id}/messages سے Messenger میسج کیسے بھیجتا ہے: PSID، messaging_type، ٹیکسٹ، اٹیچمنٹ، ریٹ لمٹس اور خرابیاں۔Messenger ہینڈ اوور پروٹوکول: AI ایجنٹ اور لوگوں کے درمیان پیج کا ان باکس بانٹنافیس بک پیج کی Messenger گفتگو ایپس اور پیج کے ان باکس کے درمیان کیسے منتقل ہوتی ہے: Conversation Routing، pass_thread_control اور تھریڈ کے مالک۔Facebook Page کے لیے Messenger ویب ہک: میسجز اور منشن ایونٹسFacebook Page کے لیے Messenger میسجز اور منشنز کی ویب ہک فیلڈز: پے لوڈ کا ڈھانچہ، سینڈر آئی ڈیز، اور ایونٹس آپ کے اینڈ پوائنٹ تک کیسے پہنچتے ہیں۔Facebook Page ویب ہک فیلڈز: مکمل فہرستMeta کی دستاویز کردہ 64 Facebook Page ویب ہک فیلڈز: feed، mention، messages جیسے Messenger فیلڈز، پروفائل فیلڈز، اور ہر ایک کی درکار اجازت۔Facebook Page API اجازتیں اور ایپ ریویو کی ضروریاتنو فیس بک پیج اجازتیں، ان سے کیا کھلتا ہے، اور Meta کا ایپ ریویو ان کے لیے کیا مانگتا ہے: ایڈوانسڈ ایکسیس، کاروباری تصدیق، اور اسکرین ریکارڈنگ۔Facebook Page ایکسیس ٹوکن: کتنی دیر چلتا ہے اور کیا اسے بے اثر کرتا ہےFacebook Page کا ایکسیس ٹوکن جس کی میعاد ختم نہیں ہوتی: اسے کیسے حاصل کیا جاتا ہے، کون اسے حاصل کر سکتا ہے، اور Meta کب اسے قبول نہیں کرتا۔

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

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

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

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