Instagram వెబ్హుక్ ఈవెంట్లు: కామెంట్లు, మెన్షన్లు మరియు DMలు
Instagram వెబ్హుక్ ఈవెంట్లు ప్రొఫెషనల్ ఖాతాపై జరిగే కార్యకలాపాలను అప్పటికప్పుడు నివేదిస్తాయి: కొత్త కామెంట్లు, @మెన్షన్లు మరియు DMలు. Meta ప్రతిదాన్ని JSON రూపంలో కనెక్ట్ చేసిన యాప్ యొక్క HTTPS ఎండ్పాయింట్కు POST చేస్తుంది, మరియు విఫలమైన డెలివరీని ఆ ఎండ్పాయింట్కు 36 గంటల వరకు మళ్లీ ప్రయత్నిస్తుంది. easyCoexistence ప్రతి ఈవెంట్ను ఖాతా వారీగా సంతకం చేసి, మీ ఎండ్పాయింట్కు ఒకసారి మాత్రమే పంపుతుంది, మళ్లీ ప్రయత్నాలు లేకుండా. Instagram Login ద్వారా మెన్షన్లు కామెంట్ల నోటిఫికేషన్లోనే వస్తాయి.
విఫలమైన డెలివరీని యాప్ ఎండ్పాయింట్కు Meta ఎంతసేపు మళ్లీ ప్రయత్నిస్తూ ఉంటుంది, ఆ తర్వాత దాన్ని వదిలేస్తుంది.
చాలా అప్డేట్లను Meta ఒకే వెబ్హుక్ డెలివరీగా కలుపుతుంది, అయితే కలపడానికి హామీ ఇవ్వదు.
ఖాతా స్వయంగా పంపిన మెసేజ్ ఈవెంట్లపై Meta సెట్ చేసే ఫ్లాగ్.
పబ్లిక్ ఖాతాల మీడియాపై మాత్రమే కామెంట్ మరియు మెన్షన్ నోటిఫికేషన్లు ట్రిగ్గర్ అవుతాయి.
ఏ ఈవెంట్లు ఉన్నాయి?
Instagram Login తో కనెక్ట్ అయిన ప్రొఫెషనల్ ఖాతా కోసం మూడు రకాల కార్యకలాపాలు ఈవెంట్లుగా వస్తాయి:
- కామెంట్లు: ఖాతా మీడియాపై కొత్త కామెంట్, దాని కామెంట్ ID, రచయిత యొక్క Instagram-స్కోప్డ్ ID మరియు యూజర్నేమ్, టెక్స్ట్, అలాగే మీడియా ID మరియు రకం.
- మెన్షన్లు: Instagram Login తో అవి సొంత ఫీల్డ్గా కాకుండా కామెంట్ల నోటిఫికేషన్ లోపల వస్తాయి.
- మెసేజ్లు: ఖాతాకు వచ్చిన DM, దానిలో పంపినవారు, గ్రహీత, టైమ్స్టాంప్ మరియు మెసేజ్ స్వయంగా, అంటే టెక్స్ట్, జోడింపులు మరియు స్టోరీ ప్రత్యుత్తరాలు.
ఈవెంట్లు మీ ఎండ్పాయింట్కు ఎలా చేరతాయి?
Meta Instagram వెబ్హుక్లను ఖాతా కనెక్ట్ చేసిన యాప్కు పంపుతుంది. easyCoexistence వాటిని స్వీకరించి ప్రతి ఈవెంట్ను అది వచ్చిన వెంటనే, ఆ ఖాతాకు ప్రత్యేకమైన రహస్య కీతో సంతకం చేసి, ఆ ఖాతా కోసం మీరు సెట్ చేసిన HTTPS ఎండ్పాయింట్కు పంపుతుంది.
Claude లేదా ChatGPT నుండి set_social_webhook_destination తో, లేదా PUT /channels/:id/webhook ద్వారా Partner API తో ఎండ్పాయింట్ను సెట్ చేయండి. సంతకం కీ ఒక్కసారే చూపబడుతుంది, ఎండ్పాయింట్ను మళ్లీ సెట్ చేస్తే కొత్త కీ జారీ అవుతుంది, URLగా null ఇస్తే ఫార్వర్డింగ్ ఆగిపోతుంది.
డెలివరీ ఎలా కనిపిస్తుంది?
JSON బాడీతో కూడిన POST, అందులో ప్లాట్ఫామ్, list_social_accounts ఇచ్చే కనెక్షన్ account_id, Instagram ఖాతా యొక్క external_id, మరియు entry: Meta ఈవెంట్ కోసం పంపే వెబ్హుక్ entry, మార్పు లేకుండా. DM కూడా అదే విధంగా వస్తుంది, changes కు బదులుగా messaging అర్రే ఉంటుంది. కొత్త కామెంట్ ఇలా ఉంటుంది:
{
"platform": "instagram",
"account_id": "<ACCOUNT_ID>",
"external_id": "<INSTAGRAM_ACCOUNT_ID>",
"entry": {
"id": "<INSTAGRAM_ACCOUNT_ID>",
"time": 1793318400,
"changes": [
{
"field": "comments",
"value": {
"id": "<COMMENT_ID>",
"from": { "id": "<INSTAGRAM_SCOPED_ID>", "username": "<USERNAME>" },
"text": "<COMMENT_TEXT>",
"media": { "id": "<MEDIA_ID>", "media_product_type": "<MEDIA_PRODUCT_TYPE>" }
}
}
]
}
}డెలివరీని ఎలా ధృవీకరిస్తారు?
ప్రతి డెలివరీలో X-EC-Signature హెడర్ ఉంటుంది, రూపం t=<unix>,v1=<hex>. ఇక్కడ v1 అనేది టైమ్స్టాంప్, డాట్ మరియు రా రిక్వెస్ట్ బాడీ యొక్క HMAC-SHA256, ఖాతా సంతకం కీతో. అందుకున్నట్లే రా బాడీపై దాన్ని లెక్కించండి, స్థిర సమయంలో పోల్చండి, మరియు 5 నిమిషాల కంటే పాతదైన టైమ్స్టాంప్ను తిరస్కరించండి.
import crypto from "node:crypto";
// rawBody: the request body exactly as received, as a string
export function verify(rawBody, header, secret) {
const sig = Object.fromEntries(header.split(",").map((part) => part.split("=")));
if (!sig.t || !sig.v1) return false;
if (Math.abs(Date.now() / 1000 - Number(sig.t)) > 300) return false;
const expected = crypto
.createHmac("sha256", secret)
.update(sig.t + "." + rawBody)
.digest("hex");
return expected.length === sig.v1.length &&
crypto.timingSafeEqual(Buffer.from(expected), Buffer.from(sig.v1));
}డెలివరీని మళ్లీ ప్రయత్నిస్తారా?
easyCoexistence ద్వారా కాదు: ఫార్వర్డింగ్ ప్రతి ఈవెంట్ను ఒక్కసారి, మెమరీలో పంపుతుంది, మళ్లీ ప్రయత్నించడానికి ఎలాంటి కాపీ ఉంచదు. వెంటనే 2xxతో జవాబు ఇచ్చి పనిని తర్వాత చేయండి, వచ్చినప్పుడే అవసరమైనదాన్ని స్టోర్ చేయండి, ఎందుకంటే గత నోటిఫికేషన్ల చరిత్రను Meta కూడా ప్రశ్నించగలిగేలా ఉంచదు.
విఫలమైన డెలివరీని Meta స్వయంగా 36 గంటల వరకు మళ్లీ ప్రయత్నిస్తుంది, కాబట్టి అదే ఈవెంట్ అప్పుడప్పుడు రెండుసార్లు రావచ్చు: కామెంట్ ID లేదా మెసేజ్ mid ఆధారంగా డూప్లికేట్లను తొలగించండి.
హ్యాండ్లర్ ఇంకా ఏమి తనిఖీ చేయాలి?
మొదటి హ్యాండ్లర్ను ఇబ్బంది పెట్టే Meta పేలోడ్లలోని కొన్ని వివరాలు:
is_echo:is_echotrue అయిన మెసేజ్ ఈవెంట్ను ఖాతాయే పంపింది, దానికి జవాబు అవసరం లేదు.- స్టోరీ ప్రత్యుత్తరాలు: స్టోరీకి సమాధానమిచ్చే DMలో స్టోరీ ID మరియు URLతో
reply_toఉంటుంది. - స్టోరీ మెన్షన్లు: attachment type
story_mentionగల మెసేజ్గా వస్తాయి. - time: Meta నోటిఫికేషన్ పంపిన సమయం, కామెంట్ లేదా మెసేజ్ చేసిన సమయం కాదు. మెసేజ్ యొక్క సొంత టైమ్స్టాంప్ దాని messaging ఎంట్రీలో ఉంటుంది.
- ఆల్బమ్ IDలు: కామెంట్ ఈవెంట్లలో అవి ఉండవు; కామెంట్ ID తో ఆల్బమ్ను వెతకండి.
సాధారణ పొరపాట్లు
- జవాబు ఇవ్వకముందే పని చేయడం. ఫార్వర్డింగ్ మళ్లీ ప్రయత్నించదు, కాబట్టి వెంటనే 2xx ఇచ్చి ఈవెంట్ను తర్వాత ప్రాసెస్ చేయండి.
- పార్స్ చేసిన JSON పై సంతకాన్ని ధృవీకరించడం. HMACను అందిన రా బాడీ పైనే సరిగ్గా లెక్కించండి.
- ఎకోలకు జవాబివ్వడం. is_echo సెట్ అయిన మెసేజ్ ఖాతా పంపినది, దానికి జవాబిస్తే లూప్ మొదలవుతుంది.
- డూప్లికేట్ తొలగింపును వదిలేయడం. విఫలం తర్వాత Meta అదే ఈవెంట్ను మళ్లీ పంపవచ్చు, కాబట్టి కామెంట్ ID లేదా మెసేజ్ mid పై ఆధారపడండి.
easyCoexistence Instagram ఖాతా కామెంట్లు, మెన్షన్లు మరియు DMలను అవి వచ్చిన వెంటనే మీ HTTPS ఎండ్పాయింట్కు ఫార్వర్డ్ చేస్తుంది, ఆ ఖాతాకు ప్రత్యేకమైన రహస్య కీతో సంతకం చేసి, మార్గంలో ఎలాంటి కాపీ ఉంచకుండా. Claude లేదా ChatGPT నుండి set_social_webhook_destination తో, లేదా Partner API తో దీన్ని ఆన్ చేయండి. నెలకు ఒక్కో కనెక్షన్కు US$ 9 నుండి US$ 0.75 వరకు, కనెక్షన్లు పెరిగేకొద్దీ తగ్గుతుంది, మొదటి 3 రోజులు ఉచితం.
తరచుగా అడిగే ప్రశ్నలు
Instagram వెబ్హుక్ టైమ్ ఫీల్డ్ అర్థం ఏమిటి?
Meta నోటిఫికేషన్ పంపిన సమయం, కామెంట్ లేదా మెసేజ్ చేసిన సమయం కాదు. DM యొక్క సొంత టైమ్స్టాంప్ దాని messaging ఎంట్రీలో ఉంటుంది.
విఫలమైన Instagram వెబ్హుక్ డెలివరీలను Meta మళ్లీ ప్రయత్నిస్తుందా?
అవును. విఫలమైన డెలివరీని Meta యాప్కు 36 గంటల వరకు మళ్లీ ప్రయత్నిస్తుంది, కాబట్టి అదే ఈవెంట్ అప్పుడప్పుడు రెండుసార్లు రావచ్చు: కామెంట్ ID లేదా మెసేజ్ mid ఆధారంగా డూప్లికేట్లను తొలగించండి. easyCoexistence ప్రతి ఈవెంట్ను మీ ఎండ్పాయింట్కు ఒక్కసారి మాత్రమే పంపుతుంది, కాబట్టి వెంటనే 2xxతో జవాబివ్వండి.
ఒక Instagram వెబ్హుక్ డెలివరీలో ఎన్ని అప్డేట్లు ఉండగలవు?
Meta బ్యాచ్ చేసినప్పుడు 1,000 వరకు, అయితే బ్యాచింగ్కు Meta హామీ ఇవ్వదు. మొదటి అంశాన్ని మాత్రమే చదవకుండా మొత్తం entry అర్రేపై లూప్ చేయండి.
మెన్షన్లకు ప్రత్యేక ఈవెంట్ ఉందా?
Instagram Login తో లేదు. Meta మెన్షన్లను కామెంట్ నోటిఫికేషన్లో చేరుస్తుంది, కాబట్టి అవి కామెంట్ల అదే మార్గంలో వస్తాయి.
చదవడం కొనసాగించండి
మీ మొదటి ఛానెల్ను రెండు నిమిషాల్లో కనెక్ట్ చేయండి.
ప్లాట్ఫామ్ సమీక్షల కోసం ఎదురుచూడాల్సిన అవసరం లేదు. WhatsApp, Instagram, TikTok లేదా మరో ఛానెల్ను కనెక్ట్ చేయండి, ఆపై పోస్ట్ చేయమని, ప్రత్యుత్తరం ఇవ్వమని లేదా రిపోర్ట్ ఇవ్వమని మీ AIకి చెప్పండి, అది పని చేయడం చూడండి.
- 3 రోజులు ఉచితం
- ఎప్పుడైనా రద్దు చేయండి
- అధికారిక APIలు మాత్రమే
- 24/7 పర్యవేక్షణ
ధృవీకరించిన తేదీ