లాగిన్ చేయండిఉచిత ట్రయల్ ప్రారంభించండి
Meta Tech Provider

Coexistence నంబర్‌పై Node.js మరియు Python తో WhatsApp AI ఏజెంట్‌ను నిర్మించండి

నంబర్ మెసేజ్‌లను మీరు ధృవీకరించే HMAC సంతకంతో (X-EC-Signature) ఫార్వార్డ్ చేసినవి లేదా URLలో రహస్య కీతో Meta వెబ్‌హుక్ నుండి నేరుగా స్వీకరించండి. తర్వాత ఇప్పటికే నిర్వహించిన ఏ మెసేజ్ ID నైనా దాటవేయండి, ఎకో చూపిస్తే వ్యక్తి ఫోన్ నుండి జవాబిచ్చిన చాట్‌లో మౌనంగా ఉండండి, మరియు కస్టమర్ చివరి మెసేజ్ నుండి 24 గంటల లోపే మాత్రమే మీ మోడల్ జవాబును Cloud API ద్వారా పంపండి.

easyCoexistence నంబర్‌ను వ్యాపారం WhatsApp Business యాప్‌లో ఉపయోగిస్తూనే ఉంచుతుంది, దాన్ని Meta యొక్క Cloud API కి కనెక్ట్ చేస్తుంది, get_api_credentials ద్వారా మీ కోడ్‌కు క్రెడెన్షియల్‌లు ఇస్తుంది, మరియు ఆటోమేషన్‌లు ఆన్‌లో ఉన్నప్పుడు మెసేజ్‌లను Meta నుండి నేరుగా మీ సర్వర్‌కు లేదా సంతకం చేసిన ఫార్వార్డ్ ద్వారా రూట్ చేస్తుంది.

5 min

సంతకంలోని t మరియు మీ గడియారం మధ్య అంగీకరించబడే గరిష్ట అంతరం; ప్రతి రీట్రై కొత్త t తో మళ్లీ సంతకం చేయబడుతుంది.

10 s

ఫార్వార్డ్ చేసిన POST 2xx కోసం ఎంతసేపు వేచి ఉంటుంది, ఆ తర్వాత easyCoexistence ఆ డెలివరీని మళ్లీ ప్రయత్నించడానికి షెడ్యూల్ చేస్తుంది.

7 days

HTTP 200 అందుకోని నేరుగా వెబ్‌హుక్‌ను Meta ఎంతసేపు మళ్లీ ప్రయత్నిస్తుంది, దీనివల్ల అదే మెసేజ్ రెండుసార్లు చేరవచ్చు.

24 hours

వినియోగదారు చివరి మెసేజ్ తర్వాత కస్టమర్ సర్వీస్ విండో; దాని వెలుపల Meta టెంప్లేట్ మెసేజ్‌లను మాత్రమే అంగీకరిస్తుంది.

20 mps

WhatsApp Business యాప్ మరియు Cloud API రెండింటితో వాడే నంబర్ యొక్క స్థిర థ్రూపుట్.

కోడ్ చేసిన ఏజెంట్ ఏ మార్గాన్ని ఉపయోగించాలి?

ఫార్వార్డ్ అంటే నంబర్ ఆటోమేషన్‌లలో ఆన్ మోడ్‌లో ఉంటుంది: Meta easyCoexistence కు డెలివర్ చేస్తుంది, ఆటోమేషన్‌లు ఇంకా నడవగలవు, మరియు ప్రతి Meta మార్పు యొక్క సంతకం చేసిన కాపీ మీ Forward URL కు వెళ్తుంది. ఒక వేరియంట్‌కు ఫార్వార్డ్ అవసరమే లేదు: ఆటోమేషన్ యొక్క నా వెబ్‌హుక్‌కు కాల్ చేయండి స్టెప్ మెసేజ్‌ను మీ ఎండ్‌పాయింట్‌కు POST చేస్తుంది మరియు మీరు తిరిగి ఇచ్చే {"reply"} ను 20 సెకన్లలో పంపుతుంది, డూప్లికేట్ తొలగింపు, ఫోన్ విరామం మరియు 24-గంటల తనిఖీ మీ కోసం జరుగుతాయి.

నేరుగా అంటే Meta తన స్వంత వెబ్‌హుక్‌ను నేరుగా మీ ఎండ్‌పాయింట్‌కు పంపుతుంది, set_webhook_destination తో సెట్ చేయబడుతుంది, మరియు easyCoexistence మెసేజ్‌లను ఎప్పుడూ చూడదు. ఆ నంబర్‌కు ఆటోమేషన్‌లు ఆఫ్‌లో ఉంటాయి, కాబట్టి ప్రతి గార్డ్ మీదే, మరియు కనెక్ట్ అయిన 24 గంటలలోపు గమ్యం సేవ్ చేస్తే 6 నెలల చరిత్ర దిగుమతి కూడా మీదే. దిగువ నమూనా కోడ్ మూడు ఎంట్రీ పాయింట్లను ఒకే షేర్డ్ కోర్‌తో నిర్వహిస్తుంది.

Forwarded, signedDirect from Meta
Number modeAutomations on (managed)Direct to your server
BodyOne Meta change: id, event, received_at, connection, valueMeta's envelope: object, entry, changes
AuthenticationX-EC-Signature, HMAC-SHA256 with a per-number secretA secret in the URL path
AcknowledgeAny 2xx within 10 secondsHTTP 200; Meta retries other codes
Retries7 attempts over about 33 hoursUp to 7 days
ReplyGraph API, or {"reply"} to a Call my webhook stepGraph API
History importNot requestedRequested if saved within 24 hours of connecting

Node.js లో ఏజెంట్ మెసేజ్‌తో ఏం చేస్తుంది?

agent.mjs లో రెండు మార్గాలు పంచుకునే లాజిక్ ఉంది. ఇది కస్టమర్ చివరి మెసేజ్ సమయాన్ని నమోదు చేస్తుంది, smb_message_echoes ఈవెంట్ WhatsApp Business యాప్ నుండి ఎవరో జవాబిచ్చారని చూపినప్పుడు ఒక చాట్‌లో 4 గంటల పాటు వెనక్కు తగ్గుతుంది (easyCoexistence ఆటోమేషన్‌లు ఉపయోగించే డిఫాల్ట్), ఇప్పటికే నిర్వహించిన మెసేజ్ ID ని దాటవేస్తుంది, మరియు 24-గంటల విండోలో మాత్రమే పంపుతుంది. విండో మెసేజ్ యొక్క స్వంత టైమ్‌స్టాంప్ నుండి కొలవబడుతుంది, అది మీకు చేరిన సమయం నుండి కాదు, ఎందుకంటే రీట్రై చేసిన డెలివరీ గంటల తర్వాత రావచ్చు.

యూజర్లు BSUID (from_user_id, లేదా ఎకోలపై to_user_id) ద్వారా గుర్తించబడతారు, ఫోన్ నంబర్ ఫాల్‌బ్యాక్‌గా ఉంటుంది, మరియు BSUID ద్వారా మాత్రమే తెలిసిన యూజర్‌కు to బదులు recipient తో జవాబిస్తారు. మోడల్ కాల్ ఏదైనా OpenAI-compatible చాట్ కంప్లీషన్స్ API ఉపయోగిస్తుంది; మీకు నచ్చితే మీ ప్రొవైడర్ SDK తో మార్చండి.

agent.mjs: the shared logic
// agent.mjs: what the agent does with one Meta change, whichever route brought it.
const DAY = 24 * 3600 * 1000;
const PAUSE = 4 * 3600 * 1000;   // quiet time after a person replies (automations default to 4 h)
const seen = new Set();          // handled ids: use Redis or your database in production
const lastInbound = new Map();   // user -> ms of their last message
const quietUntil = new Map();    // user -> ms until which a person has the chat

export function firstTime(id) {
  if (seen.has(id)) return false;
  seen.add(id);
  return true;
}

export async function handleChange(field, value) {
  if (field === "smb_message_echoes") {
    // Someone answered from the WhatsApp Business app: step back on that chat.
    for (const e of value.message_echoes ?? []) {
      quietUntil.set(e.to_user_id ?? e.to, Number(e.timestamp) * 1000 + PAUSE);
    }
    return;
  }
  if (field !== "messages") return;              // statuses ride in value.statuses: ignored here
  for (const m of value.messages ?? []) {
    if (!firstTime(m.id)) continue;               // Meta delivered this message before
    const user = m.from_user_id ?? m.from;        // BSUID first, phone number as fallback
    lastInbound.set(user, Math.max(Number(m.timestamp) * 1000, lastInbound.get(user) ?? 0));
    if ((quietUntil.get(user) ?? 0) > Date.now()) continue; // a person has this chat
    if (m.type !== "text") continue;              // media: fetch it by id first (see the FAQ)
    const reply = await askModel([{ role: "user", content: m.text.body }]);
    if (!reply) continue;
    if (Date.now() - lastInbound.get(user) >= DAY) continue; // window closed: template only
    await sendText({ phone: m.from, bsuid: m.from_user_id }, reply);
  }
}

// Any OpenAI-compatible chat completions API (OpenAI, OpenRouter...).
export async function askModel(turns) {
  const res = await fetch(`${process.env.AI_BASE_URL}/chat/completions`, {
    method: "POST",
    headers: { Authorization: `Bearer ${process.env.AI_KEY}`, "Content-Type": "application/json" },
    body: JSON.stringify({
      model: process.env.AI_MODEL,
      messages: [{ role: "system", content: process.env.AI_INSTRUCTIONS ?? "Answer briefly." }, ...turns],
    }),
  });
  if (!res.ok) throw new Error(`AI provider answered ${res.status}`);
  const data = await res.json();
  return data.choices?.[0]?.message?.content?.trim() ?? "";
}

// send_endpoint and access_token come from get_api_credentials.
async function sendText({ phone, bsuid }, text) {
  const res = await fetch(process.env.SEND_ENDPOINT, {
    method: "POST",
    headers: { Authorization: `Bearer ${process.env.WA_TOKEN}`, "Content-Type": "application/json" },
    body: JSON.stringify({
      messaging_product: "whatsapp",
      recipient_type: "individual",
      ...(phone ? { to: phone } : { recipient: bsuid }), // a BSUID-only user gets recipient
      type: "text",
      text: { body: text.slice(0, 4096) },
    }),
  });
  if (!res.ok) throw new Error(`Graph API answered ${res.status}: ${await res.text()}`);
}

Node.js లో ఈవెంట్‌లను ఎలా ధృవీకరించి రూట్ చేయాలి?

server.mjs మూడు ఎంట్రీ పాయింట్లను అందిస్తుంది. /ec/forward నిర్వహించబడే నంబర్ల ఫార్వార్డ్‌లను స్వీకరిస్తుంది: నంబర్ యొక్క ఫార్వార్డ్ రహస్య కీ తో రా బైట్లపై X-EC-Signature ను ధృవీకరిస్తుంది, ఏ పనికంటే ముందే 200 ఇస్తుంది, మరియు ఇప్పటికే అంగీకరించిన డెలివరీ ID ని దాటవేస్తుంది, ఎందుకంటే రీట్రైలో అదే ID కొత్త సంతకంతో వస్తుంది. బాడీలోని event అనేది Meta యొక్క ఫీల్డ్ నేమ్, value అనేది Meta యొక్క మార్పు, మార్చకుండా. /ec/agent నా వెబ్‌హుక్‌కు కాల్ చేయండి స్టెప్ కు జవాబిస్తుంది, ఆ ఆటోమేషన్ యొక్క స్వంత సంతకం రహస్య కీ తో సంతకం చేయబడుతుంది, మరియు చరిత్రను చాట్ టర్న్‌లుగా మారుస్తుంది. /meta/:secret నేరుగా మార్గం: ఇది Meta యొక్క GET హ్యాండ్‌షేక్‌కు raw hub.challenge తో జవాబిస్తుంది, మరియు POST లను secret path పైనే అంగీకరిస్తుంది.

HMAC కీ మొత్తం రహస్యం, whsec_ ప్రిఫిక్స్‌తో సహా, UTF-8 టెక్స్ట్‌గా. express.raw బైట్లను చెక్కుచెదరకుండా ఉంచుతుంది, మరియు దాని 5 MB పరిమితి 3 MB వరకు Meta పేలోడ్‌లకు చోటు ఇస్తుంది.

server.mjs: verification and routes (Express)
// server.mjs: Node 18+, npm i express, then node server.mjs
import crypto from "node:crypto";
import express from "express";
import { askModel, firstTime, handleChange } from "./agent.mjs";

const app = express();

// X-EC-Signature: t=<unix>,v1=<hex HMAC-SHA256 of "<t>.<raw body>">, keyed with the whole secret.
export function verifyEc(raw, header, secret, toleranceSec = 300) {
  const m = /^t=(\d+),v1=([0-9a-f]{64})$/.exec(String(header ?? "").trim());
  if (!m || !Buffer.isBuffer(raw) || !secret) return false;
  if (Math.abs(Date.now() / 1000 - Number(m[1])) > toleranceSec) return false; // stale or replayed
  const expected = crypto.createHmac("sha256", secret).update(`${m[1]}.`).update(raw).digest();
  return crypto.timingSafeEqual(expected, Buffer.from(m[2], "hex"));
}

function sameSecret(a, b) {
  const x = Buffer.from(String(a)), y = Buffer.from(String(b ?? ""));
  return x.length === y.length && crypto.timingSafeEqual(x, y);
}

// Route A, forwarded: a managed number's Forward URL. One Meta change per POST.
app.post("/ec/forward", express.raw({ type: "*/*", limit: "5mb" }), (req, res) => {
  if (!verifyEc(req.body, req.get("X-EC-Signature"), process.env.EC_FORWARD_SECRET)) return res.sendStatus(401);
  res.sendStatus(200);                                   // acknowledge inside 10 s, then work
  const d = JSON.parse(req.body.toString("utf8"));
  if (!firstTime(`delivery:${d.id}`)) return;            // a retry of a delivery already taken
  handleChange(d.event, d.value).catch(console.error);   // d.event is the Meta field name
});

// Route A, synchronous: a "Call my webhook" step. Answer {"reply"} within 20 s.
app.post("/ec/agent", express.raw({ type: "*/*", limit: "1mb" }), async (req, res) => {
  if (!verifyEc(req.body, req.get("X-EC-Signature"), process.env.EC_AUTOMATION_SECRET)) return res.sendStatus(401);
  const step = JSON.parse(req.body.toString("utf8"));
  const turns = step.history.map((h) => ({ role: h.direction === "in" ? "user" : "assistant", content: h.text }));
  while (turns[0]?.role === "assistant") turns.shift();
  if (!turns.length) turns.push({ role: "user", content: step.message?.text ?? "" }); // tests carry no history
  res.json({ reply: await askModel(turns) });            // step.dry_run is true on "Test it"
});

// Route B, direct: Meta's own envelope. The secret path is the credential.
app.get("/meta/:secret", (req, res) => {
  if (!sameSecret(req.params.secret, process.env.PATH_SECRET)) return res.sendStatus(404);
  if (req.query["hub.mode"] === "subscribe" && req.query["hub.verify_token"] === process.env.VERIFY_TOKEN) {
    return res.type("text/plain").send(String(req.query["hub.challenge"]));
  }
  res.sendStatus(403);
});

app.post("/meta/:secret", express.json({ limit: "5mb" }), (req, res) => {
  if (!sameSecret(req.params.secret, process.env.PATH_SECRET)) return res.sendStatus(404);
  res.sendStatus(200);                                   // Meta retries anything but 200
  for (const entry of req.body.entry ?? []) {
    for (const change of entry.changes ?? []) handleChange(change.field, change.value).catch(console.error);
  }
});

app.listen(process.env.PORT ?? 3000);

అదే ఏజెంట్ Python లో ఎలా కనిపిస్తుంది?

ఒకే Flask ఫైల్, అవే మూడు రూట్‌లు మరియు అవే నియమాలు. request.get_data() HMAC కోసం రా బాడీని ఇస్తుంది, hmac.compare_digest constant-time పోలికను చేస్తుంది, మరియు పని 200 తర్వాత బ్యాక్‌గ్రౌండ్ థ్రెడ్‌లో నడుస్తుంది, కాబట్టి easyCoexistence గానీ Meta గానీ మీ మోడల్ కోసం వేచి ఉండవు. డెవలప్ చేస్తున్నప్పుడు flask --app agent run తో నడపండి, ప్రొడక్షన్‌లో gunicorn లేదా మరో WSGI సర్వర్ వెనుక ఉంచండి.

ఇన్-మెమరీ సెట్ మరియు డిక్షనరీలు ఒకే ప్రాసెస్‌కు సరిపోతాయి. బహుళ వర్కర్లు లేదా ఇన్‌స్టాన్స్‌లు ఉంటే, వాటిని Redis లేదా మీ డేటాబేస్‌కు తరలించండి, మెసేజ్ IDల కోసం expiry తో set-if-absent రైట్ ఉపయోగించి; లేకపోతే రెండు వర్కర్లు ఒకే మెసేజ్‌కు జవాబిస్తాయి.

agent.py: the whole agent (Flask)
# agent.py: pip install flask requests, then flask --app agent run
import hashlib, hmac, json, os, re, threading, time
import requests
from flask import Flask, abort, request

app = Flask(__name__)
DAY, PAUSE = 24 * 3600, 4 * 3600
seen, last_inbound, quiet_until = set(), {}, {}  # use Redis or a database in production
lock = threading.Lock()

def verify_ec(raw: bytes, header: str, secret: str, tolerance: int = 300) -> bool:
    m = re.fullmatch(r"t=([0-9]+),v1=([0-9a-f]{64})", (header or "").strip())
    if not m or not secret or abs(time.time() - int(m[1])) > tolerance:
        return False
    expected = hmac.new(secret.encode(), m[1].encode() + b"." + raw, hashlib.sha256).hexdigest()
    return hmac.compare_digest(expected, m[2])

def first_time(key: str) -> bool:
    with lock:
        if key in seen:
            return False
        seen.add(key)
        return True

def ask_model(turns: list) -> str:  # any OpenAI-compatible chat completions API
    r = requests.post(f"{os.environ['AI_BASE_URL']}/chat/completions", timeout=30,
                      headers={"Authorization": f"Bearer {os.environ['AI_KEY']}"},
                      json={"model": os.environ["AI_MODEL"], "messages": [
                          {"role": "system", "content": os.environ.get("AI_INSTRUCTIONS", "Answer briefly.")}, *turns]})
    r.raise_for_status()
    return (r.json()["choices"][0]["message"]["content"] or "").strip()

def send_text(phone, bsuid, text: str) -> None:  # SEND_ENDPOINT and WA_TOKEN: get_api_credentials
    to = {"to": phone} if phone else {"recipient": bsuid}
    r = requests.post(os.environ["SEND_ENDPOINT"], timeout=15,
                      headers={"Authorization": f"Bearer {os.environ['WA_TOKEN']}"},
                      json={"messaging_product": "whatsapp", "recipient_type": "individual", **to,
                            "type": "text", "text": {"body": text[:4096]}})
    r.raise_for_status()

def handle_change(field: str, value: dict) -> None:
    if field == "smb_message_echoes":  # a person answered from the app: step back
        for e in value.get("message_echoes", []):
            quiet_until[e.get("to_user_id") or e.get("to")] = int(e["timestamp"]) + PAUSE
        return
    if field != "messages":
        return
    for m in value.get("messages", []):
        if not first_time(m["id"]):  # Meta delivered this message before
            continue
        user = m.get("from_user_id") or m.get("from")
        last_inbound[user] = max(int(m["timestamp"]), last_inbound.get(user, 0))
        if quiet_until.get(user, 0) > time.time() or m.get("type") != "text":
            continue
        reply = ask_model([{"role": "user", "content": m["text"]["body"]}])
        if reply and time.time() - last_inbound[user] < DAY:  # past 24 h: template only
            send_text(m.get("from"), m.get("from_user_id"), reply)

def later(field, value):
    threading.Thread(target=handle_change, args=(field, value), daemon=True).start()

@app.post("/ec/forward")  # route A: a managed number's Forward URL
def forward():
    raw = request.get_data()
    if not verify_ec(raw, request.headers.get("X-EC-Signature", ""), os.environ["EC_FORWARD_SECRET"]):
        abort(401)
    d = json.loads(raw)
    if first_time("delivery:" + d["id"]):  # skip retries of a delivery already taken
        later(d["event"], d["value"])
    return "", 200

@app.post("/ec/agent")  # route A: a "Call my webhook" step, answer within 20 s
def agent_step():
    raw = request.get_data()
    if not verify_ec(raw, request.headers.get("X-EC-Signature", ""), os.environ["EC_AUTOMATION_SECRET"]):
        abort(401)
    step = json.loads(raw)
    turns = [{"role": "user" if h["direction"] == "in" else "assistant", "content": h["text"]}
             for h in step["history"]]
    while turns and turns[0]["role"] == "assistant":
        turns.pop(0)
    turns = turns or [{"role": "user", "content": step["message"]["text"] or ""}]
    return {"reply": ask_model(turns)}

@app.get("/meta/<secret>")  # route B: Meta's GET handshake
def meta_handshake(secret):
    if not hmac.compare_digest(secret.encode(), os.environ["PATH_SECRET"].encode()):
        abort(404)
    if (request.args.get("hub.mode") == "subscribe"
            and request.args.get("hub.verify_token") == os.environ["VERIFY_TOKEN"]):
        return request.args.get("hub.challenge", ""), 200, {"Content-Type": "text/plain"}
    abort(403)

@app.post("/meta/<secret>")  # route B: Meta's envelope, straight from Meta
def meta_events(secret):
    if not hmac.compare_digest(secret.encode(), os.environ["PATH_SECRET"].encode()):
        abort(404)
    for entry in (request.get_json(silent=True) or {}).get("entry", []):
        for change in entry.get("changes", []):
            later(change.get("field"), change.get("value", {}))
    return "", 200

డూప్లికేట్ జవాబులను ఎలా నివారించాలి?

డూప్లికేట్‌లకు ఆరు సాధారణ కారణాలు ఉన్నాయి, పైన ఉన్న నమూనాలు మొదటి ఐదింటిని నిర్వహిస్తాయి:

  • Meta రీట్రైలు. HTTP 200 కాకుండా ఏదైనా వస్తే నేరుగా వెబ్‌హుక్‌ను 7 రోజుల వరకు మళ్లీ ప్రయత్నిస్తారు; మెసేజ్ IDల స్టోర్ ఉంచండి మరియు ఇప్పటికే నిర్వహించిన IDలను దాటవేయండి.
  • ఫార్వార్డ్ రీట్రైలు. 10 సెకన్లలో 2xx రాని డెలివరీని easyCoexistence అదే ID తో మళ్లీ ప్రయత్నిస్తుంది; ఇప్పటికే అంగీకరించిన IDలను దాటవేయండి, ఆ తర్వాత మెసేజ్ ID పై డూప్లికేట్ తొలగింపు చేయండి, ఎందుకంటే Meta మళ్లీ డెలివర్ చేసిన మార్పు కొత్త ID తో మళ్లీ ఫార్వార్డ్ అవుతుంది.
  • నెమ్మది అంగీకారాలు. ముందు జవాబివ్వండి, పని తర్వాత చేయండి; మోడల్ కోసం వేచి ఉండే హ్యాండ్లర్ టైమ్ అవుట్ అవుతుంది, అదే ఈవెంట్ తిరిగి వస్తుంది.
  • ఫోన్‌లో ఉన్న వ్యక్తి. smb_message_echoes ఈవెంట్ అంటే యాప్ నుండి ఎవరో జవాబిచ్చారని; ఆ చాట్‌లో కొన్ని గంటల పాటు మౌనంగా ఉండండి.
  • అనేక వర్కర్లు. ఇన్-మెమరీ సెట్‌లు ప్రాసెస్‌లను దాటి ఉండవు; స్టోర్‌లను Redis లేదా మీ డేటాబేస్‌కు తరలించండి.
  • రెండు రెస్పాండర్లు. ఒకే చాట్‌లలో AI-జవాబు ఆటోమేషన్ మరియు మీ స్వంత ఏజెంట్ రెండూ జవాబిస్తాయి, మరియు మీ Graph API పంపిన సందేశాలు ఎకోలు కావు, కాబట్టి అవి ఆటోమేషన్‌లను ఆపవు. ప్రతి నంబర్‌కు ఒక రెస్పాండర్‌ను ఎంచుకోండి.

రహస్యాలు మరియు క్రెడెన్షియల్‌లు ఎక్కడ నుండి వస్తాయి?

డ్యాష్‌బోర్డ్ లేదా MCP కనెక్టర్ నుండి, మరియు అవి మీ సర్వర్ ఎన్విరాన్‌మెంట్‌లో మాత్రమే ఉండాలి. get_api_credentials graph_api_base, waba_id, phone_number_id, send_endpoint మరియు access_token ను ఇస్తుంది, ఇవి వ్యాపారం యొక్క స్వంత టోకెన్; నంబర్ పేజీ "Plug in your own system" కింద అవే విలువలను చూపిస్తుంది. access_token null అయితే, టోకెన్ జారీ చేయడానికి కంప్యూటర్ నుండి Reconnect బటన్‌తో నంబర్‌ను మళ్లీ కనెక్ట్ చేయండి. టోకెన్‌ను పాస్‌వర్డ్‌లా చూసుకోండి, ఎందుకంటే దాన్ని కలిగి ఉన్న ఎవరైనా వ్యాపారం తరఫున మెసేజ్ పంపగలరు.

EC_FORWARD_SECRETShown once when you save a Forward URL, or returned once by set_inbound_mode; New secret rotates it
EC_AUTOMATION_SECRETSigning secret on the automation's page, under its Call my webhook step
SEND_ENDPOINT, WA_TOKENsend_endpoint and access_token from get_api_credentials
PATH_SECRET, VERIFY_TOKENDirect route: 32 or more random characters in the URL, and the handshake token you chose
AI_BASE_URL, AI_KEY, AI_MODELAny OpenAI-compatible API, such as https://api.openai.com/v1 or https://openrouter.ai/api/v1

సాధారణ పొరపాట్లు

  • మళ్లీ సీరియలైజ్ చేసిన JSON పై HMAC తనిఖీ. Python యొక్క json.dumps డిఫాల్ట్‌గా సెపరేటర్ల తర్వాత ఖాళీలు జోడిస్తుంది, కాబట్టి పార్స్ చేసి మళ్లీ డంప్ చేసిన బాడీ ఇక సరిపోలదు; రా బైట్లను ధృవీకరించండి.
  • రహస్యాన్ని Base64 డీకోడ్ చేయడం లేదా దాని whsec_ ప్రిఫిక్స్‌ను తీసివేయడం. కీ మొత్తం స్ట్రింగ్, UTF-8 టెక్స్ట్‌గా, మీకు ఒకసారి చూపించినట్లుగానే.
  • నేరుగా మార్గంలో మీ స్వంత Meta యాప్ రహస్యంతో X-Hub-Signature-256 ను ధృవీకరించడం. Meta easyCoexistence యొక్క యాప్ రహస్యంతో సంతకం చేస్తుంది, అది పంచుకోబడదు, కాబట్టి అసలు ఈవెంట్‌లు విఫలమవుతాయి; పాత్ రహస్యంతో ధృవీకరించండి.
  • విండోను చేరిన సమయం నుండి చదవడం. గంటల తర్వాత రీట్రై అయిన ఫార్వార్డ్ ఇప్పటికీ Meta యొక్క అసలు టైమ్‌స్టాంప్‌ను కలిగి ఉంటుంది; దానితో పోల్చండి, లేకపోతే ఏజెంట్ 24 గంటల తర్వాత జవాబిస్తుంది మరియు Meta పంపడాన్ని తిరస్కరిస్తుంది.
EasyCoexistenceతో దీన్ని చేయడం

ప్రతి నంబర్ 24/7 పర్యవేక్షించబడుతుంది, కనెక్షన్ తెగిపోతే అలర్ట్‌లతో. ప్రతి నంబర్‌కు నెలకు US$ 9 నుండి US$ 0.75 వరకు, నంబర్లు జోడించినప్పుడు తగ్గుతుంది, మొదటి 3 రోజులు ఉచితం.

తరచుగా అడిగే ప్రశ్నలు

ఏజెంట్ వాయిస్ నోట్‌లు మరియు ఫోటోలను అర్థం చేసుకోగలదా?

అవును, మీ స్వంత కోడ్‌తో. Meta యొక్క పేలోడ్‌లో మీడియా ID ఉంటుంది: దాన్ని GET /<media-id> మరియు నంబర్ టోకెన్‌తో డౌన్‌లోడ్ చేయండి, తిరిగి వచ్చిన URL ను అదే Authorization హెడర్‌తో తెచ్చుకోండి, తర్వాత మీ మోడల్‌తో ట్రాన్స్‌క్రైబ్ చేయండి లేదా వివరించండి. ఆటోమేషన్‌లు [voice message] వంటి ప్లేస్‌హోల్డర్‌లను మాత్రమే చూస్తాయి.

నమూనా కోడ్ ఏ మోడల్స్‌ను ఉపయోగించగలదు?

OpenAI-compatible చాట్ కంప్లీషన్స్ ఎండ్‌పాయింట్ వెనుక ఉన్న ఏ మోడల్‌నైనా, OpenAI మరియు OpenRouter ద్వారా చేరుకునే వాటితో సహా, లేదా askModel మరియు ask_model స్థానంలో మీ ప్రొవైడర్ SDK ఉంచండి. easyCoexistence AI కు ఎప్పుడూ బిల్ చేయదు: మీ ప్రొవైడర్ నేరుగా మీకు బిల్ చేస్తుంది.

ఏజెంట్ సంభాషణను ప్రారంభించగలదా?

ఆమోదించబడిన టెంప్లేట్‌తో మాత్రమే, అదే send ఎండ్‌పాయింట్‌కు type template తో పంపబడుతుంది. Coexistence నంబర్‌పై టెంప్లేట్‌లు API ద్వారా మాత్రమే వెళ్తాయి, ఫోన్ యాప్ నుండి ఎప్పుడూ కాదు, మరియు Meta వాటికి వ్యాపారం స్వంత WhatsApp Business Account కు ప్రతి మెసేజ్‌కు బిల్ చేస్తుంది.

ఒక ఏజెంట్ అనేక నంబర్‌లకు సేవ చేయగలదా?

అవును. value.metadata.phone_number_id లేదా connection.phone_number_id ద్వారా రూట్ చేయండి, మరియు ప్రతి నంబర్‌కు ఒక send ఎండ్‌పాయింట్, ఒక టోకెన్ మరియు ఒక forward secret ఉంచండి, ఎందుకంటే ప్రతి నంబర్‌కు దాని స్వంతది ఉంటుంది.

చదవడం కొనసాగించండి

WhatsApp మెసేజ్‌లు మీ సర్వర్‌కు ఎలా చేరతాయి: డైరెక్ట్ లేదా మేనేజ్డ్, సంతకాన్ని ధృవీకరించడండైరెక్ట్: Meta నేరుగా మీ సర్వర్‌కు పంపుతుంది. మేనేజ్డ్: ఆటోమేషన్‌లు జవాబిస్తాయి, సంతకం చేసిన కాపీ ఫార్వర్డ్ URLకు వెళ్తుంది.మీ AI ఏజెంట్‌కు మెమరీ ఇవ్వండి: ఆరు నెలల WhatsApp చాట్‌లు, కాంటాక్ట్‌లుCoexistence నంబర్‌లో AI ఏజెంట్ మెమరీకి 180 రోజుల WhatsApp చాట్‌లు, కాంటాక్ట్‌లు: 24 గంటల నియమం, చంక్స్, ప్రోగ్రెస్, స్టోరేజ్.WhatsApp యూజర్‌నేమ్‌లు మరియు వ్యాపార-పరిధి యూజర్ IDలు (BSUID): Cloud API వెబ్‌హుక్‌లలో ఏమి మారుతుందిWhatsApp యూజర్‌నేమ్‌లు Cloud API వెబ్‌హుక్‌లను ఎలా మారుస్తాయి: user_id లో BSUID, wa_id, from ఎప్పుడు పోతాయి, recipient తో జవాబు, Coexistence మార్పులు.n8nలో WhatsApp AI ఏజెంట్, సమాధానాన్ని మీ వర్క్‌ఫ్లో రాస్తుందిn8nలో WhatsApp AI ఏజెంట్: సంతకంతో వచ్చే POST మెసేజ్ మరియు చాట్‌ను అందిస్తుంది, AI Agent సమాధానం రాస్తుంది, 20 సెకన్లలో తిరిగి వస్తుంది.smb_message_echoes వెబ్‌హుక్WhatsApp Business యాప్‌లో మనిషి పంపినదాన్ని సాఫ్ట్‌వేర్ ఎలా చూస్తుందో తెలుసుకోండి. ఇది Coexistence నంబర్‌లలో మాత్రమే ఉంటుంది; పట్టించుకోకపోతే డబుల్ రిప్లైలు వస్తాయి.వ్యాపార రకం ప్రకారం WhatsApp AI: రెస్టారెంట్లు, క్లినిక్‌లు, సెలూన్‌లు, దుకాణాల కోసం సిద్ధ ఫ్లోలురెస్టారెంట్లు, క్లినిక్‌లు, సెలూన్‌లు, దుకాణాలు, రియల్ ఎస్టేట్, కోర్సు క్రియేటర్ల కోసం WhatsApp ఆటోమేషన్లు: ట్రిగ్గర్లు, స్టెప్‌లు, AI ప్రాంప్ట్, బదిలీలు.

ప్రారంభించడానికి సిద్ధంగా ఉన్నారా?

నెలల్లో కాదు, నిమిషాల్లో WhatsApp Coexistence సెటప్ చేయండి. యాప్ ఫోన్‌లో పనిచేస్తూనే ఉంటుంది.

ఉచిత ట్రయల్ ప్రారంభించండి

ధృవీకరించిన తేదీ