WhatsApp செய்திகள் உங்கள் சர்வரை எவ்வாறு அடைகின்றன: நேரடியாக அல்லது நிர்வகிக்கப்பட்டு, மற்றும் கையொப்பத்தைச் சரிபார்த்தல்
easyCoexistence வழியாக இணைக்கப்படும் ஒவ்வொரு எண்ணுக்கும் உள்வரும் செய்திகளுக்கு ஒரு பயன்முறை உண்டு. உங்கள் அமைப்புக்கு நேரடியாக (நேரடி): Meta தனது வெப்ஹூக்குகளை உங்கள் HTTPS எண்ட்பாயிண்டுக்கு அனுப்பும்; URL-இல் உள்ள ரகசியமே அங்கீகாரம், ஆட்டோமேஷன்கள் அணைந்திருக்கும். easyCoexistence வழியாக (நிர்வகிக்கப்பட்டது): Meta easyCoexistence-க்கு அனுப்பும், ஆட்டோமேஷன்கள் பதிலளிக்கலாம், விருப்பமான ஃபார்வர்ட் URL இணைப்பு விவரங்களுடன் Meta-வின் அசல் மதிப்பைப் பெறும், X-EC-Signature கையொப்பத்துடன், நீங்கள் சரிபார்க்க.
ஒவ்வொரு ஃபார்வர்ட் டெலிவரிக்கும் முயற்சிகள்: 1 நிமிடம், 5 நிமிடம், 30 நிமிடம், 2 மணி, 6 மணி மற்றும் 24 மணி இடைவெளியில், மொத்தம் சுமார் 33 மணி நேரம்.
ஒவ்வொரு ஃபார்வர்ட் முயற்சியும் 2xx பதிலுக்காக எவ்வளவு நேரம் காத்திருக்கும், அதன் பிறகு அது தோல்வியாகக் கருதப்படும்.
கையொப்பத்தின் t-க்கான பரிந்துரைக்கப்பட்ட வயது வரம்பு; மறுமுயற்சிகள் மீண்டும் கையொப்பமிடப்படுவதால், உண்மையான டெலிவரிகள் அதற்குள் இருக்கும்.
HTTP 200 அல்லாத எதையும் பெற்ற நேரடி வெப்ஹூக்கை Meta எவ்வளவு நேரம் மறுமுயற்சி செய்கிறது; இது செய்திகளை மீண்டும் அனுப்பக்கூடும்.
Meta அனுப்பும் மிகப் பெரிய வெப்ஹூக் பேலோட், வரலாற்றுப் பகுதிகள் உட்பட.
நிர்வகிக்கப்பட்ட எண்ணுக்கான இயக்கப் பதிவுகள், மெசேஜ் மற்றும் பதில் உரையுடன்; மெசேஜ் உரையே 30, 90 அல்லது 365 நாட்கள் வைக்கப்படும், உங்கள் விருப்பப்படி.
நேரடிக்கும் நிர்வகிக்கப்பட்டதற்கும் என்ன வித்தியாசம்?
Meta எண்ணின் மெசேஜ் வெப்ஹூக்குகளை எங்கு அனுப்புகிறது என்பதுதான் வித்தியாசம். 'Through easyCoexistence' எனக் காட்டப்படும் நிர்வகிக்கப்பட்ட முறையில், Meta easyCoexistence-க்கு அனுப்புகிறது; அது Meta-வின் கையொப்பத்தைச் சரிபார்க்கிறது, உங்கள் ஆட்டோமேஷன்களை இயக்குகிறது, Conversations-க்காக உரையாடல்களைச் சேமிக்கிறது, ஃபார்வர்ட் URL அமைத்திருந்தால் ஒவ்வொரு Meta மாற்றத்தையும் நீங்கள் மட்டுமே வைத்திருக்கும் ரகசியத்துடன் கையொப்பமிட்டு உங்களுக்கு அனுப்புகிறது. 'Straight to your system' எனக் காட்டப்படும் நேரடி முறையில், easyCoexistence எண்ணின் WhatsApp Business Account-இல் உங்கள் HTTPS எண்ட்பாயிண்டை வெப்ஹூக் ஓவர்ரைடாக அமைக்கிறது; அதனால் 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 |
ஓர் எண்ணை இரண்டுக்கும் இடையில் எப்படி மாற்றுவது?
எண்ணின் பக்கத்தில், 'Where incoming messages go' அட்டை முறையை இரண்டு தேர்வுகளாகக் காட்டுகிறது: 'Through easyCoexistence' மற்றும் 'Straight to your system'. 'Route incoming messages to your own webhook' அட்டையில் வெப்ஹூக் இலக்கைச் சேமிப்பதோ, அல்லது set_webhook_destination மூலம் சேமிப்பதோ, எண்ணை நேரடியாக மாற்றுகிறது. 'Through easyCoexistence' என்பதைத் தேர்ந்தெடுப்பது அந்த இலக்கை Meta-வில் உடனே நீக்குகிறது; எனவே தொடர்ந்து பெற, அதே URL-ஐ ஃபார்வர்ட் URL ஆகச் சேர்க்கவும். ஓர் எண் நிர்வகிக்கப்பட்ட முறையிலிருந்து வெளியேறும்போது வரிசையில் காத்திருக்கும் ஃபார்வர்ட்கள் கைவிடப்படும்; வெப்ஹூக் 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-வின் object, entry, changes உறையின் பதிலாக, ஒரு கோரிக்கைக்கு ஒரு Meta மாற்றம், உறையிடப்பட்டு. 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 உடன் நிலையான நேரத்தில் ஒப்பிடுங்கள். அதன் பிறகுதான் JSON-ஐப் பாகுபடுத்துங்கள். 10 வினாடிகளுக்குள் 2xx பதில் அளியுங்கள், வேலையைப் பின்னர் செய்யுங்கள்; ஏற்ற டெலிவரி 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-உடன் மீண்டும் கையொப்பமிடப்படும், URL பொது HTTPS ஆக இருக்க வேண்டும்; அது சேமிக்கும்போதும் ஒவ்வொரு அனுப்புதலுக்கு முன்பும் சரிபார்க்கப்படும். டெலிவரிகள் பழையதிலிருந்து புதியதாக அனுப்பப்படும், ஆனால் மறுமுயற்சி செய்யப்பட்டது புதியவற்றுக்குப் பின் வரக்கூடும்; எனவே Meta-வின் நேர முத்திரைகளின்படி வரிசைப்படுத்துங்கள்.
நேரடி இலக்கில் மறுமுயற்சியை Meta செய்கிறது: HTTP 200 அல்லாத எதுவும் 7 நாட்கள் வரை குறையும் அதிர்வெண்ணுடன் மறுமுயற்சி செய்யப்படும், அந்த மறுமுயற்சிகள் ஒரு மெசேஜை மீண்டும் அனுப்பக்கூடும். இரண்டு முறைகளிலும் Meta-வின் மெசேஜ் id-யின் மீது நகல்களை நீக்குங்கள், ஏனெனில் Meta மீண்டும் அனுப்பும் மாற்றம் புதிய டெலிவரி id-உடன் மீண்டும் ஃபார்வர்ட் செய்யப்படும்.
நேரடி எண்ட்பாயிண்ட் POST உண்மையானது என்பதை எப்படி அறியும்?
X-Hub-Signature-256-இலிருந்து அல்ல. Meta சந்தாவை வைத்திருக்கும் ஆப்பின் ஆப் ரகசியத்தால் கையொப்பமிடுகிறது; இங்கு இணைக்கப்பட்ட எண்ணுக்கு அது easyCoexistence-உடையது, பகிரப்படாதது; எனவே உங்கள் சொந்த Meta ஆப் ரகசியத்துடன் அந்தத் தலைப்பைச் சரிபார்த்தால் உண்மையான டெலிவரிகள் நிராகரிக்கப்படும். வெரிஃபை டோக்கன், Meta-வின் GET கைகுலுக்கலின் போது ஒரே ஒரு முறை மட்டுமே எண்ட்பாயிண்டை நிரூபிக்கிறது. அதற்குப் பதிலாக வேலை செய்வது:
- அழைப்பு URL பாதையில் 32 அல்லது அதற்கு மேற்பட்ட சீரற்ற எழுத்துகளை வையுங்கள்; அவை இல்லாத கோரிக்கைகளை நிராகரியுங்கள்; மாற்ற, புதிய URL-ஐச் சேமியுங்கள்.
- உங்கள் சொந்த Meta ஆப்பைக் கோரும் WhatsApp ட்ரிக்கர் அல்ல, n8n Webhook node போன்ற பொதுவான பெறுநரைப் பயன்படுத்துங்கள்.
- எண்ணின் டோக்கனுடன் Meta-விலிருந்து மீடியாவை id மூலம் பதிவிறக்குங்கள்; போலியான id தோல்வியடையும்.
- சுய-ஹோஸ்ட் செய்யப்பட்ட சர்வர்களில், விரும்பினால், AS32934 அறிவிக்கும் வழிகளான Meta-வின் நெட்வொர்க்கை மட்டும் அனுமதியுங்கள்.
- அல்லது ஃபார்வர்ட் URL-உடன் நிர்வகிக்கப்பட்டதற்கு மாறுங்கள், அங்கு X-EC-Signature ஒவ்வொரு POST-ஐயும் நிரூபிக்கும்.
பொதுவான தவறுகள்
- Meta-வின் உறைக்காக எழுதப்பட்ட குறியீட்டை மாற்றாமல் ஃபார்வர்ட் URL-க்குச் சுட்டிக்காட்டுவது. ஒரு ஃபார்வர்ட் ஒரே ஒரு மாற்றத்தைக் கொண்டுள்ளது: event மற்றும் value-ஐப் படியுங்கள், object, entry, changes-ஐ அல்ல.
- statuses என்ற X-EC-Event-க்காகக் காத்திருப்பது. டெலிவரி நிலைகள் messages நிகழ்வுகளுக்குள், value.statuses-இல் வருகின்றன; ஆப்பில் தட்டச்சு செய்யப்பட்ட பதில்கள் smb_message_echoes ஆக வருகின்றன.
- பதிலளிப்பதற்கு முன் வேலை செய்வது. ஒரு ஃபார்வர்ட் 10 வினாடிகள் காத்திருக்கும், பிறகு அதே டெலிவரி புதிய t-உடன் திரும்பும்; முதலில் 2xx பதில் அளியுங்கள், வரிசையிலிருந்து செயலாக்குங்கள்.
- நிர்வகிக்கப்பட்டதற்கு மாறி பழைய URL இன்னும் பெறும் என்று கருதுவது. நேரடி இலக்கு அந்த நொடியிலேயே நீக்கப்படும்; அதே set_inbound_mode அழைப்பில் forward_url-ஐ அனுப்புங்கள்.
easyCoexistence, WhatsApp Business app எண்ணை Coexistence மூலம் Meta-வின் Cloud API-உடன் இணைக்கிறது; ஒவ்வொரு எண்ணுக்கும் அதன் செய்திகள் எங்கு செல்ல வேண்டும் என்பதைத் தேர்ந்தெடுக்கலாம்: Meta-விலிருந்து நேரடியாக உங்கள் சர்வருக்கு, அல்லது easyCoexistence வழியாக, ஆட்டோமேஷன்கள் பதிலளிக்கவும், கையொப்பமிட்ட நகல் உங்கள் ஃபார்வர்ட் URL-ஐ அடையவும். கண்காணிப்பும் எச்சரிக்கைகளும் இரு முறைகளிலும் வேலை செய்கின்றன. ஓர் எண்ணுக்கு மாதம் US$ 9 முதல் US$ 0.75 வரை, எண்கள் சேர சேரக் குறையும், முதல் 3 நாட்கள் இலவசம்.
அடிக்கடி கேட்கப்படும் கேள்விகள்
எனது சர்வர் ஆட்டோமேஷன் என்ன பதில் அளித்தது என்பதைப் பார்க்குமா?
உரையை அல்ல. API அனுப்புதல்களை Meta நிலைகளாக (sent, delivered, read) messages நிகழ்வுகளுக்குள், மெசேஜ் id-உடன் தெரிவிக்கிறது; உரை தானே ஆட்டோமேஷனின் இயக்கப் பதிவில் உள்ளது, அது Runs தாவலில் 30 நாட்கள் வைக்கப்படும், மேலும் Conversations-இல் நீங்கள் தேர்ந்தெடுத்த காலத்திற்கு.
ஃபார்வர்ட் ரகசியத்தை எப்படி மாற்றுவது?
எண்ணின் பக்கத்தில் New secret என்பதைக் கிளிக் செய்யுங்கள், அல்லது rotate_secret-ஐ true என அமைத்து set_inbound_mode-ஐ அழையுங்கள். புதிய ரகசியம் ஒரே ஒரு முறை காட்டப்படும், அதன் பிறகு பழைய டெலிவரிகளின் மறுமுயற்சிகள் உட்பட எல்லாவற்றுக்கும் கையொப்பமிடும்; எனவே உங்கள் சர்வரை உடனே புதுப்பியுங்கள்.
ஃபார்வர்ட் URL-க்கு Meta-வின் GET கைகுலுக்கல் தேவையா?
இல்லை. நேரடி இலக்கை மட்டுமே Meta அழைக்கும், அது hub.challenge-ஐ எதிரொலிக்க வேண்டும். ஃபார்வர்ட் URL-ஐ easyCoexistence அழைக்கும், அது கையொப்பமிட்ட POST-களை மட்டுமே பெறும்.
ஓர் எண்ணுக்கு நேரடி இலக்கும் ஃபார்வர்ட் URL-உம் ஒரே நேரத்தில் இருக்க முடியுமா?
முடியாது. ஃபார்வர்ட் URL நிர்வகிக்கப்படும்போது மட்டுமே வேலை செய்யும், நேரடி இலக்கைச் சேமித்தால் அது நேரடியாக மாறும். ஃபார்வர்ட் URL-உம் அதன் ரகசியமும் வைக்கப்படும், எனவே நிர்வகிக்கப்பட்டதற்குத் திரும்பினால் ஃபார்வர்டிங் மீண்டும் தொடங்கும்.
தொடர்ந்து படிக்கவும்
தொடங்கத் தயாரா?
மாதங்கள் ஆகாமல், சில நிமிடங்களில் WhatsApp Coexistence-ஐ அமைக்குங்கள். ஆப்ஸ் போனில் தொடர்ந்து இயங்கும்.
இலவச ட்ரையலைத் தொடங்குங்கள்இதில் சரிபார்க்கப்பட்டது: