පාරිභෝගිකයින්ගේ WhatsApp පණිවිඩ සහ comment webhook එක හරහා ලබා ගන්නේ කෙසේද
සෑම සම්බන්ධතාවයකටම easyCoexistence හි Partner API හරහා ඔබේ පාරිභෝගිකයින්ගේ WhatsApp පණිවිඩ හෝ සමාජ comment සඳහා තනි webhook එකක් ලැබේ. WhatsApp පණිවිඩ Meta වෙතින් කෙලින්ම එම URL එකට යයි, ඔබ දරන එකක් නොව Tech Provider යෙදුමේ රහස්ය යතුරෙන් අත්සන් කර. එබැවින් URL මාර්ගයේ ඇති දිගු, අහඹු රහස්ය යතුර ඒවා සත්යාපනය කරයි. Instagram සහ Facebook comment සහ DM, සහ TikTok comment, පැමිණෙන විට ම යවනු ලැබේ, සෑම ගිණුමකටම වෙනම X-EC-Signature සමඟ අත්සන් කර.
Meta විසින් නියම කළ උපරිම දිග, අංකයේ පණිවිඩ ඔබේ endpoint එකට යවන විකල්ප callback URL එකට.
ඔබේ endpoint පිළිනොගත් WhatsApp webhook එකක් Meta නැවත උත්සාහ කරන කාලය, වාර ගණන අඩු වෙමින්; එයින් අනුපිටපත් ඇති විය හැක.
Meta ජාලය; whois මාර්ග සෙවීම්වල ලැයිස්තුගත වන්නේ WhatsApp webhook පැමිණෙන ලිපින වන අතර, Meta ඒවා කලින් කල් වෙනස් කරයි.
Meta අනුව WhatsApp webhook payload එකක උපරිම ප්රමාණය.
ආපසු යවන සිදුවීමක අත්සන් කළ කාල මුද්රාව ප්රතික්ෂේප කළ යුතු වයස, HMAC නියත කාලයෙන් සංසන්දනය කර.
සෑම සම්බන්ධතාවයකටම තමන්ගේම ගමනාන්තය ලැබෙන්නේ කෙසේද?
සම්පතකට එක් ඇමතුමකිනි. WhatsApp අංකයකට url සහ verify_token සහිතව PUT /connections/{id}/webhook ලබා ගනී, නැතහොත් එම යුගලය connect session එකේ webhook_url සහ webhook_verify_token ලෙස ලබා ගනී, එවිට අංකය පළමු මිනිත්තුවේ සිට ඔබ වෙත යොමු වේ. සමාජ ගිණුමක් සම්බන්ධ වූ පසු PUT /channels/{id}/webhook ලබා ගනී. කුමන හෝ එකක url එක null නම් බෙදාහැරීම නවතී. මාර්ග දෙක වෙනස් වන්නේ කවුරු බෙදා හරින්නේද සහ ඔබ සත්යාපනය කරන ආකාරයද අනුවයි:
| WhatsApp number | Instagram, Facebook, TikTok | |
|---|---|---|
| Set with | webhook_url on the session, or PUT /connections/{id}/webhook | PUT /channels/{id}/webhook, after it connects |
| Delivered by | Meta, straight to your URL | easyCoexistence, forwarding each event as it arrives |
| Body | Meta's webhook, unchanged | platform, account_id, external_id and the network's entry |
| Authenticate | A long random secret in the URL path | X-EC-Signature, keyed with the account's secret |
| Retries | Meta's own, for up to 7 days | None: one attempt |
| Copy kept | None | None |
අංකයේ පණිවිඩ ඔබේ endpoint එකට කෙසේ යොමු කරන්නද?
දිගු, අහඹු රහස්ය යතුරක් අඩංගු HTTPS URL එකක් සහ verify token එකක් දෙන්න: connect session එකේ webhook_verify_token (අක්ෂර 8 සිට 200 දක්වා), නැතහොත් PUT එකේ verify_token. Meta URL එක වහාම පරීක්ෂා කරන්නේ hub.mode=subscribe, hub.verify_token සහ hub.challenge සහිත GET එකකිනි, token එක ගැලපුණු විට ඔබේ endpoint එක hub.challenge අගයෙන් පිළිතුරු දිය යුතුයි. සම්බන්ධ වීමේ පරීක්ෂාව අසාර්ථක වුවහොත් PUT එක 502 meta_rejected ලබා දෙයි, Meta හි තමන්ගේම පණිවිඩය සමඟ; connect session එකක් මත අංකය තවමත් සම්බන්ධ වේ, සහ session එකේ last_error හේතුව පැහැදිලි කරයි URL එක යෙදුණේ නැත්තේ ඇයිද කියා.
import express from "express";
import { timingSafeEqual } from "node:crypto";
const PATH_SECRET = process.env.WA_PATH_SECRET; // the random part of webhook_url
const VERIFY_TOKEN = process.env.WA_VERIFY_TOKEN; // the verify token you sent
const app = express();
function same(a, b) {
const x = Buffer.from(String(a)), y = Buffer.from(String(b));
return x.length === y.length && timingSafeEqual(x, y);
}
// Meta's handshake, run when the destination is set
app.get("/wa/:secret", (req, res) => {
if (!same(req.params.secret, PATH_SECRET)) return res.sendStatus(404);
if (req.query["hub.mode"] !== "subscribe" || !same(req.query["hub.verify_token"], VERIFY_TOKEN)) {
return res.sendStatus(403);
}
res.send(req.query["hub.challenge"]);
});
// Messages, echoes and the one-time import; payloads reach 3 MB
app.post("/wa/:secret", express.json({ limit: "4mb" }), (req, res) => {
if (!same(req.params.secret, PATH_SECRET)) return res.sendStatus(404);
res.sendStatus(200); // answer first: Meta retries for up to 7 days
enqueue(req.body); // deduplicate on each message id before acting
});ඔබට Meta හි අත්සන පරීක්ෂා කළ නොහැක්කේ ඇයි, එයට වෙනුවට කුමක්ද?
Meta සෑම බෙදාහැරීමක්ම X-Hub-Signature-256 සමඟ අත්සන් කරයි: ලබන යෙදුමේ App Secret සමඟ යතුරු කළ payload එකේ HMAC-SHA256. ඔබේ පාරිභෝගිකයින්ගේ අංක සඳහා එම යෙදුම easyCoexistence හි Tech Provider යෙදුමයි, එහි රහස්ය යතුර කිසි විටෙක බෙදා නොගන්නා බැවින්, ශීර්ෂය ඔබේ පැත්තෙන් සත්යාපනය කළ නොහැක. ඒ වෙනුවට URL මාර්ගයේ ඇති දිගු, අහඹු රහස්ය යතුර අක්තපත්රය වේ: එය නියත කාලයෙන් සංසන්දනය කර වෙනත් ඕනෑම දෙයක් ප්රතික්ෂේප කරන්න. දෙවන ස්ථරයක් ලෙස, Meta හි AS32934 වෙත ලියාපදිංචි මාර්ග සුදු ලැයිස්තුගත කර, එම ලැයිස්තුව නවීකරණය කරන්න, මන්ද Meta එහි IP ලිපින කලින් කල් වෙනස් කරයි.
කුමන WhatsApp webhook ඔබේ URL එකට ළඟා වේද?
Meta විකල්ප callback URL එකකට ගෙන යාමට ඉඩ දෙන ක්ෂේත්ර: පාරිභෝගිකයින් යවන දෙය සහ ඔබ යවන දෙයේ තත්ත්වය සඳහා messages; WhatsApp Business යෙදුමෙන් ව්යාපාරය යවන දෙය සඳහා smb_message_echoes; සහ එකවාර ආනයනයේ history සහ smb_app_state_sync. Meta කිසි විටෙක template webhook හෝ account_update වැනි ගිණුම් webhook override එකකට යවන්නේ නැත. ඒවා ඒ වෙනුවට easyCoexistence හි callback එකට ළඟා වන නිසා, template අනුමැතිය poll කිරීමෙන් කියවන අතර, අත්හැරීමක් status එකක් ලෙස ඔබ වෙත පැමිණේ.
- ගමනාන්තය WhatsApp Business Account එක මත සකසා ඇත, එබැවින් එක් ගිණුමක අංක දෙකක් එය බෙදා ගනී: value.metadata.
phone_number_idමත මාර්ගගත කරන්න. - මාධ්ය ID එකක් ලෙස පැමිණේ; ගොනුව Meta වෙතින් පාරිභෝගිකයාගේ token එකෙන් credentials call එකෙන් ලබා ගන්න.
- Payloads 3 MB දක්වා විය හැකි බැවින්, ඊට පහළින් සකසා ඇති ඕනෑම body-size සීමාවක් වැඩි කරන්න.
ආපසු යවන ලද සමාජ සිදුවීමක් කෙසේ පෙනේද?
Content-Type application/json සහ X-EC-Signature ශීර්ෂය සහිත POST එකක්, යතුරු හතරක් සහිතව: platform; account_id, Partner API එක භාවිතා කරන channel ID එක; external_id, ජාලයේ ගිණුමේ ID එක; සහ entry. Instagram සහ Facebook සඳහා, entry යනු Meta හි webhook entry එක එලෙසම ය, comment සහ mention සඳහා changes සමඟ සහ DM සඳහා messaging සමඟ. TikTok සඳහා එහි comment.update සිදුවීම එහි අන්තර්ගතය විග්රහ කර ඇති ආකාරයෙන්, සහ comment_id, video_id සහ parent_comment_id string ලෙස, එම නිසා 64-bit ID රවුම් නොවේ.
- Instagram ගිණුම් comments, messages සහ mentions වෙත දායක වේ; Facebook Pages feed, messages සහ mention වෙත; TikTok comment.update යවයි.
- easyCoexistence YouTube හෝ LinkedIn වලින් comment සිදුවීම් ලබන්නේ නැත: ඒවායේ PUT 400
not_supportedලෙස ප්රතිචාරය දෙයි, සහ ඒවායේ comment ඒ ඒ ජාලයේ API හරහා credentials සමඟ කියවයි. - ආපසු යැවීම්වලට X-EC-Event හෝ X-EC-Delivery ශීර්ෂයක් නොමැත, එබැවින් ජාලයේම ID මත අනුපිටපත් ඉවත් කරන්න, comment ID හෝ පණිවිඩයේ mid වැනි.
{
"platform": "instagram",
"account_id": "<CHANNEL_ID>",
"external_id": "<INSTAGRAM_ACCOUNT_ID>",
"entry": {
"id": "<INSTAGRAM_ACCOUNT_ID>",
"time": 1793440800,
"changes": [
{
"field": "comments",
"value": {
"id": "<COMMENT_ID>",
"from": { "id": "<INSTAGRAM_SCOPED_ID>", "username": "<USERNAME>" },
"text": "<COMMENT_TEXT>",
"media": { "id": "<MEDIA_ID>", "media_product_type": "<MEDIA_PRODUCT_TYPE>" }
}
}
]
}
}X-EC-Signature සත්යාපනය කරන්නේ පියවරෙන් පියවර කෙසේද?
PUT /channels/{id}/webhook විසින් ලබා දුන් signing_secret සමඟ, එය එක් වරක් පමණක් පෙන්වන අතර එම ගිණුමට සුවිශේෂී වේ. ශීර්ෂය t=<unix>,v1=<hex> ලෙස කියවේ. ඉන්පසු, එක් එක් බෙදාහැරීම සඳහා:
- JSON විග්රහ කිරීමට පෙර, අමු ඉල්ලීම් body එක bytes ලෙස කියවන්න.
- ශීර්ෂය comma මත බෙදා t, Unix කාලය තත්පරවලින්, සහ v1, hex digest එක ලෙස වෙන් කරන්න.
- t ඔබේ ඔරලෝසුවෙන් මිනිත්තු 5 කට වඩා දුරින් නම් බෙදාහැරීම ප්රතික්ෂේප කරන්න.
- t, තිත සහ අමු body එක මත HMAC-SHA256 ගණනය කරන්න, එම ගිණුමේ රහස්ය යතුරෙන් යතුරු කර, hex ලෙස.
- v1 සමඟ නියත කාලයෙන් සංසන්දනය කර, ඉන්පසු 2xx පිළිතුරු දී කාර්යය පෝලිමට දමන්න.
import express from "express";
import { createHmac, timingSafeEqual } from "node:crypto";
const app = express();
const secrets = new Map(); // channel id -> signing_secret, kept in your database
app.post("/hooks/social", express.raw({ type: "application/json" }), (req, res) => {
const sig = Object.fromEntries(
(req.get("X-EC-Signature") ?? "").split(",").map((part) => part.split("=", 2)),
);
if (!/^\d+$/.test(sig.t ?? "") || Math.abs(Date.now() / 1000 - Number(sig.t)) > 300) {
return res.sendStatus(401); // missing or stale timestamp
}
let event;
try {
event = JSON.parse(req.body.toString("utf8")); // platform, account_id, external_id, entry
} catch {
return res.sendStatus(400);
}
const secret = secrets.get(event.account_id);
if (!secret || !sig.v1) return res.sendStatus(401);
const expected = createHmac("sha256", secret)
.update(sig.t + ".")
.update(req.body) // the raw bytes, exactly as they arrived
.digest("hex");
if (expected.length !== sig.v1.length ||
!timingSafeEqual(Buffer.from(expected), Buffer.from(sig.v1))) {
return res.sendStatus(401);
}
res.sendStatus(204); // one attempt and no retries: acknowledge, then work
enqueue(event);
});ගමනාන්තයක් සකසා නැති විට කුමක් වේද?
කිසිවක් ඔබ වෙත පැමිණෙන්නේ නැත, පසුව යැවීමට බලා සිටින දෙයක් ද නැත. webhook_url නැති අංකයක් easyCoexistence හි callback එකට fallback වේ, එහිදී එහි පණිවිඩ ගබඩා නොකර ඉවත් කෙරේ, සහ එයට chat history ආනයනයක් ලැබෙන්නේ නැත, එය ගමනාන්තයක් පවතින තෙක් ඉල්ලා නොමැති නිසා. ගමනාන්තයක් නැති සමාජ ගිණුමක් ආපසු යවන්නේ නැත: එහි සිදුවීම් තවමත් easyCoexistence හි යෙදුමට ළඟා වේ, නමුත් ඔබ වෙනුවෙන් කිසිවක් රඳවා නොගනී. ගමනාන්ත එක් එක් ගමනාගමනය අවශ්ය වීමට පෙර සකසන්න.
සම්බන්ධතාවයක් විසන්ධි වූ හෝ ඉවත් කළ විට ගමනාන්තයට කුමක් වේද?
අංකයක් එහි ගමනාන්තය වාර්තාවේ තබා ගනී. විසන්ධි වූ අංකයක් නැවත සම්බන්ධ වූ විට, easyCoexistence Meta සමඟ ඔබේ URL නැවත සකසයි, අත්හිටුවූ අංකයක් ආපසු ආ විටද එසේමයි. සමාජ ගිණුමක් ඉවත් කිරීම එහි ගමනාන්තය සහ රහස්ය යතුර මකා දමයි, එබැවින් එය නැවත සම්බන්ධ වූ පසු, PUT /channels/{id}/webhook නැවත ඇමතා නව රහස්ය යතුර ගබඩා කරන්න. එම PUT එක URL එකක් සමඟ ඇමතූ සෑම විටම නව රහස්ය යතුරක් නිකුත් කරන අතර, පැරණි එක වහාම අත්සන් කිරීම නවතී.
එය සකසන ආකාරය
- Put a secret in the URLChoose an HTTPS URL whose path holds a long random string, 200 characters or fewer in all, and make its GET answer Meta's hub.challenge.
- Route the number's messagesSend webhook_url and webhook_verify_token on the connect session, or PUT /connections/{id}/webhook once the number is connected.
- Turn on each social accountCall PUT /channels/{id}/webhook with your URL and store the signing_secret it returns against that channel.
- Verify, then acknowledgeCheck the path secret on WhatsApp deliveries and X-EC-Signature on forwarded ones, answer 2xx at once, then process from a queue.
සාමාන්ය වැරදි
- ඔබේ පාරිභෝගිකයින්ගේ WhatsApp බෙදාහැරීම් මත X-Hub-Signature-256 පරීක්ෂා කිරීම. Meta එය easyCoexistence හි යෙදුම් රහස්ය යතුරෙන් ගණනය කරයි, එය කිසි විටෙක බෙදා නොගනී, එබැවින් පරීක්ෂාව කිසි විටෙක සමත් විය නොහැක; URL මාර්ගයේ ඇති රහස්ය යතුරෙන් සත්යාපනය කරන්න.
- X-EC-Signature JSON විග්රහ කිරීමෙන් පසු සත්යාපනය කිරීම. HMAC අමු body එක byte අනුව byte ආවරණය කරයි, එය නැවත serialise කිරීම bytes වෙනස් කරයි, එබැවින් විග්රහ කිරීමට පෙර සත්යාපනය කරන්න.
- සෑම ගිණුමකටම එක රහස්ය යතුරක් භාවිතා කිරීම. සෑම සමාජ ගිණුමක්ම එහි තමන්ගේම රහස්ය යතුරෙන් අත්සන් කරන අතර, status සිදුවීම් තවත් එකකින්, එබැවින් රහස්ය යතුර account_id අනුව සොයන්න.
- ආපසු යවන ලද සිදුවීමකට පිළිතුරු දීමට පෙර මන්දගාමී වැඩ කිරීම. එය වරක් යවන අතර, ඔබේ පිළිතුර සඳහා තත්පර 8ක් රැඳී සිටියි, කිසි විටෙක නැවත උත්සාහ නොකෙරේ, එබැවින් පළමුව 2xx පිළිතුරු දී පසුව ක්රියාවලිය කරන්න.
easyCoexistence සෑම පාරිභෝගික අංකයක පණිවිඩ Meta වෙතින් කෙලින්ම ඔබේ server එකට යොමු කරයි, සහ Instagram සහ Facebook comment සහ DM, සහ TikTok comment, පැමිණෙන විට ඔබේ endpoint එකට ආපසු යවයි, සෑම ගිණුමකටම වෙනම අත්සන් කර, කිසිදු පිටපතක් නොතබා, සෑම සම්බන්ධතාවයක්ම 24/7 නිරීක්ෂණය කරමින්. සම්බන්ධතාවයකට මාසිකව US$ 9 සිට US$ 0.75 දක්වා, ඔබ සම්බන්ධතා එකතු කරන විට පහත වැටේ, පළමු දින 3 නොමිලේ.
නිතර අසන ප්රශ්න
ඔබේ පාරිභෝගිකයින්ගේ WhatsApp පණිවිඩ මත Meta හි අත්සන සත්යාපනය කළ හැකිද?
නැත. Meta ඒවා අත්සන් කරන්නේ easyCoexistence හි Tech Provider යෙදුමේ රහස්ය යතුරෙනි, එය කිසි විටෙක බෙදා නොගනී. ඔබේ URL මාර්ගයේ ඇති දිගු, අහඹු රහස්ය යතුරෙන් සත්යාපනය කරන්න, සහ විකල්පයක් ලෙස Meta හි IP පරාසයන්.
YouTube සහ LinkedIn සම්බන්ධතා comment සිදුවීම් ආපසු යවන්නේද?
නැත. easyCoexistence එම දෙකෙන් කිසිවකින් comment සිදුවීම් ලබන්නේ නැත, එබැවින් PUT /channels/{id}/webhook 400 not_supported ලෙස ප්රතිචාරය දෙයි. ඒවායේ comment කියවන්න එක් එක් ජාලයේ API හරහා, channel හි credentials සමඟ.
මගේ server බිඳ වැටී ඇත්නම් ආපසු යවන ලද සමාජ සිදුවීම් නැවත උත්සාහ කරනවාද?
නැත. එක් එකක් වරක් යවන අතර කිසිදු පිටපතක් තබා නොගනී. WhatsApp බෙදාහැරීම් වෙනස්, මන්ද Meta ම ඒවා දින 7 ක් දක්වා නැවත උත්සාහ කරයි.
පණිවිඩ easyCoexistence හරහා යනවාද?
WhatsApp හි නොවේ: Meta අංකයක පණිවිඩ ඔබ සකසූ webhook එකට කෙලින්ම බෙදා හරියි. සමාජ ජාලවලින් comment සහ DM පැමිණෙන විට, එක් එක් ගිණුමට වෙනම අත්සන් කර, කිසිදු පිටපතක් නොතබා, ඔබේ endpoint එකට ආපසු යවයි.
තවදුරටත් කියවන්න
ඔබේ පළමු channel එක මිනිත්තු දෙකකින් සම්බන්ධ කරන්න.
වේදිකා සමාලෝචන සඳහා බලා සිටීමට අවශ්ය නැත. WhatsApp, Instagram, TikTok හෝ වෙනත් channel එකක් සම්බන්ධ කර, පසුව ඔබේ AI හට පළ කිරීමට, ප්රතිචාර දැක්වීමට හෝ වාර්තා කිරීමට පවසා එය වැඩ කරන ආකාරය බලන්න.
- දින 3ක් නොමිලේ
- ඕනෑම වේලාවක අවලංගු කරන්න
- නිල API පමණි
- 24/7 නිරීක්ෂණය කෙරේ
සත්යාපනය කළේ