লগ ইনফ্রি ট্রায়াল শুরু করুন
Meta Tech Provider

Coexistence নম্বরে Node.js ও Python দিয়ে WhatsApp AI এজেন্ট তৈরি করুন

এই নম্বরের মেসেজ আসবে হয় HMAC স্বাক্ষরসহ ফরওয়ার্ড হয়ে, যা আপনি যাচাই করবেন (X-EC-Signature), নয়তো সরাসরি Meta-র ওয়েবহুক থেকে, যার URL-এ একটি সিক্রেট থাকে। এরপর যে মেসেজ আইডি আগেই প্রক্রিয়া হয়েছে, তা বাদ দিন। যে চ্যাটে ইকো দেখাচ্ছে কেউ ফোন থেকে উত্তর দিয়েছে, সেখানে চুপ থাকুন। আর আপনার মডেলের উত্তর শুধু গ্রাহকের শেষ মেসেজের 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-এ। একটি ভিন্ন পদ্ধতিতে কোনো ফরওয়ার্ডই লাগে না: একটি অটোমেশনের Call my ওয়েবহুক ধাপ মেসেজটি আপনার এন্ডপয়েন্টে 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 অ্যাপ থেকে উত্তর দিয়েছে (easyCoexistence-এর ডিফল্ট অটোমেশনও এটাই ব্যবহার করে), তখন ওই চ্যাটে 4 ঘণ্টা চুপ থাকে। যে মেসেজ আইডি আগেই প্রক্রিয়া হয়েছে তা বাদ দেয়, এবং শুধু 24 ঘণ্টার উইন্ডোর ভেতরে পাঠায়। উইন্ডো মাপা হয় মেসেজের নিজস্ব টাইমস্ট্যাম্প থেকে, যখন আপনার কাছে এসে পৌঁছেছে সেখান থেকে নয়, কারণ রিট্রাই করা ডেলিভারি ঘণ্টাখানেক দেরিতেও আসতে পারে।

ব্যবহারকারীদের চিহ্নিত করা হয় BSUID দিয়ে (from_user_id, বা ইকোতে to_user_id), ফোন নম্বর ফলব্যাক হিসেবে। যে ব্যবহারকারীকে শুধু BSUID দিয়ে চেনা যায়, তাকে to-র বদলে recipient দিয়ে উত্তর দেওয়া হয়। মডেল কলে যেকোনো OpenAI-compatible chat completions 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 দেয়, এবং যে ডেলিভারি আইডি আগেই গ্রহণ করা হয়েছে তা বাদ দেয়, কারণ রিট্রাইয়ে একই আইডি থাকে তবে নতুন স্বাক্ষর থাকে। বডির event হলো Meta-র ফিল্ডের নাম, এবং value হলো Meta-র change, অপরিবর্তিত। /ec/agent উত্তর দেয় Call my ওয়েবহুক ধাপের, যা ওই অটোমেশনের নিজস্ব Signing secret দিয়ে সাইন করা, এবং ইতিহাসকে চ্যাটের টার্নে রূপান্তর করে। /meta/:secret সরাসরি রুট: এটি Meta-র GET হ্যান্ডশেক উত্তর দেয় কাঁচা hub.challenge দিয়ে, আর POST গ্রহণ করে শুধু সিক্রেট পথে।

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 বা আপনার ডেটাবেসে সরান; মেসেজ আইডির জন্য একটি 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 দিন রিট্রাই হয়; মেসেজ আইডির একটি স্টোর রাখুন এবং যেগুলো আগেই প্রক্রিয়া হয়েছে সেগুলো বাদ দিন।
  • ফরওয়ার্ড রিট্রাই। easyCoexistence 10 সেকেন্ডের মধ্যে কোনো 2xx না পাওয়া ডেলিভারি একই আইডি দিয়ে রিট্রাই করে; যে আইডি আগেই গ্রহণ করা হয়েছে তা বাদ দিন, তারপর মেসেজ আইডির ভিত্তিতে ডুপ্লিকেট বাদ দিন, কারণ Meta যে পরিবর্তন আবার পাঠায় সেটি নতুন আইডি নিয়ে আবার ফরওয়ার্ড হয়।
  • ধীর স্বীকৃতি। আগে উত্তর দিন, পরে কাজ করুন; যে হ্যান্ডলার মডেলের জন্য অপেক্ষা করে সেটি টাইমআউট হয়, এবং একই ইভেন্ট ফিরে আসে।
  • ফোনে থাকা কোনো ব্যক্তি। একটি smb_message_echoes ইভেন্ট মানে কেউ অ্যাপ থেকে উত্তর দিয়েছে; ওই চ্যাটে কয়েক ঘণ্টা চুপ থাকুন।
  • একাধিক ওয়ার্কার। ইন-মেমোরি সেট প্রসেসের বাইরে যায় না; স্টোরগুলো Redis বা আপনার ডেটাবেসে সরান।
  • দুটি উত্তরদাতা। একটি AI-reply অটোমেশন এবং আপনার নিজের এজেন্ট একই চ্যাটে উত্তর দিলে দুটোই সাড়া দেয়, আর আপনার 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 app secret দিয়ে X-Hub-Signature-256 যাচাই করা। Meta easyCoexistence-এর app secret দিয়ে সাইন করে, যা শেয়ার করা হয় না, তাই আসল ইভেন্টগুলোও ব্যর্থ হয়; পথের সিক্রেট দিয়ে যাচাই করুন।
  • আগমনের সময় থেকে উইন্ডো পড়া। ঘণ্টা পরে রিট্রাই হওয়া ফরওয়ার্ডেও Meta-র মূল টাইমস্ট্যাম্প থাকে; তার সঙ্গে তুলনা করুন, নইলে এজেন্ট 24 ঘণ্টার পরে উত্তর দেবে এবং Meta পাঠানো প্রত্যাখ্যান করবে।
EasyCoexistence দিয়ে এটি করা

প্রতিটি নম্বর 24/7 নজরদারিতে থাকে, সংযোগ বিচ্ছিন্ন হলে সতর্কবার্তা সহ। প্রতি নম্বর প্রতি মাসে US$ 9 থেকে US$ 0.75, নম্বর বাড়ানোর সঙ্গে সঙ্গে কমতে থাকে, প্রথম 3 দিন ফ্রি।

প্রায়শই জিজ্ঞাসিত প্রশ্ন

এজেন্ট কি ভয়েস নোট ও ছবি বুঝতে পারে?

হ্যাঁ, আপনার নিজের কোড দিয়ে। Meta-র পেলোডে মিডিয়া আইডি থাকে: GET /<media-id> ও নম্বরের টোকেন দিয়ে ডাউনলোড করুন, ফেরত আসা URL-টি একই Authorization হেডার দিয়ে আনুন, তারপর আপনার মডেল দিয়ে ট্রান্সক্রাইব বা বর্ণনা করান। অটোমেশন শুধু [voice message]-এর মতো প্লেসহোল্ডার দেখে।

নমুনাগুলো কোন মডেল ব্যবহার করতে পারে?

OpenAI-compatible chat completions এন্ডপয়েন্টের পেছনের যেকোনো মডেল, OpenAI-র মডেলসহ এবং OpenRouter-এর মাধ্যমে যেগুলো পৌঁছায় সেগুলোও; অথবা askModel ও ask_model-এর জায়গায় আপনার প্রোভাইডারের SDK বসান। easyCoexistence কখনো AI-এর বিল করে না: বিল সরাসরি আপনার প্রোভাইডার আপনাকে করে।

এজেন্ট কি নিজে থেকে কথোপকথন শুরু করতে পারে?

শুধু একটি অনুমোদিত টেমপ্লেট দিয়ে, যা “type template” সহ একই send_endpoint-এ পাঠানো হয়। Coexistence নম্বরে টেমপ্লেট শুধু API দিয়ে যায়, কখনো ফোন অ্যাপ থেকে নয়, এবং Meta প্রতিটি মেসেজের হিসাব ধরে ব্যবসার নিজের WhatsApp Business Account-এ বিল করে।

একটি এজেন্ট কি একাধিক নম্বর সামলাতে পারে?

হ্যাঁ। value.metadata.phone_number_id বা connection.phone_number_id দিয়ে রুট করুন, আর প্রতি নম্বরের জন্য আলাদা send_endpoint, টোকেন ও ফরওয়ার্ড সিক্রেট রাখুন, কারণ প্রতিটি নম্বরের নিজের আলাদা।

আরও পড়ুন

WhatsApp মেসেজ কীভাবে আপনার সার্ভারে পৌঁছায়: সরাসরি বা ম্যানেজড মোড, এবং স্বাক্ষর যাচাইসরাসরি: Meta আপনার সার্ভারে পোস্ট করে। ম্যানেজড: অটোমেশন উত্তর দেয়, আর সই করা একটি কপি Forward URL-এ যায়। পেলোড, X-EC-Signature যাচাই, রিট্রাই।আপনার AI এজেন্টকে স্মৃতি দিন: WhatsApp চ্যাট ও কন্টাক্টের ছয় মাসCoexistence নম্বরে 180 দিন পর্যন্ত WhatsApp চ্যাট ও কন্টাক্ট AI এজেন্টের মেমরিতে লোড করুন: 24 ঘণ্টার নিয়ম, চাঙ্ক ও স্টোরেজ।WhatsApp ইউজারনেম ও ব্যবসা-নির্দিষ্ট ইউজার আইডি (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 সেট আপ করুন। ফোনে অ্যাপটি কাজ করতে থাকে।

ফ্রি ট্রায়াল শুরু করুন

যাচাই করা হয়েছে