Instagram వెబ్హుక్ ధృవీకరణ: hub.challenge మరియు X-Hub-Signature-256
Instagram వెబ్హుక్లను సెటప్ చేయడానికి, Meta యొక్క ధృవీకరణ GET అభ్యర్థనకు జవాబిచ్చే HTTPS ఎండ్పాయింట్ కావాలి. ఆ అభ్యర్థనలో hub.mode విలువ subscribe గా, hub.verify_token మరియు hub.challenge ఉంటాయి. టోకెన్ను తనిఖీ చేసి challenge ను తిరిగి ఇవ్వాలి. ఆ తర్వాత యాప్ ఫీల్డ్లకు సబ్స్క్రైబ్ అయి, ప్రతి ఖాతా subscribed_apps edge ద్వారా సబ్స్క్రైబ్ అయినప్పుడు, Meta యాప్ సీక్రెట్తో X-Hub-Signature-256 లో సంతకం చేసిన JSON ఈవెంట్లను POST చేస్తుంది.
easyCoexistence Meta వైపు భాగాన్ని నిర్వహిస్తుంది: దాని యాప్ ధృవీకరణలో పాస్ అవుతుంది, X-Hub-Signature-256 ను తనిఖీ చేస్తుంది, కనెక్ట్ అయిన ప్రతి Instagram ఖాతాను comments, messages మరియు mentions కు సబ్స్క్రైబ్ చేస్తుంది, ఈవెంట్లను మీ HTTPS ఎండ్పాయింట్కు X-EC-Signature తో మరియు ఖాతాకు ఒక సీక్రెట్తో సంతకం చేసి ఫార్వార్డ్ చేస్తుంది, ప్రతి కనెక్షన్ను రోజంతా పర్యవేక్షిస్తూ.
Meta యొక్క ధృవీకరణ అభ్యర్థనలో hub.mode విలువ ఎల్లప్పుడూ ఉంటుంది.
విఫలమైన నోటిఫికేషన్ను Meta తగ్గుతున్న వేగంతో తిరిగి ప్రయత్నించే కాలవ్యవధి, ఆ తర్వాత దాన్ని వదిలేస్తుంది.
డెవలపర్ ఖాతాకు Meta హెచ్చరిక పంపే ముందు, విఫలమైన మెసేజింగ్ డెలివరీల సంఖ్య.
వెబ్హుక్ డిసేబుల్ హెచ్చరిక మరియు యాప్ అన్సబ్స్క్రైబ్ అయ్యే ముందు, విఫలమవుతున్న మెసేజింగ్ డెలివరీల సంఖ్య.
యాప్ తన వినియోగదారుల ఖాతాల నోటిఫికేషన్లను అందుకోవడానికి ముందు Meta కోరే యాప్ మోడ్.
Instagram వెబ్హుక్లను సెటప్ చేయడం ఎలా పనిచేస్తుంది?
Meta గైడ్ ఇచ్చే క్రమంలో నాలుగు దశల్లో. ఏ ఫీల్డ్నైనా ఎంచుకోవడానికి ముందు ఎండ్పాయింట్ ధృవీకరణలో పాస్ కావాలి. యాప్ వినియోగదారుల ఖాతాల నోటిఫికేషన్లు అందుకోవాలంటే Live లో ఉండాలి, ప్రొడక్షన్ యాక్సెస్ కోసం వ్యాపార ధృవీకరణ తప్పనిసరి.
ధృవీకరణ అభ్యర్థనలో ఏముంటుంది?
కాల్బ్యాక్ URLకు GET అభ్యర్థన, యాప్ డాష్బోర్డ్లో వెబ్హుక్ ఉత్పత్తి కాన్ఫిగర్ చేసినప్పుడల్లా పంపబడుతుంది. hub.verify_token ఎండ్పాయింట్ సొంత టోకెన్తో సరిపోలితే, ప్రతిస్పందన మొత్తం బాడీగా hub.challenge విలువతో 200 అవుతుంది; లేకపోతే 403. ఎండ్పాయింట్ పాస్ అయిందో లేదో డాష్బోర్డ్ చూపిస్తుంది.
- hub.mode: ఎల్లప్పుడూ subscribe.
- hub.challenge: Meta రూపొందించే ఒక పూర్ణాంకం, ఎండ్పాయింట్ తిరిగి పంపాలి.
- hub.
verify_token: డాష్బోర్డ్లోని ధృవీకరణ టోకెన్ ఫీల్డ్లో నమోదు చేసిన స్ట్రింగ్, ఇది Meta మరియు ఎండ్పాయింట్కు మాత్రమే తెలియాలి. - PHP లో, ఈ పేర్లలోని చుక్కలు అండర్స్కోర్లుగా మారతాయి, కాబట్టి విలువలు
hub_mode,hub_challengeమరియుhub_verify_tokenగా వస్తాయి.
GET https://<YOUR_HOST>/webhooks/instagram
?hub.mode=subscribe
&hub.challenge=1158201444
&hub.verify_token=<YOUR_VERIFY_TOKEN>
HTTP/1.1 200 OK
Content-Type: text/plain
1158201444కాల్బ్యాక్ మరియు ఫీల్డ్లు ఎక్కడ సెట్ చేస్తారు?
యాప్ డాష్బోర్డ్లో, Instagram కింద, API setup with Instagram login, Configure వెబ్హుక్లు లో: కాల్బ్యాక్ URL మరియు verify_token అక్కడ ఇవ్వాలి; సేవ్ చేయగానే ధృవీకరణ అభ్యర్థన పంపబడుతుంది. Instagram ఉత్పత్తి comments, live_comments, message_reactions, messages, messaging_optins, messaging_postbacks, messaging_referral మరియు messaging_seen కు సబ్స్క్రైబ్ అయి ప్రారంభమవుతుంది, మరియు Manage లో వాటిలో ఏదైనా నుండి అన్సబ్స్క్రైబ్ చేయవచ్చు. Test బటన్ ఎంచుకున్న ఫీల్డ్ కోసం నమూనా నోటిఫికేషన్ పంపుతుంది.
X-Hub-Signature-256 ఎలా తనిఖీ చేస్తారు?
Meta ప్రతి ఈవెంట్ నోటిఫికేషన్ను యాప్ సీక్రెట్ను కీగా ఉపయోగించి పేలోడ్ యొక్క HMAC-SHA256 తో సంతకం చేసి, sha256= తర్వాత hex digest గా X-Hub-Signature-256 లో పంపుతుంది. స్వీకరించే వైపు raw అభ్యర్థన బాడీపై అదే HMAC లెక్కించి, స్థిర సమయంలో దాన్ని హెడర్తో పోలుస్తుంది. Meta మెసేజింగ్ గైడ్ చెబుతున్నట్లు, సంతకం Unicode escape చేసిన పేలోడ్పై ఉంటుంది; కాబట్టి డీకోడ్ చేసిన లేదా మళ్లీ సీరియలైజ్ చేసిన JSON ను హాష్ చేస్తే వేరే ఫలితం వస్తుంది.
import crypto from "node:crypto";
import express from "express";
const app = express();
const { VERIFY_TOKEN, APP_SECRET } = process.env;
// Verification request: send hub.challenge back when the token matches
app.get("/webhooks/instagram", (req, res) => {
const ok = req.query["hub.mode"] === "subscribe" &&
req.query["hub.verify_token"] === VERIFY_TOKEN;
if (!ok) return res.sendStatus(403);
res.status(200).type("text/plain").send(req.query["hub.challenge"]);
});
// Event notification: check the signature over the raw bytes
app.post("/webhooks/instagram", express.raw({ type: "application/json" }), (req, res) => {
const expected = Buffer.from(
"sha256=" + crypto.createHmac("sha256", APP_SECRET).update(req.body).digest("hex")
);
const given = Buffer.from(req.get("X-Hub-Signature-256") ?? "");
if (given.length !== expected.length || !crypto.timingSafeEqual(given, expected)) {
return res.sendStatus(401);
}
res.sendStatus(200); // answer first, work after
const body = JSON.parse(req.body.toString("utf8"));
// hand body.entry to a queue or background job
});
app.listen(3000);యాప్ సీక్రెట్ మాత్రమే ఎందుకు తనిఖీ చేయగలదు?
ఎందుకంటే సంతకం ఆ సీక్రెట్ను కీగా ఉపయోగించిన HMAC. అది లేకుండా ఎవరూ ఆశించిన విలువను లెక్కించలేరు, పేలోడ్ కాపీ ఉన్నవారు కూడా దాన్ని నకిలీ చేయలేరు; కాబట్టి ఈ తనిఖీ యాప్ కోసం Meta అభ్యర్థనలు అందుకునే సర్వర్పైనే ఉండాలి. యాప్ సీక్రెట్లు, యాక్సెస్ టోకెన్లు మరియు క్లయింట్ క్రెడెన్షియల్స్ లాగ్లు మరియు సపోర్ట్ అభ్యర్థనలలోకి రాకూడదని Meta కోరుతుంది. మరొక యాప్ పంపిన ఈవెంట్లను స్వీకరించే సిస్టమ్ Meta సంతకాన్ని అసలు తనిఖీ చేయలేదు; బదులుగా ఆ యాప్ సొంత సంతకంపై ఆధారపడుతుంది.
ప్రతి ఖాతాకు ప్రత్యేక సబ్స్క్రిప్షన్ ఎందుకు అవసరం?
ఎందుకంటే యాప్ డాష్బోర్డ్ యాప్ ఏమి అందుకోగలదో నిర్ణయిస్తుంది, అయితే ఒక ఖాతా కూడా సబ్స్క్రైబ్ అయితేనే ఆ ఖాతాకు నోటిఫికేషన్లు మొదలవుతాయి. ఆ ఖాతా యొక్క Instagram User యాక్సెస్ టోకెన్తో, graph.instagram.com కు POST /<IG_ID>/subscribed_apps పంపండి; subscribed_fields లో యాప్ కోసం ఎంచుకున్న ఫీల్డ్లను కామాలతో వేరు చేసి ఇవ్వండి. విజయవంతమైన కాల్ success ను true గా తిరిగి ఇస్తుంది.
POST https://graph.instagram.com/<IG_ID>/subscribed_apps
?subscribed_fields=comments,messages
&access_token=<INSTAGRAM_USER_ACCESS_TOKEN>
{ "success": true }డెలివరీలు విఫలమైతే Meta ఏమి చేస్తుంది?
అది మళ్లీ ప్రయత్నిస్తుంది, తర్వాత వదిలేస్తుంది. Meta గైడ్ ప్రతి నోటిఫికేషన్కు 200 OK ను అడుగుతుంది, మరియు 1,000 అప్డేట్ల వరకు బ్యాచింగ్ హామీ ఇవ్వబడదని హెచ్చరిస్తుంది. విఫలమైన అప్డేట్ను వెంటనే మళ్లీ ప్రయత్నిస్తారు, తర్వాత 36 గంటల వ్యవధిలో తగ్గుతున్న తరచుదనంతో మరికొన్ని సార్లు, ఆ తర్వాత వదిలేస్తారు; కాబట్టి అదే ఈవెంట్ రెండుసార్లు రావచ్చు. మెసేజింగ్ ఈవెంట్లు Meta యొక్క మెసేజింగ్ డెలివరీ నియమాలను అనుసరిస్తాయి, అవి వేగంగా పనిచేస్తాయి:
- 200 OK 5 సెకన్లలో ఆశించబడుతుంది, విఫలమైన డెలివరీకి కొన్ని తక్షణ రీట్రైలు వస్తాయి, కాబట్టి message mid ఆధారంగా డూప్లికేట్లను తొలగించండి.
- 15 నిమిషాల వైఫల్యాల తర్వాత, డెవలపర్ ఖాతాకు హెచ్చరిక వెళ్తుంది.
- ఒక గంట వైఫల్యాల తర్వాత, వెబ్హుక్ డిసేబుల్ హెచ్చరిక వస్తుంది, మరియు యాప్ మళ్లీ సబ్స్క్రైబ్ అయ్యే వరకు ఖాతా యొక్క వెబ్హుక్ల నుండి అన్సబ్స్క్రైబ్ చేయబడుతుంది.
- అంతరాయ సమయంలో పంపిన మెసేజ్లు క్రమం తప్పి రావచ్చు, కాబట్టి వాటిని timestamp ప్రకారం క్రమబద్ధీకరించండి.
ఏదీ రాకపోతే ఏమి తనిఖీ చేయాలి?
Meta యొక్క ట్రబుల్షూటింగ్ చెక్లిస్ట్, ఇది చాలా నిశ్శబ్ద ఎండ్పాయింట్లను కవర్ చేస్తుంది, ఈ క్రమంలో:
- కాల్బ్యాక్ URL తన తనిఖీని పాస్ అయింది మరియు చెల్లుబాటు అయ్యే సర్టిఫికెట్తో HTTPS ద్వారా చేరుకోగలదు; సెల్ఫ్-సైన్డ్ సర్టిఫికెట్లకు మద్దతు లేదు.
- యాప్ ఫీల్డ్ను ఎంచుకుంది మరియు అవసరమైన యాక్సెస్ స్థాయిని కలిగి ఉంది, comments మరియు
live_commentsకోసం Advanced Access. subscribed_appsద్వారా ఖాతాకు నోటిఫికేషన్లు ఎనేబుల్ అయ్యాయి, అదే లాగిన్ సెటప్ నుండి వచ్చిన టోకెన్తో.- ఖాతా ఆ ఫీల్డ్ నియమాలను పాటిస్తుంది: కామెంట్ నోటిఫికేషన్లకు పబ్లిక్ ఖాతా యాజమాన్యంలోని మీడియా అవసరం.
- సర్వర్ నెమ్మదైన పని మొదలుపెట్టే ముందే success ను తిరిగి ఇస్తుంది.
easyCoexistence ఫార్వార్డ్ చేసిన ఈవెంట్లను మళ్లీ ఎందుకు సంతకం చేస్తుంది?
ఎందుకంటే Meta యొక్క సంతకం ప్రయాణించలేదు. easyCoexistence యాప్ Meta డెలివరీని అందుకుంటుంది, తన సొంత యాప్ సీక్రెట్తో X-Hub-Signature-256 ను తనిఖీ చేస్తుంది, వెంటనే Meta కు జవాబిస్తుంది, మరియు కనెక్ట్ అయిన ఖాతా కోసం ప్రతి entry ను ఆ ఖాతాకు సెట్ చేసిన ఎండ్పాయింట్కు POST చేస్తుంది, platform, account_id, external_id మరియు entry తో కూడిన కొత్త బాడీలో. Meta హెడర్ ముందుకు పంపబడదు, ఆ సీక్రెట్ లేకుండా తనిఖీ కూడా చేయలేము, కాబట్టి ప్రతి ఫార్వార్డ్లో Content-Type: application/json మరియు X-EC-Signature ఉంటాయి, అవి ఒకే ఖాతాకు చెందిన సీక్రెట్తో సంతకం చేయబడతాయి.
X-EC-Signature ను ఎలా ధృవీకరిస్తారు?
హెడర్ t=<unix>,v1=<hex> గా ఉంటుంది, ఇక్కడ v1 అనేది timestamp, ఒక చుక్క మరియు raw బాడీ యొక్క hex HMAC-SHA256, ఖాతా యొక్క సైనింగ్ సీక్రెట్ను కీగా ఉపయోగించి. అందిన బైట్లపైనే మళ్లీ లెక్కించండి, స్థిర సమయంలో పోల్చండి, మరియు 5 నిమిషాల కంటే పాత timestamp ను తిరస్కరించండి.
- సీక్రెట్ whsec_ తో మొదలవుతుంది మరియు URL సెట్ చేసినప్పుడు
set_social_webhook_destinationలేదా PUT /channels/:id/webhook ద్వారా ఒక్కసారి మాత్రమే చూపబడుతుంది. - URL ను మళ్లీ సెట్ చేస్తే కొత్త సీక్రెట్ ఇవ్వబడుతుంది, మరియు null URL ఫార్వార్డింగ్ను ఆపుతుంది.
- ప్రతి ఈవెంట్ ఒక్కసారి పంపబడుతుంది, 8 సెకన్ల వరకు వేచి ఉంటూ, రీడైరెక్ట్లను అనుసరించకుండా, పబ్లిక్ IP కు పరిష్కరించబడే HTTPS చిరునామాకు.
- కనెక్షన్ తొలగిస్తే ఖాతా Meta వెబ్హుక్ల నుండి అన్సబ్స్క్రైబ్ అవుతుంది మరియు దాని ఎండ్పాయింట్ మరియు సీక్రెట్ తొలగిపోతాయి.
import hashlib, hmac, time
def verify_ec_signature(raw_body: bytes, header: str, secret: str) -> bool:
"""Check X-EC-Signature on an event forwarded by easyCoexistence."""
parts = dict(p.split("=", 1) for p in header.split(",") if "=" in p)
t, v1 = parts.get("t", ""), parts.get("v1", "")
if not t.isdigit() or abs(time.time() - int(t)) > 300:
return False # missing, malformed or older than 5 minutes
expected = hmac.new(secret.encode(), t.encode() + b"." + raw_body, hashlib.sha256).hexdigest()
return hmac.compare_digest(expected.encode(), v1.encode())సాధారణ పొరపాట్లు
- hub.challenge విలువను JSON గా లేదా కోట్ల్లో తిరిగి ఇవ్వడం. Meta ఆశించేది 200 స్టేటస్తో, బాడీగా hub.challenge విలువే.
- పార్స్ చేసిన బాడీని హాష్ చేయడం. JSON బాడీ పార్సర్ Meta సంతకం చేసిన ఖచ్చితమైన బైట్లను పక్కన పెడుతుంది, కాబట్టి HMAC కోసం raw బాడీని ఉంచి, తర్వాత పార్స్ చేయండి.
- యాప్ను సబ్స్క్రైబ్ చేసి ఖాతాను మర్చిపోవడం. ఒక ఖాతాకు POST /<IG_ID>/subscribed_apps విజయవంతమయ్యే వరకు, దానికి నోటిఫికేషన్లు రావు.
- ఎండ్పాయింట్ ఒక గంట పాటు విఫలమవ్వనివ్వడం. Meta మెసేజింగ్ వెబ్హుక్లను డిసేబుల్ చేసి, యాప్ను ఖాతా నుండి అన్సబ్స్క్రైబ్ చేస్తుంది, దాన్ని మళ్లీ సబ్స్క్రైబ్ చేయాలి.
set_social_webhook_destination లేదా Partner API తో ఆన్ చేయండి. ప్రతి కనెక్షన్కు నెలకు US$ 9 నుండి US$ 0.75 వరకు, మీరు కనెక్షన్లు జోడించేకొద్దీ తగ్గుతూ, మొదటి 3 రోజుల ట్రయల్ ఉచితం.
తరచుగా అడిగే ప్రశ్నలు
Instagram వెబ్హుక్లలో hub.challenge అంటే ఏమిటి?
Meta తన ధృవీకరణ GET లో పంపే ఒక పూర్ణాంకం. hub.verify_token ను తనిఖీ చేసిన తర్వాత, ఎండ్పాయింట్ దాన్ని ప్రతిస్పందన బాడీగా తిరిగి ఇస్తుంది, ఇది URL పై నియంత్రణ ఉందని రుజువు చేస్తుంది.
PHP లో hub.mode మరియు hub.challenge ఎందుకు కనిపించవు?
PHP పారామీటర్ పేర్లలోని చుక్కలను అండర్స్కోర్లుగా మారుస్తుంది, కాబట్టి Meta ధృవీకరణ విలువలు hub_mode, hub_challenge మరియు hub_verify_token గా వస్తాయి.
Meta వాటిని నిలిపివేసిన తర్వాత Instagram వెబ్హుక్లను మళ్లీ ఎలా ఆన్ చేయాలి?
ఎండ్పాయింట్ను సరిచేయండి, తర్వాత అదే ఫీల్డ్లతో POST /<IG_ID>/subscribed_apps ద్వారా ఖాతాను మళ్లీ సబ్స్క్రైబ్ చేయండి.
Instagram వెబ్హుక్ ఎండ్పాయింట్ కోసం సెల్ఫ్-సైన్డ్ సర్టిఫికెట్ పనిచేస్తుందా?
లేదు, Meta సెల్ఫ్-సైన్డ్ సర్టిఫికెట్లకు మద్దతు ఇవ్వదు: కాల్బ్యాక్ URL చెల్లుబాటు అయ్యే సర్టిఫికెట్తో HTTPS ద్వారా చేరుకోగలగాలి, ఇది Meta ట్రబుల్షూటింగ్ చెక్లిస్ట్లో మొదటి అంశం.
చదవడం కొనసాగించండి
మీ మొదటి ఛానెల్ను రెండు నిమిషాల్లో కనెక్ట్ చేయండి.
ప్లాట్ఫామ్ సమీక్షల కోసం ఎదురుచూడాల్సిన అవసరం లేదు. WhatsApp, Instagram, TikTok లేదా మరో ఛానెల్ను కనెక్ట్ చేయండి, ఆపై పోస్ట్ చేయమని, ప్రత్యుత్తరం ఇవ్వమని లేదా రిపోర్ట్ ఇవ్వమని మీ AIకి చెప్పండి, అది పని చేయడం చూడండి.
- 3 రోజులు ఉచితం
- ఎప్పుడైనా రద్దు చేయండి
- అధికారిక APIలు మాత్రమే
- 24/7 పర్యవేక్షణ
ధృవీకరించిన తేదీ