Instagram messaging_postbacks ویب ہک: آئس بریکرز اور بٹن
جب کوئی شخص پروفیشنل اکاؤنٹ کے ساتھ گفتگو میں آئس بریکر سوال، بٹن ٹیمپلیٹ کے postback بٹن، یا مستقل مینو آئٹم ٹیپ کرتا ہے تو Instagram کا messaging_postbacks ویب ہک فیلڈ ایپ کو اطلاع دیتا ہے۔ ایونٹ کے postback آبجیکٹ میں title ہوتا ہے، یعنی وہ متن جو شخص نے ٹیپ کیا؛ payload، یعنی وہ سٹرنگ جو ایپ نے اس آپشن کے لیے سیٹ کی؛ اور mid، یعنی میسج آئی ڈی، Graph API v11.0 سے۔
easyCoexistence ہر جڑے ہوئے Instagram اکاؤنٹ کو comments، messages اور mentions کے لیے سبسکرائب کرتا ہے، اور ان ایونٹس کو، quick reply ٹیپس سمیت، آتے ہی آپ کے HTTPS اینڈ پوائنٹ پر بھیجتا ہے، ہر اکاؤنٹ کے سیکرٹ سے دستخط شدہ اور بغیر کوئی کاپی رکھے۔
Meta کے Ice Breaker API کے ذریعے کوئی اکاؤنٹ زیادہ سے زیادہ جتنے آئس بریکر سوالات سیٹ کر سکتا ہے۔
وہ Graph API ورژن جس سے postback ایونٹس میں mid شامل ہوتا ہے؛ فیلڈ کو خود v8.0 یا اس کے بعد کے ورژن کی ضرورت ہے۔
بٹن ٹیمپلیٹ پیغام میں زیادہ سے زیادہ بٹن، جن میں سے ہر ایک postback یا web_url بٹن ہو سکتا ہے۔
مستقل مینو آئٹم ٹیپ کرنے کے بعد جواب دینے کا وقت، جو معیاری messaging window کھولتا ہے۔
ایک پیغام زیادہ سے زیادہ جتنے quick replies پیش کر سکتا ہے؛ ٹیپ کیا ہوا quick reply messaging_postbacks پر نہیں بلکہ messages پر آتا ہے۔
messaging_postbacks کب فائر ہوتا ہے؟
جب کوئی شخص گفتگو میں اکاؤنٹ کے کسی سٹرکچرڈ آپشن کو ٹیپ کرتا ہے، اور ایپ اور اکاؤنٹ اس فیلڈ کو سبسکرائب کر چکے ہوں۔ Meta کی گائیڈز یہ ذرائع فہرست کرتی ہیں:
- ایک آئس بریکر سوال، جو گفتگو شروع ہونے پر اکاؤنٹ زیادہ سے زیادہ 4 پیش کر سکتا ہے۔ ڈیسک ٹاپ پر دستیاب نہیں۔
- بٹن ٹیمپلیٹ میں ایک postback بٹن، فی پیغام زیادہ سے زیادہ 3، یا جنرک ٹیمپلیٹ میں، فی ایلیمنٹ زیادہ سے زیادہ 3۔
- اکاؤنٹ کے مستقل مینو میں ایک postback آئٹم۔
- ref پیرامیٹر والے ig.me لنک سے کھلے نئے تھریڈ میں ٹیپ کیا گیا آئس بریکر؛ اس صورت میں postback کے ساتھ referral بھی آتا ہے۔
- self-messaging ٹیسٹ، جہاں اکاؤنٹ خود اپنا بٹن ٹیپ کرتا ہے؛ اس صورت میں ایونٹ میں
is_selfکو true پر سیٹ کر کے شامل کیا جاتا ہے۔
postback نوٹیفکیشن کیسا دکھتا ہے؟
وہ messaging ایونٹ جس میں postback آبجیکٹ ہوتا ہے، وہاں جہاں عام DM میں پیغام ہوتا ہے۔ Meta کی Instagram Login کی مثال میں mid، title اور payload شامل ہیں، اور اس کی آئس بریکر گائیڈ میں یہی آبجیکٹ mid کے بغیر دکھایا گیا ہے۔ نوٹیفکیشن کچھ اس طرح ہوتا ہے:
{
"object": "instagram",
"entry": [
{
"id": "<IG_ID>",
"time": 1793448000512,
"messaging": [
{
"sender": { "id": "<IGSID>" },
"recipient": { "id": "<IG_ID>" },
"timestamp": 1793447999874,
"postback": {
"mid": "<MESSAGE_ID>",
"title": "<ICE_BREAKER_QUESTION_OR_BUTTON_TITLE>",
"payload": "<PAYLOAD_SET_FOR_THE_OPTION>"
}
}
]
}
]
}فیلڈز کا کیا مطلب ہے؟
وہ فیلڈز جو Meta postback کے لیے دستاویز کرتا ہے، باہر سے اندر کی طرف:
- sender.id: وہ Instagram-scoped آئی ڈی جس نے ٹیپ کیا، یعنی وہ آئی ڈی جس کا جواب دینا ہے۔ recipient.id اور entry[].id: پروفیشنل اکاؤنٹ۔
- timestamp: وہ وقت جب شخص نے ٹیپ کیا، Meta کی آئس بریکر گائیڈ کے مطابق۔
- postback.title: آئس بریکر سوال یا بٹن کا عنوان جو شخص نے دیکھا۔
- postback.payload: وہ سٹرنگ جو آپشن بنانے کے وقت سیٹ کی گئی، ایپ کی منتخب کردہ۔
- postback.mid: اس پیغام کی آئی ڈی جو ٹیپ نے اکاؤنٹ کو بھیجا، Graph API v11.0 سے۔
- postback.referral: ref، source اور type، جب تھریڈ ig.me لنک میں ref پیرامیٹر کے ساتھ کھلا ہو۔
is_self: postback کے برابر میں، true پر سیٹ، جب اکاؤنٹ self-messaging ٹیسٹ میں اپنا بٹن ٹیپ کرے۔
آئس بریکرز کیسے سیٹ ہوتے ہیں؟
graph.instagram.com پر POST /<IG_ID>/messenger_profile کے ذریعے، platform کو instagram سیٹ کر کے اور ایک ice_breakers array جس کے call_to_actions میں 4 تک سوال اور payload کے جوڑے ہوں، ہر ترجمہ شدہ سیٹ کے لیے locale کے ساتھ۔ GET /me/messenger_profile?fields=ice_breakers انہیں فہرست کرتا ہے، اور fields کو ice_breakers پر سیٹ کر کے DELETE انہیں ہٹاتا ہے۔ یہاں منتخب کیا گیا payload وہی ہے جو سوال ٹیپ ہونے پر messaging_postbacks واپس کرتا ہے۔
POST https://graph.instagram.com/<IG_ID>/messenger_profile?access_token=<INSTAGRAM_USER_ACCESS_TOKEN>
Content-Type: application/json
{
"platform": "instagram",
"ice_breakers": [
{
"call_to_actions": [
{ "question": "<QUESTION_1>", "payload": "<PAYLOAD_1>" },
{ "question": "<QUESTION_2>", "payload": "<PAYLOAD_2>" }
]
}
]
}postback بٹن کیسے بھیجے جاتے ہیں؟
POST /<IG_ID>/messages کے ذریعے، اس پیغام کے اندر جو اکاؤنٹ بھیجتا ہے۔ بٹن ٹیمپلیٹ میں 640 حروف تک کا متن اور 1 سے 3 بٹن ہو سکتے ہیں؛ جنرک ٹیمپلیٹ میں 10 تک ایلیمنٹس، ہر ایک میں 3 بٹن تک۔ postback قسم کا بٹن ٹیپ ہونے پر messaging_postbacks پر اپنا payload واپس کرتا ہے، جبکہ web_url بٹن اس کے بجائے ان ایپ براؤزر میں ایک صفحہ کھولتا ہے۔ مستقل مینو، جو messenger_profile پر سیٹ ہوتا ہے، وہی دو قسمیں قبول کرتا ہے۔
کیا quick replies messaging_postbacks استعمال کرتے ہیں؟
نہیں: وہ messages پر آتے ہیں۔ ٹیپ کیا ہوا quick reply اپنا عنوان گفتگو میں ایک پیغام کے طور پر بھیجتا ہے، اور messages ایونٹ میں text اس عنوان پر سیٹ ہوتا ہے اور quick_reply.payload اس آپشن کے payload پر۔ ایک پیغام زیادہ سے زیادہ 13 quick replies پیش کر سکتا ہے، ہر ایک 20 حروف تک، صرف سادہ متن۔ Meta کی Instagram Messaging گائیڈ آئس بریکر اور جنرک ٹیمپلیٹ کے انتخاب کو بھی ان چیزوں میں شامل کرتی ہے جو messages رپورٹ کرتا ہے، لیکن اس کا کوئی نمونہ payload نہیں دیتی۔
کیا ٹیپ messaging window کھولتا ہے؟
مستقل مینو کے لیے Meta یہ کہتا ہے: مینو آئٹم ٹیپ کرنے سے معیاری messaging window کھلتی ہے، اور اکاؤنٹ کے پاس جواب دینے کے لیے 24 گھنٹے ہوتے ہیں۔ recipient.id کو postback کے sender.id پر سیٹ کر کے POST /<IG_ID>/messages سے جواب دیں۔ اکاؤنٹ کا جواب messages پر echo کے طور پر واپس آتا ہے، جس میں is_echo true پر سیٹ ہوتا ہے۔
کیا easyCoexistence postbacks آگے بھیجتا ہے؟
صرف quick reply ٹیپس۔ یہ messages پر آتے ہیں، جن کے لیے easyCoexistence کی ایپ اور ہر جڑا ہوا اکاؤنٹ سبسکرائب ہیں، اس لیے یہ اپنے quick_reply.payload کے ساتھ آپ کے اینڈ پوائنٹ تک پہنچتے ہیں۔ آئس بریکر، بٹن اور مینو ٹیپس messaging_postbacks پر آتے ہیں، جن کے لیے easyCoexistence سبسکرائب نہیں کرتا، اس لیے یہ آگے نہیں بھیجے جاتے۔
عام غلطیاں
- quick replies کا messaging_postbacks پر انتظار کرنا۔ quick reply messages پر آتا ہے، اور اس کے ساتھ ٹیپ کیے گئے آپشن کے متن کے برابر quick_reply.payload ہوتا ہے۔
- postback.title پر روٹنگ کرنا۔ title وہ ہے جو شخص نے دیکھا، اور یہ locale کے لحاظ سے مختلف ہو سکتا ہے؛ روٹنگ payload پر کریں، جو ایپ خود سیٹ کرتی ہے۔
- پرانے API ورژن پر mid کی توقع کرنا۔ Meta postback.mid صرف Graph API v11.0 سے شامل کرتا ہے۔
- 4 سے زیادہ آئس بریکرز سیٹ کرنا، یا انہیں ڈیسک ٹاپ پر ٹیسٹ کرنا۔ Meta کا Ice Breaker API زیادہ سے زیادہ 4 سوال لیتا ہے، اور یہ فیچر ڈیسک ٹاپ پر دستیاب نہیں۔
send_social_dm 24 گھنٹے کی ونڈو کے اندر شخص کو جواب دیتا ہے۔ US$ 9 سے US$ 0.75 تک فی کنکشن فی مہینہ، کنکشنز بڑھنے کے ساتھ قیمت کم ہوتی جاتی ہے، اور پہلے 3 دن فری ٹرائل ہے۔
اکثر پوچھے جانے والے سوالات
Instagram کے آئس بریکر ٹیپس کی اطلاع کون سا ویب ہک فیلڈ دیتا ہے؟
messaging_postbacks۔ postback آبجیکٹ میں سوال title کے طور پر ہوتا ہے، اور اس آپشن کے لیے سیٹ کیا گیا payload ہوتا ہے، ساتھ میں Graph API v11.0 سے mid بھی۔
ایک Instagram اکاؤنٹ کے کتنے آئس بریکرز ہو سکتے ہیں؟
زیادہ سے زیادہ 4 سوال، POST /<IG_ID>/messenger_profile کے ذریعے سیٹ کیے جاتے ہیں جس میں platform کو instagram سیٹ کیا گیا ہو، اختیاری طور پر ہر locale کے لیے۔
Instagram postback کا جواب کیسے دوں؟
POST /<IG_ID>/messages کے ذریعے، recipient.id کو postback کے sender.id پر سیٹ کر کے، جو ٹیپ کرنے والے شخص کی Instagram-scoped آئی ڈی ہے۔ مستقل مینو ٹیپ کے بعد Meta اکاؤنٹ کو جواب دینے کے لیے 24 گھنٹے دیتا ہے۔
Instagram postbacks کو title پر روٹ کروں یا payload پر؟
payload پر، جو ایپ نے آپشن کے لیے سیٹ کیا۔ title وہ متن ہے جو شخص نے دیکھا، اور یہ locale کے لحاظ سے مختلف ہو سکتا ہے۔
مزید پڑھیں
دو منٹ میں اپنا پہلا چینل کنیکٹ کریں۔
کسی پلیٹ فارم کے ریویو کا انتظار نہیں۔ WhatsApp، Instagram، TikTok یا کوئی اور چینل کنیکٹ کریں، پھر اپنے AI سے پوسٹ کرنے، جواب دینے یا رپورٹ بنانے کو کہیں اور اسے کام کرتے دیکھیں۔
- 3 دن مفت
- کسی بھی وقت منسوخ کریں
- صرف آفیشل API
- 24/7 نگرانی
تصدیق شدہ تاریخ