Instagram మెసేజ్ వెబ్హుక్: DM పేలోడ్, ఎకోలు మరియు ఫీల్డ్లు
Instagram యొక్క messages వెబ్హుక్ ఫీల్డ్ ప్రొఫెషనల్ ఖాతాకు వచ్చినప్పుడే DMలను అందిస్తుంది: టెక్స్ట్, అటాచ్మెంట్లు, షేర్లు, స్టోరీ రిప్లైలు, మెన్షన్లు, ఇన్లైన్ రిప్లైలు మరియు డిలీషన్లు. ప్రతి ఈవెంట్ messaging శ్రేణిలో ఉంటుంది: పంపినవారి Instagram-స్కోప్డ్ ID, గ్రహీత, టైమ్స్టాంప్ మరియు మెసేజ్ ఆబ్జెక్ట్. ఖాతా తానే పంపిన మెసేజ్లు అదే ఫీల్డ్లో is_echo true గా తిరిగి వస్తాయి.
easyCoexistence ప్రతి కనెక్ట్ చేసిన Instagram ఖాతాను messages కు సబ్స్క్రైబ్ చేసి దాని DMలను, ఎకోలతో సహా, అవి వచ్చినప్పుడే మీ HTTPS ఎండ్పాయింట్కు ఫార్వర్డ్ చేస్తుంది; ఆ ఖాతా సీక్రెట్తో సంతకం చేసి; ఫార్వార్డింగ్ కాపీ ఏదీ ఉంచదు, మరియు DMలు డిఫాల్ట్గా నిల్వ చేయబడవు.
ఖాతా తానే పంపిన మెసేజ్ ఈవెంట్పై is_echo విలువ true గా సెట్ అవుతుంది.
చాలా వినియోగదారు చర్యలకు ప్రామాణిక మెసేజింగ్ విండో; ఈ సమయంలో యాప్ ఆ వ్యక్తికి రిప్లై ఇవ్వగలదు.
షేర్ చేసిన పోస్ట్ కోసం అటాచ్మెంట్ రకం share; పాత share రకం కేవలం ఫిబ్రవరి 1, 2026 వరకు మాత్రమే మద్దతు పొందింది.
ఎవరైనా తమ స్టోరీలో ఖాతాను మెన్షన్ చేసినప్పుడు Meta పంపే DM ఈవెంట్ యొక్క అటాచ్మెంట్ రకం.
ఖాతా యజమాని Instagram డైరెక్ట్ మెసేజ్లకు యాక్సెస్ను నిలిపివేసినప్పుడు కోడ్ 200 కింద వచ్చే లోపం సబ్కోడ్.
messages ఫీల్డ్ ఎప్పుడు ట్రిగ్గర్ అవుతుంది?
ఒక వ్యక్తి ప్రొఫెషనల్ ఖాతాకు DM పంపినప్పుడు, అలాగే ఖాతా ఒకదాన్ని పంపినప్పుడు. Meta ఉదాహరణలు మరియు రిఫరెన్స్లు ఈ కేసులను జాబితా చేస్తాయి; ప్రతి ఒక్కటి మెసేజ్ ఆబ్జెక్ట్తో కూడిన messaging ఈవెంట్:
- టెక్స్ట్, మరియు మీడియా అటాచ్మెంట్లుగా: చిత్రాలు, వీడియో, ఆడియో మరియు ఫైళ్లు.
- షేర్ చేసిన పోస్ట్ లేదా రీల్,
ig_post,ig_reelలేదా reel అటాచ్మెంట్గా. - ఖాతా స్టోరీకి వచ్చిన రిప్లై,
reply_to.story తో, మరియు ఖాతాను మెన్షన్ చేసే స్టోరీ,story_mentionఅటాచ్మెంట్గా. - ముందటి మెసేజ్కు ఇన్లైన్ రిప్లై,
reply_to.mid తో, మరియు క్విక్ రిప్లై,quick_reply.payload తో. - వ్యక్తి డిలీట్ చేసిన మెసేజ్ (
is_deleted), మద్దతులేని మీడియా (is_unsupported), మరియు Click-to-Direct యాడ్పై క్లిక్ చేసిన వ్యక్తి నుండి మెసేజ్ (referral). - ఖాతా పంపిన మెసేజ్, ఇది
is_echotrue తో తిరిగి వస్తుంది.
మెసేజ్ నోటిఫికేషన్ ఎలా కనిపిస్తుంది?
object విలువ instagram గా ఉన్న JSON తో POST. కామెంట్ లాగా కాకుండా, ఇక్కడ మెసేజ్ ఖాతా entry లోపల messaging శ్రేణిలో ఉంటుంది, ప్రతి ఎలిమెంట్లో sender, recipient, timestamp మరియు message ఉంటాయి. ఖాతా స్టోరీకి వచ్చిన రిప్లై ఇలా కనిపిస్తుంది:
{
"object": "instagram",
"entry": [
{
"id": "<IG_ID>",
"time": 1793448000512,
"messaging": [
{
"sender": { "id": "<IGSID>" },
"recipient": { "id": "<IG_ID>" },
"timestamp": 1793447999874,
"message": {
"mid": "<MESSAGE_ID>",
"text": "<MESSAGE_TEXT>",
"reply_to": {
"story": {
"url": "<CDN_URL_FOR_THE_STORY>",
"id": "<STORY_ID>"
}
}
}
}
]
}
]
}ప్రతి ఫీల్డ్ అర్థం ఏమిటి?
Meta, Instagram Login కింద మెసేజ్ ఈవెంట్ కోసం డాక్యుమెంట్ చేసే ఫీల్డ్లు, బయటి నుండి లోపలికి:
- entry[].id: ప్రొఫెషనల్ ఖాతా ID. entry[].time: Meta నోటిఫికేషన్ పంపిన సమయం; Meta మెసేజింగ్ నమూనాలు దీనిని మిల్లీసెకన్లలో ఇస్తాయి.
- sender.id మరియు recipient.id: ఇన్కమింగ్ DM పై, వ్యక్తి యొక్క Instagram-స్కోప్డ్ ID మరియు ఖాతా ID; ఎకోపై, అదే రెండు రివర్స్లో.
- timestamp: మెసేజ్ పంపబడిన సమయం; Meta నమూనాలలో మిల్లీసెకన్లలో. మెసేజ్లను వచ్చిన క్రమంలో కాకుండా దీని ప్రకారం క్రమబద్ధీకరించండి.
- message.mid: మెసేజ్ ID; డూప్లికేట్లను తొలగించడానికి, రియాక్ట్ చేయడానికి, మరియు
reply_to.mid తో ఆ మెసేజ్కు రిప్లై ఇవ్వడానికి. - message.text: మెసేజ్లో టెక్స్ట్ ఉన్నప్పుడు చేర్చబడుతుంది.
- message.attachments[]: ప్రతిదానికి type మరియు payload, సాధారణంగా url తో. షేర్ చేసిన పోస్ట్ యొక్క
ig_postపేలోడ్ లోig_post_media_idమరియు title (దాని క్యాప్షన్) జోడిస్తుంది. - message.
reply_to: ఇన్లైన్ రిప్లై కోసం mid, లేదా స్టోరీ రిప్లై కోసం story, దాని url మరియు id తో. - message.
quick_reply.payload మరియు message.referral: ఎంచుకున్న క్విక్ రిప్లై, మరియు Click-to-Direct యాడ్ యొక్క ref,ad_id, source, type మరియుads_context_data. - message.
is_deleted,is_echo,is_selfమరియుis_unsupported: నిజమైనప్పుడు మాత్రమే చేర్చబడతాయి. - message.
admin_textమరియుhandoff_reason: అర్హత కలిగిన యాప్లపై, Meta Business Agent వంటి Meta అప్లికేషన్ సంభాషణను అప్పగించినట్లు నోటీసు; mid లేదా టెక్స్ట్ లేకుండా కూడా రావచ్చు.
ఎకోలు ఎలా పని చేస్తాయి?
ఖాతా మెసేజ్ పంపినప్పుడు, Meta దానికి మెసేజ్ ఈవెంట్ కూడా పంపుతుంది, is_echo true తో. అప్పుడు sender.id ఖాతా అవుతుంది మరియు recipient.id వ్యక్తి యొక్క Instagram-స్కోప్డ్ ID; ఖాతా తనకు తానే పంపిన టెస్ట్ మెసేజ్ is_self ను కూడా కలిగి ఉంటుంది. ఎకోలు ఖాతా ఏమి చెప్పిందో రికార్డ్ చేస్తాయి, ఇది సంభాషణ లాగ్కు అవసరం, కానీ రిప్లై ఇవ్వాలో వద్దో నిర్ణయించే హ్యాండ్లర్ వాటిని దాటవేయాలి. ఖాతా మెసేజ్పై రియాక్ట్ చేసినప్పుడు లేదా రియాక్షన్ తీసివేసినప్పుడు Meta ఎకోను పంపదు.
{
"object": "instagram",
"entry": [
{
"id": "<IG_ID>",
"time": 1793448061203,
"messaging": [
{
"sender": { "id": "<IG_ID>" },
"recipient": { "id": "<IGSID>" },
"timestamp": 1793448060950,
"message": {
"mid": "<MESSAGE_ID>",
"text": "<REPLY_TEXT>",
"is_echo": true
}
}
]
}
]
}ఏ ID కి రిప్లై ఇస్తారు?
sender.id, అంటే వ్యక్తి యొక్క Instagram-స్కోప్డ్ ID. ఒకరు ఖాతాకు మెసేజ్ చేసినప్పుడు లేదా దాని మీడియాపై కామెంట్ చేసినప్పుడు Meta దీనిని సృష్టిస్తుంది, ఇది ఆ వ్యక్తికి మరియు ఆ ఖాతాకు ప్రత్యేకం. POST /<IG_ID>/messages లో recipient.id దీనికి సెట్ చేసి రిప్లై పంపండి. ఈవెంట్లో పేరు లేదా యూజర్నేమ్ ఉండదు; name మరియు username వంటి ఫీల్డ్లతో GET /<IGSID> వాటిని తిరిగి ఇస్తుంది, ఎందుకంటే ఖాతాకు మెసేజ్ చేసిన వ్యక్తి ఆ లుకప్కు అవసరమైన సమ్మతి ఇచ్చారు.
ఒక మెసేజ్ 24 గంటల విండోను ఎలా తెరుస్తుంది?
ఒక యాప్ వ్యక్తి ఖాతాకు మెసేజ్ చేసిన తర్వాత మాత్రమే, వారి చర్య తెరిచే ప్రామాణిక మెసేజింగ్ విండోలో మాత్రమే వారికి మెసేజ్ చేయగలదు. చాలా చర్యలకు ఇది 24 గంటలు ఉంటుంది, Click-to-Direct యాడ్ క్లిక్ తర్వాత పంపిన మొదటి మెసేజ్ నుండి 7 రోజుల వరకు. వ్యక్తి నుండి కొత్త మెసేజ్ కొత్త విండోను తెరుస్తుంది, కాబట్టి వారి తాజా timestamp ను ట్రాక్ చేయాలి; ఎకో ఖాతా సొంత మెసేజ్, అది ఏదీ పొడిగించదు. వ్యక్తులు రాసిన రిప్లైలు human_agent తో ట్యాగ్ చేసిన Meta యొక్క ప్రత్యేక 7-రోజుల Human Agent విండోను ఉపయోగించవచ్చు.
మెసేజ్ ఈవెంట్లో ఏమి ఉండదు?
Meta యొక్క మెసేజింగ్ రిఫరెన్స్ల ప్రకారం, హ్యాండ్లర్ వెతికే కొన్ని విషయాలు లేవు:
- వ్యక్తి పేరు లేదా యూజర్నేమ్: కేవలం Instagram-స్కోప్డ్ ID, దీన్ని GET /<IGSID> పరిష్కరిస్తుంది.
- View-once మీడియా: URL లేకుండా ephemeral అటాచ్మెంట్గా వస్తుంది.
- ఖచ్చితమైన క్యారౌసెల్ ఇమేజ్: క్యారౌసెల్ పోస్ట్లోని ఒక ఇమేజ్పై రియాక్షన్ లేదా ఫార్వర్డ్ మొదటి ఇమేజ్ను నివేదిస్తుంది.
- రియాక్షన్లు, ఎడిట్లు మరియు రీడ్ రసీదులు, ఇవి వాటి సొంత ఫీల్డ్లపై వస్తాయి.
- రీడ్ మార్క్: వెబ్హుక్ ద్వారా అందిన మెసేజ్ రిప్లై పంపే వరకు Instagram ఇన్బాక్స్లో అన్రీడ్గానే ఉంటుంది.
Meta ఏ ఇతర మెసేజింగ్ ఫీల్డ్లను జాబితా చేస్తుంది?
Meta యొక్క Instagram Login కోసం ఫీల్డ్ జాబితా మరియు ఉదాహరణలు messages కాకుండా వీటిని పేర్కొంటాయి, ప్రతి ఒక్కటి దాని సొంత messaging ఈవెంట్. easyCoexistence ప్రతి ఖాతాను messages, comments మరియు mentions కు మాత్రమే సబ్స్క్రైబ్ చేస్తుంది, కాబట్టి వీటిలో ఏదీ అది ఫార్వర్డ్ చేసే దానిలో భాగం కాదు:
message_reactions: వ్యక్తి మెసేజ్కు రియాక్ట్ చేస్తారు లేదా రియాక్షన్ తీసివేస్తారు; reaction.mid, action విలువ react లేదా unreact, మరియు reaction మరియు emoji తో.message_edit: వ్యక్తి మెసేజ్ను ఎడిట్ చేస్తారు;message_edit.mid, కొత్త టెక్స్ట్ మరియుnum_editతో.messaging_postbacks: వ్యక్తి ఐస్బ్రేకర్ లేదా టెంప్లేట్ బటన్ను ట్యాప్ చేస్తారు; postback.mid, title మరియు payload తో.messaging_referral: సంభాషణలో ఇప్పటికే ఉన్న వ్యక్తి ref పరామితితో ig.me లింక్ను తెరుస్తారు.messaging_seen: వ్యక్తి ఒక మెసేజ్ను చదువుతారు; read.mid తో.messaging_optins,messaging_handoverమరియు standby: చివరి రెండు, Meta హ్యాండోవర్ ప్రోటోకాల్ కింద సంభాషణను పంచుకునే యాప్ల కోసం.
ఖాతా ఏమి ఆన్ చేయాలి?
“Allow access to messages” ఆన్ చేయాలని Meta కోరుతుంది; API ద్వారా మెసేజ్లను నిర్వహించే ముందు ప్రొఫెషనల్ ఖాతా దీన్ని ఆన్ చేయాలి. Instagram యాప్లో Settings, Messages and story replies, Message controls, Connected tools కింద ఇది ఉంటుంది. ఇది ఆఫ్లో ఉన్నప్పుడు, పంపడం కోడ్ 200, సబ్కోడ్ 2534041 తో విఫలమవుతుంది. యాప్కు instagram_business_basic మరియు instagram_business_manage_messages కూడా అవసరం; అది యాజమాన్యంలో లేని లేదా నిర్వహించని ఖాతాలకు సేవ చేయాలంటే Advanced Access ఉండాలి.
easyCoexistence DM ను ఎలా ఫార్వర్డ్ చేస్తుంది?
కామెంట్ లాగానే: ఖాతా కోసం Meta అందించే ప్రతి entry, platform, account_id, external_id మరియు entry తో కూడిన ఎన్వలప్లో మీ HTTPS ఎండ్పాయింట్కు POST చేయబడుతుంది, X-EC-Signature లో ఖాతా సీక్రెట్తో సంతకం చేయబడుతుంది, ఒక్కసారి మాత్రమే, కాపీ ఏదీ ఉంచకుండా. ఎకోలు మిగతా వాటితో పాటు ఫార్వర్డ్ అవుతాయి, కాబట్టి రిప్లై ఇచ్చే ముందు is_echo ను తనిఖీ చేయండి. సమాధానమివ్వడానికి, account_id మరియు ఈవెంట్ యొక్క sender.id ను recipient_id గా పెట్టి send_social_dm ను కాల్ చేయండి, 24 గంటల విండో లోపల. DM పై ప్రారంభమయ్యే ఆటోమేషన్లు అదే ఈవెంట్లపై నడుస్తాయి.
{
"platform": "instagram",
"account_id": "<ACCOUNT_ID>",
"external_id": "<IG_ID>",
"entry": {
"id": "<IG_ID>",
"time": 1793448000512,
"messaging": [
{
"sender": { "id": "<IGSID>" },
"recipient": { "id": "<IG_ID>" },
"timestamp": 1793447999874,
"message": {
"mid": "<MESSAGE_ID>",
"attachments": [
{ "type": "image", "payload": { "url": "<URL_FOR_THE_MEDIA>" } }
]
}
}
]
}
}సాధారణ పొరపాట్లు
- ఎకోలకు రిప్లై ఇవ్వడం. is_echo సెట్ ఉన్న ఈవెంట్ ఖాతా సొంత మెసేజ్; దానికి రిప్లై ఇస్తే ఖాతా తనతో తానే లూప్లో పడుతుంది.
- మెసేజ్కు ఎప్పుడూ టెక్స్ట్ ఉంటుందని అనుకోవడం. అటాచ్మెంట్లు, షేర్లు, స్టోరీ మెన్షన్లు మరియు డిలీషన్లు text ఫీల్డ్ లేకుండా వస్తాయి, కాబట్టి మెసేజ్ ఆబ్జెక్ట్లో ఏముందో చూసి బ్రాంచ్ చేయండి.
- వచ్చిన క్రమంలో మెసేజ్లను క్రమబద్ధీకరించడం. ఒక లోపం తర్వాత Meta మెసేజ్లను క్రమం తప్పి పంపవచ్చు, కాబట్టి వాటిని timestamp ప్రకారం క్రమబద్ధీకరించండి.
- time మరియు timestamp ను సెకన్లుగా పార్స్ చేయడం. Meta మెసేజింగ్ నమూనాలు రెండింటినీ మిల్లీసెకన్లలో ఇస్తాయి; సెకన్లుగా చదివితే అవి చాలా దూర భవిష్యత్ తేదీలుగా మారతాయి.
send_social_dm 24 గంటల విండో లోపల రిప్లై ఇస్తుంది, మరియు ఆటోమేషన్లు స్థిరమైన టెక్స్ట్ లేదా AI తో స్వయంగా రిప్లై ఇవ్వగలవు. ప్రతి కనెక్షన్కు నెలకు US$ 9 నుండి US$ 0.75 వరకు, మీరు కనెక్షన్లు జోడించే కొద్దీ తగ్గుతుంది, మొదటి 3 రోజులు ఉచితం.
తరచుగా అడిగే ప్రశ్నలు
Instagram మెసేజ్ వెబ్హుక్ టైమ్స్టాంప్లు సెకన్లలోనా లేక మిల్లీసెకన్లలోనా?
Meta మెసేజింగ్ నమూనాలలో timestamp మరియు entry time రెండూ మిల్లీసెకన్లలో ఉంటాయి. సెకన్లుగా చదివితే అవి చాలా దూర భవిష్యత్ తేదీలుగా మారతాయి.
Instagram DM వెబ్హుక్ నుండి పంపినవారి యూజర్నేమ్ ఎలా పొందాలి?
name మరియు username వంటి ఫీల్డ్లతో GET /<IGSID> ను కాల్ చేయండి. ఈవెంట్లో వ్యక్తి యొక్క Instagram-స్కోప్డ్ ID మాత్రమే ఉంటుంది.
నా Instagram DM వెబ్హుక్లు ఎందుకు రావడం లేదు?
ఖాతా “Allow access to messages” ఆన్ చేసిందా, /subscribed_apps ద్వారా messages కు సబ్స్క్రైబ్ అయిందా, మరియు యాప్ ఖాతా యజమాని కాని ఖాతాలకు Advanced Access తో Live గా ఉందా తనిఖీ చేయండి.
easyCoexistence Instagram మెసేజ్ రియాక్షన్లను ఫార్వర్డ్ చేస్తుందా?
లేదు. రియాక్షన్లు message_reactions పై వస్తాయి, మరియు easyCoexistence ఖాతాలను messages, comments మరియు mentions కు మాత్రమే సబ్స్క్రైబ్ చేస్తుంది.
చదవడం కొనసాగించండి
మీ మొదటి ఛానెల్ను రెండు నిమిషాల్లో కనెక్ట్ చేయండి.
ప్లాట్ఫామ్ సమీక్షల కోసం ఎదురుచూడాల్సిన అవసరం లేదు. WhatsApp, Instagram, TikTok లేదా మరో ఛానెల్ను కనెక్ట్ చేయండి, ఆపై పోస్ట్ చేయమని, ప్రత్యుత్తరం ఇవ్వమని లేదా రిపోర్ట్ ఇవ్వమని మీ AIకి చెప్పండి, అది పని చేయడం చూడండి.
- 3 రోజులు ఉచితం
- ఎప్పుడైనా రద్దు చేయండి
- అధికారిక APIలు మాత్రమే
- 24/7 పర్యవేక్షణ
ధృవీకరించిన తేదీ