లాగిన్ చేయండిఉచిత ట్రయల్ ప్రారంభించండి
easyCoexistence అధికారిక APIలు

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 తో మరియు ఖాతాకు ఒక సీక్రెట్‌తో సంతకం చేసి ఫార్వార్డ్ చేస్తుంది, ప్రతి కనెక్షన్‌ను రోజంతా పర్యవేక్షిస్తూ.

subscribe

Meta యొక్క ధృవీకరణ అభ్యర్థనలో hub.mode విలువ ఎల్లప్పుడూ ఉంటుంది.

36 hours

విఫలమైన నోటిఫికేషన్‌ను Meta తగ్గుతున్న వేగంతో తిరిగి ప్రయత్నించే కాలవ్యవధి, ఆ తర్వాత దాన్ని వదిలేస్తుంది.

15 minutes

డెవలపర్ ఖాతాకు Meta హెచ్చరిక పంపే ముందు, విఫలమైన మెసేజింగ్ డెలివరీల సంఖ్య.

1 hour

వెబ్‌హుక్ డిసేబుల్ హెచ్చరిక మరియు యాప్ అన్‌సబ్‌స్క్రైబ్ అయ్యే ముందు, విఫలమవుతున్న మెసేజింగ్ డెలివరీల సంఖ్య.

Live

యాప్ తన వినియోగదారుల ఖాతాల నోటిఫికేషన్‌లను అందుకోవడానికి ముందు Meta కోరే యాప్ మోడ్.

Instagram వెబ్‌హుక్‌లను సెటప్ చేయడం ఎలా పనిచేస్తుంది?

Meta గైడ్ ఇచ్చే క్రమంలో నాలుగు దశల్లో. ఏ ఫీల్డ్‌నైనా ఎంచుకోవడానికి ముందు ఎండ్‌పాయింట్ ధృవీకరణలో పాస్ కావాలి. యాప్ వినియోగదారుల ఖాతాల నోటిఫికేషన్‌లు అందుకోవాలంటే Live లో ఉండాలి, ప్రొడక్షన్ యాక్సెస్ కోసం వ్యాపార ధృవీకరణ తప్పనిసరి.

1EndpointAn HTTPS URL with a valid certificate answers the verification GET
2App fieldsCallback URL, verify token and fields set in the App Dashboard
3Each accountPOST /<IG_ID>/subscribed_apps turns its notifications on
4TestA dashboard test, then a real event, reach the endpoint

ధృవీకరణ అభ్యర్థనలో ఏముంటుంది?

కాల్‌బ్యాక్ 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 గా వస్తాయి.
The verification request and its answer
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 ను హాష్ చేస్తే వేరే ఫలితం వస్తుంది.

Node.js: answering verification and checking X-Hub-Signature-256
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 గా తిరిగి ఇస్తుంది.

Subscribing one account to comments and messages
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 వెబ్‌హుక్‌ల నుండి అన్‌సబ్‌స్క్రైబ్ అవుతుంది మరియు దాని ఎండ్‌పాయింట్ మరియు సీక్రెట్ తొలగిపోతాయి.
Python: checking X-EC-Signature
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 మెసేజింగ్ వెబ్‌హుక్‌లను డిసేబుల్ చేసి, యాప్‌ను ఖాతా నుండి అన్‌సబ్‌స్క్రైబ్ చేస్తుంది, దాన్ని మళ్లీ సబ్‌స్క్రైబ్ చేయాలి.
EasyCoexistenceతో దీన్ని చేయడం

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 ట్రబుల్‌షూటింగ్ చెక్‌లిస్ట్‌లో మొదటి అంశం.

చదవడం కొనసాగించండి

Instagram కామెంట్స్ వెబ్‌హుక్: పేలోడ్, ఒక్కో ఫీల్డ్ వివరంగాఎవరైనా ఖాతా పోస్ట్‌లు, రీల్స్‌పై కామెంట్ చేసినప్పుడు Instagram కామెంట్స్ వెబ్‌హుక్ పంపే పేలోడ్: ప్రతి ఫీల్డ్ వివరంగా, అందులో లేనివి, పొరపాట్లు.Instagram మెసేజ్ వెబ్‌హుక్: DM పేలోడ్, ఎకోలు మరియు ఫీల్డ్‌లుDM కోసం Instagram వెబ్‌హుక్ ఏమి పంపుతుంది: పంపినవారి ID, టెక్స్ట్, జోడింపులు, స్టోరీ రిప్లైలు, ఎకోలు, 24 గంటల విండో.Instagram వెబ్‌హుక్ ఈవెంట్‌లు: కామెంట్లు, మెన్షన్లు మరియు DMలుInstagram కామెంట్లు, మెన్షన్లు, DMలు వెబ్‌హుక్ ఈవెంట్లుగా మీ ఎండ్‌పాయింట్‌కు చేరే విధానం: పేలోడ్, సంతకం, తనిఖీలు.API ద్వారా Instagram DMలు మరియు 24 గంటల విండోAPI ద్వారా Instagram DMలు ఎలా పనిచేస్తాయి: ఎవరికి మెసేజ్ పంపవచ్చు, 24 గంటల విండో, ప్రైవేట్ రిప్లైలు, మరియు Allow access to messages సెట్టింగ్.Instagram API ద్వారా కామెంట్ మోడరేషన్Instagram API కామెంట్లను చదవడం, రిప్లై, హైడ్, డిలీట్: పబ్లిక్ రిప్లైలు, కామెంట్‌కు 7 రోజుల్లో ఒక ప్రైవేట్ రిప్లై, నియమాలు.

మీ మొదటి ఛానెల్‌ను రెండు నిమిషాల్లో కనెక్ట్ చేయండి.

ప్లాట్‌ఫామ్ సమీక్షల కోసం ఎదురుచూడాల్సిన అవసరం లేదు. WhatsApp, Instagram, TikTok లేదా మరో ఛానెల్‌ను కనెక్ట్ చేయండి, ఆపై పోస్ట్ చేయమని, ప్రత్యుత్తరం ఇవ్వమని లేదా రిపోర్ట్ ఇవ్వమని మీ AIకి చెప్పండి, అది పని చేయడం చూడండి.

  • 3 రోజులు ఉచితం
  • ఎప్పుడైనా రద్దు చేయండి
  • అధికారిక APIలు మాత్రమే
  • 24/7 పర్యవేక్షణ

ధృవీకరించిన తేదీ