কীভাবে আপনার গ্রাহকের WhatsApp, Instagram ও TikTok-এ একটি AI এজেন্ট প্রোডাক্ট তৈরি করবেন
গ্রাহকের চ্যানেলে একটি AI এজেন্ট প্রোডাক্ট তিনটি অংশের ওপর নির্ভর করে: প্রতিটি গ্রাহকের WhatsApp নম্বর বা সোশ্যাল অ্যাকাউন্টের জন্য একটি হোস্টেড কানেক্ট লিংক; ওয়েবহুক, যা তাদের মেসেজ ও মন্তব্য আপনার ব্যাকএন্ডে পৌঁছে দেয়, যেখানে আপনার নিজস্ব মডেল উত্তর লেখে এবং প্রতিটি নেটওয়ার্কের অফিসিয়াল API-র মাধ্যমে গ্রাহকের টোকেন দিয়ে তা পাঠানো হয়; এবং সংযোগ বিচ্ছিন্ন হলে স্ট্যাটাস ইভেন্ট। এজেন্ট প্রতিটি নেটওয়ার্কের নিয়ম মেনে চলে, যেমন WhatsApp-এর 24 ঘণ্টার উইন্ডো।
easyCoexistence আপনার প্রোডাক্টের AI এজেন্টকে গ্রাহকের WhatsApp নম্বর এবং তাদের Instagram, Facebook, TikTok, YouTube ও LinkedIn অ্যাকাউন্টে একটি কণ্ঠস্বর দেয়, এবং আরও চ্যানেল আসছে: হোস্টেড কানেক্ট লিংক, নতুন ক্রেডেনশিয়াল, ওয়েবহুক ও স্বাক্ষরিত স্ট্যাটাস ইভেন্ট, প্রতিটি নেটওয়ার্কের অফিসিয়াল API-তে, এবং প্রতিটি সংযোগ 24/7 পর্যবেক্ষণে।
WhatsApp-এর গ্রাহক সেবা উইন্ডো ব্যবহারকারীর মেসেজ বা কল আসার পর শুরু হয়; প্রতিটি নতুন মেসেজে তা আবার শুরু হয়।
গ্রাহক সেবা উইন্ডো বন্ধ হওয়ার পর একটি WhatsApp ব্যবসা যা পাঠাতে পারে: পূর্বে অনুমোদিত টেমপ্লেট মেসেজ।
Meta-র শর্ত অনুযায়ী AI প্রদানকারীরা WhatsApp ব্যবহার করে AI-কে প্রধান কার্যকারিতা হিসেবে দিতে পারবে না, শুধু আনুষঙ্গিক হিসেবে দিতে পারবে।
একটি Instagram অ্যাকাউন্টের কোনো মন্তব্যের একক ব্যক্তিগত উত্তরের উইন্ডো, মন্তব্যটি করার সময় থেকে গণনা করা হয়।
একই নম্বর WhatsApp Business অ্যাপ ও Cloud API দুটোতেই ব্যবহার হলে তার নির্দিষ্ট থ্রুপুট।
একটি AI এজেন্ট প্রোডাক্টের গ্রাহকের চ্যানেল থেকে কী দরকার?
চারটি জিনিস: গ্রাহকের সংযুক্ত হওয়ার একটি উপায়, তাদের মেসেজ আপনার ব্যাকএন্ডে পৌঁছানো, উত্তর দেওয়ার জন্য একটি টোকেন, এবং সংযোগ কাজ বন্ধ করলে তা জানার উপায়। Partner API এগুলোর প্রতিটি কভার করে, আর মডেল, প্রম্পট ও কথোপকথনের যুক্তি আপনারই থাকে। easyCoexistence অ্যাকাউন্ট সংযুক্ত করে, অ্যাক্সেস নবায়ন রাখে ও পর্যবেক্ষণ করে, এবং আপনার উত্তর আপনার ব্যাকএন্ড থেকে সরাসরি নেটওয়ার্কের API-তে যায়।
প্রতিটি গ্রাহক কীভাবে সংযুক্ত হয়?
আপনার ব্যাকএন্ড POST /connect-sessions দিয়ে একটি কানেক্ট সেশন তৈরি করে, যেখানে চ্যানেল, redirect_url এবং গ্রাহকের জন্য external_ref উল্লেখ থাকে; নম্বরের ক্ষেত্রে থাকে webhook_url ও webhook_verify_token। গ্রাহক হোস্টেড লিংকটি খোলেন, Meta, TikTok, Google বা LinkedIn দিয়ে সাইন ইন করেন, এবং connection_id বা channel_id সহ আপনার অ্যাপে ফিরে আসেন। তাদের easyCoexistence অ্যাকাউন্ট, ইমেইল বা কার্ড লাগে না, এবং আপনার কী দিয়ে করা প্রতিটি সংযোগ আপনার অ্যাকাউন্টের অধীনে থাকে।
মেসেজ ও মন্তব্য কীভাবে আপনার মডেলে পৌঁছায়?
ওয়েবহুকের মাধ্যমে, যেসব নেটওয়ার্ক তা পাঠায়। Meta একটি নম্বরের মেসেজ সরাসরি তার webhook_url-এ পাঠায়, আর ব্যবসার কর্মীরা WhatsApp Business অ্যাপ থেকে যা পাঠান তা smb_message_echoes হিসেবে সেখানে আসে। Instagram ও Facebook-এর মন্তব্য, উল্লেখ ও DM এবং TikTok-এর মন্তব্য প্রতিটি চ্যানেলের গন্তব্যে পাঠানো হয়, তার সিক্রেট দিয়ে স্বাক্ষরিত। YouTube ও LinkedIn কোনো মন্তব্য ইভেন্ট পাঠায় না, তাই এজেন্ট নির্ধারিত সময়ে তাদের API দিয়ে নতুন মন্তব্য পড়ে। প্রতিটি ডেলিভারিতে সঙ্গে সঙ্গে 2xx দিয়ে সাড়া দিন এবং একটি ওয়ার্কারকে মডেল কল করতে দিন।
এজেন্ট কীভাবে উত্তর দেয়?
নেটওয়ার্কের নিজস্ব API-র মাধ্যমে, আপনার ব্যাকএন্ডের আনা ক্রেডেনশিয়াল দিয়ে। একটি WhatsApp উত্তর হলো নম্বরের send_endpoint-এ গ্রাহকের টোকেন সহ একটি POST; একটি Instagram বা Facebook DM যায় অ্যাকাউন্টের messages edge-এ; একটি TikTok উত্তর যায় মন্তব্যের নিচে business/comment/reply/create/ দিয়ে। নিচের স্কেচটি WhatsApp মেসেজের উত্তর দেয়: এটি URL পাথের সিক্রেট যাচাই করে, প্রতিটি আসা মেসেজ সারিতে রাখে এবং আপনার মডেল যা ফেরত দেয় তা দিয়ে উত্তর পাঠায়।
import hmac, os, queue, threading
import requests
from flask import Flask, abort, request
EC = "https://easycoexistence.com/api/v1"
KEY = {"Authorization": f"Bearer {os.environ['EC_API_KEY']}"} # ec_live_...
PATH_SECRET = os.environ["WA_PATH_SECRET"] # the random part of each webhook_url
CONNECTIONS: dict[str, str] = {} # phone_number_id -> connection id, from your database
jobs: queue.Queue = queue.Queue()
app = Flask(__name__)
@app.route("/wa/<secret>", methods=["GET", "POST"])
def whatsapp(secret: str):
if not hmac.compare_digest(secret, PATH_SECRET):
abort(404)
if request.method == "GET": # Meta's handshake when the destination is set
if request.args.get("hub.verify_token") != os.environ["WA_VERIFY_TOKEN"]:
abort(403)
return request.args.get("hub.challenge", "")
for entry in request.get_json().get("entry", []):
for change in entry.get("changes", []):
if change.get("field") == "messages": # echoes and history are context, not prompts
value = change["value"]
for msg in value.get("messages", []):
jobs.put((value["metadata"]["phone_number_id"], msg))
return "", 200 # answer at once; dedupe on msg["id"], since Meta can deliver twice
def worker() -> None:
while True:
phone_number_id, msg = jobs.get()
conn = requests.get(f"{EC}/connections/{CONNECTIONS[phone_number_id]}",
headers=KEY, params={"credentials": 1}).json()
creds = conn["credentials"]
if not creds["access_token"]: # token_ready is false: a new connect session issues one
continue
reply = my_model(conn["external_ref"], msg) # your model, your prompt, your memory
requests.post(creds["send_endpoint"], # a reply to a fresh message is inside the 24 hours
headers={"Authorization": f"Bearer {creds['access_token']}"},
json={"messaging_product": "whatsapp", "to": msg["from"],
"type": "text", "text": {"body": reply}})
threading.Thread(target=worker, daemon=True).start()MCP সার্ভার না Partner API: এজেন্ট কোনটি ব্যবহার করে?
Partner API, যখন এজেন্টটি আপনার প্রোডাক্ট এবং গ্রাহকেরা চ্যানেল আনে: আপনার ব্যাকএন্ড কী রাখে, ইভেন্ট গ্রহণ করে এবং আপনার পছন্দের যেকোনো মডেল চালায়। MCP সার্ভার https://easycoexistence.com/api/mcp Claude বা ChatGPT-এর মতো সহকারীর জন্য উপযুক্ত, যা OAuth সাইন ইনের পর চাহিদামতো কল করা টুলের মাধ্যমে আপনার নিজের easyCoexistence অ্যাকাউন্টে কাজ করে। আপনার কী দিয়ে সংযুক্ত নম্বর ও চ্যানেলও ওই অ্যাকাউন্টেই থাকে, তাই আপনার নিজের দলের কাজের জন্য একটি MCP সেশন সেগুলোতে পৌঁছাতে পারে।
| Partner API | MCP server | |
|---|---|---|
| Built for | Your product, serving your customers | An assistant working on your own account |
| Signs in with | An ec_live_ key, one per account | OAuth, from Claude, ChatGPT or another client |
| Incoming messages | Webhooks to your backend | Read when the assistant calls a tool |
| The model | Any model you run | The assistant's own |
| Replies | Your code calls each network's API | Tools such as send_message and reply_to_comment |
এজেন্সিরা কীভাবে অনেক ক্লায়েন্টের জন্য এজেন্ট চালায়?
একটি অ্যাকাউন্টে, প্রতিটি ক্লায়েন্ট ট্যাগ করে। প্রতিটি কানেক্ট সেশনে ক্লায়েন্টের ID-কে external_ref হিসেবে পাঠান, partner_name দিয়ে হোস্টেড পাতায় এজেন্সির নাম দেখান, এবং GET /connections?external_ref= ও GET /channels?external_ref= দিয়ে একটি ক্লায়েন্টের সংযোগগুলোর তালিকা নিন। প্রতিটি সংযোগের বিল এজেন্সির নামে হয়: প্রতি সংযোগে প্রতি মাসে US$ 9 থেকে US$ 0.75, সংযোগ যত বাড়বে ততই কমবে। আর Meta WhatsApp কথোপকথনের চার্জ ক্লায়েন্টের নিজের WhatsApp Business Account-এ বিল করে। Coexistence-এ ক্লায়েন্টের কর্মীরা এজেন্টের পাশাপাশি WhatsApp Business অ্যাপে উত্তর দিতে থাকেন।
এজেন্টকে কোন নিয়মগুলো মানতে হয়?
নেটওয়ার্কগুলোর নিজস্ব নিয়ম, যা মডেলের উত্তর পাঠানোর আগে আপনার কোডের যাচাই করা উচিত। প্ল্যাটফর্মগুলো এগুলো গ্রাহকের পক্ষে মেনে চলে, কারণ Meta-র ব্যবস্থা গ্রাহকের অ্যাকাউন্টের ওপরই পড়ে:
- WhatsApp: শুধু গ্রাহকের শেষ মেসেজের 24 ঘণ্টার মধ্যে ফ্রি টেক্সট উত্তর; এরপর অনুমোদিত টেমপ্লেট, API-র মাধ্যমে পাঠানো হয়, কারণ Coexistence-এ WhatsApp Business অ্যাপ টেমপ্লেট পাঠাতে পারে না।
- WhatsApp: Meta-র শর্ত AI-কে প্রধান কার্যকারিতা হিসেবে দেওয়া নিষিদ্ধ করে, যা Partner API রেফারেন্স অনুযায়ী সাধারণ-উদ্দেশ্যের AI বট নয় বোঝায়; এবং WhatsApp-এর ডেটায় ফাইন-টিউনিং কেবল ব্যবসার নিজস্ব একচেটিয়া ব্যবহারের জন্য অনুমোদিত।
- Instagram ও Facebook: DM ব্যক্তির শেষ মেসেজের 24 ঘণ্টার মধ্যে, এবং প্রতিটি মন্তব্যের একটি ব্যক্তিগত উত্তর সেটির 7 দিনের মধ্যে।
- TikTok: মন্তব্যের উত্তর প্রকাশ্য, কারণ TikTok সংযোগে কোনো DM নেই।
- ভলিউম: প্রতি Coexistence নম্বরে সেকেন্ডে 20 মেসেজ, এবং মার্কেটিং টেমপ্লেটের জন্য গ্রাহকের WhatsApp Business Account-এ পেমেন্ট পদ্ধতি লাগে।
একটি চ্যানেল কাজ বন্ধ করেছে, এজেন্ট কীভাবে জানে?
স্ট্যাটাস ইভেন্ট থেকে। connection.disconnected বা channel.disconnected মানে গ্রাহক পুনরায় সংযুক্ত না হওয়া পর্যন্ত উত্তর ব্যর্থ হয়, তাই ওই গ্রাহকের এজেন্ট বন্ধ রাখুন, তাকে জানান এবং একটি নতুন কানেক্ট লিংক পাঠান; connection.token_missing মানে নম্বরটি মেসেজ গ্রহণ করতে পারে কিন্তু এখনো পাঠাতে পারে না। connection.connected বা channel.connected আবার এলে নতুন ক্রেডেনশিয়াল আনুন এবং কাজ চালু করুন। প্রতিটি ইভেন্ট X-EC-Signature দিয়ে স্বাক্ষরিত এবং প্রায় 33 ঘণ্টা ধরে পুনরায় পাঠানো হয়।
সাধারণ ভুলগুলো
- 24 ঘণ্টার চেয়ে পুরনো WhatsApp মেসেজের উত্তর মডেলকে ফ্রি টেক্সটে দিতে দেওয়া। উইন্ডো বন্ধ হয়ে গেছে, তাই গ্রাহকের শেষ ইনবাউন্ড সময় যাচাই করুন এবং অনুমোদিত টেমপ্লেটে যান।
- একটি শেয়ার্ড মডেল গ্রাহকদের WhatsApp কথোপকথনে প্রশিক্ষণ দেওয়া। Meta-র শর্ত WhatsApp Business Platform-এর ডেটায় ফাইন-টিউনিং কেবল ব্যবসার একচেটিয়া ব্যবহারের জন্য অনুমোদন করে, অন্য মডেল উন্নত করতে নয়।
- smb_message_echoes-কে গ্রাহকের মেসেজ ধরা। এগুলো ব্যবসার কর্মীরা অ্যাপ থেকে যা পাঠিয়েছেন, তাই এগুলো মডেলকে প্রসঙ্গ হিসেবে দিন, উত্তর দেওয়ার মেসেজ হিসেবে নয়।
- অ্যাকাউন্টের নিজের উত্তরে উত্তর দেওয়া। সে যে Instagram DM পাঠায় তা ইকো হয়ে ফিরে আসে এবং TikTok উত্তর আসে মন্তব্য ইভেন্ট হিসেবে, তাই অ্যাকাউন্ট নিজে যা লিখেছে তা এড়িয়ে যান, নইলে এজেন্ট নিজেকেই উত্তর দেবে।
প্রতি সংযোগে প্রতি মাসে US$ 9 থেকে US$ 0.75, সংযোগ যত যোগ করবেন ততই কমবে, প্রথম 3 দিন ফ্রি ট্রায়াল।
প্রায়শই জিজ্ঞাসিত প্রশ্ন
আমি কি নিজের AI মডেল ব্যবহার করতে পারি?
হ্যাঁ। আপনার ব্যাকএন্ড মেসেজ গ্রহণ করে, আপনার পছন্দের যেকোনো মডেল কল করে এবং গ্রাহকের টোকেন দিয়ে নেটওয়ার্কের API-র মাধ্যমে উত্তর দেয়। WhatsApp নম্বরের মেসেজ Meta থেকে সরাসরি আপনার ওয়েবহুকে যায়, easyCoexistence-এর মধ্য দিয়ে কখনো নয়।
WhatsApp এজেন্টের জন্য Meta-র AI নীতির মানে কী?
Meta-র শর্ত AI প্রদানকারীদের WhatsApp Business Platform ব্যবহার করে AI প্রযুক্তিকে প্রধান কার্যকারিতা হিসেবে দেওয়া থেকে বিরত রাখে, আনুষঙ্গিক বা গৌণ নয়, যেভাবে Meta নির্ধারণ করে। গ্রাহকের পক্ষে সেটি মেনে চলুন, সঙ্গে 24 ঘণ্টার উইন্ডো ও অনুমোদিত টেমপ্লেটও।
এজেন্ট কি TikTok, YouTube বা LinkedIn-এ DM পাঠাতে পারে?
না। ওই নেটওয়ার্কগুলোতে এজেন্ট মন্তব্যে কাজ করে: TikTok-এর উত্তর প্রকাশ্য, আর YouTube ও LinkedIn-এর মন্তব্য তাদের API-র মাধ্যমে পড়া ও উত্তর দেওয়া হয়।
একটি AI এজেন্ট প্রোডাক্টের জন্য easyCoexistence-এর খরচ কত?
প্রতি সংযোগে, সব নেটওয়ার্কে একই: প্রতি সংযোগে প্রতি মাসে US$ 9 থেকে US$ 0.75, সংযোগ যত যোগ করবেন ততই কমবে, প্রথম 3 দিন ফ্রি ট্রায়াল। Meta WhatsApp কথোপকথনের চার্জ প্রতিটি গ্রাহকের নিজের WhatsApp Business Account-এ বিল করে।
আরও পড়ুন
দুই মিনিটে আপনার প্রথম চ্যানেল সংযুক্ত করুন।
প্ল্যাটফর্মের রিভিউয়ের জন্য অপেক্ষা করতে হবে না। WhatsApp, Instagram, TikTok বা অন্য কোনো চ্যানেল সংযুক্ত করুন, তারপর আপনার AI-কে পোস্ট করতে, রিপ্লাই দিতে বা রিপোর্ট দিতে বলুন, আর নিজের চোখে দেখুন কীভাবে কাজ করে।
- 3 দিন ফ্রি
- যেকোনো সময় বাতিল করুন
- শুধুমাত্র অফিশিয়াল API
- 24/7 পর্যবেক্ষণ
যাচাই করা হয়েছে