AI এজেন্টের জন্য WhatsApp API: মিনিটেই অফিশিয়াল অ্যাক্সেস, Tech Provider না হয়েও
একজন AI এজেন্ট Meta-র Cloud API-এর মাধ্যমে অফিশিয়াল WhatsApp অ্যাক্সেস পায়, এবং WhatsApp Business অ্যাপে থাকা একটি নম্বর একটি Tech Provider বা Solution Partner-এর মাধ্যমে তাতে যুক্ত হয়। আপনি নিজেই একটি হতে পারেন, যার জন্য ব্যবসায়িক যাচাইকরণ, App Review-এর ভিডিও ও একটি Embedded Signup বিল্ড লাগে, অথবা ইতিমধ্যে সেই পদে থাকা একটি প্রোভাইডারের মাধ্যমে সংযুক্ত হতে পারেন। নম্বরটি মিনিটের মধ্যে যুক্ত হয় এবং এজেন্ট পায় MCP টুল বা API ক্রেডেনশিয়াল।
easyCoexistence একটি স্বাধীন Meta Tech Provider: এটি Coexistence-এর মাধ্যমে একটি WhatsApp Business নম্বরকে মিনিটের মধ্যে Cloud API-তে যুক্ত করে, ফলে আপনার এজেন্ট অফিশিয়াল অ্যাক্সেস পায় এবং ব্যবসা অ্যাপটি রেখে দেয়।
যে কেউ WhatsApp Business অ্যাপে থাকা একটি নম্বর যুক্ত করে, Meta তার কাছে যা চায়: Tech Provider বা Solution Partner মর্যাদা।
App Review চায় একটি ভিডিও, যেখানে আপনার অ্যাপ থেকে একটি মেসেজ পাঠানো হয়, এবং আরেকটি, যেখানে আপনার অ্যাপ একটি টেমপ্লেট তৈরি করে।
App Review whatsapp_business_messaging ও whatsapp_business_management-এর জন্য যে অনুমতি দেয়, দুটিই Tech Provider হওয়ার জন্য প্রয়োজন।
Meta যখন Embedded Signup v2 ও v3 বাতিল করে, তখন ইন্টিগ্রেশনগুলোকে v4-তে সরে যেতে বলে।
একই সঙ্গে WhatsApp Business অ্যাপ ও Cloud API-তে ব্যবহৃত একটি নম্বরের স্থির থ্রুপুট।
Partner API-র মাধ্যমে কোনো প্ল্যাটফর্ম গ্রাহকের নম্বর যুক্ত করলে, হোস্টেড কানেক্ট লিংক কতক্ষণ বৈধ থাকে।
একজন AI এজেন্টের অফিশিয়াল WhatsApp ব্যবহারে কী লাগে?
Meta-র Cloud API থেকে চারটি জিনিস লাগে। একটি ফোন নম্বরের আইডি এবং whatsapp_business_messaging অনুমতিসহ একটি অ্যাক্সেস টোকেন, যাতে এজেন্ট messages এন্ডপয়েন্ট কল করতে পারে। একটি ওয়েবহুক এন্ডপয়েন্ট, যেখানে Meta আসা মেসেজ পাঠায়, এবং অ্যাপের সঙ্গে ভাগ করা নম্বরে ফোনে টাইপ করা উত্তরের জন্য smb_message_echoes। অনুমোদিত টেমপ্লেট, কারণ টাইপ করা মেসেজ কেবল সেই ব্যক্তির কাছে পৌঁছায় যে শেষ 24 ঘণ্টার মধ্যে লিখেছে। আর সংযোগ ভেঙে গেলে জানার একটি উপায়, কারণ API দিকটি বন্ধ হলেও ফোনের অ্যাপ চালু থাকে।
মানুষ প্রথমে যে শর্টকাটটি খুঁজে পায় তা হলো WhatsApp Web অটোমেশন, যা একটি লিংক করা ডিভাইস হিসেবে সাইন ইন করে। এটি WhatsApp-এর শর্তাবলি ভাঙে এবং নম্বরটিকে ব্যান হওয়ার ঝুঁকিতে ফেলে, এজেন্ট তার উপরে যা-ই চালাক না কেন।
Tech Provider পথে কী কী জড়িত?
Meta-র নিজস্ব ধারাবাহিকতা, এই ক্রমে। প্রতিটি ধাপ বিনামূল্যে, এবং কোনোটিই অর্থ দিয়ে দ্রুত করা যায় না: রিভিউগুলো Meta-র সূচি অনুযায়ী চলে এবং Meta কোনো সময়সীমা প্রকাশ করে না, তাই প্রথম গ্রাহকের নম্বর যুক্ত হওয়ার আগে দিনের বদলে সপ্তাহের হিসাব রাখুন। এরপর ব্যাকএন্ডকে সচল থাকতে হয়: প্রতিটি সাইনআপের পর টোকেন বিনিময়, একটি ওয়েবহুক রিসিভার, প্রতি নম্বরের রাউটিং, এবং Meta-র 14 দিনের নিষ্ক্রিয়তার নিয়মের মতো সংযোগ বিচ্ছিন্ন হওয়ার পর্যবেক্ষণ।
সংক্ষিপ্ত পথটি কী?
এমন একটি প্রোভাইডারের মাধ্যমে নম্বরটি সংযুক্ত করুন যে ইতিমধ্যে এই প্রক্রিয়া পার করেছে। easyCoexistence-এর সঙ্গে ব্যবসা Meta-র Embedded Signup চালায় এবং WhatsApp Business অ্যাপ দিয়ে একটি কোড স্ক্যান করে, যা প্রায় 2 মিনিট লাগে। নম্বরটি ব্যবসার নিজস্ব Business Portfolio-তে Cloud API-তে যুক্ত হয়, আর অ্যাপও চালু থাকে। এরপর এজেন্ট যে রূপে কথা বলে সেই রূপে অ্যাক্সেস পায়: ChatGPT, Claude, Claude Code বা Codex-এর মতো অ্যাসিস্ট্যান্টের জন্য MCP টুল, অথবা আপনার চালানো কোডের জন্য নম্বরের ক্রেডেনশিয়াল ও ওয়েবহুক।
| Connect through easyCoexistence | Become a Tech Provider | |
|---|---|---|
| Meta app and App Review | Not needed: the number joins through ours | Yours to build and pass |
| Embedded Signup | Hosted, with the QR scan in the app | You integrate version 4 and host the flow |
| First number connected | Minutes after signing up | After verification and review |
| Webhook trust | A secret in your URL, or X-EC-Signature on forwarded messages | Your app secret signs Meta's deliveries |
| Disconnection alerts | Every number watched 24/7, 14-day rule included | Monitoring you build and run |
| Who owns the WhatsApp Business Account | The business, in its own portfolio | The business |
এজেন্ট নম্বরের ক্রেডেনশিয়াল কীভাবে পায়?
get_api_credentials টুলের মাধ্যমে, অথবা ড্যাশবোর্ডে নম্বরের পেজ থেকে। টুলটি Graph API বেস URL, WhatsApp Business Account ID, ফোন নম্বরের আইডি, সেন্ড এন্ডপয়েন্ট এবং, যদি থাকে, ব্যবসার নিজস্ব অ্যাক্সেস টোকেন ফেরত দেয়, যা তার WhatsApp অ্যাসেটে সীমাবদ্ধ। কোনো ক্লায়েন্ট টোকেন ইস্যু না হলে টোকেনটি null হয়ে আসে, সঙ্গে একটি নোট থাকে যে ড্যাশবোর্ড থেকে নম্বরটি আবার সংযুক্ত করলে একটি টোকেন ইস্যু হবে, কিন্তু যেটি কাজ করছে সেটি বদলাবে না। আনতে হয় এমন কোনো অ্যাপ সিক্রেট নেই, কারণ Meta ওয়েবহুক easyCoexistence-এর অ্যাপ সিক্রেট দিয়ে সাইন করে, যা কখনো ভাগ করা হয় না। টুলটির সক্রিয় প্ল্যান লাগে, কারণ টোকেনটি মেসেজ পাঠাতে পারে।
curl -X POST "$SEND_ENDPOINT" \
-H "Authorization: Bearer $ACCESS_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"messaging_product": "whatsapp",
"to": "5511999998888",
"type": "text",
"text": { "body": "Your order #1042 is ready for pickup." }
}'ইনকামিং মেসেজ এজেন্টের কাছে কীভাবে পৌঁছায়?
প্রতিটি নম্বরের দুটি মোড আছে, যা set_inbound_mode দিয়ে বা নম্বরের পেজ থেকে বদলানো যায়। সরাসরি আপনার সার্ভারে: set_webhook_destination Meta-কে সরাসরি আপনার HTTPS এন্ডপয়েন্টে পাঠায়, যেটিকে Meta-র GET হ্যান্ডশেকের উত্তর দিতে হয়, এবং easyCoexistence কখনো মেসেজ দেখে না, তাই অটোমেশন বন্ধ থাকে। Meta ওই ডেলিভারিগুলো আমাদের অ্যাপ সিক্রেট দিয়ে সাইন করে বলে, URL পথে একটি দীর্ঘ এলোমেলো সিক্রেট রাখুন এবং তা ছাড়া আসা অনুরোধ প্রত্যাখ্যান করুন।
অটোমেশন চালু: Meta easyCoexistence-কে ডেলিভার করে, অটোমেশন উত্তর দিতে পারে, এবং একটি ঐচ্ছিক Forward URL Meta-র মূল পেলোড "value"-র অধীনে পায়, যা X-EC-Signature: t=<unix>,v1=<HMAC-SHA256 of "<t>.<body>">-তে সাইন হয়, একবার দেখানো একটি সিক্রেট দিয়ে। অটোমেশনের “Call my Webhook” ধাপ এজেন্টকে মেসেজ ও চ্যাটের শেষ 10টি মেসেজও দেয়, এবং আপনার উত্তর যদি 20 সেকেন্ডের মধ্যে {"reply": "..."} হয়, তবে সেটি পাঠায়।
এজেন্টকে কোন সীমাগুলো মেনে চলতে হয়?
Meta-র সীমা, এবং যেকোনো প্রোভাইডারের মাধ্যমে সেগুলো একই। যে এজেন্ট আগে থেকে এগুলো জানে, সে বাগের মতো দেখায় এমন ব্যর্থতা এড়ায়:
- প্রতি সেকেন্ডে প্রতি নম্বরে 20টি মেসেজ, WhatsApp Business অ্যাপের সঙ্গে ভাগ করা নম্বরের জন্য Meta-র নির্ধারিত।
- টাইপ করা মেসেজ কেবল গ্রাহকের শেষ মেসেজের 24 ঘণ্টার মধ্যে; তারপর একটি অনুমোদিত টেমপ্লেট।
- টেমপ্লেট শুধু API দিয়ে যায়, কারণ Coexistence নম্বরের অ্যাপ সেগুলো পাঠাতে পারে না।
- অ্যাপে কোনো ব্যক্তি যে উত্তর টাইপ করে তা
smb_message_echoesহিসেবে আসে; সেই চ্যাটে এজেন্ট থামান, নইলে গ্রাহক দুটি উত্তর পায়। - গ্রুপ চ্যাট API-তে সিঙ্ক হয় না, তাই এজেন্ট এক-থেকে-এক চ্যাটে কাজ করে।
- কন্ট্যাক্ট ও সর্বোচ্চ 6 মাসের এক-থেকে-এক চ্যাট একবার আমদানি হয়, কেবল যদি সংযোগের 24 ঘণ্টার মধ্যে একটি সরাসরি ওয়েবহুক গন্তব্য সংরক্ষিত হয়; অটোমেশন চালু থাকা নম্বর এই আমদানি পায় না।
- ভয়েস ও ভিডিও কল অ্যাপে চালু থাকে, কিন্তু Cloud API একটি Coexistence নম্বরে কল বহন করে না, তাই এজেন্ট টেক্সটে কাজ করে।
কোনো প্ল্যাটফর্ম কি নিজের গ্রাহকদের নম্বর এভাবে যুক্ত করতে পারে?
হ্যাঁ, Partner API-র মাধ্যমে, যেভাবে একটি SaaS বা এজেন্সি নিজের Tech Provider মর্যাদা ছাড়াই গ্রাহকদের যুক্ত করে। create_api_key দিয়ে কী তৈরি করুন (এটি ec_live_ দিয়ে শুরু হয় এবং একবারই দেখানো হয়), তারপর আপনার ব্যাকএন্ড থেকে POST /api/v1/connect-sessions কল করুন, অথবা সহকারী থেকে create_connect_link ব্যবহার করুন, যা 1 ঘণ্টা বৈধ একটি হোস্টেড লিংক দেয়। গ্রাহক সেখানে Meta-র পপআপ ও QR স্ক্যান চালায় এবং একটি connection_id-সহ আপনার redirect_url-এ ফিরে আসে। এরপর GET /api/v1/connections/:id?credentials=1 গ্রাহকের নিজস্ব টোকেন ফেরত দেয়, এবং connection.disconnected-এর মতো স্ট্যাটাস ইভেন্টগুলো X-EC-Signature দিয়ে সাইন হয়ে আসে। প্রতিটি নম্বর আপনার অ্যাকাউন্টে একই প্রতি-নম্বর স্তরে বিল হয়।
সাধারণ ভুলগুলো
- সরাসরি ডেস্টিনেশনে X-Hub-Signature-256 যাচাই করা। Meta easyCoexistence-এর অ্যাপ সিক্রেট দিয়ে সাইন করে, যা কখনো ভাগ করা হয় না, তাই আসল ডেলিভারিগুলোও যাচাইয়ে ব্যর্থ হয়; URL-এ একটি দীর্ঘ এলোমেলো সিক্রেট বিশ্বাস করুন, অথবা X-EC-Signature সহ ফরওয়ার্ডিং ব্যবহার করুন।
- n8n-এর WhatsApp Trigger নোড দিয়ে রিসিভ করা। সেটি নিজের Meta অ্যাপ আশা করে; বরং URL-এ একটি সিক্রেটসহ সাধারণ Webhook নোড ব্যবহার করুন।
- smb_message_echoes উপেক্ষা করা। তখন এজেন্ট এমন একজন মানুষের উপরে উত্তর দেয় যিনি ফোন থেকে আগেই উত্তর দিয়ে ফেলেছেন, এবং গ্রাহক দুটি উত্তর পড়ে।
- সংযোগের কয়েক দিন পরে সরাসরি ওয়েবহুক গন্তব্য সংরক্ষণ করা, বা নম্বরটি অটোমেশনে রেখে দেওয়া। Meta-র এক-বারের কন্ট্যাক্ট ও সর্বোচ্চ 6 মাসের চ্যাট আমদানির জন্য সংযোগের 24 ঘণ্টার মধ্যে একটি সরাসরি গন্তব্য সংরক্ষিত হতে হয়।
এজেন্ট 30-এরও বেশি MCP টুলের মাধ্যমে, অথবা প্রতিটি নম্বরের ক্রেডেনশিয়াল ও ওয়েবহুকের মাধ্যমে কাজ করে, এবং প্রতিটি নম্বর 24/7 পর্যবেক্ষণ করা হয় সতর্কবার্তাসহ। প্রতি নম্বর প্রতি মাসে US$ 9 থেকে US$ 0.75 পর্যন্ত, নম্বর যোগ করলে মূল্য কমে, প্রথম 3 দিন ফ্রি।
প্রায়শই জিজ্ঞাসিত প্রশ্ন
আমার কি নিজের Meta অ্যাপ লাগবে?
না। নম্বরটি easyCoexistence-এর Meta অ্যাপ দিয়ে যুক্ত হয় এবং ব্যবসার নিজস্ব Business Portfolio ও WhatsApp Business Account-এ থাকে। আপনার কোড get_api_credentials থেকে পাওয়া ব্যবসার নিজস্ব টোকেন দিয়ে পাঠায়, তাই ভবিষ্যতে নিজে কোনো অ্যাপ না বানালে আপনার কোনো অ্যাপ জড়িত হয় না।
এজেন্ট ও দল কি একই সময়ে নম্বরটি ব্যবহার করতে পারে?
হ্যাঁ। Meta Cloud API ও WhatsApp Business অ্যাপের মধ্যে মেসেজ মিরর করে, তাই এজেন্ট যা পাঠায় তা ফোনের অ্যাপের চ্যাট থ্রেডে দেখা যায়, এবং দল অ্যাপে যা টাইপ করে তা smb_message_echoes হিসেবে আপনার সিস্টেমে পৌঁছায়।
কোন এজেন্ট ফ্রেমওয়ার্ক এর সঙ্গে কাজ করে?
OAuth সহ HTTP-এর উপর MCP বলে এমন যেকোনো ক্লায়েন্ট, যেমন ChatGPT, Claude, Claude Code, Codex ও Cursor, এবং Meta-র Graph API কল করে এমন যেকোনো কোড: Node.js, Python, n8n, LangChain, OpenAI Agents SDK বা Vercel AI SDK। নিচের API Meta-র নিজস্ব, তাই এজেন্টের ভেতরে কোনো মালিকানাধীন উপাদান নেই।
সাধারণ কাজের AI অ্যাসিস্ট্যান্ট কি WhatsApp-এ অনুমোদিত?
Meta-র Business Solution Terms-এর ধারা 4.7 সাধারণ-উদ্দেশ্যের AI অ্যাসিস্ট্যান্টের প্রদানকারীদের WhatsApp Business Platform-এ তা দিতে নিষেধ করে, যেখানে AI প্রধান কার্যকারিতা, যেমন Meta নির্ধারণ করে, এবং তা 15 জানুয়ারি 2026 থেকে কার্যকর। যে ব্যবসা নিজের গ্রাহকদের জন্য সহায়তা, বিক্রি বা বুকিংয়ে AI ব্যবহার করে, সে এর লক্ষ্য নয়; আর EU ও ব্রাজিলের নিয়ন্ত্রকরা প্রতিদ্বন্দ্বী অ্যাসিস্ট্যান্টদের জন্য নিয়মটি স্থগিত বা প্রত্যাহার করতে Meta-কে আদেশ দিয়েছে।
আরও পড়ুন
শুরু করতে প্রস্তুত?
মাস নয়, কয়েক মিনিটেই WhatsApp Coexistence সেট আপ করুন। ফোনে অ্যাপটি কাজ করতে থাকে।
ফ্রি ট্রায়াল শুরু করুনযাচাই করা হয়েছে