Vercel AI SDK দিয়ে একটি WhatsApp এজেন্ট তৈরি করুন
আসা মেসেজগুলো সেই রুট হ্যান্ডলারে পৌঁছায়, যেটি নম্বরের ওয়েবহুক গন্তব্য হিসেবে সেট করা থাকে। হ্যান্ডলার generateText কল করে এবং উত্তরটি Cloud API-এর মাধ্যমে পাঠায়। নম্বরের ওপর কাজ করা টুলের জন্য @ai-sdk/mcp থেকে createMCPClient HTTP-এর মাধ্যমে EasyCoexistence MCP সার্ভারে সংযুক্ত হয়, এবং authProvider-এর মাধ্যমে OAuth দিয়ে সাইন ইন করে।
এটি সেই প্যাকেজ যা createMCPClient দেয়, অর্থাৎ AI SDK-এর MCP ক্লায়েন্ট।
একটি authProvider দিয়ে AI SDK-এর MCP HTTP ট্রান্সপোর্টে OAuth সমর্থিত।
WhatsApp Business অ্যাপ ও Cloud API দুটোতেই ব্যবহৃত একটি নম্বরের জন্য স্থির থ্রুপুট।
রুট হ্যান্ডলার কীভাবে WhatsApp মেসেজ গ্রহণ করে?
একটি রুটে দুটি মেথড থাকে, যা নম্বরের ওয়েবহুক গন্তব্য হিসেবে সেট করা হয় এবং পাথে একটি দীর্ঘ এলোমেলো সিক্রেট থাকে।
GET অংশটি Meta-র যাচাইকরণের উত্তর দেয়। কোয়েরি থেকে hub.mode, hub.verify_token ও hub.challenge পড়ুন, টোকেন মিলিয়ে দেখুন, এবং challenge সাধারণ টেক্সট হিসেবে ফেরত দিন। JSON হেল্পারের মাধ্যমে ফেরত দেওয়াই পুরোনো ভুল: বডিতে চারপাশে উদ্ধৃতিচিহ্ন চলে আসে এবং Meta ডেলিভারি শুরু করে না।
POST ইভেন্ট গ্রহণ করে। দ্রুত 200 ফেরত দিন এবং মডেল কল পরে করুন, কারণ Meta ধীর প্রতিক্রিয়া আবার চেষ্টা করে, আর কোল্ড স্টার্টের সময় মডেল সরাসরি চালালে একই মেসেজের দুটি উত্তর যেতে পারে। যে প্ল্যাটফর্ম রেসপন্স পাঠানোর পর ফাংশন শেষ করে দেয়, সেখানে কাজটি একটি কিউতে বা প্ল্যাটফর্মের রেসপন্সের পরের কাজের ব্যবস্থায় পাঠান।
পাথের সিক্রেটই প্রমাণীকরণ। Meta প্রতিটি ডেলিভারি Tech Provider-এর অ্যাপ সিক্রেট দিয়ে সাইন করে, তাই X-Hub-Signature-256 হেডার আপনার দিকে যাচাই করা যায় না।
AI SDK WhatsApp টুল কীভাবে লোড করে?
@ai-sdk/mcp থেকে createMCPClient এবং HTTP ট্রান্সপোর্ট দিয়ে, যা AI SDK ডকুমেন্টেশন প্রোডাকশনের জন্য সুপারিশ করে। ট্রান্সপোর্ট সার্ভারের URL এবং একটি authProvider নেয়। authProvider-এর মাধ্যমে OAuth-ই EasyCoexistence MCP সার্ভারের অনুমোদনের উপায়: এটি OAuth মেটাডেটা প্রকাশ করে, ডাইনামিক ক্লায়েন্ট রেজিস্ট্রেশন ও PKCE সমর্থন করে এবং সাইন ইনের পর নিজস্ব টোকেন দেয়। হেডারে বসানোর মতো কোনো API কী নেই।
ক্লায়েন্টের টুলগুলো সরাসরি generateText বা streamText-এ যায়। তখন মডেল list_numbers, send_message, send_template, get_number_health এবং বাকিগুলো দেখে, যাদের বর্ণনায় 24 ঘণ্টার উইন্ডোর কথা লেখা থাকে। কল শেষ হলে ক্লায়েন্ট বন্ধ করুন: স্ট্রিমের ক্ষেত্রে onEnd কলব্যাকে, অন্যথায় finally ব্লকে, যেমন AI SDK ডকুমেন্টেশন চায়।
যেখানে মডেলের সিদ্ধান্ত নেওয়ার কথা, সেখানে এটি ব্যবহার করুন। যে মেসেজটি এইমাত্র এসেছে তার উত্তর দেওয়ার জন্য হ্যান্ডলার থেকে সরাসরি Cloud API কল ছোট ও সহজ।
import { createMCPClient } from "@ai-sdk/mcp";
const mcp = await createMCPClient({
transport: {
type: "http",
url: "https://easycoexistence.com/api/mcp",
authProvider, // your OAuthClientProvider implementation
},
});
try {
const tools = await mcp.tools();
// pass tools to generateText({ model, tools, prompt })
} finally {
await mcp.close();
}নম্বরটি Coexistence-এ থাকলে কী বদলায়?
কোডের যে দুটি বিষয় জানা দরকার। প্রথমত, কথোপকথনে হয়তো আগে থেকেই একজন মানুষ আছে। WhatsApp Business অ্যাপ নম্বরে কাজ করতে থাকে, এবং ফোনে টাইপ করা প্রতিটি উত্তর একটি echo ইভেন্ট হিসেবে রুটে পৌঁছায়। যে হ্যান্ডলার echo-র পর একজন যোগাযোগকারীর জন্য মডেল থামিয়ে দেয়, সে মানুষের উপর দিয়ে মডেল উত্তর দেওয়া আটকায়।
দ্বিতীয়ত, নম্বর থেকে পাঠানোর সীমা স্থির, প্রতি সেকেন্ডে 20 মেসেজ। একটি কথোপকথনমূলক এজেন্ট সেই সীমার কাছেও যায় না, কিন্তু যোগাযোগ তালিকার উপর Promise.all দিয়ে লেখা ব্রডকাস্ট লুপ পৌঁছে যাবে, তাই সেটি ব্যাচ করুন।
বাকি সবকিছু সাধারণ Cloud API। গ্রাহকের শেষ মেসেজের 24 ঘণ্টার মধ্যে ফ্রি টেক্সট অনুমোদিত। এরপর শুধু অনুমোদিত টেমপ্লেট যায়, এবং ফ্রি টেক্সট পাঠালে গ্রাহক কিছু না দেখেই ত্রুটি 131047 ফেরত আসে।
সাধারণ ভুলগুলো
- JSON রেসপন্স হেল্পার দিয়ে challenge ফেরত দেওয়া। চারপাশের উদ্ধৃতিচিহ্ন Meta-র যাচাই ব্যর্থ করে।
- Meta-কে উত্তর দেওয়ার আগে generateText চালানো। কোল্ড স্টার্টে আবার চেষ্টা দ্বিতীয় উত্তর তৈরি করে।
- MCP ক্লায়েন্ট বন্ধ করতে ভুলে যাওয়া। প্রতিটি রিকোয়েস্টে একটি সংযোগ প্ল্যাটফর্ম বন্ধ না করা পর্যন্ত খোলা থাকে।
easycoexistence.com-এ নম্বর সংযুক্ত করুন, ওয়েবহুক গন্তব্য আপনার রুট হ্যান্ডলারে সেট করুন, এবং একটি OAuth সাইন ইনে MCP ক্লায়েন্ট যোগ করুন। প্রতি নম্বরে মাসে US$ 9 থেকে শুরু করে, নম্বর যোগ করলে কমে US$ 0.75 হয়, প্রথম 3 দিন ফ্রি।
প্রায়শই জিজ্ঞাসিত প্রশ্ন
শুধু Vercel-এ কাজ করে?
না। AI SDK একটি TypeScript লাইব্রেরি, এবং রুট এমন যেকোনো হোস্টে চলতে পারে যা HTTPS সার্ভ করে এবং GET ও POST-এর উত্তর দেয়।
আমার কি MCP ক্লায়েন্ট আদৌ লাগবে?
উত্তর দেওয়ার জন্য না। নম্বরের টোকেন দিয়ে Cloud API মেসেজ এন্ডপয়েন্টে একটি fetch এই কাজ করে। মডেল যখন ঠিক করে কী করা হবে, তখন MCP-র প্রয়োজন হয়।
মডেল কোন প্রোভাইডার হতে পারে?
AI SDK যেকোনোটি সমর্থন করে। WhatsApp অংশটি মডেল থেকে স্বাধীন, তাই প্রোভাইডার বদলালে রুট বা Cloud API কলে কোনো পরিবর্তন লাগে না।
EasyCoexistence কি মেসেজ দেখে?
ডিফল্টভাবে না। Meta সরাসরি আপনার রুটে ডেলিভার করে, এবং মেসেজের কোনো বিষয়বস্তু আমাদের দিকে সংরক্ষিত হয় না।
আরও পড়ুন
শুরু করতে প্রস্তুত?
মাস নয়, কয়েক মিনিটেই WhatsApp Coexistence সেট আপ করুন। ফোনে অ্যাপটি কাজ করতে থাকে।
ফ্রি ট্রায়াল শুরু করুনযাচাই করা হয়েছে