පුරනය වන්නනොමිලේ trial කාලය ආරම්භ කරන්න
easyCoexistence නිල API

Facebook webhook එකේ සත්‍යාපනය: hub.challenge සහ X-Hub-Signature-256

Facebook webhook endpoint එක සත්‍යාපනය කරන්නේ hub.mode subscribe, hub.verify_token සහ hub.challenge ඇතුළත් GET request එකකිනි; endpoint එක token එක යෙදුමේ dashboard එකේ ඇති එක සමඟ ගලපා, challenge අගය body එක ලෙස ආපසු යවයි. ඉන් පසු එක් එක් සිදුවීම X-Hub-Signature-256 අත්සන් කළ POST එකක් ලෙස පැමිණේ: sha256= ඉන් පසු payload එකේ HMAC-SHA256 අගය, යෙදුමේ රහස්‍ය යතුර ලෙස භාවිතා කරමින්.

easyCoexistence ඔබ සම්බන්ධ කරන සෑම Page එකක් සඳහාම Meta පැත්ත හසුරුවයි: එහි යෙදුම hub.challenge ට පිළිතුරු දෙයි, X-Hub-Signature-256 පරීක්ෂා කරයි, Page එක feed, පණිවිඩ සහ mention වෙත subscribe කරයි, ඉන් පසු සිදුවීම් Page එක සඳහා වෙනම රහස්‍යෙන් X-EC-Signature සමඟ අත්සන් කර ඔබේ HTTPS endpoint එකට forward කරයි.

subscribe

hub.mode අගය Meta හි සත්‍යාපන request එකේ සැමවිටම ඇත; hub.challenge යනු ආපසු යැවිය යුතු පූර්ණ සංඛ්‍යාවකි.

sha256=

X-Hub-Signature-256 හි prefix එක, ඉන් පසු Meta payload සහ යෙදුමේ රහස්‍යෙන් ජනනය කරන SHA256 අත්සන.

5 seconds

Messenger webhook endpoint එකක් සෑම දැනුම්දීමකටම 200 OK සමඟ කෙතරම් ඉක්මනින් පිළිතුරු දිය යුතුද.

1 hour

Webhooks Disabled අනතුරු ඇඟවීමට සහ Page එකෙන් යෙදුම unsubscribe වීමට පෙර අසාර්ථක delivery ගණන.

36 hours

Meta අසාර්ථක Page දැනුම්දීමක් අඩුවන වාර ගණනකින් නැවත උත්සාහ කරන කාලය, පසුව එය අත්හරින්නට පෙර.

Meta හි සත්‍යාපන request එකේ මොනවා අඩංගුද?

Webhooks product එක dashboard එකේ configure කළ විට හෝ /{app-id}/subscriptions හරහා දායකත්වයක් සාදන විට, callback URL එකට GET request එකක් යවයි. එයට query parameter තුනක් පැමිණේ:

  • hub.mode: සැමවිටම subscribe.
  • hub.challenge: endpoint එක ආපසු යැවිය යුතු පූර්ණ සංඛ්‍යාවකි.
  • hub.verify_token: dashboard එකේ Verify Token ක්ෂේත්‍රයට ඇතුළත් කළ string එක.
  • PHP ලකුණු (dots) underscores බවට හරවා ගනී, එබැවින් ඒවා hub_mode, hub_challenge සහ hub_verify_token ලෙස කියවයි.

endpoint එක එයට කෙසේ පිළිතුරු දිය යුතුද?

200 ප්‍රතිචාරයක් සමඟ, body එක සම්පූර්ණයෙන්ම hub.challenge අගය වන විට පමණි, hub.mode subscribe වී hub.verify_token ගැළපෙන විට පමණි; වෙනත් ඕනෑම දෙයකට Meta නියැදි යෙදුමේ මෙන් 403 ලැබේ. Dashboard එක endpoint එක සමත් වූවාද යන්න වාර්තා කරන අතර /{app-id}/subscriptions සාර්ථකත්වය හෝ දෝෂයක් ලෙස ප්‍රතිචාර දක්වයි. Endpoint එකට valid TLS හෝ SSL certificate සහිත HTTPS අවශ්‍යයි, self-signed certificate සහාය නොදක්වයි.

X-Hub-Signature-256 ගණනය කරන්නේ කෙසේද?

යෙදුමේ රහස්‍ය යතුර සමඟ request payload එකේ HMAC-SHA256 ලෙස, sha256= ඉන් පසු lowercase hex ආකාරයෙන් ලියා ඇත. Meta හි Messenger මාර්ගෝපදේශය තවදුරටත් සඳහන් කරන්නේ අත්සනට Unicode escape කළ payload ආවරණය වන බවයි, එබැවින් äöå වැනි string එකක් \u00e4\u00f6\u00e5 ලෙස ගණන් වේ: raw body එක ලැබුණු ආකාරයටම hash කරන්න; decode කළ හෝ නැවත serialize කළ පිටපතක් කදාචිත් භාවිතා නොකරන්න. Meta පවසන්නේ සත්‍යාපනය විකල්පයක් වන නමුත් එය දැඩි ලෙස නිර්දේශ කරන බවයි.

කේතයෙන් එය පරීක්ෂා කරන්නේ කෙසේද?

raw bytes තබා ගන්න, HMAC ගණනය කරන්න, constant time තුළ සංසන්දනය කරන්න, ඉන් පසු parse කරන්න. Flask හි get_data මගින් body එක වෙනස් නොකර ලබා දෙයි, එය අත්සන ගණනය කළ දත්තයයි; පළමුව parse කර නැවත serialize කළහොත් bytes වෙනස් වේ. සත්‍යාපනය සහ සෑම POST එකක්ම පරීක්ෂා කරන කුඩා endpoint එකක්:

Python: hub.challenge and X-Hub-Signature-256
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", 200

සත්‍යාපනයෙන් පසු Meta බලාපොරොත්තු වන්නේ කුමක්ද?

සෑම දැනුම්දීමකටම 200 OK, Messenger සිදුවීම් සඳහා තත්පර 5ක් ඇතුළත. Meta එක් delivery එකකට යාවත්කාලීන 1,000ක් දක්වා batch කරයි, එය සහතික නොකරමින්, සහ අසාර්ථකත්වය මෙසේ හසුරුවයි:

  • Page දැනුම්දීම්: වහාම නැවත උත්සාහ කරයි, පසුව පැය 36ක් තුළ අඩුවන වාර ගණනකින් තවත් කිහිප වාරයක්, ඉන් පසු අත්හරියි.
  • Messenger දැනුම්දීම්: වහාම කිහිප වාරයක් නැවත උත්සාහ කරයි; විනාඩි 15ක අසාර්ථකත්වයකින් පසු, developer ගිණුමට අනතුරු ඇඟවීමක් ළඟා වේ.
  • පැයක අසාර්ථකත්වයකින් පසු, Webhooks Disabled අනතුරු ඇඟවීමක් ළඟා වන අතර, යෙදුම නැවත subscribe කරන තෙක් Page එකෙන් unsubscribe කෙරේ.
  • නැවත උත්සාහයන් සිදුවීමක් දෙවරක් සහ පිළිවෙළ වෙනස්ව delivery කළ හැකි නිසා, deduplicate කර පණිවිඩ කාලමුද්‍රාව අනුව අනුපිළිවෙළට සකසන්න.
  • අතීත දැනුම්දීම් පසුව query කළ නොහැක, එබැවින් ඒවා පැමිණෙන විට අවශ්‍ය දේ ගබඩා කරන්න.

easyCoexistence Meta හි පරීක්ෂාවන් සමත් වන්නේ කෙසේද?

එහි Meta යෙදුමට එය සම්බන්ධ කරන Page සඳහා එක callback URL එකක් ඇති අතර, එම endpoint එක මෙම පරීක්ෂා දෙකම තනිව කරයි. hub.mode subscribe වී verify_token ගැළපෙන විට පමණක් GET එකට පිළිතුරු දෙන අතර, නොමැතිනම් 403 ලබා දෙයි; නියත කාලයෙන් සංසන්දනය කරයි. සෑම POST එකක්ම raw text ලෙස කියවා, යෙදුමේ රහස්‍ය සමඟ X-Hub-Signature-256 නැවත ගණනය කර, නොගැළපීමකට 401 සමඟ ප්‍රතික්ෂේප කර, වහාම Meta වෙත පිළිතුරු දෙයි, පිළිතුරෙන් පසු සිදුවීම හසුරුවයි.

easyCoexistence තමන් forward කරන දේ අත්සන් කරන්නේ කෙසේද?

තමන්ගේම අත්සනකින්, මන්ද Meta හි header එක easyCoexistence හි යෙදුමේ රහස්‍ය සමඟ පමණක් පරීක්ෂා කළ හැකි වන අතර ඉදිරියට යවන්නේ නැත. Endpoint එක සකසා ඇති, සම්බන්ධ කළ Page සඳහා සෑම ඇතුළත් කිරීමක්ම {platform, account_id, external_id, entry} ලෙස JSON මගින් POST කෙරේ, X-EC-Signature header එකක් සමඟ t=<unix>,v1=<hex> ආකාරයෙන්, මෙහි v1 යනු timestamp, dot එක සහ raw body එකේ HMAC-SHA256 වන අතර, එම Page හි අත්සන් රහස්‍යෙන් යතුරු කර ඇත:

  • රහස්‍ය whsec_ වලින් ආරම්භ වන අතර, set_social_webhook_destination හෝ Partner API හි PUT /channels/:id/webhook මගින් එක් වරක් පමණක් පෙන්වයි.
  • URL එක නැවත සැකසීමෙන් නව රහස්‍යක් නිකුත් වන අතර, null URL එකක් forwarding අක්‍රිය කරයි.
  • සෑම forward එකක්ම එක් වරක් යවන අතර, තත්පර 8ක් දක්වා රැඳී, redirect අනුගමනය නොකර, පොදු IP එකට විසඳෙන HTTPS ලිපිනයකට.
  • සිදුවීමේ පිටපතක් තබා නොගන්නා බැවින්, නැවත උත්සාහ කිරීමට කිසිවක් නැත.

X-EC-Signature සත්‍යාපනය කරන්නේ කෙසේද?

header එක t සහ v1 ලෙස බෙදා, විනාඩි 5කට වඩා පැරණි කාලමුද්‍රාවක් ප්‍රතික්ෂේප කර, t, dot සහ raw body මත HMAC එක Page හි අත්සන් රහස්‍යෙන් නැවත ගණනය කර, නියත කාලයෙන් සංසන්දනය කරන්න. Node.js හි, body එක raw bytes ලෙස තබාගෙන:

Node.js: checking X-EC-Signature on a forwarded event
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
});

සාමාන්‍ය වැරදි

  • hub.challenge JSON හෝ quotes වලින් ඔතා ගැනීම. 200 body එක challenge අගයම විය යුතුය.
  • JSON parser එකෙන් පසු HMAC ගණනය කිරීම. Parse කර නැවත serialize කිරීම bytes වෙනස් කරන අතර, Meta payload එක Unicode escape කළ ආකාරයට අත්සන් කරන බැවින්, raw body එක hash කරන්න.
  • පිළිතුරු දීමට පෙර වැඩ කිරීම. Messenger තත්පර 5ක් ඇතුළත 200 බලාපොරොත්තු වන අතර, පැයක අසාර්ථකත්වයකින් යෙදුම Page එකෙන් unsubscribe වේ.
  • Forward කළ සිදුවීම් මත Meta අත්සන පරීක්ෂා කිරීම. Meta easyCoexistence හි යෙදුමේ රහස්‍යෙන් අත්සන් කරයි; forward කළ සිදුවීමක X-EC-Signature ඇති අතර, එය Page හි අත්සන් රහස්‍යෙන් පරීක්ෂා කරන්න.
EasyCoexistence සමඟ මෙය කිරීම

සම්බන්ධතාවයකට මාසිකව US$ 9 සිට US$ 0.75 දක්වා, සම්බන්ධතා එකතු කරන විට අඩුවෙමින්, පළමු දින 3 නොමිලේ trial කාලය සමඟ.

නිතර අසන ප්‍රශ්න

verify_token එක කොහෙන් ලැබේද?

ඔබම එය තෝරා ගනී. එය dashboard එකේ webhook සකසන විට Verify Token ක්ෂේත්‍රයට ඇතුළත් කරන string එකයි, හෝ /{app-id}/subscriptions වෙත යවන verify_token එකයි.

curl සමඟ සත්‍යාපනය පරීක්ෂා කළ හැකිද?

ඔව්. Meta හි Messenger මාර්ගෝපදේශය hub.verify_token, hub.challenge=CHALLENGE_ACCEPTED සහ hub.mode=subscribe සමඟ GET එකක් යවයි, ක්‍රියාත්මක endpoint එකක් CHALLENGE_ACCEPTED ලෙස පිළිතුරු දෙයි.

endpoint එක පැයක් අසාර්ථක වුවහොත් කුමක් වේද?

Meta Webhooks Disabled අනතුරු ඇඟවීමක් යවා යෙදුම Page එකෙන් unsubscribe කරයි. Endpoint එක නිවැරදි කිරීමෙන් පසු, subscribed_apps හරහා Page එක නැවත subscribe කරන්න.

Page එකක webhooks ලබා ගැනීමට මගේම Meta යෙදුමක් අවශ්‍යද?

easyCoexistence සමඟ නැත. Meta එහි යෙදුමට delivery කරයි, එය සකසන ලද endpoint එකට සෑම Page එකකම සිදුවීම් forward කරයි, X-EC-Signature සමඟ අත්සන් කර.

තවදුරටත් කියවන්න

Facebook Page එකක් webhooks වෙත දායක කිරීම: subscribed_apps edgePOST /{page-id}/subscribed_apps මගින් Facebook Page එකක් webhook fields වෙත දායක කරන ආකාරය: tokens, tasks සහ යෙදුම් මට්ටමේ දායකත්වය.Facebook Page webhook එකේ fields: සම්පූර්ණ ලැයිස්තුවMeta ලේඛනගත Facebook Page webhook එකේ fields 64: feed, mention, messages වැනි Messenger fields, profile fields, සහ ඒ සෑමකට අවශ්‍ය permission.Facebook Page සඳහා Messenger webhook: පණිවිඩ සහ mention සිදුවීම්Messenger පණිවිඩ සහ mentions සඳහා Facebook Page webhook fields: payload හැඩය, sender IDs, attachments සහ events ඔබේ endpoint එකට එන ආකාරය.Facebook Page feed webhook: comment, post සහ reaction සිදුවීම්Facebook Page feed webhook එක comment, post සහ reaction සඳහා යවන දේ, item සහ verb fields, Meta payload ආකෘතිය සහ Page subscribe කිරීම.Facebook Page access token: කොපමණ කාලයක් පවතීද සහ කුමක් එය අවලංගු කරයිදදිගු කාලීන Facebook Page access token එකක් ලබා ගන්නේ කෙසේද, කාටද එය ලබා ගත හැකිද සහ Meta එය පිළිගැනීම නවත්වන්නේ කුමක් නිසාද.

ඔබේ පළමු channel එක මිනිත්තු දෙකකින් සම්බන්ධ කරන්න.

වේදිකා සමාලෝචන සඳහා බලා සිටීමට අවශ්‍ය නැත. WhatsApp, Instagram, TikTok හෝ වෙනත් channel එකක් සම්බන්ධ කර, පසුව ඔබේ AI හට පළ කිරීමට, ප්‍රතිචාර දැක්වීමට හෝ වාර්තා කිරීමට පවසා එය වැඩ කරන ආකාරය බලන්න.

  • දින 3ක් නොමිලේ
  • ඕනෑම වේලාවක අවලංගු කරන්න
  • නිල API පමණි
  • 24/7 නිරීක්ෂණය කෙරේ

සත්‍යාපනය කළේ