এজেন্সির জন্য সোশ্যাল মিডিয়া API: নিজের সফটওয়্যার থেকে ক্লায়েন্টদের অ্যাকাউন্ট চালান
এজেন্সির সোশ্যাল মিডিয়া API-এর মাধ্যমে এজেন্সির নিজস্ব সফটওয়্যার প্রতিটি ক্লায়েন্টের অ্যাকাউন্ট সংযুক্ত, পোস্ট, রিপ্লাই ও রিপোর্ট করতে পারে। easyCoexistence-এর Partner API-তে ক্লায়েন্টের WhatsApp নম্বর এবং Instagram, Facebook, TikTok, YouTube ও LinkedIn অ্যাকাউন্ট হোস্টেড লিংকের মাধ্যমে এজেন্সির অ্যাকাউন্টে যুক্ত হয়, যেগুলো ক্লায়েন্টের আইডি দিয়ে ট্যাগ করা থাকে, এবং একটি API কী দিয়ে সব কিছু শিডিউল, রাউট ও পর্যবেক্ষণ করা যায়।
কানেক্ট সেশন সর্বোচ্চ যত দীর্ঘ external_ref নিতে পারে, অর্থাৎ এজেন্সির নিজস্ব ক্লায়েন্ট আইডি, যা প্রতিটি সংযোগে রাখা হয়।
যে ক্লায়েন্ট হোস্টেড কানেক্ট লিংক খোলেন, তার জন্য লিংকটি কতক্ষণ কার্যকর থাকে।
যে Instagram প্রফেশনাল অ্যাকাউন্টগুলোর মালিক বা ম্যানেজার অ্যাপ নিজে নয়, সেগুলো পরিচালনা করতে Meta অ্যাপের যা প্রয়োজন, অ্যাপ রিভিউ ও ব্যবসা যাচাইকরণের পরে।
LinkedIn Page-এর যে ভূমিকা সদস্যের rw_organization_admin অনুমতির জন্য প্রয়োজন, যা পেজ পরিচালনা করে এবং তার রিপোর্টিং পড়ে।
এজেন্সি API দিয়ে সরিয়ে দিলে ক্লায়েন্ট সংযোগের বিলিং কখন বন্ধ হয়।
API কীভাবে এজেন্সির ক্লায়েন্টদের সাজায়?
আপনার ক্লায়েন্ট আইডি দিয়ে। প্রতিটি কানেক্ট সেশনে এটি external_ref হিসেবে পাঠান, এবং সেশনের তৈরি প্রতিটি নম্বর ও অ্যাকাউন্টে তা থেকে যায় এবং প্রতিটি স্ট্যাটাস ইভেন্টে ফিরে আসে। GET /channels?external_ref=client_118 ওই ক্লায়েন্টের সোশ্যাল অ্যাকাউন্টগুলো দেখায়, একটি নেটওয়ার্কে সীমাবদ্ধ করতে &channel=instagram যোগ করুন, আর GET /connections?external_ref=client_118 তাদের WhatsApp নম্বরগুলো দেখায়। প্রতিটি ক্লায়েন্ট এজেন্সির একটিমাত্র অ্যাকাউন্টের অধীনে থাকে, একটিমাত্র ec_live_ কী দিয়ে, আর সেটাই পুরো সংখ্যাটিকে একটিমাত্র মূল্য ব্যান্ডে রাখে।
curl "https://easycoexistence.com/api/v1/channels?external_ref=client_118" \
-H "Authorization: Bearer $EC_API_KEY"
curl "https://easycoexistence.com/api/v1/connections?external_ref=client_118" \
-H "Authorization: Bearer $EC_API_KEY"ক্লায়েন্ট কীভাবে অ্যাক্সেস দেয়?
এজেন্সির পাঠানো একটি লিংকের মাধ্যমে। channel হিসেবে নেটওয়ার্ক, ক্লায়েন্টের external_ref এবং এজেন্সির নাম partner_name হিসেবে দিয়ে POST /connect-sessions পাঠালে একটি url ফেরত আসে। ক্লায়েন্ট সেটি খোলে, নেটওয়ার্কের নিজস্ব সম্মতি স্ক্রিনে সাইন ইন করে, অথবা WhatsApp নম্বরের জন্য Meta-র পপআপ চালিয়ে একটি QR কোড স্ক্যান করে, এবং এজেন্সির redirect_url-এ ফিরে যায়। Facebook বা LinkedIn সাইন ইনে একসঙ্গে একাধিক পেজ আসতে পারে, প্রতিটি আলাদা সংযোগ হিসেবে, তাই তালিকাটি ক্লায়েন্টের ব্রিফের সঙ্গে মিলিয়ে দেখুন।
এজেন্সি ক্লায়েন্টদের জন্য কীভাবে পোস্ট প্রকাশ করে?
নিজস্ব অনুমোদন প্রবাহ থেকে। ক্লায়েন্ট অনুমোদন না দেওয়া পর্যন্ত এজেন্সির সফটওয়্যার ড্রাফট রাখে, তারপর প্রতিটি অনুমোদিত পোস্ট publish_at সহ POST /channels/:id/posts-এ পাঠায়, যা 90 দিন আগে পর্যন্ত হতে পারে। GET /channels/:id/posts একটি অ্যাকাউন্টের ক্যালেন্ডার দেখায়, স্ট্যাটাস ফিল্টারসহ GET /posts দেখায় ক্লায়েন্টদের জুড়ে কী অপেক্ষা করছে, আর post.published ও post.failed অ্যাকাউন্ট ম্যানেজারকে জানায় কী ঘটল। LinkedIn পোস্ট সবসময় একজন ব্যক্তির অনুমোদনের মধ্য দিয়ে যায়, যা এজেন্সির অনুমোদন ধাপ আগে থেকেই দেয়।
এজেন্সি ক্লায়েন্টদের কমেন্ট ও DM-এর উত্তর কীভাবে দেয়?
একটি ইনবক্স থেকে, যা অ্যাকাউন্ট অনুযায়ী রাউট করে। PUT /channels/:id/webhook প্রতিটি Instagram অ্যাকাউন্ট, Facebook পেজ ও TikTok অ্যাকাউন্টের জন্য একটি ঠিকানা ঠিক করে, এবং ফরওয়ার্ড করা প্রতিটি কমেন্ট, মেনশন বা DM-এ account_id থাকে, যা ক্লায়েন্টের সঙ্গে মেলে। একটি WhatsApp নম্বরের মেসেজ Meta থেকে সেই নম্বরের জন্য সেট করা webhook_url-এ যায়। উত্তর প্রতিটি নেটওয়ার্কের API দিয়ে বেরিয়ে যায়, GET /channels/:id?credentials=1 থেকে পাওয়া ক্রেডেনশিয়াল দিয়ে, এবং এজেন্সির দল একই অ্যাকাউন্টের MCP কানেক্টর দিয়ে Claude বা ChatGPT-তে ক্লায়েন্টদের জুড়ে কাজ করতে পারে।
এজেন্সি ক্লায়েন্টদের রিপোর্ট কীভাবে তৈরি করে?
প্রতিটি নেটওয়ার্কের নিজস্ব অ্যানালিটিক্স থেকে, ক্লায়েন্ট অ্যাকাউন্টের ক্রেডেনশিয়াল দিয়ে কল করে। Instagram ও Facebook-এর ইনসাইটস আসে Meta-র Graph API থেকে, TikTok-এরটা তার API for Business থেকে, YouTube-এরটা YouTube Analytics থেকে, যার base ক্রেডেনশিয়ালে থাকে, এবং LinkedIn-এরটা তার পরিসংখ্যান এন্ডপয়েন্ট থেকে। এজেন্সির রিপোর্ট জব প্রতিটি রানের শুরুতে প্রতিটি অ্যাকাউন্টের জন্য নতুন ক্রেডেনশিয়াল নেয়, সময়ের পরিসংখ্যান টানে এবং সেগুলো ক্লায়েন্টের external_ref অনুযায়ী ফাইল করে।
ক্লায়েন্টের অ্যাকাউন্টের মনোযোগ দরকার, এজেন্সি কীভাবে জানে?
স্বাক্ষরিত স্ট্যাটাস ইভেন্ট থেকে। channel.disconnected ও connection.disconnected-এ ক্লায়েন্টের external_ref থাকে, তাই এজেন্সির সফটওয়্যার সেই ক্লায়েন্টের অ্যাকাউন্ট ম্যানেজারকে সতর্কবার্তা পাঠাতে পারে এবং ক্লায়েন্টকে নতুন কানেক্ট লিংক পাঠাতে পারে। প্রতিটি সংযোগ 24/7 পর্যবেক্ষণ করা হয়, আর কোনো সংযোগ বিচ্ছিন্ন হলে এজেন্সির মালিককেও ইমেইল পাঠানো হয়। কোনো ক্লায়েন্ট নেটওয়ার্কের সেটিংসে অ্যাক্সেস প্রত্যাহার করলে একই ভাবে দেখা যায়।
কোনো ক্লায়েন্ট চলে গেলে API-তে কী ঘটে?
এজেন্সির অফবোর্ডিং জব external_ref অনুযায়ী ক্লায়েন্টের সংযোগগুলো তালিকাভুক্ত করে এবং প্রতিটির জন্য DELETE /channels/:id ও DELETE /connections/:id কল করে। এগুলোর বিলিং চক্রের শেষে বন্ধ হয়, সরিয়ে ফেলা চ্যানেলের নির্ধারিত পোস্টগুলো বাতিল করা হয়, এবং সরানো সোশ্যাল অ্যাকাউন্টের টোকেন মুছে ফেলা হয়। একটি WhatsApp নম্বর ক্লায়েন্ট WhatsApp Business অ্যাপে সংযোগ বিচ্ছিন্ন না করা পর্যন্ত Cloud API-তে থেকে যায়।
সাধারণ ভুলগুলো
- ক্লায়েন্ট অনুমোদন দেওয়ার আগে পোস্ট কিউতে রাখা। কিউতে থাকা পোস্ট আর কোনো যাচাই ছাড়াই নির্ধারিত সময়ে প্রকাশিত হয়, তাই ড্রাফট আপনার অনুমোদন ধাপে রাখুন এবং অনুমোদিত হলেই পাঠান।
- Partner API কী ক্লায়েন্ট পোর্টালের ফ্রন্ট এন্ডে রাখা। কী অ্যাকাউন্টের প্রতিটি ক্লায়েন্টের ক্রেডেনশিয়ালে পৌঁছায়, তাই এটি এজেন্সির সার্ভারে রাখুন।
- ক্লায়েন্টের YouTube চ্যানেল বা LinkedIn পেজ থেকে কমেন্ট ইভেন্টের জন্য অপেক্ষা করা। easyCoexistence দুটোর কোনোটি থেকেই পায় না, তাই রিপোর্ট বা ইনবক্স জব প্রতিটি নেটওয়ার্কের API থেকে সেগুলো পড়ে।
easyCoexistence এজেন্সির নিজস্ব সফটওয়্যারকে ক্লায়েন্টদের WhatsApp নম্বর এবং Instagram, Facebook, TikTok, YouTube ও LinkedIn অ্যাকাউন্টের জন্য একটি API দেয়, আরও চ্যানেল যুক্ত হচ্ছে: ক্লায়েন্ট অনুযায়ী ট্যাগ করা হোস্টেড কানেক্ট লিংক, একটি পাবলিশিং কিউ, ফরওয়ার্ড করা কমেন্ট ও DM, রিপোর্টের জন্য নতুন ক্রেডেনশিয়াল এবং প্রতিটি সংযোগ 24/7 পর্যবেক্ষণ। প্রতি সংযোগ প্রতি মাসে US$ 9 থেকে US$ 0.75, সংযোগ যত যোগ করবেন তত কমে, প্রথম 3 দিনের ফ্রি ট্রায়াল সহ।
প্রায়শই জিজ্ঞাসিত প্রশ্ন
ক্লায়েন্টের কি easyCoexistence-এর নিজস্ব অ্যাকাউন্ট লাগে?
না। ক্লায়েন্ট হোস্টেড লিংক খুলে সাইন ইন করে, আর সংযোগটি এজেন্সির অ্যাকাউন্টে যুক্ত হয়, যেখানে সেটির বিলিং ও পর্যবেক্ষণ হয়।
এজেন্সি কি ক্লায়েন্টদের আলাদা API কী রাখতে পারে?
এক অ্যাকাউন্টে একটি কী থাকে। আলাদা কী মানে আলাদা easyCoexistence অ্যাকাউন্ট, প্রতিটির বিলিং প্রথম মূল্য ব্যান্ড থেকে শুরু হয়, তাই বেশিরভাগ এজেন্সি external_ref দিয়ে ক্লায়েন্টদের আলাদা রাখে।
সংযোগের সময় ক্লায়েন্ট কি এজেন্সির নাম দেখতে পারে?
হ্যাঁ। হোস্টেড পেজে partner_name হিসেবে পাঠানো নামটি দেখায়। নেটওয়ার্কের নিজস্ব সম্মতি স্ক্রিনে easyCoexistence-কে সেই অ্যাপ হিসেবে দেখানো হয় যেটি অ্যাক্সেস চাইছে।
একটি এজেন্সির জন্য easyCoexistence-এর খরচ কত?
প্রতি ক্লায়েন্ট সংযোগ প্রতি মাসে US$ 9 থেকে US$ 0.75, এজেন্সি যত ক্লায়েন্ট যোগ করে তত কমে, সব নেটওয়ার্কে একই, প্রথম 3 দিনের ফ্রি ট্রায়াল সহ।
আরও পড়ুন
দুই মিনিটে আপনার প্রথম চ্যানেল সংযুক্ত করুন।
প্ল্যাটফর্মের রিভিউয়ের জন্য অপেক্ষা করতে হবে না। WhatsApp, Instagram, TikTok বা অন্য কোনো চ্যানেল সংযুক্ত করুন, তারপর আপনার AI-কে পোস্ট করতে, রিপ্লাই দিতে বা রিপোর্ট দিতে বলুন, আর নিজের চোখে দেখুন কীভাবে কাজ করে।
- 3 দিন ফ্রি
- যেকোনো সময় বাতিল করুন
- শুধুমাত্র অফিশিয়াল API
- 24/7 পর্যবেক্ষণ
যাচাই করা হয়েছে