Vercel AI SDK-র সোশ্যাল মিডিয়া টুল ব্যবহার করুন: Instagram, TikTok এবং আরও
Vercel AI SDK পায় Instagram, TikTok, Facebook, WhatsApp ও আরও চ্যানেলের সোশ্যাল মিডিয়া টুল easyCoexistence-এর MCP সার্ভার থেকে। @ai-sdk/mcp প্যাকেজের createMCPClient https://easycoexistence.com/api/mcp-তে একটি HTTP সংযোগ খোলে, আপনার লেখা একটি OAuthClientProvider সাইন-ইন ধরে রাখে, এবং ক্লায়েন্টের tools() generateText বা streamText-এ যায়, যাতে প্রতিটি নেটওয়ার্কের অফিশিয়াল API-এর মাধ্যমে পোস্ট, শিডিউল, কমেন্ট ও DM-এর রিপ্লাই এবং ইনসাইটস পড়া যায়।
@ai-sdk/mcp-এর ফাংশন যা serverUrl ও authorizationCode থেকে OAuth কলব্যাক শেষ করে, উপস্থিত থাকলে callbackState ও callbackIssuer সহ।
generateText-এর ডিফল্ট stopWhen, তাই stopWhen আরও ধাপের অনুমতি না দিলে মডেল টুলের ফলাফল পড়ে না।
AI SDK যে MCP ট্রান্সপোর্ট প্রোডাকশনের জন্য সুপারিশ করে; এর stdio ট্রান্সপোর্ট শুধু লোকাল সার্ভারের জন্য।
easyCoexistence MCP অ্যাক্সেস টোকেনের মেয়াদ; এর রিফ্রেশ টোকেন 60 দিন টেকে এবং প্রতিটি রিফ্রেশে বদলে যায়।
একটি Instagram DM-এ সর্বোচ্চ যতটুকু টেক্সট থাকে, UTF-8 হিসেবে মাপা, তাই উচ্চারণ-চিহ্ন ও ইমোজি বেশি জায়গা নেয়।
AI SDK easyCoexistence-এ কীভাবে সাইন ইন করে?
আপনার নিজের স্টোরেজের ওপর তৈরি একটি OAuthClientProvider দিয়ে, যা AI SDK-এর auth() ফাংশন চালায়। প্রথম কলটি আপনার অ্যাপকে একটি পাবলিক ক্লায়েন্ট হিসেবে easyCoexistence-এ নিবন্ধন করে, PKCE ভেরিফায়ার সংরক্ষণ করে এবং redirectToAuthorization-এর মাধ্যমে সম্মতির URL দেয়; এটি REDIRECT ফেরত দেয়, আর আপনার রুট ব্যবহারকারীকে সেখানে পাঠায়। এরপর easyCoexistence একটি কোড সহ আপনার কলব্যাকে রিডাইরেক্ট করে, এবং authorizationCode সহ দ্বিতীয় auth() কল সেটিকে টোকেনে বদলায়। টোকেন সংরক্ষিত হলে auth() রিফ্রেশ টোকেন দিয়ে নতুন জোড়া নেয়, ব্যবহারকারীকে আর ফেরত পাঠায় না। redirectUrl ও নিবন্ধিত redirect_uris হুবহু এক রাখুন, কারণ easyCoexistence এগুলো হুবহু মেলায়।
import { auth, type OAuthClientProvider } from "@ai-sdk/mcp";
export const MCP_URL = "https://easycoexistence.com/api/mcp";
const CALLBACK = "https://app.example.com/api/easycoexistence/callback";
// db is your own key-value store (Postgres, Redis, Vercel KV); one set of keys per user
export function easyAuth(userId: string): OAuthClientProvider {
const k = (name: string) => "easycoexistence:" + userId + ":" + name;
return {
get redirectUrl() { return CALLBACK; },
get clientMetadata() {
return {
client_name: "Acme app", // shown on easyCoexistence's consent screen
redirect_uris: [CALLBACK],
grant_types: ["authorization_code", "refresh_token"],
response_types: ["code"],
token_endpoint_auth_method: "none", // easyCoexistence registers public clients
};
},
clientInformation: () => db.get(k("client")),
saveClientInformation: (info) => db.set(k("client"), info),
isClientInformationDynamicallyRegistered: async () => Boolean(await db.get(k("client"))),
tokens: () => db.get(k("tokens")),
saveTokens: (tokens) => db.set(k("tokens"), tokens),
saveCodeVerifier: (verifier) => db.set(k("verifier"), verifier),
codeVerifier: () => db.get(k("verifier")),
redirectToAuthorization: (url) => db.set(k("sign-in"), url.href),
};
}
// GET /api/easycoexistence/connect: send the user to the consent screen
export async function connect(userId: string) {
const result = await auth(easyAuth(userId), { serverUrl: MCP_URL });
if (result === "AUTHORIZED") return new Response("Already connected");
return Response.redirect(await db.get("easycoexistence:" + userId + ":sign-in"));
}
// GET /api/easycoexistence/callback: trade the code for tokens
export async function callback(req: Request, userId: string) {
const code = new URL(req.url).searchParams.get("code");
if (!code) return new Response("Sign-in was cancelled", { status: 400 });
await auth(easyAuth(userId), { serverUrl: MCP_URL, authorizationCode: code });
return Response.redirect("https://app.example.com/settings");
}টুলগুলো generateText-এ কীভাবে পৌঁছায়?
HTTP ট্রান্সপোর্ট, easyCoexistence URL ও প্রোভাইডার সহ createMCPClient থেকে। tools() সার্ভারের টুলগুলো AI SDK টুল হিসেবে ফেরত দেয়; কাজের জন্য যেগুলো লাগে সেগুলো নাম ধরে রেখে generateText বা streamText-এ পাস করুন। stopWhen-এ isStepCount দিন, কারণ ডিফল্টে কল এক ধাপেই থামে এবং মডেল reply_to_comment যা ফেরত দিল তা আর পড়ে না। নেটওয়ার্কের নিয়ম instructions-এ লিখুন, বর্তমান রেফারেন্স যে প্যারামিটারে মডেলের আচরণ ঠিক করে। ক্লায়েন্টটি finally ব্লকে বা streamText-এর onEnd কলব্যাকে বন্ধ করুন, যাতে কোনো সংযোগ খোলা না থাকে।
import { createMCPClient } from "@ai-sdk/mcp";
import { generateText, isStepCount, type LanguageModel } from "ai";
import { easyAuth, MCP_URL } from "./easycoexistence-auth";
const REPLY_TOOLS = new Set(["list_social_comments", "reply_to_comment", "hide_comment", "send_social_dm"]);
export async function replyToEvent(userId: string, model: LanguageModel, event: unknown) {
const mcp = await createMCPClient({
transport: { type: "http", url: MCP_URL, authProvider: easyAuth(userId) },
});
try {
const tools = Object.fromEntries(
Object.entries(await mcp.tools()).filter(([name]) => REPLY_TOOLS.has(name)),
);
const { text } = await generateText({
model,
tools,
stopWhen: isStepCount(4),
instructions:
"Reply to comments and DMs for Acme on the event's account_id. TikTok replies are public " +
"and need the video ID as post_id. Instagram DMs only go to people who wrote in the last 24 hours.",
prompt: JSON.stringify(event),
});
return text;
} finally {
await mcp.close();
}
}সার্ভারলেস হোস্টে টোকেন কোথায় থাকবে?
এমন কোথাও যা এক বার চালানোর চেয়ে বেশি সময় টিকে থাকে: একটি ডেটাবেস সারি, Redis বা কী-ভ্যালু স্টোর, যার কী আপনার অ্যাপের সেই ব্যবহারকারী যার কাছে টোকেনগুলো থাকে। Vercel বা অন্য সার্ভারলেস প্ল্যাটফর্মের ফাংশন মেমোরিতে কিছু না নিয়ে শুরু হয়, তাই যে প্রোভাইডার টোকেন একটি ভেরিয়েবলে রাখে, কোল্ড স্টার্টের পর সে ব্যবহারকারীকে সম্মতির পর্দায় ফেরত পাঠায়। অ্যাক্সেস টোকেন এক ঘণ্টা টেকে এবং রিফ্রেশ টোকেন 60 দিন, আর প্রতিবার ব্যবহারের সময় নতুন রিফ্রেশ টোকেন আসে, তাই যে অ্যাপ 60 দিনে অন্তত একবার টুল কল করে সে সাইন-ইন থাকে। ক্লায়েন্ট নিবন্ধন টোকেনের পাশে রাখুন, কারণ প্রোভাইডার প্রতিটি সংযোগে দুটোই পড়ে।
কমেন্ট ও DM অ্যাপে কীভাবে পৌঁছায়?
একটি রুট হ্যান্ডলারে সাইন করা POST হিসেবে, যা set_social_webhook_destination একটি অ্যাকাউন্টের জন্য নিবন্ধন করে এবং যা তারপর Instagram ও Facebook-এর কমেন্ট, মেনশন ও DM এবং TikTok-এর কমেন্ট গ্রহণ করে। প্রতিটি বডিতে platform, account_id, external_id ও entry থাকে, নেটওয়ার্কের ইভেন্টটি যেভাবে পাঠানো হয়েছিল ঠিক সেভাবে। বডিটি টেক্সট হিসেবে পড়ুন, অ্যাকাউন্টের সাইনিং সিক্রেট দিয়ে সেটির বিপরীতে X-EC-Signature মেলান, এবং দ্রুত সাড়া দিন: easyCoexistence রুটকে 8 সেকেন্ড দেয় এবং প্রতিটি ইভেন্ট একবারই পাঠায়, কোনো রিট্রাই ছাড়া। ইভেন্টটি একটি কিউতে রাখুন এবং একজন ওয়ার্কারকে সেটি দিয়ে replyToEvent কল করতে দিন, যাতে মডেলের সময় 8 সেকেন্ডের হিসাবে না যায়।
প্রতিটি নেটওয়ার্কে মডেল কী করতে পারে?
অ্যাকাউন্টের API যতটুকু অনুমতি দেয় ততটুকু, যা নির্দেশনায় স্পষ্ট করে লেখা উচিত:
- Instagram: JPEG ছবি সহ পোস্ট, Reels ও Stories; DM-এর রিপ্লাই শুধু গত 24 ঘণ্টায় যারা লিখেছে তাদের কাছে, সর্বোচ্চ 1,000 বাইটে।
- Facebook: Page পোস্ট, কমেন্টের রিপ্লাই এবং একই 24 ঘণ্টার মধ্যে Messenger রিপ্লাই।
- TikTok: ভিডিও ও ছবির পোস্ট; কমেন্টের রিপ্লাই সবসময় পাবলিক,
post_idহিসেবে ভিডিওর ID সহ, এবং কোনো DM নেই। - WhatsApp: শেষ গ্রাহক-বার্তার 24 ঘণ্টার মধ্যে
send_message, অন্য সবার জন্যsend_template। - YouTube ও LinkedIn: ব্যবহারকারী চাইলে আপলোড ও পোস্ট, কমেন্টের রিপ্লাই ও অ্যানালিটিক্স; কোনোটিই ইভেন্ট পাঠায় না, তাই অ্যাপ নির্ধারিত সময়ে নতুন কমেন্ট পড়ে।
সাধারণ ভুলগুলো
- stopWhen ডিফল্টে রেখে দেওয়া। generateText প্রথম ধাপের পরেই থামে, তাই মডেল reply_to_comment কল করে আর জানে না রিপ্লাইটি গেছে কি না; isStepCount দিয়ে কয়েকটি ধাপের অনুমতি দিন।
- সার্ভারলেস হোস্টে মডিউল-স্তরের ভেরিয়েবলে টোকেন রাখা। পরের কোল্ড স্টার্টে সেটি থাকে না, এবং ব্যবহারকারী আবার সম্মতির পর্দায় পৌঁছায়; এগুলো এমন ডেটাবেসে রাখুন যেখানে `tokens()` ও `saveTokens()` পৌঁছায়।
- একটি রিডাইরেক্ট URL নিবন্ধন করে অন্যটি পাঠানো। easyCoexistence redirect_uri নিবন্ধনের সঙ্গে হুবহু মেলায়, তাই একটি ট্রেইলিং স্ল্যাশ বা ভিন্ন পাথ সাইন-ইনকে একটি ত্রুটির পাতায় শেষ করে।
- অ্যাকাউন্টের নিজের কার্যকলাপে রিপ্লাই দেওয়া। Instagram অ্যাকাউন্টের DM-গুলো ইকো হিসেবে ফেরত পাঠায় এবং এর পাবলিক রিপ্লাইগুলো কমেন্ট হয়ে ফিরে আসে; মডেলের কাছে প্রম্পট পৌঁছানোর আগে দুটোই বাদ দিন।
easyCoexistence আপনার তৈরি Vercel AI SDK এজেন্টগুলোকে WhatsApp, Instagram, Facebook, TikTok, YouTube, LinkedIn ও আরও চ্যানেলের গ্রাহকদের কাছে পৌঁছানোর সুযোগ দেয়, প্রতিটি অফিশিয়াল API-এর মাধ্যমে: OAuth সাইন-ইনের পেছনে MCP টুল, কমেন্ট ও DM-এর জন্য সাইন করা ইভেন্ট, এবং 90 দিন আগে পর্যন্ত পোস্ট শিডিউল করার কিউ, প্রতিটি সংযোগ 24/7 পর্যবেক্ষণে থাকে। প্রতি সংযোগে মাসে US$ 9 থেকে US$ 0.75, সংযোগ যোগ করলে কমে, প্রথম 3 দিন ফ্রি।
প্রায়শই জিজ্ঞাসিত প্রশ্ন
এর জন্য কি Next.js বা Vercel হোস্টিং লাগবে?
না। AI SDK Node.js-এ চলে, তাই যেকোনো হোস্ট যা একটি HTTPS রুট চালায় কাজ করে, এবং MCP ক্লায়েন্টের শুধু easycoexistence.com-এ আউটবাউন্ড HTTPS লাগে।
চ্যাট ইন্টারফেস কি টুল কল স্ট্রিম করতে পারে?
হ্যাঁ। একই টুলগুলো streamText-এ পাস করুন এবং MCP ক্লায়েন্টটি এর onEnd কলব্যাকে বন্ধ করুন, যেভাবে AI SDK স্ট্রিম করা উত্তরের জন্য নথিভুক্ত করেছে।
একই অ্যাপ কি WhatsApp বার্তার রিপ্লাই দিতে পারে?
হ্যাঁ। নম্বরের টুলগুলো একই ক্লায়েন্টের মাধ্যমে আসে: connection_id-এর জন্য list_numbers, তারপর শেষ গ্রাহক-বার্তার 24 ঘণ্টার মধ্যে send_message। সেগুলো গ্রহণ করার বিষয়টি WhatsApp-এর AI SDK গাইডে আছে।
AI SDK অ্যাপের জন্য easyCoexistence-এর দাম কত?
প্রতি সংযোগে মাসে US$ 9 থেকে US$ 0.75, সংযোগ যোগ করলে কমে, প্রতিটি নেটওয়ার্কে একই। MCP সার্ভার ও Partner API এর মধ্যেই আছে, এবং প্রথম 3 দিন ফ্রি।
আরও পড়ুন
দুই মিনিটে আপনার প্রথম চ্যানেল সংযুক্ত করুন।
প্ল্যাটফর্মের রিভিউয়ের জন্য অপেক্ষা করতে হবে না। WhatsApp, Instagram, TikTok বা অন্য কোনো চ্যানেল সংযুক্ত করুন, তারপর আপনার AI-কে পোস্ট করতে, রিপ্লাই দিতে বা রিপোর্ট দিতে বলুন, আর নিজের চোখে দেখুন কীভাবে কাজ করে।
- 3 দিন ফ্রি
- যেকোনো সময় বাতিল করুন
- শুধুমাত্র অফিশিয়াল API
- 24/7 পর্যবেক্ষণ
যাচাই করা হয়েছে