WhatsApp म्यासेज तपाईंको सर्भरसम्म कसरी पुग्छन्: डाइरेक्ट वा म्यानेज्ड, र हस्ताक्षर प्रमाणीकरण
easyCoexistence मार्फत जडान गरिएको प्रत्येक नम्बरको एउटा इनबाउन्ड मोड हुन्छ। सिधै तपाईंको प्रणालीमा (डाइरेक्ट): Meta ले आफ्ना वेबहुकहरू तपाईंको HTTPS एन्डपोइन्टमा पठाउँछ, यूआरएलमा रहेको गोप्य कुञ्जी नै प्रमाणपत्र हो, र स्वचालन बन्द हुन्छ। easyCoexistence मार्फत (म्यानेज्ड): Meta ले easyCoexistence मा डेलिभर गर्छ, स्वचालनले जवाफ दिन सक्छ, र वैकल्पिक फर्वार्ड यूआरएलले Meta को मूल मान जडानको विवरणसहित पाउँछ, जुन तपाईंले प्रमाणित गर्न X-EC-Signature ले हस्ताक्षरित गरिएको हुन्छ।
फर्वार्ड गरिएको हरेक डेलिभरीका लागि प्रयासहरू 1 मिनेट, 5 मिनेट, 30 मिनेट, 2 घण्टा, 6 घण्टा र 24 घण्टाको अन्तरमा हुन्छन्, जम्मा करिब 33 घण्टा।
हरेक फर्वार्ड प्रयासले 2xx प्रतिक्रियाको लागि कति समय पर्खन्छ, त्यसपछि मात्र त्यो असफल मानिन्छ।
हस्ताक्षरको t को उमेरमा सिफारिस गरिएको सीमा; पुन: प्रयासहरू फेरि हस्ताक्षरित हुन्छन्, त्यसैले वास्तविक डेलिभरी त्यस सीमाभित्र रहन्छन्।
डाइरेक्ट वेबहुकमा HTTP 200 बाहेक अरू जुनसुकै प्रतिक्रिया आए Meta कति समयसम्म पुन: प्रयास गर्छ, जसले म्यासेज दोहोर्याउन सक्छ।
Meta ले पठाउने सबैभन्दा ठूलो वेबहुक पेलोड, इतिहासका खण्डहरू समेत।
म्यानेज्ड नम्बरका रन लगहरू म्यासेज र जवाफको पाठसहित राखिन्छन्; म्यासेजको पाठ आफैं 30, 90 वा 365 दिनसम्म राखिन्छ, तपाईंको रोजाइअनुसार।
डाइरेक्ट र म्यानेज्ड बीच के फरक छ?
Meta ले नम्बरका म्यासेज वेबहुकहरू कहाँ डेलिभर गर्छ भन्ने कुरा। म्यानेज्ड, जुन easyCoexistence मार्फत भनेर देखाइन्छ, मा Meta ले easyCoexistence मा डेलिभर गर्छ, जसले Meta को हस्ताक्षर जाँच गर्छ, तपाईंका स्वचालन चलाउँछ, Conversations का लागि च्याटहरू राख्छ, र यदि फर्वार्ड यूआरएल सेट गर्नुभयो भने 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 मा त्यो गन्तव्य तुरुन्तै हट्छ, त्यसैले प्राप्त गर्न जारी राख्न त्यही URL लाई फर्वार्ड यूआरएल को रूपमा थप्नुहोस्। म्यानेज्ड मोडबाट नम्बर बाहिरिँदा पर्खिरहेका फर्वार्डहरू हटाइन्छ, र वेबहुक यूआरएल बिना जडान गरिएका नम्बरहरू म्यानेज्डबाट सुरु हुन्छन्।
तपाईंको 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 मा के हुन्छ?
प्रति अनुरोध एउटा Meta परिवर्तन, Meta को object, entry र changes लिफाफाको सट्टा र्यापमा बेरिएको। id डेलिभरी 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 सँग constant time मा तुलना गर्नुहोस्। त्यसपछि मात्र JSON पार्स गर्नुहोस्। 10 सेकेन्डभित्र प्रतिक्रिया दिनुहोस् र काम पछि गर्नुहोस्, र स्वीकार गरिएका डेलिभरी id हरू याद राख्नुहोस्, ताकि पुन: प्रयास दोहोरिएर प्रशोधन नहोस्।
// 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 मा कसरी प्रमाणित गर्ने?
मानक पुस्तकालयसँग समान चार जाँच: हेडरका लागि कडा ढाँचा, 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 को म्यासेज id मा डिडुप्लिकेट गर्नुहोस्, किनभने Meta ले पुन: डेलिभर गरेको परिवर्तन नयाँ डेलिभरी id अन्तर्गत फेरि फर्वार्ड गरिन्छ।
डाइरेक्ट एन्डपोइन्टले POST वास्तविक हो भनेर कसरी थाहा पाउँछ?
X-Hub-Signature-256 बाट होइन। Meta ले सदस्यता रहेको एपको एप गोप्य कुञ्जीले हस्ताक्षर गर्छ, जुन यहाँ जडान गरिएको नम्बरका लागि easyCoexistence को हो र साझा गरिँदैन, त्यसैले तपाईंको आफ्नै Meta एप गोप्य कुञ्जीले त्यो हेडर जाँच्दा वास्तविक डेलिभरी अस्वीकार हुन्छ। verify token ले Meta को GET ह्यान्डसेकको क्रममा मात्र एन्डपोइन्ट प्रमाणित गर्छ। यसको सट्टा काम गर्ने तरिका:
- कलब्याक यूआरएलको पथमा 32 वा बढी अनियमित वर्ण राख्नुहोस्, र तिनीहरू नभएका अनुरोध अस्वीकार गर्नुहोस्; परिवर्तन गर्न नयाँ यूआरएल सुरक्षित गर्नुहोस्।
- तपाईंको आफ्नै Meta एप अपेक्षा गर्ने WhatsApp ट्रिगरको सट्टा n8n वेबहुक नोड जस्तो सामान्य रिसिभर प्रयोग गर्नुहोस्।
- नम्बरको टोकनसहित Meta बाट id द्वारा मिडिया डाउनलोड गर्नुहोस्, ताकि नक्कली id सजिलै असफल होस्।
- आफैले होस्ट गरेका सर्भरमा, इच्छा अनुसार AS32934 ले घोषणा गरेका मार्गहरू, मात्र Meta को नेटवर्कलाई अनुमति दिन सकिन्छ।
- वा फर्वार्ड यूआरएलसहित म्यानेज्डमा स्विच गर्नुहोस्, जहाँ X-EC-Signature ले हरेक POST प्रमाणित गर्छ।
सामान्य गल्तीहरू
- Meta को लिफाफाका लागि लेखिएको कोड फर्वार्ड यूआरएलमा बिना परिवर्तन औंल्याउनु। फर्वार्डमा एउटा मात्र परिवर्तन हुन्छ: object, entry र changes होइन, event र value पढ्नुहोस्।
- X-EC-Event मा statuses आउने पर्खनु। डेलिभरी स्ट्याटस messages घटनाभित्र value.statuses मा आउँछन्, र एपमा टाइप गरिएका जवाफहरू smb_message_echoes को रूपमा आउँछन्।
- प्रतिक्रिया दिनुअघि काम गर्नु। फर्वार्डले 10 सेकेन्ड पर्खन्छ, त्यसपछि उही डेलिभरी नयाँ t सहित फर्किन्छ; पहिले 2xx प्रतिक्रिया दिनुहोस् र क्यूबाट प्रशोधन गर्नुहोस्।
- म्यानेज्डमा स्विच गरेर पुरानो यूआरएलले अझै प्राप्त गर्छ भन्ने मान्नु। त्यो क्षणमा डाइरेक्ट गन्तव्य हटाइन्छ; त्यही set_inbound_mode कलमा forward_url पास गर्नुहोस्।
easyCoexistence ले WhatsApp Business एप नम्बरलाई Coexistence मार्फत Meta को Cloud API सँग जोड्छ, र प्रति नम्बर तपाईंका म्यासेजहरू कहाँ जान्छन् भन्ने छनोट गर्न दिन्छ: Meta बाट सिधै तपाईंको सर्भरमा, वा easyCoexistence मार्फत, ताकि स्वचालनले जवाफ दिन सकोस् र हस्ताक्षरित प्रति तपाईंको फर्वार्ड यूआरएलमा पुगोस्। मनिटरिङ र अलर्टहरू दुवै मोडमा काम गर्छन्। प्रति नम्बर प्रति महिना US$ 9 देखि US$ 0.75 सम्म, नम्बर थपिँदै जाँदा घट्दै, पहिलो 3 दिन निःशुल्क।
बारम्बार सोधिने प्रश्नहरू
स्वचालनले के जवाफ दियो भन्ने कुरा मेरो सर्भरले देख्छ?
पाठ होइन। API बाट पठाइएका म्यासेजहरूलाई Meta ले messages घटनाभित्र म्यासेज id सहित स्ट्याटस (sent, delivered, read) को रूपमा रिपोर्ट गर्छ; पाठ आफैं स्वचालनको रन लगमा हुन्छ, जुन Runs ट्याबमा 30 दिन राखिन्छ, र Conversations मा तपाईंले रोजेको अवधिसम्म।
फर्वार्ड गोप्य कुञ्जी कसरी परिवर्तन गर्ने?
नम्बरको पृष्ठमा नयाँ गोप्य कुञ्जी क्लिक गर्नुहोस्, वा rotate_secret लाई true सेट गरेर set_inbound_mode कल गर्नुहोस्। नयाँ गोप्य कुञ्जी एकपटक मात्र देखाइन्छ र त्यसपछिका सबै कुरामा हस्ताक्षर गर्छ, पुराना डेलिभरीका पुन: प्रयासहरू समेत, त्यसैले तपाईंको सर्भर तुरुन्तै अपडेट गर्नुहोस्।
फर्वार्ड यूआरएलले Meta को GET ह्यान्डसेक चाहिन्छ?
चाहिँदैन। Meta ले डाइरेक्ट गन्तव्यलाई मात्र कल गर्छ र त्यसले hub.challenge फर्काउनुपर्छ। फर्वार्ड यूआरएललाई easyCoexistence ले कल गर्छ र त्यसले हस्ताक्षरित POST मात्र प्राप्त गर्छ।
एउटै नम्बरमा डाइरेक्ट गन्तव्य र फर्वार्ड यूआरएल एकै पटक हुन सक्छ?
सक्दैन। फर्वार्ड यूआरएल नम्बर म्यानेज्ड हुँदा मात्र काम गर्छ, र डाइरेक्ट गन्तव्य सुरक्षित गर्नुले नम्बरलाई डाइरेक्ट बनाउँछ। फर्वार्ड यूआरएल र यसको गोप्य कुञ्जी राखिन्छ, त्यसैले म्यानेज्डमा फर्केपछि फर्वार्डिङ फेरि सुरु हुन्छ।
पढ्दै जानुहोस्
सुरु गर्न तयार हुनुहुन्छ?
महिनौं होइन, केही मिनेटमै WhatsApp Coexistence सेट अप गर्नुहोस्। एप फोनमा चलिरहन्छ।
निःशुल्क ट्रायल सुरु गर्नुहोस्प्रमाणीकरण गरिएको