Instagram కామెంట్స్ వెబ్హుక్: పేలోడ్, ఒక్కో ఫీల్డ్ వివరంగా
Instagram కామెంట్స్ వెబ్హుక్ ఫీల్డ్ ఎవరైనా ప్రొఫెషనల్ ఖాతా మీడియాపై కామెంట్ చేసినప్పుడు లేదా కామెంట్కు రిప్లై ఇచ్చినప్పుడు యాప్కు తెలియజేస్తుంది; రీల్స్ కూడా ఇందులో ఉంటాయి. Meta field ను comments గా సెట్ చేసి change పంపుతుంది; దాని value లో కామెంట్ id మరియు టెక్స్ట్, from లో రచయిత Instagram-scoped ID మరియు యూజర్నేమ్, మీడియా id మరియు product type, కామెంట్ రిప్లై అయితే parent_id ఉంటాయి.
easyCoexistence ప్రతి కనెక్ట్ అయిన Instagram ఖాతాను comments కు సబ్స్క్రైబ్ చేస్తుంది, దాని కోసం Meta పంపే comments ఈవెంట్లను వచ్చిన వెంటనే మీ HTTPS ఎండ్పాయింట్కు ఫార్వర్డ్ చేస్తుంది, ఆ ఖాతా సీక్రెట్తో సంతకం చేసి, ఏ కాపీ ఉంచకుండా.
కామెంట్ రిప్లై అయితే ఇది ఉంటుంది, అది రిప్లై చేస్తున్న కామెంట్ ID ను కలిగి ఉంటుంది.
ఖాతా తన సొంత మీడియాపై కామెంట్ చేసినప్పుడు, from లో ఖాతా స్వంత ID పక్కన జోడించబడుతుంది.
లైవ్ ప్రసారంలో వచ్చే కామెంట్లకు ప్రత్యేక ఫీల్డ్ ఉంది; ప్రసారం ముగిసినప్పుడు దాని నోటిఫికేషన్లు ఆగిపోతాయి.
comments మరియు live_comments నోటిఫికేషన్లకు ఇది అవసరం; ప్రైవేట్ ఖాతాలకు చెందిన మీడియా ఏదీ నోటిఫికేషన్ ట్రిగ్గర్ చేయదు.
కామెంట్ ID ద్వారా అడ్రస్ చేయబడిన, కామెంట్ చేసిన వ్యక్తికి ఒక ప్రైవేట్ రిప్లై పంపడానికి మిగిలిన సమయం.
కామెంట్స్ ఫీల్డ్ ఎప్పుడు ట్రిగ్గర్ అవుతుంది?
యాప్, ఖాతా రెండూ ఫీల్డ్కు సబ్స్క్రైబ్ అయిన తర్వాత, ప్రొఫెషనల్ ఖాతా సొంతమైన మీడియాపై ఎవరైనా కామెంట్ చేసినప్పుడు, లేదా ఖాతాను మెన్షన్ చేసినప్పుడు ఇది ట్రిగ్గర్ అవుతుంది. నోటిఫికేషన్లో ప్రతి కామెంట్ ఒక change, ఈ కేసులన్నీ ఈ ఆకారాన్నే పంచుకుంటాయి:
- పోస్ట్, రీల్, స్టోరీ లేదా యాడ్పై కొత్త కామెంట్; media.
media_product_typeఆ మీడియా ఏ ఉపరితలంపై ఉందో చెబుతుంది. - ఇప్పటికే ఉన్న కామెంట్కు రిప్లై; దానిలో అది రిప్లై చేస్తున్న కామెంట్ ID తో
parent_idఉంటుంది. - ఖాతా తన సొంత మీడియాపై చేసే కామెంట్, దాని రిప్లైలతో సహా: from.id ఖాతా సొంత ID, మరియు from లో
self_ig_scoped_idజోడించబడుతుంది. - ఖాతాకు @మెన్షన్: Instagram Login తో, Meta మెన్షన్లను వాటి స్వంత ఫీల్డ్గా కాకుండా కామెంట్స్ నోటిఫికేషన్లోనే చేరుస్తుంది.
- లైవ్ ప్రసారంలో కామెంట్
live_commentsఅనే వేరే ఫీల్డ్లో వస్తుంది, అదే విలువ ఆకారంతో; ప్రసారం ముగిసినప్పుడు అది ఆగిపోతుంది.
కామెంట్స్ నోటిఫికేషన్ ఎలా కనిపిస్తుంది?
JSON లో object విలువ instagram అయి, entry అర్రే ఉండే POST. ప్రతి entry ఒక ప్రొఫెషనల్ ఖాతా: దాని ID, Meta నోటిఫికేషన్ పంపిన సమయం, మరియు ప్రతి కామెంట్కు ఒక change ఉన్న changes అర్రే. రీల్పై వచ్చిన రిప్లై ఇలా కనిపిస్తుంది:
{
"object": "instagram",
"entry": [
{
"id": "<IG_ID>",
"time": 1793448000,
"changes": [
{
"field": "comments",
"value": {
"id": "<COMMENT_ID>",
"parent_id": "<PARENT_COMMENT_ID>",
"text": "<COMMENT_TEXT>",
"from": {
"id": "<INSTAGRAM_SCOPED_ID>",
"username": "<USERNAME>"
},
"media": {
"id": "<MEDIA_ID>",
"media_product_type": "REELS"
}
}
}
]
}
]
}ప్రతి ఫీల్డ్ దేని అర్థం?
Meta యొక్క వెబ్హుక్ రిఫరెన్స్ కామెంట్ కోసం జాబితా చేసే ఫీల్డ్లు, బయటి నుంచి లోపలికి:
- entry[].id: ప్రొఫెషనల్ ఖాతా ID, అంటే /me దాని కోసం ఇచ్చే
user_id. ఏ ఖాతాకు కామెంట్ చెందుతుందో ఇది చెబుతుంది. - entry[].time: Meta నోటిఫికేషన్ పంపిన సమయం, Unix timestamp గా. కామెంట్ రాసిన సమయం కాదు.
- changes[].field: comments, లేదా లైవ్ ప్రసారం కోసం
live_comments. value చదవడానికి ముందు దీన్ని తనిఖీ చేయండి. - value.id: కామెంట్ ID; పబ్లిక్గా లేదా ప్రైవేట్గా రిప్లై ఇవ్వడానికి, హైడ్ లేదా డిలీట్ చేయడానికి ఉపయోగించే ID.
- value.text: కామెంట్లో టెక్స్ట్ ఉన్నప్పుడు, ఆ టెక్స్ట్.
- value.from.id మరియు value.from.username: రచయిత Instagram-scoped ID మరియు యూజర్నేమ్. ఖాతానే కామెంట్ రాసినప్పుడు value.from.
self_ig_scoped_idకనిపిస్తుంది. - value.media.id మరియు value.media.
media_product_type: కామెంట్ చేసిన మీడియా మరియు దాని ఉపరితలం; Meta మీడియా రిఫరెన్స్ AD, FEED, STORY మరియు REELS అని పేర్కొంటుంది. - value.
parent_id: రిప్లైపై, అది రిప్లై చేస్తున్న కామెంట్ ID. టాప్-లెవల్ కామెంట్కు ఇది ఉండదు. - value.media.
ad_id,ad_titleమరియుoriginal_media_id: యాడ్పై చేసిన కామెంట్ల కోసం రిఫరెన్స్లో జాబితా చేయబడ్డాయి.
కామెంట్స్ ఫీల్డ్ ఏమి రిపోర్ట్ చేయదు?
హ్యాండ్లర్ ఆశించే కొన్ని విషయాలు ఈవెంట్లో లేవు లేదా ఎప్పుడూ పంపబడవు, Meta సెటప్ గైడ్ మరియు రిఫరెన్స్ల ప్రకారం:
- ప్రైవేట్ ఖాతాకు చెందిన మీడియాపై కామెంట్లు: వాటికి Meta కామెంట్ లేదా మెన్షన్ నోటిఫికేషన్లు పంపదు.
- ఆల్బమ్ IDలు: ఈవెంట్లో అవి ఉండవు; కామెంట్ ID తో ఆల్బమ్ను వెతకమని Meta చెబుతుంది.
- డైనమిక్ యాడ్లలో ఉపయోగించిన మీడియా కోసం యాడ్ IDలు.
- కామెంట్ సృష్టించిన సమయం: GET /<
COMMENT_ID>?fields=timestamp దానిని ISO 8601 లో ఇస్తుంది. - లైవ్ ప్రసారం ముగిసిన తర్వాత లైవ్ కామెంట్లు, లైవ్ మీడియా నోటిఫికేషన్లు ఆగిపోయినప్పుడు.
- స్టోరీ మెన్షన్లు: వీటికి Meta మెన్షన్స్ API మద్దతు ఇవ్వదు; బదులుగా అవి DMల రూపంలో ఖాతాకు చేరతాయి.
- గత ఈవెంట్లు: Meta ప్రశ్నించడానికి నోటిఫికేషన్ చరిత్ర ఉంచదు, కాబట్టి ప్రతిది వచ్చినప్పుడే మీకు అవసరమైనది నిల్వ చేయండి.
కామెంట్స్ ఫీల్డ్కు ఏమి కావాలి?
Instagram Login తో instagram_business_basic మరియు instagram_business_manage_comments అనుమతులు, మరియు comments మరియు live_comments నోటిఫికేషన్లకు Meta కోరే Advanced Access. యాప్ యాప్ డాష్బోర్డ్లో లైవ్ మోడ్లో ఉండి comments కు సబ్స్క్రైబ్ అయి ఉండాలి; ప్రతి ఖాతా POST /<IG_ID>/subscribed_apps ద్వారా subscribed_fields లో comments తో సబ్స్క్రైబ్ కావాలి. కామెంట్ల కోసం Meta ఈ వెబ్హుక్ను పోలింగ్ కంటే గట్టిగా సిఫార్సు చేస్తుంది, ఎందుకంటే అది రేట్ లిమిట్ను ఆదా చేస్తుంది.
ఈవెంట్ నుండి కామెంట్కు ఎలా రిప్లై ఇవ్వాలి?
అది కలిగి ఉన్న IDలతో. POST /<COMMENT_ID>/replies లో message తో value.id ఉపయోగించి కామెంట్ కింద పబ్లిక్ రిప్లై పోస్ట్ చేయవచ్చు. POST /<IG_ID>/messages లో recipient.comment_id ను value.id కు సెట్ చేస్తే, రచయితకు ఒక ప్రైవేట్ రిప్లై వెళ్తుంది: కామెంట్ చేసిన తేదీ నుండి 7 రోజుల లోపు, లేదా లైవ్ ప్రసారం జరిగే సమయంలో. from.id ఒక Instagram-scoped ID, కానీ వ్యక్తి ఖాతాకు మెసేజ్ చేసే వరకు నేరుగా దానికి పంపిన DM విఫలమవుతుంది; కాబట్టి DM ద్వారా చేరడానికి ప్రైవేట్ రిప్లైయే మార్గం.
easyCoexistence కామెంట్ను ఎలా ఫార్వర్డ్ చేస్తుంది?
అది వచ్చిన వెంటనే, Claude లేదా ChatGPT నుండి set_social_webhook_destination తో, లేదా Partner API పై PUT /channels/:id/webhook తో ఖాతాకు ఎండ్పాయింట్ సెట్ చేసిన తర్వాత. easyCoexistence ప్రతి కనెక్ట్ అయిన ఖాతాను దాని కామెంట్లు, మెన్షన్లు మరియు DMలను తీసుకువెళ్లే ఫీల్డ్లకు సబ్స్క్రైబ్ చేస్తుంది, ప్రతి డెలివరీపై Meta సిగ్నేచర్ను తనిఖీ చేస్తుంది, వెంటనే Meta కు జవాబు ఇస్తుంది, మరియు ఆ ఖాతాకు చెందిన ప్రతి entry ను ఒక ఎన్వలప్లో మీ HTTPS URLకు POST చేస్తుంది:
- ప్లాట్ఫామ్ మరియు
external_id: instagram, మరియు ఖాతా Instagram ID, ఇది entry.id కు సమానం. account_id: easyCoexistence లో కనెక్షన్ ID;list_social_accountsతిరిగి ఇచ్చేది, MCP టూల్స్ తీసుకునేది.- entry: ఖాతాకు Meta యొక్క entry, మార్చకుండా; కాబట్టి బ్యాచ్ డెలివరీ ప్రతి entry కు ఒక POST అవుతుంది. Meta యొక్క object ఫీల్డ్ మరియు X-Hub-Signature-256 పంపబడవు.
- డెలివరీ: ఒక ప్రయత్నం, 8 సెకన్ల వరకు వేచి ఉండి, రీడైరెక్ట్లు అనుసరించకుండా, పబ్లిక్ IP కు రిజాల్వ్ అయ్యే HTTPS చిరునామాకు. కాపీ ఏదీ ఉంచబడదు, మళ్లీ ప్రయత్నం ఉండదు.
POST <YOUR_ENDPOINT>
Content-Type: application/json
X-EC-Signature: t=1793448001,v1=<HEX_HMAC_SHA256>
{
"platform": "instagram",
"account_id": "<ACCOUNT_ID>",
"external_id": "<IG_ID>",
"entry": {
"id": "<IG_ID>",
"time": 1793448000,
"changes": [
{
"field": "comments",
"value": {
"id": "<COMMENT_ID>",
"text": "<COMMENT_TEXT>",
"from": { "id": "<INSTAGRAM_SCOPED_ID>", "username": "<USERNAME>" },
"media": { "id": "<MEDIA_ID>", "media_product_type": "FEED" }
}
}
]
}
}అదే ఈవెంట్పై కామెంట్-టు-DM రూల్స్ ఏమి చేస్తాయి?
అవి ఫార్వర్డ్తో పాటు దాన్ని చదువుతాయి. కామెంట్లో రూల్ యొక్క కీవర్డ్లలో ఒకటి ఉంటే (అక్షరాల పెద్ద చిన్న తేడా లేకుండా), ఒక ఎంచుకున్న పోస్ట్పై లేదా అన్నింటిపై, అది రూల్ యొక్క DM ను రచయితకు ప్రైవేట్ రిప్లైగా పంపుతుంది; రూల్కు పబ్లిక్ రిప్లై ఉంటే అదీ కలిపి. ఖాతా స్వయంగా చేసిన కామెంట్లు దాటవేయబడతాయి; కామెంట్పై ప్రారంభమయ్యే ఆటోమేషన్లు, ఏ రూల్ రిప్లై ఇవ్వని కామెంట్లను తీసుకుంటాయి, మరియు రూల్ రిప్లై ఇచ్చిన కామెంట్ కూడా మీ ఎండ్పాయింట్కు చేరుతుంది. రూల్ యొక్క పబ్లిక్ రిప్లై ఖాతా నుండే కొత్త comments ఈవెంట్గా తిరిగి రావచ్చు.
సాధారణ పొరపాట్లు
- comment_id కోసం వెతకడం. Instagram Login కింద కామెంట్ ID value.id లో ఉంటుంది; comment_id అనేది Meta యొక్క ఇతర లాగిన్ సెటప్ల పేలోడ్లకు చెందుతుంది.
- ఖాతా యొక్క సొంత కామెంట్లకు రిప్లై ఇవ్వడం. వాటి రిప్లైలు from.id = entry.id తో comments ఈవెంట్లుగా తిరిగి వస్తాయి, మరియు వాటికి రిప్లై ఇచ్చే ఆటోమేషన్ తనతోనే మాట్లాడుకుంటూ ముగుస్తుంది.
- entry.time ను కామెంట్ సమయంగా చదవడం. అది Meta నోటిఫికేషన్ పంపిన సమయాన్ని నమోదు చేస్తుంది; కామెంట్ రాసిన సమయాన్ని దాని స్వంత timestamp ఫీల్డ్ చెబుతుంది.
- comments ఫీల్డ్పై లైవ్ కామెంట్ల కోసం వేచి ఉండటం. అవి live_comments పై వస్తాయి, దానికి దాని స్వంత సబ్స్క్రిప్షన్ కావాలి, మరియు ప్రసారం ముగిసినప్పుడు నిశ్శబ్దమైపోతుంది.
కామెంట్-టు-DM రూల్స్ మరియు ఆటోమేషన్లు అదే కామెంట్లకు 24 గంటలూ రిప్లై ఇస్తాయి. కనెక్షన్కు నెలకు US$ 9 నుండి US$ 0.75 వరకు, మీరు కనెక్షన్లు జోడించేకొద్దీ తగ్గుతుంది, మొదటి 3 రోజులు ఉచితం.
తరచుగా అడిగే ప్రశ్నలు
Instagram కామెంట్స్ వెబ్హుక్ కామెంట్లకు రిప్లైలను కూడా చేరుస్తుందా?
అవును. రిప్లై తనదైన comments ఈవెంట్గా వస్తుంది, దానిలో అది రిప్లై చేస్తున్న కామెంట్ ID తో parent_id ఉంటుంది.
రీల్స్ కామెంట్లు Instagram కామెంట్స్ వెబ్హుక్ను ట్రిగ్గర్ చేస్తాయా?
అవును. రీల్పై కామెంట్ పోస్ట్పై ఉన్నట్లే comments ఫీల్డ్లో వస్తుంది; media.media_product_type రెండింటినీ వేరు చేసి చెబుతుంది.
నా Instagram కామెంట్స్ వెబ్హుక్ ఎందుకు ట్రిగ్గర్ కావడం లేదు?
చాలావరకు యాప్ లైవ్ మోడ్లో లేకపోవడం లేదా Advanced Access లేకపోవడం, ఖాతా /subscribed_apps ద్వారా ఎప్పుడూ సబ్స్క్రైబ్ కాకపోవడం, మీడియా ప్రైవేట్ ఖాతాకు చెందడం, లేదా కామెంట్ లైవ్ ప్రసారంపై ఉండటం (అది live_comments ఉపయోగిస్తుంది) వల్ల.
కామెంట్స్ వెబ్హుక్ కామెంట్ చేసిన వ్యక్తి యూజర్నేమ్ను చేరుస్తుందా?
అవును. value.from లో వ్యక్తి యూజర్నేమ్ వారి Instagram-scoped ID పక్కన ఉంటుంది, కాబట్టి ఎవరు కామెంట్ చేశారో చూపడానికి అదనపు కాల్ అవసరం లేదు.
చదవడం కొనసాగించండి
మీ మొదటి ఛానెల్ను రెండు నిమిషాల్లో కనెక్ట్ చేయండి.
ప్లాట్ఫామ్ సమీక్షల కోసం ఎదురుచూడాల్సిన అవసరం లేదు. WhatsApp, Instagram, TikTok లేదా మరో ఛానెల్ను కనెక్ట్ చేయండి, ఆపై పోస్ట్ చేయమని, ప్రత్యుత్తరం ఇవ్వమని లేదా రిపోర్ట్ ఇవ్వమని మీ AIకి చెప్పండి, అది పని చేయడం చూడండి.
- 3 రోజులు ఉచితం
- ఎప్పుడైనా రద్దు చేయండి
- అధికారిక APIలు మాత్రమే
- 24/7 పర్యవేక్షణ
ధృవీకరించిన తేదీ