Facebook Page కోసం Messenger వెబ్హుక్: మెసేజ్లు మరియు ప్రస్తావనలు
Facebook Page వెబ్హుక్ల messages ఫీల్డ్ ఒక వ్యక్తి Pageకు Messenger మెసేజ్ పంపినప్పుడు ట్రిగ్గర్ అవుతుంది, messaging అర్రేను ఇస్తుంది: పంపినవారి Page పరిధిలోని ID, Page ID, టైమ్స్టాంప్, మెసేజ్ mid, దానితో టెక్స్ట్ లేదా అటాచ్మెంట్లు. mention ఫీల్డ్ పోస్ట్లు మరియు కామెంట్లలో Page ప్రస్తావనల కొత్త వివరాలను నివేదిస్తుంది. Meta రెండింటినీ X-Hub-Signature-256 తో సైన్ చేస్తుంది.
easyCoexistence కనెక్ట్ అయిన ప్రతి Page యొక్క Messenger మెసేజ్లు, ప్రస్తావనలను అవి వచ్చినప్పుడే మీ HTTPS ఎండ్పాయింట్కు ఫార్వర్డ్ చేస్తుంది, ఆ Page కోసం ప్రత్యేక secret తో సైన్ చేసి, కాపీ ఏదీ ఉంచకుండా.
Messenger వెబ్హుక్ ఎండ్పాయింట్ ప్రతి నోటిఫికేషన్కు 200 OK తో ఎంత వేగంగా స్పందించాలని Meta అడుగుతుంది.
ఈ సమయం వరకు డెలివరీలు విఫలమైతే, Meta మళ్లీ సబ్స్క్రైబ్ చేసే వరకు యాప్ను Page వెబ్హుక్ల నుంచి అన్సబ్స్క్రైబ్ చేస్తుంది.
messages ఈవెంట్లోని సెండర్ Page పరిధిలోని ID, ప్రతి వ్యక్తి మరియు Page జతకు ప్రత్యేకమైనది.
mention ఈవెంట్లోని sender ఫీల్డ్ను Meta రిఫరెన్స్ ఎలా గుర్తిస్తుందో.
గత వెబ్హుక్ నోటిఫికేషన్లను తర్వాత ప్రశ్నించలేము, కాబట్టి రిసీవర్ తనకు కావలసినది నిల్వ చేసుకోవాలి.
messages ఫీల్డ్ ఏమి పంపుతుంది?
ఒక వ్యక్తి Pageకు Messenger మెసేజ్ పంపినప్పుడు వచ్చే నోటిఫికేషన్. Meta టెక్స్ట్ మెసేజ్లు, లేదా అటాచ్మెంట్లతో కూడిన మెసేజ్లు పంపుతుంది; అటాచ్మెంట్లు చిత్రాలు, ఆడియో, వీడియో, ఫైళ్లు, స్టిక్కర్లు వంటి ఇతర రకాలు కావచ్చు. షేర్ చేసిన లింక్ ఫాల్బ్యాక్ అటాచ్మెంట్గా రావచ్చు. గతంలోని మెసేజ్కు రిప్లై అయితే reply_to లో ఆ మెసేజ్ mid ఉంటుంది, క్విక్ రిప్లై అయితే దాని పేలోడ్ ఉంటుంది.
messages ఈవెంట్ ఎలా కనిపిస్తుంది?
feed మార్పుల లాగా కాకుండా, మెసేజ్ Page entry లోపల messaging అర్రేలో వస్తుంది. ప్రతి ఈవెంట్లో sender, అంటే వ్యక్తి Page పరిధిలోని ID; recipient, అంటే Page; టైమ్స్టాంప్; message, దానిలో mid మరియు టెక్స్ట్ లేదా అటాచ్మెంట్లు, రకం మరియు పేలోడ్ URL తో ఉంటాయి:
{
"object": "page",
"entry": [
{
"id": "<PAGE_ID>",
"time": 1458692752478,
"messaging": [
{
"sender": { "id": "<PSID>" },
"recipient": { "id": "<PAGE_ID>" },
"timestamp": 1458692752478,
"message": {
"mid": "<MESSAGE_ID>",
"text": "hello, world!"
}
}
]
}
]
}mention ఫీల్డ్ ఏమి పంపుతుంది?
Page పోస్ట్ లేదా కామెంట్లో ప్రస్తావించబడినప్పుడు mention ఫీల్డ్తో వచ్చే change. దానిలో post_id లేదా comment_id, మెసేజ్, ఏదైనా లింక్, ఫోటో లేదా వీడియో, అలాగే item మరియు verb ఉంటాయి. కొన్ని పోస్ట్ మరియు కామెంట్ IDలను అనుమతి లేకపోవడం లేదా గోప్యత కారణంగా ప్రశ్నించలేమని Meta హెచ్చరిస్తుంది; దాని రిఫరెన్స్ sender ఫీల్డ్ను Workplace కు మాత్రమే అని గుర్తిస్తుంది, కాబట్టి ప్రస్తావన దాని రచయిత లేకుండా రావచ్చు.
ఏ Messenger ఫీల్డ్లు ఫార్వర్డ్ కావు?
easyCoexistence Pageలను messages కు మాత్రమే సబ్స్క్రైబ్ చేస్తుంది, message_echoes, messaging_postbacks, message_reads లేదా message_deliveries కు కాదు. కాబట్టి Page పంపే మెసేజ్లు, బటన్ ట్యాప్లు, రీడ్ లేదా డెలివరీ రసీదులు ఫార్వర్డ్ కావు. send_social_dm తో పంపిన రిప్లై బదులుగా దాని స్వంత మెసేజ్ ID ను ఇస్తుంది.
డెలివరీలు మీ ఎండ్పాయింట్కు ఎలా చేరతాయి?
Meta Page వెబ్హుక్లను Page ఇన్స్టాల్ చేసిన యాప్కు పంపుతుంది, మొత్తం యాప్కు ఒకే కాల్బ్యాక్ URL ద్వారా. easyCoexistence ప్రతి డెలివరీపై Meta X-Hub-Signature-256 ను తనిఖీ చేస్తుంది, వెంటనే Meta కు సమాధానం ఇస్తుంది, కనెక్ట్ అయిన ప్రతి Page కోసం ప్రతి entry ను ఆ Page కు మీరు సెట్ చేసిన HTTPS ఎండ్పాయింట్కు పంపుతుంది, ఆ Page సొంత secret తో సైన్ చేసి. దాన్ని Claude లేదా ChatGPT నుండి set_social_webhook_destination తో, లేదా Partner API లో PUT /channels/:id/webhook తో సెట్ చేయండి; secret ఒక్కసారే చూపబడుతుంది, మళ్లీ సెట్ చేస్తే కొత్తది జారీ అవుతుంది, URL null అయితే పంపడం ఆగిపోతుంది.
ఫార్వర్డ్ అయిన ఈవెంట్ ఎలా కనిపిస్తుంది?
ఫార్వర్డ్ అయిన ప్రతి POST లో platform, list_social_accounts ఇచ్చే Page కనెక్షన్ account_id, Page ID external_id గా, మరియు entry ఉంటాయి: Page కోసం Meta entry, మారకుండా. sender.id అనేది 24 గంటల విండోలో రిప్లై కోసం send_social_dm తీసుకునే recipient_id:
{
"platform": "facebook",
"account_id": "<ACCOUNT_ID>",
"external_id": "<PAGE_ID>",
"entry": {
"id": "<PAGE_ID>",
"time": 1793318400000,
"messaging": [
{
"sender": { "id": "<PSID>" },
"recipient": { "id": "<PAGE_ID>" },
"timestamp": 1793318399000,
"message": { "mid": "<MESSAGE_ID>", "text": "<MESSAGE_TEXT>" }
}
]
}
}ఈవెంట్ను ఎలా ధృవీకరించాలి?
ప్రతి ఫార్వర్డ్ POST లో X-EC-Signature హెడర్ ఉంటుంది, t=<unix>,v1=<hex> రూపంలో, ఇక్కడ v1 అనేది టైమ్స్టాంప్, చుక్క మరియు raw body యొక్క HMAC-SHA256, Page సైనింగ్ సీక్రెట్ను కీగా ఉపయోగించి. body ను అందినట్లుగానే పూర్తిగా లెక్కించండి, constant time లో పోల్చండి, మరియు 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 ద్వారా కాదు. ప్రతి entry ఒకసారి మాత్రమే, మెమరీలో ఫార్వర్డ్ అవుతుంది, మళ్లీ ప్రయత్నించడానికి కాపీ ఉంచకుండా; ఫార్వర్డ్ సమాధానం కోసం 8 సెకన్లు వేచి ఉంటుంది, రీడైరెక్ట్లను అనుసరించదు, మరియు పబ్లిక్ IP కు రిజాల్వ్ అయ్యే HTTPS చిరునామాకు మాత్రమే వెళ్తుంది. గత నోటిఫికేషన్లను తర్వాత ప్రశ్నించలేమని Meta గమనిస్తుంది, కాబట్టి అందినప్పుడే అవసరమైనది నిల్వ చేయండి. అప్స్ట్రీమ్లో Meta విఫలమైన డెలివరీని కొన్ని సార్లు వెంటనే మళ్లీ ప్రయత్నిస్తుంది, కాబట్టి అదే మెసేజ్ అప్పుడప్పుడు రెండుసార్లు రావచ్చు: దాని mid ఆధారంగా డూప్లికేట్లను తొలగించండి.
సాధారణ పొరపాట్లు
- సమాధానం ఇవ్వకముందే పని చేయడం. ఫార్వర్డ్ చేయడం మళ్లీ ప్రయత్నించదు, కాబట్టి వెంటనే 2xx తిరిగి ఇవ్వండి, తర్వాత ఈవెంట్ను ప్రాసెస్ చేయండి.
- parse చేసిన JSON పై సిగ్నేచర్ను ధృవీకరించడం. HMAC ను అందినట్లుగానే raw body పై లెక్కించండి.
- మెసేజ్కు ఎప్పుడూ టెక్స్ట్ ఉంటుందని అనుకోవడం. స్టిక్కర్, చిత్రం, లేదా షేర్ చేసిన లింక్ అటాచ్మెంట్లుగా వస్తుంది, text ఫీల్డ్ లేకుండా.
- డూప్లికేషన్ తొలగింపును వదిలేయడం. విఫలమైన తర్వాత Meta ఈవెంట్ను మళ్లీ పంపవచ్చు, కాబట్టి చర్య తీసుకునే ముందు మెసేజ్ mid పై కీ చేయండి.
send_social_dm 24 గంటల విండోలో రిప్లై చేస్తుంది. set_social_webhook_destination లేదా Partner API తో ఫార్వర్డ్ చేయడాన్ని ఆన్ చేయండి. ప్రతి కనెక్షన్కు నెలకు US$ 9 నుంచి US$ 0.75 వరకు, కనెక్షన్లు పెరిగేకొద్దీ తగ్గుతుంది, మొదటి 3 రోజులు ఉచితం.
తరచుగా అడిగే ప్రశ్నలు
easyCoexistence ఏ webhook ఫీల్డ్లకు Pageను సబ్స్క్రైబ్ చేస్తుంది?
Messenger కోసం messages, ప్రస్తావనల కోసం mention, Page పోస్ట్లు మరియు కామెంట్ల కోసం feed తో పాటు.
Messenger స్టిక్కర్ లేదా చిత్రంతో టెక్స్ట్ వస్తుందా?
లేదు. స్టిక్కర్, చిత్రం, లేదా షేర్ చేసిన లింక్ అటాచ్మెంట్లలో వస్తుంది, ప్రతిదానికీ రకం మరియు పేలోడ్ URL ఉంటుంది, మెసేజ్కు text ఫీల్డ్ ఉండదు.
Messenger webhook ఎండ్పాయింట్ ఎంత వేగంగా సమాధానం ఇవ్వాలి?
5 సెకన్లలోపు 200 OK తో. విఫలమైన డెలివరీలు 1 గంట గడిస్తే, Meta యాప్ను Page వెబ్హుక్ల నుంచి అన్సబ్స్క్రైబ్ చేస్తుంది.
ఫార్వర్డ్ అయిన మెసేజ్కు ఎలా రిప్లై చేయాలి?
ఈవెంట్లోని sender.id ను recipient_id గా ఇచ్చి send_social_dm కాల్ చేయండి, వ్యక్తి మెసేజ్ వచ్చిన 24 గంటలలోపు.
చదవడం కొనసాగించండి
మీ మొదటి ఛానెల్ను రెండు నిమిషాల్లో కనెక్ట్ చేయండి.
ప్లాట్ఫామ్ సమీక్షల కోసం ఎదురుచూడాల్సిన అవసరం లేదు. WhatsApp, Instagram, TikTok లేదా మరో ఛానెల్ను కనెక్ట్ చేయండి, ఆపై పోస్ట్ చేయమని, ప్రత్యుత్తరం ఇవ్వమని లేదా రిపోర్ట్ ఇవ్వమని మీ AIకి చెప్పండి, అది పని చేయడం చూడండి.
- 3 రోజులు ఉచితం
- ఎప్పుడైనా రద్దు చేయండి
- అధికారిక APIలు మాత్రమే
- 24/7 పర్యవేక్షణ
ధృవీకరించిన తేదీ