वेबहुक मार्फत ग्राहकका WhatsApp म्यासेज र सामाजिक कमेन्ट कसरी प्राप्त गर्ने
easyCoexistence को Partner API मार्फत ग्राहकका हरेक WhatsApp नम्बर वा सामाजिक खाताका लागि आफ्नै वेबहुक पाइन्छ। WhatsApp म्यासेज Meta बाट सिधै त्यो URL मा पठाइन्छ, र तपाईंले राखेको सिक्रेटको सट्टा Tech Provider app को सिक्रेटले हस्ताक्षर गरिएको हुन्छ, त्यसैले URL को पथमा रहेको लामो र अनियमित सिक्रेटले तिनलाई प्रमाणित गर्छ। Instagram र Facebook का कमेन्ट र DM, र TikTok का कमेन्ट, आए जस्तै अग्रेषित गरिन्छन्, र प्रत्येक खाताको आफ्नै सिक्रेटले X-EC-Signature सहित हस्ताक्षर गरिएका हुन्छन्।
Meta को अधिकतम लम्बाइ, जुन नम्बरका म्यासेज तपाईंको एन्डपोइन्टमा पठाउने वैकल्पिक कलब्याक यूआरएलको हो।
तपाईंको एन्डपोइन्टले स्वीकार नगरेको WhatsApp वेबहुक Meta ले कति समयसम्म, घट्दो आवृत्तिमा, पुनः प्रयास गर्छ, जसले दोहोरिने म्यासेज सिर्जना गर्न सक्छ।
Meta को नेटवर्क; whois मार्गखोजीमा यसको ठेगाना सूची, जसबाट WhatsApp वेबहुक आउँछन् र जसलाई Meta समय समयमा परिवर्तन गर्छ।
Meta का अनुसार WhatsApp वेबहुक पेलोड अधिकतम कति ठूलो हुन सक्छ।
अग्रेषित इभेन्टको हस्ताक्षरित टाइमस्ट्याम्प कति पुरानो भएपछि अस्वीकार गर्नुपर्छ, र HMAC लाई स्थिर समयमा तुलना गर्दै।
प्रत्येक कनेक्सनले आफ्नै गन्तव्य कसरी पाउँछ?
प्रत्येक स्रोतका लागि एउटा कल गरेर। WhatsApp नम्बरका लागि PUT /connections/{id}/webhook मा url र verify_token पठाउनुहोस्, वा कनेक्ट सेसनमा webhook_url र webhook_verify_token को उही जोडी दिनुहोस्, ताकि नम्बर पहिलो मिनेटदेखि नै तपाईंतिर रुट होस्। सामाजिक खाता जडान भएपछि PUT /channels/{id}/webhook मा url पठाउनुहोस्। दुवैमा 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 token दिनुहोस्: कनेक्ट सेसनमा webhook_verify_token (8 देखि 200 वर्ण) वा PUT मा verify_token। Meta ले तुरुन्तै URL मा hub.mode=subscribe, hub.verify_token र hub.challenge सहितको GET पठाएर जाँच गर्छ, र token मेल खाएमा तपाईंको एन्डपोइन्टले hub.challenge को मान फिर्ता गर्नुपर्छ। यो ह्यान्डसेक असफल भयो भने PUT ले Meta को आफ्नै त्रुटि म्यासेजसहित 502 meta_rejected फर्काउँछ; कनेक्ट सेसनमा नम्बर तैपनि जडान हुन्छ, र सेसनको 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 को App Secret सँग कुञ्जीकृत पेलोडको HMAC-SHA256 हो। तपाईंका ग्राहकका नम्बरका लागि त्यो app easyCoexistence को Tech Provider app हो, र त्यसको सिक्रेट कहिल्यै साझा गरिँदैन; त्यसैले तपाईंको पक्षबाट हेडर प्रमाणित गर्न सकिँदैन। त्यसको सट्टा URL पथमा रहेको लामो र अनियमित सिक्रेट नै प्रमाणीकरणको साधन हो: त्यसलाई स्थिर समयमा तुलना गर्नुहोस् र अरू सबै अस्वीकार गर्नुहोस्। दोस्रो तहको रूपमा, AS32934 मा दर्ता गरिएका मार्गहरू अनुमति सूचीमा राख्नुहोस्, र त्यो सूची ताजा गर्दै रहनुहोस्, किनकि Meta ले आफ्ना IP ठेगाना समय समयमा परिवर्तन गर्छ।
कुन WhatsApp वेबहुकहरू तपाईंको URL मा पुग्छन्?
Meta ले वैकल्पिक कलब्याक URL ले बोक्न दिने फिल्डहरू: messages, जसमा ग्राहकले पठाएका म्यासेज र तपाईंले पठाएका म्यासेजको स्ट्याट्स पर्छन्; smb_message_echoes, जसमा व्यवसायले WhatsApp Business app बाट पठाएको कुरा पर्छ; र एकपटकको इम्पोर्टको history र smb_app_state_sync। Meta ले कहिल्यै टेम्प्लेट वेबहुक, वा account_update जस्ता खाता वेबहुक, ओभरराइडमा पठाउँदैन। ती easyCoexistence को कलब्याकमा जान्छन्, त्यसैले टेम्प्लेट समीक्षा पोलिङमार्फत पढिन्छ, र ड्रप भएको कुरा स्ट्याटस इभेन्टको रूपमा तपाईंसम्म आउँछ।
- गन्तव्य WhatsApp Business Account मा सेट हुन्छ, त्यसैले एउटै खातामा दुई नम्बर उही साझा गर्छन्: value.metadata.
phone_number_idअनुसार रुट गर्नुहोस्। - मिडिया ID को रूपमा आउँछ; क्रेडेन्सियल्स कलबाट ग्राहकको टोकन प्रयोग गरेर Meta बाट फाइल ल्याउनुहोस्।
- पेलोड 3 MB सम्म पुग्न सक्छ, त्यसैले त्योभन्दा कम सेट गरिएको कुनै पनि बडी-साइज सीमा बढाउनुहोस्।
अग्रेषित सामाजिक इभेन्ट कस्तो देखिन्छ?
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 जस्ताको तस्तै हुन्छ, कमेन्ट र mention का लागि changes र DM का लागि messaging सहित। TikTok का लागि यसमा comment.update इभेन्ट हुन्छ, content पार्स गरिएको, र comment_id, video_id र parent_comment_id स्ट्रिङका रूपमा, ताकि 64-bit ID हरू गोलो नहोऊन्।
- Instagram खाता comments, messages र mentions मा सब्सक्राइब हुन्छन्; Facebook Pages feed, messages र mention मा; TikTok ले comment.update पठाउँछ।
- easyCoexistence ले YouTube वा LinkedIn बाट कमेन्ट इभेन्ट प्राप्त गर्दैन: तिनीहरूको PUT ले 400
not_supportedफर्काउँछ, र तिनीहरूका कमेन्ट प्रत्येक नेटवर्कको API मार्फत, क्रेडेन्सियल्सका साथ पढिन्छन्। - अग्रेषित डेलिभरीमा X-EC-Event वा X-EC-Delivery हेडर हुँदैन, त्यसैले नेटवर्कका आफ्नै ID, जस्तै कमेन्ट 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 पार्स गर्नु अघि, कच्चा अनुरोध बडीलाई बाइटको रूपमा पढ्नुहोस्।
- हेडरलाई कमाले छुट्याएर t (Unix समय, सेकेन्डमा) र v1 (hex डाइजेस्ट) मा विभाजन गर्नुहोस्।
- t तपाईंको घडीबाट 5 मिनेटभन्दा बढी टाढा भए डेलिभरी अस्वीकार गर्नुहोस्।
- t, डट र कच्चा बडीको HMAC-SHA256 गणना गर्नुहोस्, त्यस खाताको सिक्रेटले कुञ्जीकृत गरेर, हेक्साडेसिमलमा।
- 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 को कलब्याकमा फर्किन्छ, जहाँ त्यसका म्यासेज भण्डारण नगरी ड्रप हुन्छन्, र त्यसले च्याट इतिहास इम्पोर्ट पाउँदैन, जुन गन्तव्य अस्तित्वमा आएपछि मात्र अनुरोध गरिन्छ। गन्तव्य नभएको सामाजिक खाताको इभेन्ट अग्रेषित हुँदैन: ती easyCoexistence को app मा पुग्छन् तर तपाईंका लागि कुनै पनि राखिँदैन। ट्राफिक आवश्यक हुनुअघि नै प्रत्येक गन्तव्य सेट गर्नुहोस्।
कनेक्सन ड्रप वा हटाइँदा गन्तव्यको के हुन्छ?
नम्बरले आफ्नो गन्तव्य रेकर्डमा राख्छ। ड्रप भएको नम्बर पुनः जडान हुँदा easyCoexistence ले तपाईंको URL Meta सँग फेरि सेट गर्छ, र निलम्बित नम्बर फर्किँदा पनि त्यस्तै हुन्छ। सामाजिक खाता हटाइँदा त्यसको गन्तव्य र सिक्रेट मेटिन्छ, त्यसैले पुनः जडान भएपछि 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 को app सिक्रेटले गणना गर्छ, जुन कहिल्यै साझा गरिँदैन, त्यसैले जाँच पास हुन सक्दैन; URL पथको सिक्रेटसँग प्रमाणीकरण गर्नुहोस्।
- पार्स गरिएको JSON माथि X-EC-Signature प्रमाणित गर्नु। HMAC ले कच्चा बडीको प्रत्येक बाइट समेट्छ, र पुनः सिरियलाइज गर्दा बाइट बदलिन्छन्, त्यसैले पार्स गर्नु अघि प्रमाणित गर्नुहोस्।
- सबै च्यानलका लागि एउटै सिक्रेट प्रयोग गर्नु। प्रत्येक सामाजिक खाताले आफ्नै सिक्रेटले, र स्ट्याटस इभेन्टहरूले फरक सिक्रेटले हस्ताक्षर गर्छन्, त्यसैले account_id अनुसार सिक्रेट खोज्नुहोस्।
- अग्रेषित इभेन्टको जवाफ दिनु अघि ढिलो काम गर्नु। त्यो एकपटक मात्र पठाइन्छ, तपाईंको जवाफको लागि 8 सेकेन्ड पर्खन्छ, र कहिल्यै पुनः प्रयास गरिँदैन, त्यसैले पहिले 2xx फर्काउनुहोस् र पछि प्रशोधन गर्नुहोस्।
easyCoexistence ले प्रत्येक ग्राहकको नम्बरका म्यासेज Meta बाट सिधै तपाईंको सर्भरमा पठाउँछ, र Instagram र Facebook का कमेन्ट र DM, तथा TikTok का कमेन्ट, आए जस्तै तपाईंको एन्डपोइन्टमा अग्रेषित गर्छ, खाता अनुसार हस्ताक्षरित, कुनै प्रति नराखी, र हरेक कनेक्सन 24/7 निगरानीमा राखिन्छ। प्रति कनेक्सन प्रति महिना US$ 9 देखि US$ 0.75 सम्म, कनेक्सन थप्दै जाँदा घट्दै, पहिलो 3 दिन निःशुल्क।
बारम्बार सोधिने प्रश्नहरू
ग्राहकका WhatsApp म्यासेजमा Meta को हस्ताक्षर प्रमाणित गर्न सक्छु?
होइन। Meta ले तिनीहरूमा easyCoexistence को Tech Provider app को सिक्रेटले हस्ताक्षर गर्छ, जुन कहिल्यै साझा गरिँदैन। आफ्नो URL पथमा रहेको लामो र अनियमित सिक्रेटसँग प्रमाणीकरण गर्नुहोस्, र चाहनुभएमा Meta को IP दायरा पनि प्रयोग गर्नुहोस्।
के YouTube र LinkedIn कनेक्सनले कमेन्ट इभेन्ट अग्रेषित गर्छन्?
होइन। easyCoexistence ले कुनैबाट पनि कमेन्ट इभेन्ट प्राप्त गर्दैन, त्यसैले PUT /channels/{id}/webhook ले 400 not_supported फर्काउँछ। तिनीहरूका कमेन्ट प्रत्येक नेटवर्कको API मार्फत, च्यानलको क्रेडेन्सियल्सका साथ पढ्नुहोस्।
के मेरो सर्भर बन्द हुँदा अग्रेषित सामाजिक इभेन्ट फेरि पठाइन्छन्?
होइन। प्रत्येक इभेन्ट एकपटक मात्र पठाइन्छ, र कुनै प्रति राखिँदैन। WhatsApp डेलिभरी फरक हुन्छ, किनकि Meta आफैँले तिनलाई 7 दिनसम्म पुनः प्रयास गर्छ।
के म्यासेज easyCoexistence हुँदै जान्छन्?
WhatsApp मा होइन: Meta ले नम्बरका म्यासेज तपाईंले सेट गरेको वेबहुकमा सिधै पठाउँछ। सामाजिक नेटवर्कका कमेन्ट र DM आए जस्तै तपाईंको एन्डपोइन्टमा अग्रेषित गरिन्छन्, खाता अनुसार हस्ताक्षरित, कुनै प्रति नराखी।
पढ्दै जानुहोस्
दुई मिनेटमै आफ्नो पहिलो च्यानल जडान गर्नुहोस्।
प्लेटफर्मको समीक्षा कुर्नुपर्दैन। WhatsApp, Instagram, TikTok वा अर्को च्यानल जडान गर्नुहोस्, अनि आफ्नो AI लाई पोस्ट गर्न, जवाफ दिन वा रिपोर्ट बनाउन भन्नुहोस् र काम भइरहेको हेर्नुहोस्।
- 3 दिन निःशुल्क
- जुनसुकै बेला रद्द गर्नुहोस्
- आधिकारिक एपीआई मात्र
- 24/7 निगरानी
प्रमाणीकरण गरिएको