உங்கள் வாடிக்கையாளர்களின் WhatsApp மெசேஜ்களையும் சமூக ஊடகக் கருத்துகளையும் வெப்ஹூக் மூலம் பெறுவது எப்படி
ஒவ்வொரு இணைப்பிற்கும் Partner API வழியாக வாடிக்கையாளர்களின் WhatsApp மெசேஜ்கள் அல்லது சமூக ஊடகக் கருத்துகளுக்கென தனி வெப்ஹூக் கிடைக்கும். WhatsApp மெசேஜ்கள் Meta-விலிருந்து அந்த URL-க்கு நேரடியாக அனுப்பப்படும்; அவை உங்களிடம் உள்ள ரகசியத்தால் அல்ல, Tech Provider ஆப்பின் ரகசியத்தால் கையொப்பமிடப்படுகின்றன. எனவே URL பாதையில் உள்ள நீண்ட, சீரற்ற ரகசியமே அவற்றை அங்கீகரிக்கிறது. Instagram மற்றும் Facebook கருத்துகள், DM-கள், மற்றும் TikTok கருத்துகள் வரும்போதே அனுப்பப்படும்; ஒவ்வொரு கணக்கின் X-EC-Signature கொண்டு கையொப்பமிடப்படும்.
easyCoexistence வாடிக்கையாளரின் ஒவ்வொரு எண்ணின் மெசேஜ்களையும் Meta-விலிருந்து நேரடியாக உங்கள் சர்வருக்குத் திசைதிருப்புகிறது; Instagram மற்றும் Facebook கருத்துகள், DM-கள், TikTok கருத்துகள் ஆகியவற்றை வரும்போதே உங்கள் எண்ட்பாயிண்டிற்கு அனுப்புகிறது, ஒவ்வொரு கணக்கின் கையொப்பத்துடன், எந்த நகலும் வைக்கப்படாமல், ஒவ்வொரு இணைப்பும் 24/7 கண்காணிக்கப்படுகிறது.
ஒரு எண்ணின் மெசேஜ்களை உங்கள் எண்ட்பாயிண்டிற்கு அனுப்பும் மாற்று கால்பேக் URL-க்கு Meta-வின் அதிகபட்ச நீளம்.
உங்கள் எண்ட்பாயிண்ட் ஏற்காத WhatsApp வெப்ஹூக்கை Meta எத்தனை நேரம் மீண்டும் முயற்சிக்கிறது, குறைந்து வரும் அதிர்வெண்ணில்; இது நகல்களை உருவாக்கலாம்.
Meta-வின் நெட்வொர்க்; அதற்கான whois வழித் தேடல்கள் WhatsApp வெப்ஹூக்குகள் வரும் முகவரிகளைப் பட்டியலிடுகின்றன, Meta அவற்றை அவ்வப்போது மாற்றுகிறது.
Meta-வின் கூற்றுப்படி WhatsApp வெப்ஹூக் பேலோடின் அதிகபட்ச அளவு.
அனுப்பப்பட்ட நிகழ்வின் கையொப்பமிடப்பட்ட நேர முத்திரை எத்தனை நேரத்திற்குப் பிறகு நிராகரிக்கப்பட வேண்டும், HMAC நிலையான நேரத்தில் ஒப்பிடப்படுகிறது.
ஒவ்வொரு இணைப்பும் தனி இலக்கை எவ்வாறு பெறுகிறது?
ஒவ்வொரு வளத்திற்கும் ஒரு அழைப்பின் மூலம். WhatsApp எண்ணுக்கு PUT /connections/{id}/webhook, url மற்றும் verify_token உடன்; அல்லது அதன் 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 |
எண்ணின் மெசேஜ்களை உங்கள் எண்ட்பாயிண்டிற்கு எவ்வாறு திருப்புவது?
நீண்ட சீரற்ற ரகசியத்தைக் கொண்ட HTTPS URL பாதையையும், ஒரு verify டோக்கனையும் கொடுங்கள்: connect session-இல் webhook_verify_token (8 முதல் 200 எழுத்துகள்), அல்லது PUT-இல் verify_token. Meta உடனே hub.mode=subscribe, hub.verify_token மற்றும் hub.challenge கொண்ட GET மூலம் URL-ஐச் சரிபார்க்கும்; டோக்கன் பொருந்தினால் உங்கள் எண்ட்பாயிண்ட் 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 கொண்டு பேலோட்டின் HMAC-SHA256. உங்கள் வாடிக்கையாளர்களின் எண்களுக்கு அந்த ஆப் easyCoexistence-இன் Tech Provider ஆப்; அதன் ரகசியம் பகிரப்படுவதில்லை, எனவே உங்கள் பக்கத்தில் அந்தத் தலைப்பைச் சரிபார்க்க முடியாது. அதற்குப் பதில் URL பாதையில் உள்ள நீண்ட சீரற்ற ரகசியமே அடையாளச் சான்று: அதை நிலையான நேரத்தில் ஒப்பிட்டு, மற்றதை மறுக்கவும். இரண்டாம் அடுக்காக, Meta-வின் AS32934-க்குப் பதிவான வழிகளை அனுமதிப்பட்டியலிட்டு அந்தப் பட்டியலைப் புதுப்பிக்கவும்; Meta அதன் IP முகவரிகளை அவ்வப்போது மாற்றுகிறது.
எந்த WhatsApp வெப்ஹூக்குகள் உங்கள் URL-ஐ அடையும்?
Meta ஒரு மாற்று கால்பேக் URL-க்கு அனுப்ப அனுமதிக்கும் புலங்கள்: messages, வாடிக்கையாளர் அனுப்புவதற்கும் நீங்கள் அனுப்பியதன் ஸ்டேட்டஸுக்கும்; smb_message_echoes, WhatsApp Business ஆப்பிலிருந்து வணிகம் அனுப்புவதற்கு; மற்றும் ஒரு முறை இறக்குமதியின் history மற்றும் smb_app_state_sync. Meta ஒருபோதும் டெம்ப்ளேட் வெப்ஹூக்குகளையோ account_update போன்ற கணக்கு வெப்ஹூக்குகளையோ மாற்று URL-க்கு அனுப்பாது. அவை easyCoexistence-இன் கால்பேக்குக்குச் செல்கின்றன; அதனால்தான் டெம்ப்ளேட் மதிப்பாய்வு polling மூலம் படிக்கப்படுகிறது, மேலும் நிராகரிப்பு ஸ்டேட்டஸ் நிகழ்வாக உங்களை வந்தடைகிறது.
- இலக்கு WhatsApp Business Account-இல் அமைக்கப்படுகிறது, எனவே ஒரே கணக்கில் உள்ள இரு எண்கள் அதைப் பகிர்கின்றன: value.metadata.
phone_number_id-இன் அடிப்படையில் திசைதிருப்புங்கள். - மீடியா ஒரு ID-ஆக வரும்; credentials அழைப்பிலிருந்து பெற்ற வாடிக்கையாளரின் டோக்கன் மூலம் Meta-விடமிருந்து கோப்பைப் பெறுங்கள்.
- பேலோட்கள் 3 MB வரை வரலாம்; அதற்குக் கீழே அமைக்கப்பட்ட எந்த கோரிக்கை body அளவு வரம்பையும் உயர்த்துங்கள்.
பகிரப்பட்ட சமூக நிகழ்வு எவ்வாறு தோன்றுகிறது?
Content-Type application/json மற்றும் X-EC-Signature தலைப்புடன் ஒரு POST, நான்கு விசைகள் கொண்டு: platform; account_id, Partner API பயன்படுத்தும் சேனல் ID; external_id, நெட்வொர்க்கில் கணக்கின் ID; மற்றும் entry. Instagram மற்றும் Facebook-க்கு, entry என்பது Meta-வின் வெப்ஹூக் entry மாறாமல்; கருத்துகள் மற்றும் குறிப்புகளுக்கு changes, DM-களுக்கு messaging. TikTok-க்கு அதில் comment.update நிகழ்வு உள்ளது, அதன் content பகுப்பாய்வு செய்யப்பட்டு, comment_id, video_id மற்றும் parent_comment_id ஆகியவை சரங்களாக (strings) உள்ளன; எனவே 64-bit ID-கள் வட்டமிடப்படுவதில்லை.
- Instagram கணக்குகள் comments, messages மற்றும் mentions-க்கு பதிவு செய்யப்பட்டுள்ளன; Facebook Pages feed, messages மற்றும் mention-க்கு; TikTok comment.update அனுப்புகிறது.
- easyCoexistence YouTube அல்லது LinkedIn-இலிருந்து கருத்து நிகழ்வுகளைப் பெறாது: அவற்றின் PUT 400
not_supportedபதிலளிக்கும்; அவற்றின் கருத்துகள் ஒவ்வொரு நெட்வொர்க்கின் API வழியாக credentials-உடன் படிக்கப்படும். - அனுப்பப்பட்ட நிகழ்வுகளில் X-EC-Event அல்லது X-EC-Delivery தலைப்பு இல்லை; எனவே நெட்வொர்க்கின் சொந்த ID-களான கருத்து ID அல்லது message 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> என்று இருக்கும். ஒவ்வொரு டெலிவரிக்கும்:
- கோரிக்கையின் raw body-ஐ JSON பகுப்பாய்வுக்கு முன், bytes-ஆகப் படியுங்கள்.
- தலைப்பை கமாக்களில் பிரித்து t-ஐ (Unix நேரம், வினாடிகளில்) மற்றும் v1-ஐ (hex digest) பெறுங்கள்.
- t உங்கள் கடிகாரத்திலிருந்து 5 நிமிடத்திற்கு மேல் வேறுபட்டால் டெலிவரியை நிராகரியுங்கள்.
- t, ஒரு புள்ளி மற்றும் raw 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-இன் கால்பேக்குக்குத் திரும்பும், அங்கே அதன் மெசேஜ்கள் சேமிக்கப்படாமல் நீக்கப்படும்; chat history இறக்குமதியும் கிடைக்காது, ஏனெனில் அது ஒரு இலக்கு இருந்தால் மட்டுமே கோரப்படும். இலக்கு இல்லாத சமூகக் கணக்கு அனுப்பப்படுவதில்லை: அதன் நிகழ்வுகள் easyCoexistence-இன் ஆப்பை அடையும், ஆனால் உங்களுக்காக எதுவும் வைக்கப்படாது. தேவைப்படுவதற்கு முன் ஒவ்வொரு இலக்கையும் அமைத்துக் கொள்ளுங்கள்.
இணைப்பு துண்டிக்கப்பட்டாலோ அல்லது நீக்கப்பட்டாலோ இலக்குக்கு என்ன ஆகும்?
ஒரு எண் தன் இலக்கை பதிவில் வைத்திருக்கும். துண்டிக்கப்பட்ட எண் மீண்டும் இணையும்போது, easyCoexistence Meta-வுடன் உங்கள் URL-ஐ மீண்டும் அமைக்கும்; இடைநிறுத்தப்பட்ட எண் திரும்பும்போதும் அதே நடக்கும். ஒரு சமூகக் கணக்கை நீக்கினால் அதன் இலக்கும் ரகசியமும் அழிக்கப்படும்; எனவே அது மீண்டும் இணைந்த பிறகு PUT /channels/{id}/webhook-ஐ மீண்டும் அழைத்து, புதிய ரகசியத்தைச் சேமியுங்கள். URL உடன் அழைக்கப்படும் ஒவ்வொரு PUT-உம் புதிய ரகசியத்தை வழங்கும்; பழையது உடனே கையொப்பமிடுவதை நிறுத்தும்.
இதை எப்படி அமைப்பது
- 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 பாதையில் உள்ள ரகசியத்தைக் கொண்டு அங்கீகரியுங்கள்.
- பகுப்பாய்வு செய்யப்பட்ட JSON மீது X-EC-Signature-ஐ சரிபார்ப்பது. HMAC raw body-ஐ பைட் பைட்டாக உள்ளடக்கும்; அதை மீண்டும் சீரியலைஸ் செய்தால் பைட்டுகள் மாறும், எனவே பகுப்பாய்வுக்கு முன் சரிபாருங்கள்.
- எல்லா சேனல்களுக்கும் ஒரே ரகசியத்தைப் பயன்படுத்துவது. ஒவ்வொரு சமூகக் கணக்கும் தன் சொந்த ரகசியத்தாலும், ஸ்டேட்டஸ் நிகழ்வுகள் வேறொன்றாலும் கையொப்பமிடுகின்றன; எனவே account_id மூலம் ரகசியத்தைத் தேடுங்கள்.
- அனுப்பப்பட்ட நிகழ்வுக்குப் பதிலளிக்கும் முன் மெதுவான வேலை செய்வது. அது ஒருமுறை மட்டுமே அனுப்பப்படும், உங்கள் பதிலுக்காக 8 வினாடிகள் காத்திருக்கும், ஒருபோதும் மீண்டும் முயற்சிக்கப்படாது; எனவே முதலில் 2xx பதிலளித்து பின்னர் செயலாக்குங்கள்.
ஒரு இணைப்புக்கு மாதம் US$ 9 முதல் US$ 0.75 வரை, இணைப்புகள் கூடும்போது குறைகிறது; முதல் 3 நாட்கள் இலவசம்.
அடிக்கடி கேட்கப்படும் கேள்விகள்
உங்கள் வாடிக்கையாளர்களின் WhatsApp மெசேஜ்களில் Meta-வின் கையொப்பத்தை சரிபார்க்க முடியுமா?
முடியாது. Meta அவற்றை easyCoexistence-இன் Tech Provider ஆப்பின் ரகசியத்தால் கையொப்பமிடுகிறது, அது ஒருபோதும் பகிரப்படுவதில்லை. உங்கள் URL பாதையில் உள்ள நீண்ட சீரற்ற ரகசியத்தைக் கொண்டு அங்கீகரியுங்கள்; விருப்பமாக Meta-வின் IP வரம்புகளையும் பயன்படுத்தலாம்.
YouTube மற்றும் LinkedIn இணைப்புகள் கருத்து நிகழ்வுகளை அனுப்புமா?
இல்லை. easyCoexistence இரண்டிலிருந்தும் கருத்து நிகழ்வுகளைப் பெறாது, எனவே PUT /channels/{id}/webhook 400 not_supported பதிலளிக்கும். அவற்றின் கருத்துகளை ஒவ்வொரு நெட்வொர்க்கின் API வழியாக, சேனலின் credentials-உடன் படியுங்கள்.
என் சர்வர் கீழே இருந்தால் அனுப்பப்பட்ட சமூக நிகழ்வுகள் மீண்டும் முயற்சிக்கப்படுமா?
இல்லை. ஒவ்வொன்றும் ஒருமுறை மட்டுமே அனுப்பப்படும், எந்த நகலும் வைக்கப்படாது. WhatsApp டெலிவரிகள் வேறுபடுகின்றன, ஏனெனில் Meta தானே அவற்றை 7 நாட்கள் வரை மீண்டும் முயற்சிக்கிறது.
மெசேஜ்கள் easyCoexistence வழியாகச் செல்லுமா?
WhatsApp-இல் இல்லை: நீங்கள் அமைத்த வெப்ஹூக்குக்கு Meta ஒரு எண்ணின் மெசேஜ்களை நேரடியாக அனுப்புகிறது. சமூக நெட்வொர்க்குகளிலிருந்து வரும் கருத்துகளும் DM-களும் வரும்போதே, ஒவ்வொரு கணக்கின் கையொப்பத்துடன், எந்த நகலும் வைக்கப்படாமல் உங்கள் எண்ட்பாயிண்டிற்கு அனுப்பப்படுகின்றன.
தொடர்ந்து படிக்கவும்
உங்கள் முதல் சேனலை இரண்டு நிமிடங்களில் இணையுங்கள்.
காத்திருக்க வேண்டிய தளச் மதிப்பாய்வுகள் எதுவும் இல்லை. WhatsApp, Instagram, TikTok அல்லது வேறொரு சேனலை இணையுங்கள். பிறகு போஸ்ட் செய்ய, பதிலளிக்க அல்லது ரிப்போர்ட் தர உங்கள் AI-யிடம் கேளுங்கள், அது செயல்படுவதைப் பாருங்கள்.
- 3 நாட்கள் இலவசம்
- எப்போது வேண்டுமானாலும் ரத்து செய்யலாம்
- அதிகாரப்பூர்வ API-கள் மட்டுமே
- 24/7 கண்காணிப்பு
இதில் சரிபார்க்கப்பட்டது: