Claude Code বা Codex দিয়ে WhatsApp বট বানান, অ্যাপে রাখা আপনার নিজের নম্বরে
Claude Code বা Codex-এ একটি WhatsApp MCP সার্ভার যোগ করুন, তারপর কোডিং এজেন্টকে সেটআপ করতে দিন। সে নম্বরের Cloud API ক্রেডেনশিয়াল পড়ে, একটি ওয়েবহুক রিসিভার সাজায়, আসা মেসেজ সেদিকে পাঠায় এবং গত 24 ঘণ্টায় যে লিখেছে তাকে একটি টেস্ট উত্তর পাঠায়। শেষ পর্যন্ত আপনার হাতে থাকে আপনার নিজের এজেন্ট, যা আপনার সার্ভারে আপনার কোড হিসেবে চলে।
easyCoexistence আপনার অ্যাপে রাখা WhatsApp Business নম্বরটিকে Coexistence-এর মাধ্যমে Meta-র Cloud API-র সঙ্গে যুক্ত করে এবং Claude Code ও Codex-কে বানানোর জন্য 30-এরও বেশি MCP টুল দেয়: ক্রেডেনশিয়াল, রাউটিং, টেমপ্লেট, টেস্ট মেসেজ ও অটোমেশন।
সব প্রজেক্টে সার্ভার লোড করে এমন Claude Code ফ্ল্যাগ; ডিফল্ট লোকাল স্কোপ শুধু যেখানে যোগ করা হয়েছে সেখানে লোড করে।
সার্ভারের OAuth সাইন-ইন সংরক্ষণ করে এমন Codex কমান্ড; কোনো ক্রেডেনশিয়াল না থাকলে Codex প্রমাণীকরণ ছাড়াই সংযোগ করতে পারে।
সরাসরি ওয়েবহুক ডেস্টিনেশনের জন্য কী ব্যবহার করতে হবে, এবং Meta-র GET হ্যান্ডশেকে hub.challenge ফিরিয়ে দিতে হবে।
আপনার এন্ডপয়েন্টের {"reply"} আসার জন্য Call my ওয়েবহুক ধাপটি কতক্ষণ অপেক্ষা করে, তারপর ধাপটি ব্যর্থ হয়।
ব্যবহারকারীর শেষ মেসেজের পর কাস্টমার সার্ভিস উইন্ডো; তার বাইরে Meta শুধু টেমপ্লেট মেসেজ গ্রহণ করে।
WhatsApp Business অ্যাপ এবং Cloud API উভয়ের সঙ্গে ব্যবহৃত একটি নম্বরের নির্দিষ্ট থ্রুপুট।
কোডিং এজেন্টকে WhatsApp এজেন্ট বানাতে কী লাগে?
চারটি জিনিস। একটি WhatsApp Business নম্বর, যা Coexistence-এর মাধ্যমে Meta-র Cloud API-র সঙ্গে যুক্ত, যাতে অ্যাপ ফোনেই থাকে আর কোড মেসেজ পাঠাতে ও পেতে পারে। Claude Code বা Codex থেকে সেই নম্বরের একটি MCP সংযোগ, যা কোডিং এজেন্টকে ক্রেডেনশিয়াল পড়তে, রাউটিং বদলাতে এবং টেস্ট মেসেজ পাঠাতে দেয়, আপনাকে কোনো ড্যাশবোর্ড খুলতে না হয়েই। একটি পাবলিক HTTPS ঠিকানা রিসিভারের জন্য, যা এমন একটি হোস্টের হতে পারে যেখানে আপনি ডেপ্লয় করেন, অথবা ডেভেলপমেন্টের সময় একটি টানেল। এবং যে এজেন্ট বানাচ্ছেন তার জন্য একটি মডেল কী।
আপনার মাথায় দুটি এজেন্ট আলাদা রাখুন। Claude Code বা Codex হলো নির্মাতা: সেটি শুধু টার্মিনালে আপনি যখন তার সঙ্গে কাজ করেন তখনই কাজ করে। সেটি যে প্রোগ্রাম লেখে সেটাই কাস্টমারদের উত্তর দেয়, এবং সেশন বন্ধ করার পরও চালু থাকে।
Claude Code ও Codex-এ WhatsApp টুল কীভাবে যোগ করবেন?
প্রতিটিতে টার্মিনাল থেকে একটি URL দিতে হয় এবং OAuth দিয়ে সাইন ইন করতে হয়, তাই কোনো কী কোনো ফাইলে লেখা হয় না। Claude Code-এ --scope user দিয়ে সার্ভার যোগ করুন, যাতে সেটি প্রতিটি প্রজেক্টে লোড হয়, তারপর claude চালু করুন, /mcp চালান, easycoexistence বেছে নিন এবং ব্রাউজারে সাইন ইন করুন। Codex-এ সার্ভার যোগ করে codex mcp login চালান, যা সাইন-ইন সংরক্ষণ করে; codex mcp list দেখায় কী কনফিগার করা আছে। Codex এন্ট্রিটি ~/.codex/config.toml-এ রাখে, যা ChatGPT ডেস্কটপ অ্যাপ এবং Codex IDE এক্সটেনশনও পড়ে।
কাজ হয়েছে কিনা যাচাই করতে এমন কিছু জিজ্ঞেস করুন যার উত্তর শুধু টুলগুলোই দিতে পারে, যেমন “আমার WhatsApp নম্বরগুলো দেখাও”। এজেন্ট list_numbers কল করে এবং প্রতিটি নম্বরের connection_id পায়, যা অন্য প্রতিটি টুল নেয়।
# Claude Code: then start claude and run /mcp to sign in
claude mcp add --transport http easycoexistence --scope user https://easycoexistence.com/api/mcp
# Codex: add, store the OAuth sign-in, check
codex mcp add easycoexistence --url https://easycoexistence.com/api/mcp
codex mcp login easycoexistence
codex mcp listএজেন্টের জন্য কোন রুট বানাতে হবে?
কাস্টমারের মেসেজ আপনার কোডে পৌঁছানোর তিনটি রুট আছে, যেগুলো কোডকে কতটা কাজ করতে হবে তাতে আলাদা। প্রথম সংস্করণের জন্য Call my ওয়েবহুক ধাপটি সবচেয়ে ছোট পথ: easyCoexistence ডুপ্লিকেট বাদ দেয়, আপনি ফোন থেকে উত্তর দিলে সরে যায়, এবং আপনার এন্ডপয়েন্ট ডাকার আগে 24 ঘণ্টার উইন্ডো যাচাই করে, তাই আপনার কোড শুধু উত্তরটি লেখে। যখন এজেন্টের সব ইভেন্ট দরকার, শুধু অটোমেশনের বাছাই করা মেসেজ নয়, তখন Forward URL বা সরাসরি ডেস্টিনেশনে যান।
কোডিং এজেন্টকে কী করতে বলবেন?
রুট, ভাষা এবং নিয়মগুলো আগে থেকেই দিন, এবং কোড লেখার আগে একটি প্ল্যান চান। বলে দিন কোন টুল কল সে নিজে করতে পারবে: ক্রেডেনশিয়াল ও ডক পড়া ক্ষতিকর নয়, কিন্তু মেসেজ কোথায় যাবে তা বদলানো লাইভ নম্বরকে প্রভাবিত করে। get_docs easyCoexistence-এর ডকুমেন্টেশন ফেরত দেয়, যার মধ্যে একটি রিসিভার ডেলিভারি কীভাবে প্রমাণীকরণ করে তাও আছে, তাই এজেন্ট নিয়ম অনুমান না করে পড়তে পারে। এর মতো একটি অনুরোধ এমন একটি রিসিভার দেয় যা আপনি এক বসায় পর্যালোচনা করতে পারবেন:
Build a WhatsApp agent in Node.js for my number +55 11 4000 1234.
1. Call list_numbers, then get_api_credentials for that number.
Put send_endpoint and access_token in .env, never in code.
2. Scaffold an HTTPS server with POST /wa/<long random path>.
Verify X-EC-Signature (HMAC-SHA256 of "<t>.<raw body>").
Skip message ids already handled.
On smb_message_echoes, stay quiet on that chat for 4 hours.
3. Reply with my model only within 24 hours of the
customer's last message.
4. Write tests for the signature check and the 24-hour rule.
Do not call set_inbound_mode or set_webhook_destination
until I say so.রিসিভার কীভাবে সংযোগ করবেন ও পরীক্ষা করবেন?
সার্ভার এমন জায়গায় চালু করুন যেখানে Meta ও easyCoexistence HTTPS দিয়ে পৌঁছাতে পারে, তারপর রাউটিং এজেন্টকে করতে দিন। Forward URL রুটের জন্য সে Automations on mode-এ থাকা একটি নম্বরে আপনার URL দিয়ে set_inbound_mode কল করে; ফরওয়ার্ড সিক্রেট একবারই ফেরত আসে, এবং এজেন্ট সেটি আপনার .env-এ লেখে। সরাসরি রুটের জন্য এন্ডপয়েন্টকে আগে Meta-র GET হ্যান্ডশেকের উত্তর দিতে হবে, তারপর এজেন্ট URL, তার পথে একটি দীর্ঘ এলোমেলো সিক্রেট এবং আপনার verify টোকেন দিয়ে set_webhook_destination কল করে।
পরীক্ষা করতে আপনার নিজের ফোন থেকে ব্যবসার নম্বরে মেসেজ পাঠান এবং লগ দেখুন: রিসিভার ইভেন্টটি দেখবে, মডেল উত্তর দেবে, আর উত্তরটি চ্যাটে আসবে। আপনি এইমাত্র লিখেছেন বলে 24 ঘণ্টার উইন্ডো খোলা আছে, তাই কোডিং এজেন্ট নিজের নম্বরেও send_message চেষ্টা করতে পারে।
তৈরি হওয়া এজেন্টের কি এখনও MCP সার্ভার দরকার?
না। MCP সার্ভার হলো নির্মাতার টুল, যা আপনার হয়ে সাইন ইন করে। আপনার ডেপ্লয় করা এজেন্ট get_api_credentials-এর ফেরত দেওয়া send_endpoint ও access_token ব্যবহার করে Meta-র Graph API-তে পাঠায়; এটি ব্যবসার নিজের টোকেন, যা তার WhatsApp অ্যাসেটে সীমাবদ্ধ, আর গ্রহণ করে আপনার সেট করা রুটে। access_token null এলে ড্যাশবোর্ড থেকে নম্বরটি আবার সংযুক্ত করুন; তাতে যে টোকেন ইতিমধ্যে কাজ করছে তা না বদলেই একটি টোকেন ইস্যু হয়।
MCP সংযোগ এজেন্টের চারপাশের কাজের জন্য রাখুন: create_template দিয়ে টেমপ্লেট বানানো, কিছু গোলমাল মনে হলে get_number_health দেখা, এবং যে কোনো অটোমেশনের রান লগ পড়া যা মেসেজ আপনার কোডে পাঠায়।
কীভাবে সেট আপ করবেন
- Connect your numberAt easycoexistence.com, run Meta's Embedded Signup and scan the code with the WhatsApp Business app; the app keeps its chats.
- Add the server to your coding agentRun the claude mcp add or codex mcp add command, then sign in with /mcp in Claude Code or codex mcp login in Codex.
- Ask for credentials and a planHave the agent call list_numbers and get_api_credentials, store the values in .env and propose the receiver before writing it.
- Expose the receiver over HTTPSDeploy it, or run a tunnel while developing, and confirm the URL answers from outside your machine.
- Route the messagesLet the agent call set_inbound_mode with a Forward URL, or set_webhook_destination for the direct route, once you approve.
- Test from your phoneSend the business number a message and check that your agent's reply arrives in the same chat.
সাধারণ ভুলগুলো
- প্রথম 24 ঘণ্টায় একটি অস্থায়ী টানেলকে সরাসরি ডেস্টিনেশন হিসেবে সংরক্ষণ করা। Meta-র কন্টাক্ট ও সর্বোচ্চ 6 মাসের চ্যাটের এককালীন ইমপোর্ট ওই URL-এ যায়, এবং টানেল বন্ধ হলে তা হারিয়ে যায়।
- অটোমেশন চলছে এমন একটি নম্বরে সরাসরি ডেস্টিনেশন সেট করা। নম্বরটি সরাসরি মোডে চলে যায় এবং তার অটোমেশন বন্ধ হয়; দুটোই রাখতে Automations on mode-এ একটি Forward URL ব্যবহার করুন।
- এজেন্টের লেখা .env কমিট করা। আগে এটি .gitignore-এ যোগ করুন, কারণ অ্যাক্সেস টোকেন যার হাতে থাকে, সে ব্যবসার হয়ে কাস্টমারদের মেসেজ পাঠাতে পারে।
- যে কন্টাক্ট গত 24 ঘণ্টায় লেখেনি তাকে send_message দিয়ে পরীক্ষা করা। উইন্ডোর বাইরে Meta ফ্রি টেক্সট প্রত্যাখ্যান করে, তাই প্রথমে আপনার নিজের ফোন থেকে নম্বরে মেসেজ পাঠান।
তারপর আপনার এজেন্ট আপনার নিজের সার্ভারে চলে, এবং প্রতিটি নম্বর 24/7 পর্যবেক্ষণ করা হয়, সতর্কবার্তাসহ। US$ 9 থেকে US$ 0.75 পর্যন্ত প্রতি নম্বর প্রতি মাসে, নম্বর বাড়ালে কমে; প্রথম 3 দিন ফ্রি।
প্রায়শই জিজ্ঞাসিত প্রশ্ন
এটি কি Cursor বা অন্য কোডিং টুলে কাজ করে?
হ্যাঁ। যে কোনো MCP ক্লায়েন্ট যা OAuth সহ Streamable HTTP-এ রিমোট সার্ভারে সংযোগ করে, সে একই URL ব্যবহার করতে পারে, যার মধ্যে Cursor, VS Code, Gemini CLI এবং Antigravity আছে। এক ক্লায়েন্ট থেকে অন্যটিতে শুধু কনফিগারেশনের ফরম্যাট বদলায়।
এজেন্টটি কোন ভাষায় লিখতে হবে?
যে কোনো ভাষা যা HTTPS পরিবেশন করতে পারে এবং HMAC-SHA256 গণনা করতে পারে। Node.js ও Python সবচেয়ে প্রচলিত পছন্দ, এবং দুটোর জন্যই পরীক্ষিত নমুনা রয়েছে, সিগনেচার যাচাই, ডুপ্লিকেট হ্যান্ডলিং ও ফোন পজ সহ, Node.js and Python agent পেজে।
আমার কি নিজের Meta অ্যাপ বা App Review দরকার?
না। নম্বরটি easyCoexistence-এর Meta অ্যাপের মাধ্যমে Cloud API-তে যুক্ত হয় এবং ব্যবসার নিজের Business Portfolio-তেই থাকে। আপনার কোড যে টোকেন দিয়ে পাঠায় তা ব্যবসার নিজের, তাই আপনার কোনো Meta অ্যাপ এতে জড়িত নয়।
কোডিং এজেন্ট কি প্রয়োজনীয় টেমপ্লেট বানাতে পারে?
হ্যাঁ, create_template দিয়ে, তারপর Meta উত্তর না দেওয়া পর্যন্ত get_template_status; সাধারণত কয়েক মিনিটে, সর্বোচ্চ প্রায় 24 ঘণ্টায়। কথোপকথন শুরু করতে, অথবা 24 ঘণ্টার উইন্ডো বন্ধ হওয়ার পর লিখতে, আপনার এজেন্টের একটি অনুমোদিত টেমপ্লেট দরকার।
আরও পড়ুন
শুরু করতে প্রস্তুত?
মাস নয়, কয়েক মিনিটেই WhatsApp Coexistence সেট আপ করুন। ফোনে অ্যাপটি কাজ করতে থাকে।
ফ্রি ট্রায়াল শুরু করুনযাচাই করা হয়েছে