সোশ্যাল মিডিয়া পোস্টিং ও মেসেজিং APIAI এজেন্টের জন্য তৈরি

একটিমাত্র REST এন্ডপয়েন্ট সেট দিয়ে ১৮টি ডেস্টিনেশনে প্রকাশ করুন এবং একটিমাত্র ইনবক্স থেকে প্রতিটি DM, কমেন্ট ও মেনশনের উত্তর দিন। API-কী প্রমাণীকরণ, রিট্রাইসহ কিউ-ভিত্তিক প্রকাশ, স্বাক্ষরিত ওয়েবহুক, আর প্রতি প্ল্যাটফর্মে আলাদা OAuth লেখার ঝামেলা নেই।

বেস URL https://api.so-me.studio/v1 · প্রমাণীকরণ X-API-Key · JSON দিন, JSON নিন

zsh — api.so-me.studio/v1

দুটি কাজ, একটিমাত্র ওয়ার্কস্পেস

বেশিরভাগ সোশ্যাল API প্রকাশ করাতেই থেমে যায়। যে এজেন্ট পোস্ট করতে পারে কিন্তু উত্তর দিতে পারে না, সে অর্ধেক এজেন্ট, তাই দুটোই একই কী-এর পেছনে, একই সংযুক্ত অ্যাকাউন্টের উপর কাজ করে।

একটিমাত্র কল থেকে যেকোনো জায়গায় প্রকাশ করুন

একবার পোস্ট তৈরি করুন, যেকোনো সংযুক্ত ডেস্টিনেশন বেছে নিন, আর প্রতি প্ল্যাটফর্মের ফরম্যাটিং, মিডিয়া আপলোড, রেট লিমিট ও রিট্রাই কিউকেই সামলাতে দিন। আপনার এজেন্টকে কখনোই কোনো প্ল্যাটফর্ম SDK ছুঁতে হবে না।

  • POST /v1/posts
  • POST /v1/posts/:id/schedule
  • POST /v1/posts/:id/retry
  • POST /v1/media/presign-upload
  • POST /v1/drafts/:id/convert

প্রতিটি কথোপকথন পড়ুন ও উত্তর দিন

প্রতিটি সংযুক্ত অ্যাকাউন্টের DM, কমেন্ট ও মেনশন এসে জমা হয় একটিমাত্র ইউনিফাইড ইনবক্সে। থ্রেড টেনে আনুন, উত্তর পাঠান, সামলানো হয়েছে বলে চিহ্নিত করুন, সবই সাধারণ JSON-এ, আপনার পোস্টের সেই একই ওয়ার্কস্পেসে।

  • GET /v1/inbox/conversations
  • GET /v1/inbox/conversations/:id/messages
  • POST /v1/inbox/conversations/:id/reply
  • POST /v1/whatsapp/templates/send
  • GET /v1/inbox/saved-replies

কলগুলো দেখতে কেমন

কোনো SDK লাগবে না। একটি এজেন্ট সারাদিন যে লুপ চালায়, তার জন্য তিনটি রিকোয়েস্টই যথেষ্ট: প্রকাশ, শোনা, উত্তর।

একটি পোস্ট শিডিউল করুন
curl -X POST \
  https://api.so-me.studio/v1/posts \
  -H "X-API-Key: $SOME_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "text": "Ship day 🚀",
    "socialMedia": "LINKEDIN",
    "postType": "TEXT",
    "scheduledAt":
      "2026-08-04T09:00:00Z"
  }'
একটি DM-এর উত্তর দিন
const { data } = await api(
  '/v1/inbox/conversations'
);

for (const c of data) {
  const reply = await agent.answer(c);

  await api(
    `/v1/inbox/conversations/${c.id}`
      + '/reply',
    { method: 'POST',
      body: { message: reply } }
  );
}
ফলাফলের জন্য অপেক্ষা করুন
await fetch(
  BASE + '/v1/webhooks/subscriptions',
  {
    method: 'POST',
    headers: {
      'X-API-Key': KEY,
      'Content-Type': 'application/json'
    },
    body: JSON.stringify({
      url: 'https://my-agent.dev/hook',
      events: [
        'post.published',
        'post.failed'
      ]
    })
  }
);

আপনার ওয়ার্কস্পেসেই কী, লগ আর ওয়েবহুক

প্রতিটি ইন্টিগ্রেশনের জন্য API কী তৈরি করুন, প্রতিটি রিকোয়েস্ট আসতে দেখুন, আর Settings থেকে ওয়েবহুক সাবস্ক্রিপশন পরিচালনা করুন। আলাদা কোনো ডেভেলপার কনসোল লাগে না।

API কী ও রিকোয়েস্ট হিস্ট্রি

API কী ও রিকোয়েস্ট হিস্ট্রি

প্রতিটি ইন্টিগ্রেশনের কী-কে আলাদা নাম দিন, শেষ কবে ব্যবহার হয়েছে দেখুন, আর মেথড, স্ট্যাটাস ও ল্যাটেন্সি ধরে প্রতিটি কল যাচাই করুন।

ওয়েবহুক সাবস্ক্রিপশন

ওয়েবহুক সাবস্ক্রিপশন

পোস্ট, ইনবক্স ও বিলিং ইভেন্টে সাবস্ক্রাইব করুন, ডেলিভারির ব্যবহার দেখুন, আর আপনার এজেন্ট কোনো ইভেন্ট মিস করার আগেই ব্যর্থ এন্ডপয়েন্ট ধরে ফেলুন।

পুরো প্রোডাক্টই, এন্ডপয়েন্ট আকারে

ড্যাশবোর্ডে আপনি যা যা করতে পারেন, তার প্রতিটির জন্যই একটি রুট আছে। কিছুই শুধু UI-এর জন্য সংরক্ষিত নয়।

পোস্ট

/v1/posts

পোস্ট তৈরি, আপডেট, শিডিউল, আনশিডিউল, বাল্ক-ডিলিট, রিট্রাই ও পুনরায় জমা দিন। ক্যালেন্ডার পড়ুন এবং প্রতি পোস্টের কমেন্ট পরিচালনা করুন।

ড্রাফট

/v1/drafts

চলমান কাজ জমিয়ে রাখুন, তারপর একটিমাত্র কলে একটি ড্রাফটকে শিডিউল করা লাইভ পোস্টে রূপান্তর করুন।

ইনবক্স

/v1/inbox

প্রতিটি সংযুক্ত অ্যাকাউন্টের কথোপকথনের তালিকা দেখুন, মেসেজ থ্রেড পড়ুন, উত্তর দিন, আর্কাইভ করুন এবং সেভড রিপ্লাই পরিচালনা করুন।

WhatsApp

/v1/whatsapp

অনুমোদিত মেসেজ টেমপ্লেট তৈরি ও তালিকাভুক্ত করুন, টেমপ্লেট মিডিয়া আপলোড করুন এবং গ্রাহকদের টেমপ্লেট মেসেজ পাঠান।

মিডিয়া

/v1/media

প্রি-সাইনড আপলোড, ফোল্ডার, সার্চ, রিনেম, মুভ ও বাল্ক ডিলিট। আপলোড করা যেকোনো অ্যাসেট আইডি দিয়ে পোস্টে যুক্ত করুন।

অ্যানালিটিক্স

/v1/analytics

প্রতি অ্যাকাউন্ট ও প্রতি পোস্টের মেট্রিক, সাথে Facebook, Instagram, LinkedIn, YouTube, X ও WhatsApp-এর প্ল্যাটফর্ম-নেটিভ বিশ্লেষণ।

AI

/v1/ai

আপনার এজেন্ট থেকেই ক্যাপশন, ইমেজ ও UGC ভিডিও তৈরি করুন, তারপর ফলাফল সরাসরি একটি পোস্টে দিন।

অ্যাপ্রুভাল

/v1/approvals

পর্যালোচনার অপেক্ষায় থাকা সবকিছুর তালিকা দেখুন এবং অনুমোদন বা বাতিল করুন, যাতে এজেন্ট ড্রাফট করতে পারে আর চূড়ান্ত সম্মতি মানুষের হাতেই থাকে।

অ্যাকাউন্ট

/v1/accounts

সংযুক্ত সোশ্যাল অ্যাকাউন্ট ও তাদের আইডির তালিকা দেখুন, প্রতিটি পোস্ট ও কথোপকথন যে আইডেন্টিফায়ারের সাথে বাঁধা।

ওয়েবহুক

/v1/webhooks

সাবস্ক্রিপশন পরিচালনা করুন, ডেলিভারি রিপ্লে করুন, টেস্ট পেলোড পাঠান এবং পূর্ণ ইভেন্ট ক্যাটালগ ঘুরে দেখুন।

বায়ো-লিংক

/v1/biolinks

প্রোগ্রাম্যাটিকভাবে লিংক-ইন-বায়ো পেজ বানান, বাটন, এমবেড করা পোস্ট, থিম, প্রকাশ ও ক্লিক অ্যানালিটিক্স।

টিম ও সেটিংস

/v1/teams · /v1/settings

সদস্য আমন্ত্রণ জানান, রোল ঠিক করুন, API কী রোটেট করুন, ওয়ার্কস্পেস বদলান এবং আপনার প্ল্যানের বর্তমান ব্যবহার দেখুন।

পূর্ণ রিকোয়েস্ট ও রেসপন্স স্কিমা, সাথে OpenAPI স্পেক, আছে API রেফারেন্সে।

কোথায় কোথায় পৌঁছায়

ড্যাশবোর্ডে একবার অ্যাকাউন্ট যুক্ত করুন; API সেটি সবখানেই পেয়ে যায়।

প্রকাশ

১৮টি ডেস্টিনেশন

Twitter/X, Instagram, LinkedIn (ব্যক্তিগত ও Page), Facebook, TikTok, YouTube, Threads, Pinterest, Bluesky, Mastodon, Reddit, Google Business Profile, WordPress, Dev.to, Dribbble, Discord ও Slack, সবই একটিমাত্র POST /v1/posts থেকে। WhatsApp-এর ক্ষেত্রে অনুমোদিত টেমপ্লেটের মাধ্যমে পাঠানো হয়।

বার্তা

ইউনিফাইড ইনবক্স

Facebook, Instagram, WhatsApp ও Twitter/X-এর জন্য রিয়েল-টাইম ওয়েবহুক ইনজেশন, সাথে Bluesky, Mastodon, Reddit, Telegram, Discord ও Slack-এর জন্য পোল করা থ্রেড। সবার জন্য একটিমাত্র কথোপকথন মডেল।

সংযোগ

২০টি প্ল্যাটফর্ম

OAuth ড্যাশবোর্ডে একবারই সামলানো হয়। API শুধু তার ফলে তৈরি হওয়া অ্যাকাউন্ট আইডি পড়ে, কোনো প্ল্যাটফর্ম টোকেন আপনাকে কখনোই সংরক্ষণ, রিফ্রেশ বা রোটেট করতে হয় না।

যে কলার কখনো ঘুমায় না, তার জন্যই ডিজাইন করা

একটি এজেন্ট বারবার চেষ্টা করে, সমান্তরালে চলে এবং এরর বডি আক্ষরিকভাবে পড়ে। API সেভাবেই সাজানো।

তিনটি সারফেসের জন্য একটিমাত্র কী

একই X-API-Key কাজ করে REST API, npm দিয়ে ইনস্টল করা CLI এবং MCP সার্ভারে। Settings → API Keys থেকে একবার তৈরি করুন; আপনার এজেন্ট কখনোই কোনো প্ল্যাটফর্ম OAuth টোকেন দেখে না।

প্রকাশ কিউ-ভিত্তিক, ছুড়ে-দিয়ে-ভুলে-যাওয়া নয়

create কল সাথে সাথেই ফেরত আসে আর পোস্টটি ঢোকে একটি ওয়ার্কার কিউয়ে, যেখানে প্রতি প্ল্যাটফর্মের রেট লিমিট বিবেচনা করা হয় এবং স্বয়ংক্রিয় রিট্রাই চলে। ব্যর্থ হলে POST /v1/posts/:id/retry দিয়ে আবার চালানো যায়।

১৫০+ স্বাক্ষরিত ইভেন্ট

post.published, post.failed, ইনবক্স মেসেজ ইভেন্ট, অ্যাপ্রুভাল সিদ্ধান্ত, অ্যাকাউন্ট বিচ্ছিন্ন হওয়া এবং আরও অনেক কিছুতে সাবস্ক্রাইব করুন। পেলোড HMAC-SHA256 দিয়ে স্বাক্ষরিত, তাই আপনার এজেন্ট সেগুলোতে ভরসা রাখতে পারে।

গঠনগতভাবেই ওয়ার্কস্পেস-সীমাবদ্ধ

প্রতিটি কী একটিমাত্র ওয়ার্কস্পেসের সাথে বাঁধা। প্রতি ক্লায়েন্টের জন্য আলাদা কী চালান, আর কোনো এজেন্ট চাইলেও অন্য টেন্যান্টের অ্যাকাউন্ট পড়তে বা সেখানে পোস্ট করতে পারবে না।

নথিভুক্ত, কার্যকর রেট লিমিট

প্রতি মিনিট ও প্রতি মাসের কোটা প্রতিটি প্ল্যানের জন্য প্রকাশ করা আছে এবং সীমা ছাড়ালে পরিষ্কার 429 ফেরত আসে, কোনো নীরব থ্রটলিং নেই যা রিট্রাই লুপ ভুল বুঝতে পারে।

শুধু REST নয়

এন্ডপয়েন্টের বদলে টুল পছন্দ? একই ওয়ার্কস্পেস ২০০+ MCP টুল হিসেবেও পাওয়া যায়, সাথে একটি CLI যা JSON প্রিন্ট করে ও সত্যিকারের এক্সিট কোড ফেরত দেয়।

সীমা, আগেভাগেই স্পষ্ট

অ্যাক্সেস ও সীমা বর্তমান প্ল্যান ক্যাটালগ থেকে আসে। কোটা অতিক্রম করলে HTTP 429 ফেরত আসে।

প্ল্যান অনুযায়ী বর্তমান API সীমা
প্ল্যানAPI কলরেট লিমিটওয়েবহুক ডেলিভারি
Advancedআনলিমিটেডমিনিটে ৩০০টি কলআনলিমিটেড
Standardমাসে ৫,০০০টি কলমিনিটে ৬০টি কলমাসে ২,৫০০টি ডেলিভারি
Liteমাসে ৫০০টি কলমিনিটে ৬০টি কলমাসে ৫০০টি ডেলিভারি

বর্তমান প্ল্যানের দাম দেখতে প্রাইসিং দেখুন, আর সরাসরি এন্ডপয়েন্টের বদলে MCP টুল ব্যবহার করতে চাইলে এজেন্ট ওভারভিউ দেখুন।

তিন ধাপে প্রথম কল

কোনো সেলস কল নেই, স্যান্ডবক্সের আবেদন নেই, প্রতি প্ল্যাটফর্মে আলাদা ডেভেলপার অ্যাকাউন্টও নেই।

1

আপনার অ্যাকাউন্ট যুক্ত করুন

সাইন আপ করে ড্যাশবোর্ডে ২০টি ডেস্টিনেশনের যেকোনোটি যুক্ত করুন। এরপর থেকে OAuth, টোকেন রিফ্রেশ ও পুনরায় অনুমোদনের অনুরোধ আমরাই সামলাই।

2

একটি API কী তৈরি করুন

Settings → API Keys। X-API-Key হিসেবে পাঠান। প্রতি ওয়ার্কস্পেসে একটি করে কী ক্লায়েন্টদের আলাদা রাখে; একই কী CLI ও MCP সার্ভারও চালায়।

3

পোস্ট করুন, তারপর শুনুন

প্রকাশ বা শিডিউল করতে POST /v1/posts, post.published ও post.failed-এ সাবস্ক্রাইব করুন এবং উত্তর দেওয়া শুরু করতে GET /v1/inbox/conversations পড়ুন।

একটিমাত্র কী দিয়ে দুটি কাজ। পোস্টিং: ১৮টি ডেস্টিনেশনে কনটেন্ট তৈরি, শিডিউল, প্রকাশ, রিট্রাই ও ডিলিট, একই ওয়ার্কস্পেসে প্রি-সাইনড মিডিয়া আপলোড এবং AI ক্যাপশন/ইমেজ জেনারেশনসহ। মেসেজিং: ইউনিফাইড ইনবক্স থেকে কথোপকথনের তালিকা নিন, একটি থ্রেড পড়ুন, DM ও কমেন্টের উত্তর দিন এবং অনুমোদিত WhatsApp টেমপ্লেট পাঠান। এর চারপাশে আছে অ্যানালিটিক্স, অ্যাপ্রুভাল, বায়ো-লিংক, টিম, টেমপ্লেট ও ওয়েবহুক, সবই https://api.so-me.studio/v1-এর অধীনে।

Settings → API Keys থেকে একটি কী তৈরি করুন এবং প্রতিটি রিকোয়েস্টে X-API-Key হেডারে সেটি পাঠান। কী একটিমাত্র ওয়ার্কস্পেসে সীমাবদ্ধ, তাই প্রতি ক্লায়েন্টের জন্য আলাদা কী চালালে এজেন্টরা একে অন্যের থেকে বিচ্ছিন্ন থাকে। একই কী CLI (npm i -g @social-media-scheduler/cli) ও MCP সার্ভারেরও প্রমাণীকরণ করে।

না। আপনি ড্যাশবোর্ডে একবার অ্যাকাউন্ট যুক্ত করেন, আর প্ল্যাটফর্ম টোকেনগুলো এনক্রিপ্টেড অবস্থায় আমাদের দিকেই থাকে। GET /v1/accounts সেই অ্যাকাউন্ট আইডিগুলো ফেরত দেয়, যেগুলো আপনি পোস্ট করা বা উত্তর দেওয়ার সময় ব্যবহার করবেন। টোকেন রিফ্রেশ, পুনরায় অনুমোদনের অনুরোধ আর প্রতি প্ল্যাটফর্মের খুঁতখুঁতে নিয়মকানুন সামলানোর দায়িত্ব আমাদের, আপনার নয়।

হ্যাঁ। GET /v1/inbox/conversations প্রতিটি সংযুক্ত অ্যাকাউন্টের থ্রেড তালিকাভুক্ত করে, GET /v1/inbox/conversations/:id/messages প্রসঙ্গের জন্য মেসেজের ইতিহাস ফেরত দেয় এবং POST /v1/inbox/conversations/:id/reply উত্তরটি পাঠায়। Facebook, Instagram, WhatsApp ও Twitter/X রিয়েল-টাইম ওয়েবহুকে আসে; Bluesky, Mastodon, Reddit, Telegram, Discord ও Slack একই কথোপকথন মডেলে টেনে আনা হয়।

WhatsApp ফ্রি-ফর্ম নয়, টেমপ্লেট-ভিত্তিক: POST /v1/whatsapp/templates অনুমোদনের জন্য একটি টেমপ্লেট তৈরি করে, POST /v1/whatsapp/templates/upload-media হেডার মিডিয়া যুক্ত করে এবং POST /v1/whatsapp/templates/send সেটি পৌঁছে দেয়। আসা WhatsApp মেসেজ বাকি সবকিছুর মতোই একই ইউনিফাইড ইনবক্সে জমা হয়।

না, আর সেটি ইচ্ছাকৃত। পোস্ট গৃহীত হওয়ামাত্রই POST /v1/posts ফেরত আসে; প্রকাশের কাজটি চলে একটি কিউয়ের মধ্য দিয়ে, প্রতি প্ল্যাটফর্মের রেট লিমিট বিবেচনায় রেখে ও স্বয়ংক্রিয় রিট্রাইসহ। কোনো প্ল্যাটফর্মের দিনটা খারাপ যাচ্ছে বলে রিকোয়েস্ট থ্রেড আটকে রাখার বদলে post.published ও post.failed ওয়েবহুকের দিকে নজর রাখুন, অথবা GET /v1/posts/:id পোল করুন।

১৫০-এরও বেশি, পোস্ট, ড্রাফট, রিপারপাসিং, অ্যাপ্রুভাল, ইনবক্স, মিডিয়া, অ্যাকাউন্ট, বিলিং ও টিমজুড়ে: post.published, post.failed, post.approval.requested, অ্যাকাউন্ট বিচ্ছিন্ন হওয়া এবং আরও অনেক। POST /v1/webhooks/subscriptions দিয়ে সাবস্ক্রিপশন পরিচালনা করুন, একটি টেস্ট ডেলিভারি পাঠান, ব্যর্থ ডেলিভারি রিপ্লে করুন এবং গ্রহণের সময় HMAC-SHA256 স্বাক্ষর যাচাই করুন।

অ্যাক্সেস, মূল্য ও কোটা আপনার বর্তমান প্ল্যানের ওপর নির্ভর করে। বর্তমান প্ল্যানের জন্য মূল্যতালিকা এবং API কল, রেট ও ওয়েবহুক কোটার জন্য API সীমার টেবিল দেখুন।

একই ওয়ার্কস্পেস, তিনটি রূপ। যেকোনো ব্যাকএন্ড বা ফ্রেমওয়ার্ক (LangChain, CrewAI, AutoGen, Vertex AI, সাধারণ কোনো ক্রন ওয়ার্কার) থেকে REST ব্যবহার করুন। শেল, CI ও শিডিউল করা জবে CLI ব্যবহার করুন। এজেন্ট নিজে থেকেই ২০০+ টাইপড টুল খুঁজে নিক, এমন চাইলে MCP সার্ভার ব্যবহার করুন; Claude, Cursor ও Windsurf-এর পথ সেটিই।

docs.so-me.studio-তে, সাথে OpenAPI স্পেকও আছে যাতে আপনি যেকোনো ভাষায় টাইপড ক্লায়েন্ট জেনারেট করতে পারেন। এই পেজটি সংক্ষিপ্ত পরিচিতি; রেফারেন্সে প্রতিটি রুটের রিকোয়েস্ট ও রেসপন্স স্কিমা আছে।

একবার শিডিউল করুন।
সবখানে পোস্ট করুন।

ট্যাব নিয়ে টানাহেঁচড়া বন্ধ করুন, একটিমাত্র ক্যালেন্ডার থেকেই ২০টি প্ল্যাটফর্মের জন্য লিখুন, সাজান ও প্রকাশ করুন।