Instagram messaging_postbacks వెబ్హుక్: ఐస్ బ్రేకర్లు మరియు బటన్లు
Instagram యొక్క messaging_postbacks వెబ్హుక్ ఫీల్డ్, ఒక వ్యక్తి ప్రొఫెషనల్ ఖాతాతో సంభాషణలో ఐస్ బ్రేకర్ ప్రశ్న, టెంప్లేట్లోని postback బటన్ లేదా పర్సిస్టెంట్ మెనూ ఐటమ్ను ట్యాప్ చేసినప్పుడు యాప్కు తెలియజేస్తుంది. ఈవెంట్లోని postback ఆబ్జెక్ట్లో title (వ్యక్తి ట్యాప్ చేసిన టెక్స్ట్), payload (యాప్ ఆ ఎంపిక కోసం సెట్ చేసిన స్ట్రింగ్), మరియు mid (మెసేజ్ ID, Graph API v11.0 నుండి) ఉంటాయి.
easyCoexistence ప్రతి కనెక్ట్ చేసిన Instagram ఖాతాను comments, messages, mentions కు సబ్స్క్రైబ్ చేస్తుంది, ఆ ఈవెంట్లను, క్విక్ రిప్లై ట్యాప్లతో సహా, అవి వచ్చినప్పుడే మీ HTTPS ఎండ్పాయింట్కు పంపుతుంది.
ఒక ఖాతా Meta యొక్క Ice Breaker API ద్వారా సెట్ చేయగల ఐస్ బ్రేకర్ ప్రశ్నల గరిష్ట సంఖ్య.
postback ఈవెంట్లలో mid చేర్చే Graph API వెర్షన్; ఫీల్డ్ స్వయంగా v8.0 లేదా ఆ తర్వాతి వెర్షన్ను కోరుతుంది.
ఒక బటన్ టెంప్లేట్ మెసేజ్లో గరిష్ట బటన్లు, ప్రతి ఒక్కటీ postback లేదా web_url బటన్.
పర్సిస్టెంట్ మెనూ ఐటమ్ను ట్యాప్ చేసిన తర్వాత ప్రతిస్పందించడానికి ఉన్న సమయం, ఇది ప్రామాణిక మెసేజింగ్ విండోను తెరుస్తుంది.
ఒక మెసేజ్ అందించగల గరిష్ట క్విక్ రిప్లైలు; ట్యాప్ చేసిన క్విక్ రిప్లై messages ఈవెంట్లో వస్తుంది, messaging_postbacks లో కాదు.
messaging_postbacks ఎప్పుడు ట్రిగర్ అవుతుంది?
ఒక వ్యక్తి సంభాషణలో ఖాతా అందించే నిర్మాణాత్మక ఎంపికల్లో ఒకదాన్ని ట్యాప్ చేసినప్పుడు, యాప్ మరియు ఖాతా ఆ ఫీల్డ్కు సబ్స్క్రైబ్ అయి ఉంటే. Meta గైడ్లు ఈ మూలాలను జాబితా చేస్తాయి:
- ఐస్ బ్రేకర్ ప్రశ్న, సంభాషణ మొదలైనప్పుడు ఖాతా అందించే గరిష్టంగా 4 ప్రశ్నల్లో ఒకటి. డెస్క్టాప్లో అందుబాటులో లేదు.
- బటన్ టెంప్లేట్లోని postback బటన్, ప్రతి మెసేజ్కు గరిష్టంగా 3, లేదా జనరిక్ టెంప్లేట్లోని ప్రతి ఎలిమెంట్కు గరిష్టంగా 3.
- ఖాతా పర్సిస్టెంట్ మెనూలోని postback ఐటమ్.
- ref పారామీటర్తో ig.me లింక్ నుండి తెరిచిన కొత్త థ్రెడ్లో ట్యాప్ చేసిన ఐస్ బ్రేకర్: అప్పుడు postback referral ను కూడా తీసుకెళ్తుంది.
- సెల్ఫ్-మెసేజింగ్ టెస్ట్, ఇందులో ఖాతా తన సొంత బటన్ను ట్యాప్ చేస్తుంది: ఈవెంట్కు
is_selfను true గా జోడిస్తుంది.
postback నోటిఫికేషన్ ఎలా కనిపిస్తుంది?
DM ఉండే చోట postback ఆబ్జెక్ట్ ఉన్న మెసేజింగ్ ఈవెంట్. Instagram Login కోసం Meta ఉదాహరణలో 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 ID, రిప్లై ఇవ్వాల్సిన ID. recipient.id మరియు entry[].id: ప్రొఫెషనల్ ఖాతా.
- timestamp: వ్యక్తి ఎప్పుడు ట్యాప్ చేశాడో, Meta యొక్క ఐస్ బ్రేకర్ గైడ్ ప్రకారం.
- postback.title: వ్యక్తి చూసిన ఐస్ బ్రేకర్ ప్రశ్న లేదా బటన్ టైటిల్.
- postback.payload: ఆ ఎంపిక సృష్టించినప్పుడు సెట్ చేసిన స్ట్రింగ్, యాప్ ఎంచుకుంది.
- postback.mid: ట్యాప్ ఖాతాకు పంపిన మెసేజ్ ID, Graph API v11.0 నుండి.
- postback.referral: ref, source, type; థ్రెడ్ ig.me లింక్ ref పారామీటర్తో తెరిచినప్పుడు.
is_self: postback పక్కన true గా సెట్ అవుతుంది, ఖాతా సెల్ఫ్-మెసేజింగ్ టెస్ట్లో తన బటన్ను ట్యాప్ చేసినప్పుడు.
ఐస్ బ్రేకర్లు ఎలా సెట్ చేస్తారు?
graph.instagram.com పై POST /<IG_ID>/messenger_profile తో: platform ను instagram గా, మరియు ice_breakers అర్రే సెట్ చేయాలి. ఇందులో 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 రకం బటన్ ట్యాప్ చేసినప్పుడు తన payload ను messaging_postbacks లో ఇస్తుంది; web_url బటన్ మాత్రం యాప్లోని బ్రౌజర్లో ఒక పేజీ తెరుస్తుంది. messenger_profile పై సెట్ చేసిన పర్సిస్టెంట్ మెనూ ఈ రెండు రకాలనే తీసుకుంటుంది.
క్విక్ రిప్లైలు messaging_postbacks ను ఉపయోగిస్తాయా?
లేదు: అవి messages లో వస్తాయి. ట్యాప్ చేసిన క్విక్ రిప్లై దాని టైటిల్ ను సంభాషణలో మెసేజ్గా పోస్ట్ చేస్తుంది, మరియు messages ఈవెంట్లో text ఆ టైటిల్కు సెట్ అయి, quick_reply.payload ఆ ఎంపిక యొక్క payload కు సెట్ అవుతుంది. ఒక మెసేజ్ గరిష్టంగా 13 క్విక్ రిప్లైలను, ప్రతిదానికి గరిష్టంగా 20 అక్షరాలతో, సాదా టెక్స్ట్లో మాత్రమే అందించగలదు. Meta యొక్క Instagram Messaging గైడ్ ఐస్ బ్రేకర్ మరియు జనరిక్ టెంప్లేట్ ఎంపికలను కూడా messages నివేదించే వాటిలో జాబితా చేస్తుంది, కానీ నమూనా payload లేకుండా.
ట్యాప్ మెసేజింగ్ విండోను తెరుస్తుందా?
పర్సిస్టెంట్ మెనూ కోసం Meta అలా చెబుతుంది: మెనూ ఐటమ్పై ట్యాప్ ప్రామాణిక మెసేజింగ్ విండోను తెరుస్తుంది, మరియు ఖాతాకు స్పందించడానికి 24 గంటలు ఉంటాయి. recipient.id ను postback యొక్క sender.id కు సెట్ చేసి POST /<IG_ID>/messages తో రిప్లై ఇవ్వండి. ఖాతా రిప్లై messages లో is_echo ను true గా సెట్ చేసి echo గా తిరిగి వస్తుంది.
easyCoexistence postbacks ను ఫార్వర్డ్ చేస్తుందా?
క్విక్ రిప్లై ట్యాప్లు మాత్రమే. అవి messages పై వస్తాయి, దానికి easyCoexistence యొక్క యాప్ మరియు ప్రతి కనెక్ట్ చేసిన ఖాతా సబ్స్క్రైబ్ అయి ఉంటాయి, కాబట్టి అవి quick_reply.payload తో మీ ఎండ్పాయింట్కు చేరతాయి. ఐస్ బ్రేకర్, బటన్ మరియు మెనూ ట్యాప్లు messaging_postbacks పై వస్తాయి, దానికి easyCoexistence సబ్స్క్రైబ్ చేయదు, కాబట్టి అవి ఫార్వార్డ్ చేయబడవు.
సాధారణ పొరపాట్లు
- క్విక్ రిప్లైలను messaging_postbacks లో ఆశించడం. క్విక్ రిప్లై messages లో వస్తుంది, quick_reply.payload తో పాటు ట్యాప్ చేసిన ఎంపిక యొక్క టెక్స్ట్ ఉంటుంది.
- postback.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 ID. పర్సిస్టెంట్ మెనూ ట్యాప్ తర్వాత, ఖాతాకు స్పందించడానికి Meta 24 గంటలు ఇస్తుంది.
Instagram postbacks ను title పై రూట్ చేయాలా లేక payload పైనా?
payload పై, అంటే యాప్ ఎంపికకు సెట్ చేసిన స్ట్రింగ్ పై. title అనేది వ్యక్తి చూసిన టెక్స్ట్, ఇది locale ప్రకారం మారవచ్చు.
చదవడం కొనసాగించండి
మీ మొదటి ఛానెల్ను రెండు నిమిషాల్లో కనెక్ట్ చేయండి.
ప్లాట్ఫామ్ సమీక్షల కోసం ఎదురుచూడాల్సిన అవసరం లేదు. WhatsApp, Instagram, TikTok లేదా మరో ఛానెల్ను కనెక్ట్ చేయండి, ఆపై పోస్ట్ చేయమని, ప్రత్యుత్తరం ఇవ్వమని లేదా రిపోర్ట్ ఇవ్వమని మీ AIకి చెప్పండి, అది పని చేయడం చూడండి.
- 3 రోజులు ఉచితం
- ఎప్పుడైనా రద్దు చేయండి
- అధికారిక APIలు మాత్రమే
- 24/7 పర్యవేక్షణ
ధృవీకరించిన తేదీ