Facebook webhook verification: hub.challenge at X-Hub-Signature-256
Bine-verify ng Facebook ang webhook endpoint sa pamamagitan ng GET na may hub.mode na nakatakda sa subscribe, hub.verify_token, at hub.challenge; sinusuri ng endpoint ang token laban sa nasa App Dashboard at ibinabalik ang challenge bilang body. Pagkatapos, bawat event ay dumarating bilang POST na pinirmahan sa X-Hub-Signature-256: sha256= kasunod ng HMAC-SHA256 ng payload, gamit ang app secret bilang key.
Hinahawakan ng easyCoexistence ang panig ng Meta para sa bawat Page na ikinokonekta ninyo: sinasagot ng app nito ang hub.challenge, chine-check ang X-Hub-Signature-256 at ina-subscribe ang Page sa feed, mensahe, at mention, saka ipinapasa ang mga event sa inyong HTTPS endpoint na pinirmahan ng X-EC-Signature at ng secret para sa Page na iyon.
Ang halagang laging dala ng hub.mode sa verification request ng Meta; ang hub.challenge ay integer na dapat ibalik.
Prefix ng X-Hub-Signature-256, kasunod ang SHA256 signature na ginagawa ng Meta mula sa payload at App Secret.
Kung gaano kabilis dapat sagutin ng Messenger webhook endpoint ang bawat notification ng 200 OK.
Bilang ng mga nabigong delivery bago ang alert na Webhooks Disabled at ang pag-unsubscribe ng app sa Page.
Gaano katagal sinusubukang muli ng Meta ang nabigong Page notification, na may unti-unting pagbaba ng dalas, bago ito tuluyang i-drop.
Ano ang laman ng verification request ng Meta?
Isang GET sa callback URL, ipinapadala sa tuwing naka-configure ang Webhooks product sa App Dashboard o kapag may gawang subscription sa pamamagitan ng /{app-id}/subscriptions. Kasama nito ang tatlong query parameter:
- hub.mode: laging subscribe.
- hub.challenge: isang integer na dapat ibalik ng endpoint.
- hub.
verify_token: ang string na inilagay sa Verify Token field ng dashboard. - Pinapalitan ng PHP ang mga tuldok ng underscore, kaya binabasa ito bilang
hub_mode,hub_challengeathub_verify_token.
Paano dapat sagutin ito ng endpoint?
Sa pamamagitan ng 200 na ang buong body ay ang halaga ng hub.challenge, ngunit kapag subscribe lamang ang hub.mode at tugma ang hub.verify_token; ang anumang iba pa ay makakatanggap ng 403, gaya ng sample app ng Meta. Sinasabi ng dashboard kung pumasa ang endpoint, at sumasagot ang /{app-id}/subscriptions ng success o error. Kailangan ng endpoint ang HTTPS na may balidong TLS o SSL certificate, dahil hindi sinusuportahan ang self-signed certificate.
Paano kinukuwenta ang X-Hub-Signature-256?
Bilang HMAC-SHA256 ng request payload, gamit ang App Secret ng app bilang key, na nakasulat sa lowercase hex pagkatapos ng sha256=. Idinadagdag ng Messenger guide ng Meta na sakop ng signature ang payload na naka-escape ang Unicode, kaya ang string na tulad ng äöå ay binibilang bilang \u00e4\u00f6\u00e5: i-hash ang raw body nang eksakto gaya ng natanggap, hindi ang na-decode o muling na-serialize na kopya. Sinasabi ng Meta na opsyonal ang pag-validate, ngunit lubos nitong inirerekomenda ito.
Paano ito i-check sa code?
Itago ang raw bytes, kuwentahin ang HMAC, ikumpara sa constant time, saka i-parse. Ibinabalik ng get_data ng Flask ang body nang buo, at iyon ang ginamit sa pagkuwenta ng signature; kung i-parse muna ito at muling i-serialize, magbabago ang mga bytes. Isang maliit na endpoint na sumasagot sa verification at nagche-check sa bawat POST:
import hashlib, hmac, os
from flask import Flask, abort, request
app = Flask(__name__)
VERIFY_TOKEN = os.environ["VERIFY_TOKEN"]
APP_SECRET = os.environ["APP_SECRET"].encode()
@app.get("/webhooks/facebook")
def verify():
token = request.args.get("hub.verify_token", "")
if request.args.get("hub.mode") == "subscribe" and hmac.compare_digest(token.encode(), VERIFY_TOKEN.encode()):
return request.args.get("hub.challenge", ""), 200
abort(403)
@app.post("/webhooks/facebook")
def receive():
raw = request.get_data() # the bytes Meta signed
expected = "sha256=" + hmac.new(APP_SECRET, raw, hashlib.sha256).hexdigest()
if not hmac.compare_digest(expected.encode(), request.headers.get("X-Hub-Signature-256", "").encode()):
abort(401)
# answer at once; hand request.get_json() to a queue for the work
return "EVENT_RECEIVED", 200Ano ang inaasahan ng Meta pagkatapos ng verification?
Isang 200 OK para sa bawat notification, sa loob ng 5 segundo para sa mga Messenger event. Maaaring pagsamahin ng Meta hanggang 1,000 update sa isang delivery nang walang garantiya, at ganito ang paghawak nito sa mga pagkabigo:
- Page notifications: sinusubukang muli agad, saka ilang beses pa na may unti-unting pagbaba ng dalas sa loob ng 36 na oras, saka ibinabasura.
- Messenger notifications: sinusubukang muli ng ilang beses agad; pagkatapos ng 15 minutong pagkabigo, may alert na makararating sa developer account.
- Pagkatapos ng isang oras na pagkabigo, susunod ang alert na Webhooks Disabled at ima-unsubscribe ang app sa Page hanggang muli itong mag-subscribe.
- Maaaring maihatid nang dalawang beses at wala sa pagkakasunod-sunod ang event dahil sa retry, kaya i-deduplicate ito at ayusin ang mga mensahe ayon sa timestamp.
- Hindi na maaaring i-query ang mga nakaraang notification, kaya itago ang kailangan ninyo habang dumarating ang mga ito.
Paano pumapasa ang easyCoexistence sa mga check ng Meta?
Ang Meta app nito ay may isang callback URL para sa mga Page na naka-connect, at ang endpoint na iyon ay gumagawa mismo ng dalawang check. Sumasagot lamang ito sa GET kapag subscribe ang hub.mode at tugma ang verify token, na ikinukumpara sa constant time, at nagbabalik ng 403 kung hindi; binabasa nito ang bawat POST bilang raw text, kinukuwenta muli ang X-Hub-Signature-256 gamit ang app secret nito, tinatanggihan ang hindi tugma sa pamamagitan ng 401, at agad na sumasagot sa Meta, saka pinoproseso ang event pagkatapos ng response.
Paano pinipirmahan ng easyCoexistence ang mga ipinapasa nito?
Gamit ang sariling signature, dahil ang header ng Meta ay maaari lamang i-check gamit ang app secret ng easyCoexistence at hindi ito ipinapasa. Ang bawat entry para sa naka-connect na Page na may nakatakdang endpoint ay ipinapadala roon bilang JSON, {platform, account_id, external_id, entry}, kasama ang X-EC-Signature header sa anyong t=<unix>,v1=<hex>, kung saan ang v1 ay ang HMAC-SHA256 ng timestamp, tuldok, at raw body, gamit ang signing secret ng Page na iyon bilang key:
- Nagsisimula ang secret sa whsec_ at ipinapakita nang isang beses, sa pamamagitan ng
set_social_webhook_destinationo PUT /channels/:id/webhook sa Partner API. - Kapag muling itinakda ang URL, bumubuo ito ng bagong secret, at ang null na URL ay nag-o-off ng forwarding.
- Bawat forward ay ipinapadala nang isang beses, naghihintay nang hanggang 8 segundo, nang hindi sinusundan ang redirect, sa HTTPS address na nagre-resolve sa public IP.
- Walang kopya ng event na itinatago, kaya walang mare-retry.
Paano i-verify ang X-EC-Signature?
Hatiin ang header sa t at v1, tanggihan ang timestamp na higit sa 5 minuto ang edad, kuwentahin muli ang HMAC sa t, tuldok, at raw body gamit ang signing secret ng Page, at ikumpara sa constant time. Sa Node.js, habang nakatago ang body bilang raw bytes:
import crypto from "node:crypto";
import express from "express";
const app = express();
const SECRET = process.env.EC_SIGNING_SECRET; // whsec_..., shown once
app.post("/events/facebook", express.raw({ type: "application/json" }), (req, res) => {
const sig = Object.fromEntries(
String(req.get("X-EC-Signature") ?? "").split(",").map((part) => part.split("="))
);
const fresh = Math.abs(Date.now() / 1000 - Number(sig.t)) <= 300;
const expected = crypto
.createHmac("sha256", SECRET)
.update(Buffer.concat([Buffer.from(`${sig.t}.`), req.body]))
.digest("hex");
const ok = fresh && typeof sig.v1 === "string" && sig.v1.length === expected.length &&
crypto.timingSafeEqual(Buffer.from(expected), Buffer.from(sig.v1));
if (!ok) return res.sendStatus(401);
res.sendStatus(200); // answer first: forwards are not retried
const { platform, account_id, external_id, entry } = JSON.parse(req.body.toString("utf8"));
// queue entry for the work
});Mga karaniwang pagkakamali
- Pagbalot sa hub.challenge sa JSON o quotes. Ang body ng 200 ay dapat ang mismong halaga ng challenge.
- Pagkuwenta ng HMAC pagkatapos ng JSON parser. Ang pag-parse at muling pag-serialize ay nagbabago sa mga bytes, at pinipirmahan ng Meta ang payload na naka-escape ang Unicode, kaya i-hash ang raw body.
- Paggawa ng trabaho bago sumagot. Inaasahan ng Messenger ang 200 sa loob ng 5 segundo, at ang isang oras na pagkabigo ay nag-a-unsubscribe sa app sa Page.
- Pag-check ng signature ng Meta sa mga ipinasa-forward na event. Pinipirmahan ng Meta gamit ang app secret ng easyCoexistence; ang ipinasa-forward na event ay may X-EC-Signature, na chine-check gamit ang signing secret ng Page.
US$ 9 hanggang US$ 0.75 kada koneksyon kada buwan, bumababa habang dumarami ang koneksyon, at libre ang unang 3 araw.
Mga madalas itanong
Saan galing ang verify token?
Kayo ang pumipili nito. Ito ang string na inilagay sa Verify Token field kapag nagko-configure ng webhooks sa App Dashboard, o ang verify_token na ipinadala sa /{app-id}/subscriptions.
Puwede bang i-test ang verification gamit ang curl?
Oo. Nagpapadala ang Messenger guide ng Meta ng GET na may hub.verify_token, hub.challenge=CHALLENGE_ACCEPTED at hub.mode=subscribe, at sinasagot ng gumaganang endpoint ang CHALLENGE_ACCEPTED.
Ano ang mangyayari kung pumalya ang endpoint nang isang oras?
Nagpapadala ang Meta ng alert na Webhooks Disabled at ina-unsubscribe ang app sa Page. Pagkatapos ayusin ang endpoint, i-subscribe muli ang Page sa pamamagitan ng subscribed_apps.
Kailangan ko ba ng sarili kong Meta app para makatanggap ng webhooks ng isang Page?
Hindi, sa easyCoexistence. Ipinapadala ng Meta sa app nito, na ipinapasa ang bawat event ng Page sa endpoint na itinakda ninyo, pinirmahan ng X-EC-Signature.
Magpatuloy sa pagbabasa
I-connect ang inyong unang channel sa loob ng dalawang minuto.
Walang review ng platform na hihintayin. I-connect ang WhatsApp, Instagram, TikTok o iba pang channel, pagkatapos ay utusan ang inyong AI na mag-post, mag-reply o gumawa ng report, at panoorin itong gumana.
- 3 araw na libre
- Mag-cancel anumang oras
- Official API lang
- Minomonitor 24/7
Na-verify noong