तुमच्या ग्राहकांचे WhatsApp मेसेज आणि सोशल कमेंट्स वेबहुकद्वारे मिळवा
प्रत्येक कनेक्शनला easyCoexistence च्या Partner API द्वारे तुमच्या ग्राहकांच्या WhatsApp मेसेजेस किंवा सोशल कमेंट्ससाठी स्वतंत्र वेबहुक मिळतो. WhatsApp मेसेजेस Meta कडून थेट त्या यूआरएलवर पाठवले जातात, आणि ते Tech Provider ॲपच्या गुप्त कीने सही केलेले असतात, तुमच्याकडे असलेल्या कीने नाही. त्यामुळे यूआरएल पथामधील एक लांब, यादृच्छिक गुप्त की त्यांची पडताळणी करते. Instagram आणि Facebook वरील कमेंट्स व DM, तसेच TikTok वरील कमेंट्स, येताच पुढे पाठवल्या जातात, आणि प्रत्येक खात्याच्या X-EC-Signature ने सही केलेल्या असतात.
पर्यायी कॉलबॅक यूआरएलची Meta ने ठरवलेली कमाल लांबी, जो नंबरचे मेसेज तुमच्या एंडपॉइंटकडे पाठवतो.
Meta किती वेळ, कमी होत जाणाऱ्या वारंवारतेने, तुमच्या एंडपॉइंटने स्वीकारला नाही अशा WhatsApp वेबहुकचे पुन्हा प्रयत्न करते, आणि त्यामुळे डुप्लिकेट येऊ शकतात.
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 यूआरएल द्या ज्याच्या पथात एक लांब, यादृच्छिक गुप्त की असेल, सोबत verify token द्या: कनेक्ट सेशनवर webhook_verify_token (8 ते 200 अक्षरे) किंवा PUT वर verify_token. Meta लगेच यूआरएल तपासते, hub.mode=subscribe, hub.verify_token आणि hub.challenge सह GET पाठवून; टोकन जुळल्यास तुमच्या एंडपॉइंटने hub.challenge चे मूल्य परत करणे आवश्यक आहे. ही हँडशेक अयशस्वी झाल्यास PUT 502 meta_rejected परत करतो, Meta च्या स्वतःच्या संदेशासह. कनेक्ट सेशनवर नंबर तरीही कनेक्ट होतो, आणि सेशनचा last_error सांगतो की यूआरएल का लागू झाला नाही.
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 ने सही करतो, जो पेलोडचा HMAC-SHA256 असतो आणि तो प्राप्त करणाऱ्या ॲपच्या App Secret ने की केलेला असतो. तुमच्या ग्राहकांच्या नंबरांसाठी ते ॲप easyCoexistence चे Tech Provider ॲप आहे, आणि त्याची गुप्त की कधीही शेअर केली जात नाही, त्यामुळे तुमच्या बाजूने हे हेडर तपासता येत नाही. त्याऐवजी प्रमाणीकरणाचा आधार URL पथातील लांब, यादृच्छिक गुप्त की आहे: ती स्थिर वेळेत तुलना करा आणि बाकी सर्व नाकारा. दुसरा स्तर म्हणून Meta च्या AS32934 वर नोंदवलेले मार्ग allowlist करा आणि ती यादी अद्ययावत ठेवा, कारण Meta वेळोवेळी त्याचे IP पत्ते बदलते.
कोणते WhatsApp वेबहुक तुमच्या यूआरएलपर्यंत पोहोचतात?
Meta पर्यायी कॉलबॅक यूआरएल ज्या फील्ड्स वाहून नेऊ देतो ते: messages, जे ग्राहक पाठवतात आणि तुम्ही पाठवलेल्या मेसेजची स्थिती यासाठी; smb_message_echoes, जे व्यवसाय WhatsApp Business ॲपमधून पाठवतो त्यासाठी; आणि एकवेळच्या आयातीचे 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 जसा आहे तसाच असतो, कमेंट्स व मेन्शन्ससाठी changes आणि DM साठी messaging सह. TikTok साठी त्यात comment.update इव्हेंट त्याच्या पार्स केलेल्या सामग्रीसह असतो, आणि comment_id, video_id व parent_comment_id स्ट्रिंग म्हणून असतात, त्यामुळे 64-bit ID ची अचूकता टिकते.
- Instagram खाती कमेंट्स, मेसेज आणि मेन्शन्सची सदस्यता घेतात; Facebook Pages फीड, मेसेज आणि मेन्शन्सची; TikTok comment.update पाठवतो.
- easyCoexistence ला YouTube किंवा LinkedIn कडून कोणतेही कमेंट इव्हेंट मिळत नाहीत: त्यांचा PUT 400
not_supportedपरत करतो, आणि त्यांच्या कमेंट्स प्रत्येक नेटवर्कच्या एपीय द्वारे क्रेडेन्शियल्ससह वाचल्या जातात. - फॉरवर्डमध्ये 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, हेक्स डायजेस्ट.
- 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 च्या ॲपपर्यंत पोहोचतात, पण त्यातील एकही तुमच्यासाठी ठेवला जात नाही. ट्रॅफिकची गरज भासण्यापूर्वी प्रत्येक गंतव्य सेट करा.
कनेक्शन ड्रॉप झाल्यावर किंवा काढल्यावर गंतव्याचे काय होते?
नंबर त्याचे गंतव्य नोंदीत ठेवतो. ड्रॉप झालेला नंबर पुन्हा कनेक्ट झाल्यावर 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 कच्च्या बॉडीचा प्रत्येक बाइट कव्हर करतो, आणि ती पुन्हा सीरियलाइज केल्यास बाइट्स बदलतात, म्हणून पार्स करण्यापूर्वी पडताळा.
- सर्व चॅनेलसाठी एकच गुप्त की वापरणे. प्रत्येक सोशल खाते स्वतःच्या गुप्त कीने सही करते, आणि स्टेटस इव्हेंट दुसऱ्या कीने, म्हणून account_id वरून गुप्त की शोधा.
- फॉरवर्ड केलेल्या इव्हेंटला उत्तर देण्यापूर्वी संथ काम करणे. तो एकदाच पाठवला जातो, तुमच्या उत्तराची 8 सेकंद वाट पाहतो आणि कधीही पुन्हा प्रयत्न होत नाही, म्हणून आधी 2xx द्या आणि नंतर प्रक्रिया करा.
easyCoexistence प्रत्येक ग्राहक नंबरचे मेसेज Meta कडून थेट तुमच्या सर्व्हरकडे पाठवते आणि Instagram आणि Facebook वरील कमेंट्स व DM, तसेच TikTok वरील कमेंट्स, येताच प्रत्येक खात्यासाठी सही करून तुमच्या एंडपॉइंटकडे पाठवते. कोणतीही प्रत ठेवली जात नाही आणि प्रत्येक कनेक्शनचे 24/7 निरीक्षण केले जाते. प्रति कनेक्शन प्रति महिना 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 परत करतो. त्यांच्या कमेंट्स प्रत्येक नेटवर्कच्या एपीय द्वारे चॅनेलच्या क्रेडेन्शियल्ससह वाचा.
माझा सर्व्हर बंद असेल तर फॉरवर्ड केलेले सोशल इव्हेंट पुन्हा पाठवले जातात का?
नाही. प्रत्येक इव्हेंट एकदाच पाठवला जातो आणि त्याची प्रत ठेवली जात नाही. WhatsApp डिलिव्हरी वेगळ्या आहेत, कारण Meta स्वतः त्या 7 दिवसांपर्यंत पुन्हा पाठवतो.
मेसेज easyCoexistence मधून जातात का?
WhatsApp वर नाही: Meta नंबरचे मेसेज तुम्ही सेट केलेल्या वेबहुकवर थेट पाठवतो. सोशल नेटवर्क्सवरील कमेंट्स आणि DM येताच, प्रत्येक खात्यासाठी सही करून, कोणतीही प्रत न ठेवता तुमच्या एंडपॉइंटकडे फॉरवर्ड केले जातात.
पुढे वाचा
तुमचे पहिले चॅनेल दोन मिनिटांत कनेक्ट करा.
कोणत्याही प्लॅटफॉर्म पुनरावलोकनाची वाट पाहावी लागत नाही. WhatsApp, Instagram, TikTok किंवा दुसरे चॅनेल कनेक्ट करा, मग तुमच्या AI ला पोस्ट करायला, उत्तर द्यायला किंवा रिपोर्ट द्यायला सांगा आणि ते काम करताना पाहा.
- 3 दिवस मोफत
- कधीही रद्द करा
- फक्त अधिकृत एपीआय
- 24/7 देखरेख
पडताळले: