WhatsApp मेसेज तुमच्या सर्व्हरपर्यंत कसे पोहोचतात: थेट की व्यवस्थापित, आणि स्वाक्षरीची पडताळणी
easyCoexistence द्वारे जोडलेल्या प्रत्येक नंबरला एक इनबाउंड मोड असतो. थेट तुमच्या सिस्टमवर (थेट): Meta आपले वेबहुक तुमच्या HTTPS एंडपॉइंटवर पाठवते, यूआरएलमधील गुप्त कोड हेच ओळखपत्र आहे आणि ऑटोमेशन बंद असतात. easyCoexistence द्वारे (व्यवस्थापित): Meta easyCoexistence कडे पोहोचवते, ऑटोमेशन उत्तर देऊ शकतात आणि पर्यायी फॉरवर्ड यूआरएलला कनेक्शनच्या तपशिलांसह Meta चे मूळ मूल्य मिळते, जे X-EC-Signature ने स्वाक्षरीकृत असते आणि तुम्ही पडताळायचे असते.
प्रत्येक फॉरवर्ड केलेल्या डिलिव्हरीसाठी प्रयत्न, 1 मिनिट, 5 मिनिटे, 30 मिनिटे, 2 तास, 6 तास आणि 24 तास अंतराने, एकूण सुमारे 33 तास.
प्रत्येक फॉरवर्ड प्रयत्न 2xx प्रतिसादासाठी किती वेळ थांबतो, त्यानंतर तो अयशस्वी मानला जातो.
स्वाक्षरीच्या t च्या वयावरील सुचवलेली मर्यादा; पुन्हा प्रयत्नही पुन्हा स्वाक्षरीकृत होतात, म्हणून खऱ्या डिलिव्हरी त्या मर्यादेत राहतात.
Meta थेट वेबहुकला HTTP 200 व्यतिरिक्त काहीही मिळाल्यास किती काळ पुन्हा प्रयत्न करते, आणि त्यामुळे मेसेज पुन्हा येऊ शकतात.
Meta पाठवणारा सर्वात मोठा वेबहुक पेलोड, history तुकड्यांसह.
व्यवस्थापित नंबरसाठी रन लॉग ठेवले जातात, त्यात मेसेज आणि प्रतिसाद मजकूर असतो; मेसेज मजकूर स्वतः 30, 90 किंवा 365 दिवस ठेवला जातो, तुमच्या निवडीनुसार.
थेट आणि व्यवस्थापित यामध्ये काय फरक आहे?
Meta नंबरचे मेसेज वेबहुक कुठे पाठवते ते ठरवते. व्यवस्थापित, ज्याला easyCoexistence द्वारे असे दाखवले जाते, त्यात Meta easyCoexistence कडे पाठवते, जे Meta ची स्वाक्षरी तपासते, तुमचे ऑटोमेशन चालवते, संभाषणांसाठी चॅट्स ठेवते आणि फॉरवर्ड यूआरएल ठेवल्यास प्रत्येक Meta बदल तुमच्याकडे, फक्त तुमच्याकडे असलेल्या गुप्त कोडने स्वाक्षरीकृत करून पाठवते. थेट, ज्याला तुमच्या सिस्टमवर थेट असे दाखवले जाते, त्यात easyCoexistence तुमचा HTTPS एंडपॉइंट नंबरच्या WhatsApp Business Account वर वेबहुक ओव्हरराइड म्हणून सेट करते, त्यामुळे Meta थेट तुम्हाला पाठवते आणि मेसेज easyCoexistence पर्यंत कधीच पोहोचत नाहीत.
मॉनिटरिंगमागील ऑपरेशनल वेबहुक, जसे की account_update आणि गुणवत्ता बदल, दोन्ही पद्धतींत easyCoexistence कडेच राहतात, म्हणून अलर्ट कोणत्याही पद्धतीत चालू राहतात.
| Managed: Through easyCoexistence | Direct: Straight to your system | |
|---|---|---|
| Meta delivers to | easyCoexistence, which verifies Meta's signature | Your HTTPS endpoint |
| Automations | Run on the number | Off |
| Your copy | Optional Forward URL, one Meta change per POST | Meta's envelope, unchanged |
| Proof it is genuine | X-EC-Signature, HMAC-SHA256 with the number's secret | A long random secret in the URL path |
| Failed deliveries | 7 attempts over about 33 hours | Meta retries for up to 7 days |
| History import | Not requested | Requested when saved within 24 hours of connecting |
| Kept by easyCoexistence | Message text 30, 90 or 365 days, run logs 30 days | Nothing |
नंबर दोन पद्धतींत कसा बदलायचा?
नंबरच्या पानावर, इनकमिंग मेसेज कुठे जातात कार्डात मोड दोन पर्याय म्हणून दिसतो: easyCoexistence द्वारे आणि थेट तुमच्या सिस्टमवर. इनकमिंग मेसेज तुमच्या स्वतःच्या वेबहुककडे पाठवा कार्डात किंवा set_webhook_destination ने वेबहुक गंतव्य जतन केल्यास नंबर थेट होतो. easyCoexistence द्वारे निवडल्यावर ते गंतव्य Meta वरून लगेच काढले जाते, त्यामुळे फॉरवर्ड यूआरएल म्हणून तीच यूआरएल जोडा म्हणजे मेसेज मिळत राहतील. नंबर व्यवस्थापित मोड सोडतो तेव्हा रांगेतील फॉरवर्ड टाकले जातात, आणि वेबहुक यूआरएलशिवाय जोडलेले नंबर व्यवस्थापित मोडमध्ये सुरू होतात.
तुमच्या AI कडून set_inbound_mode एकाच कॉलमध्ये मोड बदलते आणि फॉरवर्ड सेट करते, आणि फॉरवर्ड गुप्त कोड फक्त एकदाच परत देते:
// set_inbound_mode arguments
{
"connection_id": "3f2a9c1e-7b4d-4e8a-9c2f-1a2b3c4d5e6f",
"mode": "managed",
"forward_url": "https://agent.example.com/ec/forward"
}
// result: forward_secret is shown once
{
"connection_id": "3f2a9c1e-7b4d-4e8a-9c2f-1a2b3c4d5e6f",
"mode": "managed",
"forward_url": "https://agent.example.com/ec/forward",
"forward_secret": "whsec_Qm9vbXRoZXNlY3JldHNhcmVmYWtlMTIz",
"secret_note": "Shown once. Verify X-EC-Signature: t=<unix>,v1=<hex HMAC-SHA256 of \"<t>.<raw body>\"> with it; the body's value is Meta's original payload.",
"direct_destination": null
}फॉरवर्ड केलेल्या POST मध्ये काय असते?
प्रत्येक POST मध्ये एक Meta बदल असतो, Meta च्या object, entry आणि changes लिफाफ्यात गुंडाळलेला नाही. id ही डिलिव्हरी आयडी आहे, ती X-EC-Delivery मध्ये पुनरावृत्त होते आणि पुन्हा प्रयत्नांत स्थिर राहते. event हे Meta फील्डचे नाव आहे: messages, smb_message_echoes, history किंवा smb_app_state_sync, ते X-EC-Event मध्ये पुनरावृत्त होते. received_at म्हणजे easyCoexistence ला Meta कडून बदल मिळाल्याची वेळ, connection नंबर ओळखतो आणि value हे Meta ने पाठवलेले अगदी तसेच मूल्य आहे, त्यामुळे Meta च्या पेलोडसाठी लिहिलेला पार्सिंग कोड यावर चालतो. डिलिव्हरी स्टेटस messages इव्हेंटच्या आत value.statuses खाली येतात.
POST /ec/forward HTTP/1.1
Content-Type: application/json
User-Agent: easyCoexistence-forward/1
X-EC-Event: messages
X-EC-Delivery: 8c1d7e52-0f4b-4a3e-9d61-2b7f5a9e0c13
X-EC-Signature: t=1794405732,v1=<64 hex characters>
{
"id": "8c1d7e52-0f4b-4a3e-9d61-2b7f5a9e0c13",
"event": "messages",
"received_at": "2026-11-11T14:02:11.482Z",
"connection": {
"id": "3f2a9c1e-7b4d-4e8a-9c2f-1a2b3c4d5e6f",
"phone": "+1 631-555-0142",
"phone_number_id": "106540352242922",
"waba_id": "102290129340398",
"external_ref": null
},
"value": {
"messaging_product": "whatsapp",
"metadata": { "display_phone_number": "16315550142", "phone_number_id": "106540352242922" },
"contacts": [{ "profile": { "name": "Ana Souza" }, "wa_id": "5511987654321", "user_id": "BR.13491208655302741918" }],
"messages": [{
"from": "5511987654321",
"from_user_id": "BR.13491208655302741918",
"id": "wamid.HBgNNTUxMTk4NzY1NDMyMRUCABIYFjNFQjBDNzE4RjQ2QjI5RDkxQTNFAA==",
"timestamp": "1794405731",
"type": "text",
"text": { "body": "Do you deliver on Sundays?" }
}]
}
}Node.js मध्ये X-EC-Signature ची पडताळणी कशी करायची?
हेडर t=<unix seconds>,v1=<64 hex characters> असा वाचा. तुमच्या घड्याळापासून 5 मिनिटांपेक्षा जास्त दूर असलेला t नाकारा, t, एक ठिपका आणि मूळ बॉडीवर HMAC-SHA256 काढा, की म्हणून संपूर्ण फॉरवर्ड गुप्त कोड UTF-8 मजकूर म्हणून वापरा आणि परिणामाची v1 शी स्थिर वेळेत तुलना करा. मगच JSON पार्स करा. 10 सेकंदांच्या आत 2xx द्या आणि काम नंतर करा, आणि स्वीकारलेले डिलिव्हरी आयडी लक्षात ठेवा, जेणेकरून पुन्हा प्रयत्न दोनदा प्रक्रिया होणार नाही.
// forward-receiver.mjs: node forward-receiver.mjs (no dependencies)
import crypto from "node:crypto";
import http from "node:http";
const SECRET = process.env.EC_FORWARD_SECRET; // the whole whsec_... string is the HMAC key
const taken = new Set(); // delivery ids already accepted: use a database in production
export function verifyEcSignature(raw, header, secret = SECRET, maxAgeSec = 300) {
const m = /^t=(\d+),v1=([0-9a-f]{64})$/.exec(String(header ?? "").trim());
if (!m || !secret) return false;
if (Math.abs(Math.floor(Date.now() / 1000) - Number(m[1])) > maxAgeSec) return false;
const mac = crypto.createHmac("sha256", secret).update(`${m[1]}.`).update(raw).digest();
return crypto.timingSafeEqual(mac, Buffer.from(m[2], "hex"));
}
http.createServer((req, res) => {
const chunks = [];
req.on("data", (c) => chunks.push(c));
req.on("end", () => {
const raw = Buffer.concat(chunks);
if (req.method !== "POST" || !verifyEcSignature(raw, req.headers["x-ec-signature"])) {
res.writeHead(401).end();
return;
}
res.writeHead(200).end(); // a 2xx within 10 s, before any work
const d = JSON.parse(raw.toString("utf8"));
if (taken.has(d.id)) return; // a retry of a delivery already accepted
taken.add(d.id);
// d.event is the Meta field (messages, smb_message_echoes, history, smb_app_state_sync)
// d.value is Meta's change value, unchanged; queue it for your worker here.
console.log(d.event, d.connection.phone_number_id, Object.keys(d.value));
});
}).listen(process.env.PORT ?? 3000);Python मध्ये कशी पडताळणी करायची?
तेच चार तपास standard library ने: हेडरसाठी कडक पॅटर्न, t चे वय, t, ठिपका आणि मूळ बाइट्सवर hmac.new, आणि hmac.compare_digest. FastAPI मध्ये मूळ बॉडी await request.body() मधून येते, आणि 200 पाठवल्यानंतर BackgroundTasks काम चालवते. Flask मध्ये request.get_data() वापरा, आणि बॉडी json.dumps ने कधीच पुन्हा बांधू नका, कारण Python चे डीफॉल्ट सेपरेटर स्पेस घालतात आणि स्वाक्षरी जुळत नाही.
# forward_receiver.py: pip install fastapi uvicorn, then uvicorn forward_receiver:app
import hashlib, hmac, json, os, re, time
from fastapi import BackgroundTasks, FastAPI, Request, Response
app = FastAPI()
SECRET = os.environ["EC_FORWARD_SECRET"].encode() # the whole whsec_... string, as bytes
SIGNATURE = re.compile(r"t=([0-9]+),v1=([0-9a-f]{64})")
taken = set() # delivery ids already accepted: use a database in production
def verify_ec_signature(raw: bytes, header: str, max_age: int = 300) -> bool:
m = SIGNATURE.fullmatch(header.strip())
if not m or abs(int(time.time()) - int(m[1])) > max_age:
return False
mac = hmac.new(SECRET, m[1].encode() + b"." + raw, hashlib.sha256).hexdigest()
return hmac.compare_digest(mac, m[2])
def process(delivery: dict) -> None:
if delivery["id"] in taken: # a retry of a delivery already accepted
return
taken.add(delivery["id"])
print(delivery["event"], delivery["connection"]["phone_number_id"], list(delivery["value"]))
@app.post("/ec/forward")
async def forward(request: Request, tasks: BackgroundTasks):
raw = await request.body()
if not verify_ec_signature(raw, request.headers.get("x-ec-signature", "")):
return Response(status_code=401)
tasks.add_task(process, json.loads(raw)) # runs after the 200 goes out
return Response(status_code=200)अयशस्वी डिलिव्हरी पुन्हा कशा प्रयत्न केल्या जातात?
फॉरवर्ड डिलिव्हरी झाली असे तेव्हा मानले जाते जेव्हा तुमचा एंडपॉइंट 10 सेकंदांच्या आत कोणताही 2xx प्रतिसाद देतो. इतर काहीही, टाइमआउट, 4xx, 5xx किंवा रीडायरेक्ट (जो फॉलो केला जात नाही), पुढील प्रयत्न सुमारे 1 मिनिट, 5 मिनिटे, 30 मिनिटे, 2 तास, 6 तास आणि 24 तासांनी शेड्यूल करते, आणि सातव्या प्रयत्नानंतर डिलिव्हरी सोडली जाते. प्रत्येक प्रयत्न नवीन t सह पुन्हा स्वाक्षरीकृत होतो, आणि यूआरएल सार्वजनिक HTTPS असणे आवश्यक आहे, ते सेव्ह करताना आणि प्रत्येक पाठवण्यापूर्वी पुन्हा तपासले जाते. डिलिव्हरी सर्वात जुन्या आधी जातात, पण पुन्हा प्रयत्न केलेली डिलिव्हरी नवीनांनंतर पोहोचू शकते, म्हणून Meta च्या टाइमस्टॅम्पनुसार क्रम लावा.
थेट डेस्टिनेशनवर पुन्हा प्रयत्न Meta करते: HTTP 200 व्यतिरिक्त काहीही 7 दिवसांपर्यंत कमी होत जाणाऱ्या वारंवारतेने पुन्हा प्रयत्न केले जाते, आणि त्या पुन्हा प्रयत्नांमुळे मेसेज पुन्हा येऊ शकतात. दोन्ही पद्धतींत Meta च्या मेसेज आयडीवर डुप्लिकेट काढा, कारण Meta ने पुन्हा पाठवलेला बदल नव्या डिलिव्हरी आयडीसह पुन्हा फॉरवर्ड होतो.
थेट एंडपॉइंटला POST खरा आहे हे कसे कळते?
X-Hub-Signature-256 वरून नाही. Meta सबस्क्रिप्शनची मालकी असलेल्या ॲपच्या ॲप गुप्त कोडने स्वाक्षरी करते, जो येथे जोडलेल्या नंबरसाठी easyCoexistence चा आहे आणि शेअर केलेला नाही, त्यामुळे तो हेडर तुमच्या Meta ॲप गुप्त कोडने तपासल्यास खरे डिलिव्हरी नाकारले जातात. पडताळणी टोकन फक्त Meta च्या GET हँडशेक दरम्यान एंडपॉइंट सिद्ध करतो. त्याऐवजी हे काम करते:
- कॉलबॅक यूआरएल पाथमध्ये 32 किंवा अधिक यादृच्छिक अक्षरे ठेवा आणि त्याशिवायच्या विनंत्या नाकारा; बदलण्यासाठी नवीन यूआरएल सेव्ह करा.
- सामान्य रिसीव्हर वापरा, जसे की n8n चा वेबहुक नोड, WhatsApp ट्रिगर नाही, जो तुमचे स्वतःचे Meta ॲप अपेक्षित करतो.
- नंबरच्या टोकनने Meta कडून मीडिया आयडीनुसार डाउनलोड करा, त्यामुळे बनावट आयडी फक्त अपयशी ठरतो.
- स्वतः होस्ट केलेल्या सर्व्हरवर, पर्यायाने फक्त Meta चे नेटवर्क, म्हणजे AS32934 ने जाहीर केलेले मार्ग, परवानगी द्या.
- किंवा फॉरवर्ड यूआरएलसह व्यवस्थापित मोडवर जा, जिथे X-EC-Signature प्रत्येक POST सिद्ध करतो.
सामान्य चुका
- Meta च्या लिफाफ्यासाठी लिहिलेला कोड बदल न करता फॉरवर्ड यूआरएलकडे पाठवणे. फॉरवर्डमध्ये एक बदल असतो: event आणि value वाचा, object, entry आणि changes नाही.
- X-EC-Event चे statuses येण्याची वाट पाहणे. डिलिव्हरी स्टेटस messages इव्हेंटच्या आत, value.statuses मध्ये येतात, आणि ॲपमध्ये टाइप केलेली उत्तरे smb_message_echoes म्हणून येतात.
- उत्तर देण्यापूर्वी काम करणे. फॉरवर्ड 10 सेकंद थांबते, मग तीच डिलिव्हरी नवीन t सह परत येते; आधी 2xx द्या आणि रांगेतून प्रक्रिया करा.
- व्यवस्थापितवर स्विच करून जुनी यूआरएल अजूनही मिळेल असे गृहीत धरणे. थेट डेस्टिनेशन त्याक्षणी काढले जाते; त्याच set_inbound_mode कॉलमध्ये forward_url पाठवा.
easyCoexistence Coexistence द्वारे WhatsApp Business ॲप नंबर Meta चा Cloud API ला जोडते आणि प्रत्येक नंबरसाठी त्याचे मेसेज कुठे जातात ते तुम्ही निवडता: थेट Meta कडून तुमच्या सर्व्हरवर, किंवा easyCoexistence मार्गे, जेणेकरून ऑटोमेशन उत्तर देऊ शकतील आणि स्वाक्षरीकृत प्रत तुमच्या फॉरवर्ड यूआरएलवर पोहोचेल. मॉनिटरिंग आणि अलर्ट दोन्ही पद्धतींत चालतात. US$ 9 ते US$ 0.75 प्रति नंबर, प्रति महिना, नंबर वाढवल्यावर कमी होत जाते, पहिले 3 दिवस मोफत.
वारंवार विचारले जाणारे प्रश्न
ऑटोमेशनने दिलेले उत्तर माझ्या सर्व्हरला दिसेल का?
मजकूर नाही. Meta एपीआयने पाठवलेल्या मेसेजना स्टेटस म्हणून (sent, delivered, read) messages इव्हेंटमध्ये मेसेज आयडीसह कळवते; मजकूर स्वतः ऑटोमेशनच्या रन लॉगमध्ये असतो, जो Runs टॅबमध्ये 30 दिवस ठेवला जातो, आणि संभाषणांमध्ये तुम्ही निवडलेल्या कालावधीसाठी.
फॉरवर्ड गुप्त कोड कसा बदलायचा?
नंबरच्या पानावर नवीन गुप्त कोड क्लिक करा, किंवा rotate_secret सेट करून true वर set_inbound_mode कॉल करा. नवीन गुप्त कोड एकदाच दाखवला जातो आणि तेव्हापासून सर्वकाही स्वाक्षरीकृत करतो, जुन्या डिलिव्हरीचे पुन्हा प्रयत्नही, म्हणून तुमचा सर्व्हर लगेच अपडेट करा.
फॉरवर्ड यूआरएलला Meta च्या GET हँडशेकची गरज आहे का?
नाही. फक्त थेट डेस्टिनेशनला Meta कॉल करते आणि hub.challenge परत पाठवावा लागतो. फॉरवर्ड यूआरएलला easyCoexistence कॉल करते आणि फक्त स्वाक्षरीकृत POST मिळतात.
एका नंबरला एकाच वेळी थेट डेस्टिनेशन आणि फॉरवर्ड यूआरएल असू शकते का?
नाही. फॉरवर्ड यूआरएल फक्त नंबर व्यवस्थापित असतानाच चालते, आणि थेट डेस्टिनेशन जतन केल्यास नंबर थेट होतो. फॉरवर्ड यूआरएल आणि त्याचा गुप्त कोड जतन राहतात, त्यामुळे व्यवस्थापितवर परत गेल्यास फॉरवर्डिंग पुन्हा सुरू होते.
पुढे वाचा
सुरुवात करण्यासाठी तयार आहात?
WhatsApp Coexistence काही मिनिटांत सेट करा, काही महिन्यांत नाही. ॲप फोनवर काम करत राहते.
मोफत ट्रायल सुरू करापडताळले: