Messenger Send API: فیس بک پیج سے میسج بھیجنا
فیس بک پیج Page ٹوکن کے ساتھ POST /{page-id}/messages پر Messenger میسج بھیجتا ہے: recipient میں شخص کا Page-scoped ID (PSID) ہوتا ہے، messaging_type معیاری میسجنگ ونڈو کے اندر RESPONSE یا UPDATE ہوتا ہے، اور ونڈو کے بعد MESSAGE_TAG، اور message میں ٹیکسٹ ہوتا ہے یا image، audio، video یا file جیسی اٹیچمنٹ۔ Meta جواب میں recipient_id اور message_id دیتا ہے۔
easyCoexistence Claude، ChatGPT یا آپ کے اپنے کوڈ سے Messenger پر DMs کا جواب send_social_dm کے ذریعے 24 گھنٹے کی ونڈو کے اندر ٹیکسٹ کی صورت میں دیتا ہے؛ میڈیا، کوئیک ریپلائیز اور ٹیمپلیٹس شامل نہیں ہیں۔
ٹیکسٹ، لنکس، ری ایکشنز اور اسٹیکرز والے میسجز کے لیے ایپ ہر Page پر جتنی Send API کالز کر سکتی ہے۔
آڈیو یا ویڈیو والے میسجز کے لیے ایپ ہر Page پر جتنی Send API کالز کر سکتی ہے۔
Messenger Platform دوبارہ استعمال کے لیے جو سب سے بڑا اثاثہ محفوظ کرتا ہے، URL سے اپ لوڈ کی گئی تصویر 8 MB تک محدود ہے۔
ایک میسج اپنے attachments array میں زیادہ سے زیادہ جتنی تصاویر رکھ سکتا ہے، یہ وہ واحد میڈیا قسم ہے جس کی وہاں اجازت ہے۔
محفوظ شدہ attachment_id کتنی دیر تک چلتا ہے، اس کے بعد میڈیا دوبارہ اپ لوڈ کرنا پڑتا ہے۔
Send API کی درخواست میں کیا ہوتا ہے؟
Meta کسی میسج کو بھیجنے کے لیے چھ اجزا لازمی قرار دیتا ہے: بھیجنے والے Page کا ID، وصول کرنے والے شخص کا ID، اس Page کا Page ٹوکن، شخص کی اجازت، میسج کی قسم اور مواد۔ یہ درخواست /{page-id}/messages پر JSON کا POST ہوتی ہے، اور ابھی لکھنے والے شخص کو جواب کچھ یوں بھیجا جاتا ہے:
POST /{page-id}/messages
{
"recipient": { "id": "<PSID>" },
"messaging_type": "RESPONSE",
"message": { "text": "Your order ships tomorrow." }
}
{ "recipient_id": "<PSID>", "message_id": "<MESSAGE_ID>" }recipient میں کون سا ID جاتا ہے؟
عموماً Page-scoped ID، یعنی PSID، جو Meta کسی شخص کو اس کے پہلی بار Page کو میسج کرنے پر دیتا ہے؛ یہ messages ویب ہک میں sender.id کے طور پر آتا ہے۔ recipient آبجیکٹ خاص صورتوں کے لیے دوسری اقسام کے ID بھی قبول کرتا ہے:
- id: PSID، جو اس شخص اور اس Page کے لیے منفرد ہے۔
user_ref: اس شخص کے لیے جس نے Page کو میسج کرنے کے لیے plugin یا postback button استعمال کیا۔comment_idیاpost_id: کمنٹ کے پرائیویٹ جواب یا وزیٹر پوسٹ کے لیے۔- Facebook Login کے ID ایپ کے لیے مخصوص ہوتے ہیں اور Messenger Platform پر کام نہیں کرتے۔
ایک میسج کے لیے کون سی messaging_type ہونی چاہیے؟
یہ قسم Meta کو بتاتی ہے کہ میسج کیوں بھیجا جا رہا ہے، اور یہی طے کرتی ہے کہ بھیجنا کب جائز ہے۔ Meta کے Page میسجز ریفرنس میں چار قدریں درج ہیں:
- RESPONSE: اس میسج کا جواب جو Page کو ملا، خواہ پروموشنل ہو یا نہ ہو، معیاری میسجنگ ونڈو کے اندر۔
- UPDATE: وہ میسج جو Page اپنے طور پر بھیجتا ہے، خواہ پروموشنل ہو یا نہ ہو، اور یہ بھی ونڈو کے اندر ہو۔
MESSAGE_TAG: غیر پروموشنل میسج جو ونڈو کے بعد بھیجا جائے، اس ٹیگ کے ساتھ جو منظور شدہ استعمال کے کیس سے مطابقت رکھتا ہو۔- UTILITY: منظور شدہ ٹیمپلیٹ سے بنا یوٹیلٹی میسج، جیسے آرڈر یا اپائنٹمنٹ کی اپ ڈیٹ۔
ایک میسج میں کیا شامل ہو سکتا ہے؟
ٹیکسٹ، یا ایک اٹیچمنٹ آبجیکٹ جس میں type اور پے لوڈ ہو: image، audio، video اور file اٹیچمنٹس کسی URL یا محفوظ شدہ attachment_id کی طرف اشارہ کرتے ہیں، اور ٹیمپلیٹ اٹیچمنٹس بٹنوں والے ساختی میسجز رکھتے ہیں۔ یہی اینڈ پوائنٹ یہ بھی قبول کرتا ہے:
- attachments: ایک array، جس میں ایک میسج کے طور پر زیادہ سے زیادہ 30 تصاویر بھیجی جا سکتی ہیں۔
reply_toکے ساتھ mid: کسی مخصوص پچھلے میسج کا جواب، شخص کا ہو یا Page کا۔quick_replies: کمپوزر کے اوپر 13 تک بٹن، ہر ایک کا عنوان 20 حروف تک۔sender_action: ٹائپنگ انڈیکیٹر، سین مارک یا ری ایکشن، جو میسج سے الگ درخواست میں بھیجا جاتا ہے۔notification_type: ڈیفالٹ طور پر REGULAR ہوتا ہے، ورنہSILENT_PUSHیاNO_PUSHہو سکتا ہے۔
اٹیچمنٹس کا زیادہ سے زیادہ سائز کیا ہو سکتا ہے؟
Meta کی محفوظ اثاثوں کی گائیڈ ان حدود کو طے کرتی ہے جو Messenger Platform اس میڈیا کے لیے رکھتا ہے جسے وہ حاصل کرتا اور محفوظ رکھتا ہے: 25 MB تک کے اثاثے، URL سے اپ لوڈ ہونے والی تصاویر 8 MB تک، audio Content-Type کے ساتھ بھیجا گیا آڈیو، اور 75 سیکنڈ کے اندر حاصل ہونے والی ویڈیو۔ is_reusable کو true پر سیٹ کرنے سے attachment_id ملتا ہے جسے صرف وہی Page دوبارہ استعمال کر سکتا ہے جس نے اسے بھیجا تھا، 90 دن تک، اور POST /{page-id}/message_attachments میڈیا کو پہلے سے اپ لوڈ کرنے دیتا ہے۔
Send API کی ریٹ لمٹس کیا ہیں؟
Meta انہیں ہر Page کے حساب سے اور مواد کی قسم کے مطابق گنتا ہے۔ اس کے Page میسجز ریفرنس میں کوڈ 613 درج ہے، یعنی Calls to this api have exceeded the rate limit، جو Send API کی خرابیوں میں شامل ہے۔ یہ ظاہر ہو تو فوراً دوبارہ کوشش کرنے کے بجائے رفتار کم کریں:
- ٹیکسٹ، لنکس، ری ایکشنز اور اسٹیکرز والے میسجز کے لیے ہر Page پر فی سیکنڈ 300 کالز۔
- آڈیو یا ویڈیو والے میسجز کے لیے ہر Page پر فی سیکنڈ 10 کالز۔
- کسی ایک تھریڈ میں بہت سے میسجز اپنے طور پر بھی ریٹ لمٹ ہو سکتے ہیں۔
- Messenger API کالز مجموعی طور پر: 24 گھنٹے کے رولنگ دورانیے میں، فعال صارفین کی تعداد کا 200 گنا۔
- فی سیکنڈ 40 میسجز سے زیادہ پر، Page کا ان باکس نئے میسجز دکھانا بند کر دیتا ہے، اور حجم کم ہونے تک Page بھیج نہیں سکتا۔
Send API کون سی ایرر لوٹاتا ہے؟
Meta کی Messenger ایرر ٹیبل ہر کوڈ کو ایک سب کوڈ کے ساتھ جوڑتی ہے جو وجہ بتاتا ہے۔ یہ وہ ہیں جو Page بھیجتے وقت سب سے زیادہ دیکھتا ہے:
- 10 کے ساتھ 2018278 یا 2534022: یہ میسج اجازت یافتہ ونڈو سے باہر بھیجا گیا ہے۔
- 10 کے ساتھ 2018300: کسی اور ایپ کا گفتگو پر کنٹرول ہے۔
- 100: غلط پیرامیٹر، جیسے غلط recipient ID؛ سب کوڈ 2018001 کا متن ہے: No matching user found، یعنی صارف نہیں ملا۔
- 551: شخص دستیاب نہیں، شاید اس نے Page کو بلاک کیا ہو یا اکاؤنٹ غیر فعال کیا ہو؛ 200 کے ساتھ 1545041 کا متن ہے: This person isn't available right now، یعنی شخص اس وقت دستیاب نہیں۔
- 200 کے ساتھ 2018028: جب تک
pages_messagingکا جائزہ نہ ہو اور ایپ لائیو نہ ہو، ایپ اپنے رولز سے باہر کے لوگوں کو میسج نہیں کر سکتی۔ - 10904: سیٹنگز میں Page کے میسجز بند ہیں۔
easyCoexistence اس کے ذریعے کیسے بھیجتا ہے؟
send_social_dm کو account_id، شخص کا recipient_id (جو موصول شدہ messages ایونٹ میں sender.id ہوتا ہے) اور ٹیکسٹ درکار ہوتے ہیں، اور وہ انہیں messaging_type RESPONSE کے ساتھ /{page-id}/messages پر پوسٹ کرتا ہے۔ نتیجہ Meta کا جواب ہوتا ہے، جس میں message_id شامل ہوتا ہے، اور رد ہونے والا بھیجنا Meta کا ایرر کوڈ اور پیغام لے کر واپس آتا ہے۔ میڈیا، کوئیک ریپلائیز، ٹیمپلیٹس اور سینڈر ایکشنز ٹولز میں شامل نہیں ہیں: send_social_dm ٹیکسٹ بھیجتا ہے۔
عام غلطیاں
- میسج کے ساتھ ٹائپنگ انڈیکیٹر بھیجنا۔ Meta چاہتا ہے کہ sender_action شخص کے ساتھ اکیلا ہو، اور ٹیکسٹ یا ٹیمپلیٹس الگ درخواست میں ہوں۔
- ایک شخص پر تیز بوچھاڑ کرنا۔ Meta کسی ایک تھریڈ کو Page کی فی سیکنڈ 300 کالز کی حد سے الگ اپنے طور پر ریٹ لمٹ کر سکتا ہے۔
- ٹیکسٹ کی رفتار پر آڈیو یا ویڈیو بھیجنا۔ آڈیو یا ویڈیو والے میسجز ہر Page پر فی سیکنڈ 10 کالز تک محدود ہیں۔
- 90 دن سے پرانا attachment_id دوبارہ استعمال کرنا۔ محفوظ شدہ attachment IDs ختم ہو جاتے ہیں، اس لیے نیا ID لینے کے لیے میڈیا دوبارہ اپ لوڈ کریں۔
آٹومیشنز نئے میسجز کا خودکار جواب ایک مقررہ ٹیکسٹ یا AI جواب کے ساتھ دیتی ہیں۔ فی کنکشن ماہانہ US$ 9 سے US$ 0.75 تک، کنکشن بڑھانے کے ساتھ قیمت کم ہوتی ہے، اور پہلے 3 دن فری ٹرائل ہے۔
اکثر پوچھے جانے والے سوالات
کیا Messenger Send API مفت ہے؟
جی ہاں، معیاری میسجز کے لیے۔ Meta کی Messenger جائزہ دستاویز اسے استعمال کے لیے مفت قرار دیتی ہے، اس لیے جو Page اپنے میسجز کا جواب دیتا ہے اسے فی میسج کچھ نہیں پڑتا؛ مارکیٹنگ میسجز کا بل فی میسج ہوتا ہے۔
میسج بھیجنے کے لیے Page کا کون سا ٹاسک درکار ہے؟
Meta کا Messenger جائزہ ایسے شخص کا Page ٹوکن مانگتا ہے جو MESSAGING اور MODERATE ٹاسک انجام دے سکتا ہو، اور pages_messaging کی اجازت دی گئی ہو۔
کیا easyCoexistence Messenger پر تصاویر کے ساتھ جواب دے سکتا ہے؟
ابھی نہیں۔ send_social_dm ٹیکسٹ بھیجتا ہے، اور کوئی ٹول اٹیچمنٹ نہیں بھیجتا۔
ایک Facebook Page کے لیے easyCoexistence کی قیمت کتنی ہے؟
آپ جو ہر Page کنیکٹ کرتے ہیں وہ ایک کنکشن ہے، جس کی فیس فی کنکشن ماہانہ US$ 9 سے US$ 0.75 تک ہے، جو آپ کے کنکشنز کی تعداد پر منحصر ہے، اور پہلے 3 دن فری ہیں۔
مزید پڑھیں
دو منٹ میں اپنا پہلا چینل کنیکٹ کریں۔
کسی پلیٹ فارم کے ریویو کا انتظار نہیں۔ WhatsApp، Instagram، TikTok یا کوئی اور چینل کنیکٹ کریں، پھر اپنے AI سے پوسٹ کرنے، جواب دینے یا رپورٹ بنانے کو کہیں اور اسے کام کرتے دیکھیں۔
- 3 دن مفت
- کسی بھی وقت منسوخ کریں
- صرف آفیشل API
- 24/7 نگرانی
تصدیق شدہ تاریخ