Instagram வெப்ஹூக் சரிபார்ப்பு: hub.challenge மற்றும் X-Hub-Signature-256
Instagram வெப்ஹூக்குகளை அமைக்க, Meta-வின் சரிபார்ப்பு GET கோரிக்கைக்கு பதிலளிக்கும் HTTPS எண்ட்பாயிண்ட் தேவை. அந்தக் கோரிக்கையில் hub.mode subscribe என்ற மதிப்புடனும், hub.verify_token மற்றும் hub.challenge உடனும் வரும்; டோக்கனைச் சரிபார்த்து challenge-ஐத் திருப்பி அனுப்ப வேண்டும். ஆப் புலங்களுக்கு சந்தா செய்து, ஒவ்வொரு கணக்கும் subscribed_apps edge வழியாக சந்தா செய்யப்பட்ட பிறகு, ஆப்பின் secret-ஆல் X-Hub-Signature-256-இல் கையொப்பமிடப்பட்ட JSON நிகழ்வுகளை Meta POST செய்யும்.
easyCoexistence Meta பக்கத்தைக் கையாளுகிறது: அதன் ஆப் சரிபார்ப்பில் தேறுகிறது, X-Hub-Signature-256-ஐ சரிபார்க்கிறது, இணைக்கப்பட்ட ஒவ்வொரு Instagram கணக்கையும் comments, messages மற்றும் குறிப்புகளுக்கு சந்தா செய்கிறது, நிகழ்வுகளை உங்கள் HTTPS எண்ட்பாயிண்டுக்கு X-EC-Signature மற்றும் ஒவ்வொரு கணக்கிற்கும் தனி secret உடன் கையொப்பமிட்டு அனுப்புகிறது, ஒவ்வொரு இணைப்பையும் இரவும் பகலும் கண்காணிக்கிறது.
Meta-வின் சரிபார்ப்பு கோரிக்கையில் எப்போதும் hub.mode மதிப்பு இருக்கும்.
தோல்வியடைந்த அறிவிப்பை Meta குறைந்து வரும் அதிர்வெண்ணில் மீண்டும் முயற்சிக்கும் கால அளவு, அதன் பிறகு அது கைவிடப்படும்.
டெவலப்பர் கணக்கிற்கு எச்சரிக்கை அனுப்பப்படுவதற்கு முன் தோல்வியடைந்த மெசேஜிங் டெலிவரிகளின் எண்ணிக்கை.
வெப்ஹூக்ஸ் முடக்கப்பட்டது எச்சரிக்கையும் ஆப் கணக்கிலிருந்து சந்தா நீக்கமும் நிகழ்வதற்கு முன் தோல்வியடையும் மெசேஜிங் டெலிவரிகளின் எண்ணிக்கை.
ஆப் பயனர்களின் கணக்குகளுக்கான அறிவிப்புகளைப் பெறுவதற்கு Meta கோரும் ஆப் பயன்முறை.
Instagram வெப்ஹூக்குகள் எவ்வாறு அமைக்கப்படுகின்றன?
Meta-வின் வழிகாட்டி கொடுக்கும் வரிசையில் நான்கு படிகளில். எந்தப் புலத்தையும் தேர்ந்தெடுக்கும் முன் எண்ட்பாயிண்ட் சரிபார்ப்பில் தேறியிருக்க வேண்டும், பயனர்களின் கணக்குகளுக்கான அறிவிப்புகளைப் பெற ஆப் Live நிலையில் இருக்க வேண்டும், உற்பத்தி அணுகலுக்கு வணிகச் சரிபார்ப்பு தேவை.
சரிபார்ப்பு கோரிக்கையில் என்ன இருக்கும்?
கால்பேக் URL-க்கு ஒரு GET கோரிக்கை, App Dashboard-இல் Webhooks தயாரிப்பு அமைக்கப்படும் போதெல்லாம் அனுப்பப்படும். hub.verify_token எண்ட்பாயிண்டின் சொந்த டோக்கனுடன் பொருந்தினால், பதில் 200 ஆக இருக்கும், உடலாக hub.challenge மதிப்பு முழுவதுமாக இருக்கும்; இல்லையெனில் 403. எண்ட்பாயிண்ட் தேறியதா என்பதை டாஷ்போர்டு காட்டும்.
- hub.mode: எப்போதும் subscribe.
- hub.challenge: Meta உருவாக்கும் ஒரு முழு எண், எண்ட்பாயிண்ட் அதைத் திருப்பி அனுப்ப வேண்டும்.
- hub.
verify_token: டாஷ்போர்டின் 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கால்பேக்கும் புலங்களும் எங்கே அமைக்கப்படுகின்றன?
App Dashboard-இல், 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 மூலம் கையொப்பமிடுகிறது, அது ஆப்பின் secret-ஆல் சாவியிடப்படும், அதை X-Hub-Signature-256-இல் sha256= என்று தொடர்ந்து hex digest ஆக அனுப்பும். பெறுநர் மூல கோரிக்கை உடலின் மீது அதே 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);app secret மட்டும் ஏன் இதைச் சரிபார்க்க முடியும்?
ஏனெனில் கையொப்பம் அந்த secret-ஆல் சாவியிடப்பட்ட HMAC. அது இல்லாமல் யாரும் எதிர்பார்க்கப்படும் மதிப்பைக் கணக்கிட முடியாது, பேலோட் நகல் வைத்திருப்பவர்களாலும் ஒன்றை போலியாக உருவாக்க முடியாது, ஆகவே இந்தச் சரிபார்ப்பு ஆப்பிற்காக Meta-வின் கோரிக்கைகளைப் பெறும் சர்வரில் இருக்க வேண்டும். app secret, அணுகல் டோக்கன் மற்றும் கிளையன்ட் நற்சான்றுகளை பதிவுகளிலும் support கோரிக்கைகளிலும் வெளியிடக் கூடாது என்று Meta கேட்கிறது. வேறொரு ஆப் அனுப்பும் நிகழ்வுகளைப் பெறும் அமைப்பு Meta-வின் கையொப்பத்தை சரிபார்க்கவே முடியாது, அதற்குப் பதிலாக அந்த ஆப்பின் சொந்த கையொப்பத்தையே நம்ப வேண்டும்.
ஒவ்வொரு கணக்கிற்கும் ஏன் தனி சந்தா தேவை?
ஏனெனில் App Dashboard ஆப் எவற்றைப் பெற முடியும் என்பதை அமைக்கிறது, ஆனால் ஒரு கணக்கிற்கான அறிவிப்புகள் அந்தக் கணக்கும் சந்தா செய்யப்பட்ட பிறகே தொடங்கும். Instagram Login உடன், கணக்கின் Instagram User அணுகல் டோக்கன் மற்றும் ஆப்புக்குத் தேர்ந்தெடுத்த புலங்களை கமாவால் பிரித்து subscribed_fields-இல் வைத்து, graph.instagram.com-க்கு POST /<IG_ID>/subscribed_apps அனுப்ப வேண்டும். வெற்றிகரமான அழைப்பு 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-வின் மெசேஜிங் டெலிவரி விதிகளைப் பின்பற்றுகின்றன, அவை வேகமாகச் செயல்படும்:
- 5 வினாடிகளுக்குள் 200 OK எதிர்பார்க்கப்படுகிறது, தோல்வியடைந்த டெலிவரி சில உடனடி மறுமுயற்சிகளைப் பெறும், ஆகவே message mid-ஆல் நகல்களை நீக்குங்கள்.
- 15 நிமிடத் தோல்விகளுக்குப் பிறகு டெவலப்பர் கணக்கிற்கு எச்சரிக்கை செல்லும்.
- ஒரு மணி நேரத் தோல்விகளுக்குப் பிறகு வெப்ஹூக்ஸ் முடக்கப்பட்டது எச்சரிக்கை வரும், கணக்கின் வெப்ஹூக்குகளிலிருந்து ஆப் மீண்டும் சந்தா செய்யும் வரை சந்தா நீக்கப்படும்.
- செயலிழப்பின் போது அனுப்பப்பட்ட மெசேஜ்கள் வரிசை மாறி வரலாம், ஆகவே அவற்றை நேர முத்திரை வாரியாக வரிசைப்படுத்துங்கள்.
எதுவும் வராதபோது எதைச் சரிபார்க்க வேண்டும்?
பெரும்பாலான அமைதியான எண்ட்பாயிண்டுகளை உள்ளடக்கும் Meta-வின் சரிபார்ப்புப் பட்டியல், இந்த வரிசையில்:
- கால்பேக் URL சரிபார்ப்பில் தேறியிருக்க வேண்டும், HTTPS வழியாக அணுகக்கூடியதாகவும் சரியான சான்றிதழுடனும் இருக்க வேண்டும்; self-signed சான்றிதழ்கள் ஆதரிக்கப்படாது.
- ஆப் புலத்தைத் தேர்ந்தெடுத்திருக்க வேண்டும், தேவையான அணுகல் நிலையும் இருக்க வேண்டும், comments மற்றும்
live_comments-க்கு Advanced Access. subscribed_appsவழியாக கணக்குக்கு அறிவிப்புகள் இயக்கப்பட்டிருக்க வேண்டும், அதே login அமைப்பிலிருந்து வந்த டோக்கனுடன்.- கணக்கு புலத்தின் விதிகளை நிறைவு செய்ய வேண்டும்: கருத்து அறிவிப்புகளுக்கு பொது கணக்குக்குச் சொந்தமான மீடியா வேண்டும்.
- சர்வர் மெதுவான வேலையைத் தொடங்குவதற்கு முன் success-ஐத் திருப்பி அனுப்ப வேண்டும்.
easyCoexistence ஏன் அனுப்பப்பட்ட நிகழ்வுகளுக்கு மீண்டும் கையொப்பமிடுகிறது?
ஏனெனில் Meta-வின் கையொப்பம் பயணிக்க முடியாது. easyCoexistence-இன் ஆப் Meta-வின் டெலிவரியைப் பெறுகிறது, அதன் சொந்த app secret-ஆல் X-Hub-Signature-256-ஐ சரிபார்க்கிறது, உடனே Meta-விற்குப் பதிலளிக்கிறது, இணைக்கப்பட்ட கணக்கிற்கான ஒவ்வொரு entry-யையும் அந்தக் கணக்கிற்கு அமைக்கப்பட்ட எண்ட்பாயிண்டுக்கு POST செய்கிறது. அது platform, account_id, external_id மற்றும் entry அடங்கிய புதிய உடலில் அனுப்பப்படுகிறது. Meta-வின் தலைப்பு அனுப்பப்படுவதில்லை, அந்த secret இல்லாமல் அதைச் சரிபார்க்கவும் முடியாது, ஆகவே ஒவ்வொரு அனுப்புதலும் Content-Type: application/json மற்றும் X-EC-Signature உடன் வருகிறது, அது ஒரே கணக்கிற்குச் சொந்தமான secret-ஆல் சாவியிடப்படுகிறது.
X-EC-Signature-ஐ எவ்வாறு சரிபார்ப்பது?
தலைப்பு t=<unix>,v1=<hex> என்று இருக்கும், இங்கு v1 என்பது நேர முத்திரை, ஒரு புள்ளி, மூல உடல் ஆகியவற்றின் hex HMAC-SHA256, அது கணக்கின் signing secret-ஆல் சாவியிடப்படும். பெறப்பட்ட பைட்டுகளை அப்படியே வைத்து மீண்டும் கணக்கிட்டு, நிலையான நேரத்தில் ஒப்பிட்டு, 5 நிமிடத்திற்கும் பழைய நேர முத்திரையை நிராகரியுங்கள்.
- secret whsec_ என்று தொடங்கும், URL அமைக்கப்படும்போது
set_social_webhook_destinationஅல்லது PUT /channels/:id/webhook மூலம் ஒருமுறை காட்டப்படும். - URL-ஐ மீண்டும் அமைத்தால் புதிய secret வழங்கப்படும், null URL அனுப்புதலை நிறுத்தும்.
- ஒவ்வொரு நிகழ்வும் ஒருமுறை அனுப்பப்படும், 8 வினாடிகள் வரை காத்திருந்து, திசைதிருப்பல்களைப் பின்தொடராமல், பொது IP-க்கு தீர்வாகும் HTTPS முகவரிக்கு.
- இணைப்பை நீக்கினால் கணக்கு Meta-வின் வெப்ஹூக்குகளிலிருந்து சந்தா நீக்கப்படும், அதன் எண்ட்பாயிண்டும் secret-ம் அழிக்கப்படும்.
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())பொதுவான தவறுகள்
- சவாலை JSON ஆகவோ மேற்கோள்களுக்குள்ளோ திருப்பி அனுப்புவது. Meta எதிர்பார்ப்பது hub.challenge மதிப்பை உடலாக, 200 நிலையுடன்.
- parse செய்யப்பட்ட உடலை ஹாஷ் செய்வது. JSON body parser Meta கையொப்பமிட்ட சரியான பைட்டுகளை நிராகரிக்கிறது, ஆகவே HMAC-க்கு மூல உடலை வைத்து, பிறகு பார்ஸ் செய்யுங்கள்.
- ஆப்பிற்கு சந்தா செய்து கணக்கை மறப்பது. ஒரு கணக்கிற்கு POST /<IG_ID>/subscribed_apps வெற்றியடையும் வரை அதற்கான அறிவிப்புகள் வராது.
- ஒரு மணி நேரம் எண்ட்பாயிண்ட் தோல்வியடைய விடுவது. Meta மெசேஜிங் வெப்ஹூக்குகளை முடக்கி, ஆப்பை கணக்கிலிருந்து சந்தா நீக்கும், மீண்டும் சந்தா செய்ய வேண்டியிருக்கும்.
set_social_webhook_destination அல்லது Partner API மூலம் இயக்குங்கள். ஒரு இணைப்புக்கு மாதம் US$ 9 முதல் US$ 0.75 வரை, இணைப்புகள் சேர சேரக் குறைகிறது, முதல் 3 நாட்கள் இலவசம்.
அடிக்கடி கேட்கப்படும் கேள்விகள்
hub.challenge என்றால் என்ன Instagram வெப்ஹூக்குகளில்?
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 வெப்ஹூக் எண்ட்பாயிண்டுக்கு self-signed சான்றிதழ் வேலை செய்யுமா?
இல்லை, Meta self-signed சான்றிதழ்களை ஆதரிப்பதில்லை: கால்பேக் URL HTTPS வழியாக அணுகக்கூடியதாகவும் சரியான சான்றிதழுடனும் இருக்க வேண்டும், இது Meta-வின் சரிபார்ப்புப் பட்டியலின் முதல் உருப்படி.
தொடர்ந்து படிக்கவும்
உங்கள் முதல் சேனலை இரண்டு நிமிடங்களில் இணையுங்கள்.
காத்திருக்க வேண்டிய தளச் மதிப்பாய்வுகள் எதுவும் இல்லை. WhatsApp, Instagram, TikTok அல்லது வேறொரு சேனலை இணையுங்கள். பிறகு போஸ்ட் செய்ய, பதிலளிக்க அல்லது ரிப்போர்ட் தர உங்கள் AI-யிடம் கேளுங்கள், அது செயல்படுவதைப் பாருங்கள்.
- 3 நாட்கள் இலவசம்
- எப்போது வேண்டுமானாலும் ரத்து செய்யலாம்
- அதிகாரப்பூர்வ API-கள் மட்டுமே
- 24/7 கண்காணிப்பு
இதில் சரிபார்க்கப்பட்டது: