মাল্টি-টেন্যান্ট সোশ্যাল মিডিয়া API: একটি API কী, অনেক গ্রাহকের অ্যাকাউন্ট
easyCoexistence-এর Partner API ডিজাইন অনুযায়ীই মাল্টি-টেন্যান্ট: আপনার অ্যাকাউন্টের একটি ec_live_ কী দিয়ে অনেক গ্রাহকের WhatsApp নম্বর ও সোশ্যাল অ্যাকাউন্ট সংযুক্ত ও পরিচালনা করা যায়। প্রতিটি সংযোগে থাকে আপনার গ্রাহকের id, external_ref হিসেবে, সেই গ্রাহকের নিজস্ব টোকেন, নিজস্ব ওয়েবহুক গন্তব্য, এবং স্বাক্ষরিত স্ট্যাটাস ইভেন্টে এর পরিচয়। তাই GET /channels?external_ref= একজন গ্রাহকের অ্যাকাউন্টগুলোর তালিকা দেয়।
একটি সংযোগ সেশন যে সর্বোচ্চ দৈর্ঘ্যের external_ref নেয়: আপনার নিজের গ্রাহক-id, যা সেশনের তৈরি সংযোগে সংরক্ষিত হয়।
একটি easyCoexistence অ্যাকাউন্ট একসঙ্গে যতগুলো API কী রাখতে পারে; আলাদা কী মানে আলাদা অ্যাকাউন্ট ও আলাদা বিল।
একটি অ্যাকাউন্ট একসঙ্গে যতগুলো সংযোগ সেশন খোলা রাখতে পারে, তার পাশে ঘণ্টায় 100 নতুন সেশনের সীমা।
যে বয়সের পর স্বাক্ষরিত ইভেন্টের টাইমস্ট্যাম্প বাতিল করা উচিত, এবং HMAC তুলনা হয় constant time-এ।
একটি অ্যাকাউন্ট কীভাবে অনেক গ্রাহককে সেবা দেয়?
আপনার easyCoexistence অ্যাকাউন্ট আপনার পণ্যের প্রতিনিধিত্ব করে, আর প্রতিটি গ্রাহক তারা যে সংযোগগুলো আনে তাতে একটি ট্যাগ। গ্রাহকদের নিজস্ব কোনো অ্যাকাউন্ট তৈরি করতে হয় না, তারা আপনার কী দেখে না, এবং তাদের বিল করেন আপনি, easyCoexistence নয়:
প্রতিটি সংযোগে কীভাবে আপনার গ্রাহককে ট্যাগ করবেন?
সংযোগ সেশনে external_ref পাঠান। মানটি সেশনের তৈরি নম্বর বা চ্যানেলে সংরক্ষিত হয়, রিডাইরেক্টে যোগ হয় এবং তার স্ট্যাটাস ইভেন্টে থাকে। একটি Facebook বা LinkedIn সাইন-ইন যদি একাধিক Page নিয়ে আসে, প্রতিটিকে ট্যাগ করা হয়। একজন গ্রাহকের অ্যাকাউন্টগুলো দেখতে যেকোনো তালিকা ফিল্টার করুন:
curl "https://easycoexistence.com/api/v1/channels?external_ref=customer_4821" \
-H "Authorization: Bearer $EC_API_KEY"
curl "https://easycoexistence.com/api/v1/connections?external_ref=customer_4821" \
-H "Authorization: Bearer $EC_API_KEY"গ্রাহকদের টোকেন কীভাবে আলাদা রাখা হয়?
প্রতিটি সংযোগ নিজের গ্রাহকের টোকেন ধরে রাখে। একটি WhatsApp নম্বরের টোকেন হলো Meta-র Embedded Signup-এ জারি করা ব্যবসায়িক টোকেন, যা সেই গ্রাহকের অ্যাসেটে সীমাবদ্ধ, আর একটি সোশ্যাল অ্যাকাউন্টের টোকেন হলো তার মালিকের দেওয়া অনুমতি। ক্রেডেনশিয়াল আসে শুধু আপনার কী দিয়ে, আপনার ব্যাকএন্ড থেকে, এবং আপনার অ্যাকাউন্টে নেই এমন একটি ID 404 not_found উত্তর দেয়। টোকেন আনার আগে কাজটি যে গ্রাহকের, তার সংযোগটি খুঁজে নিন, যাতে একটি টেন্যান্টের কাজ অন্য টেন্যান্টের অ্যাকাউন্টে না চলে।
প্রতিটি গ্রাহকের জন্য ওয়েবহুক কীভাবে কাজ করে?
প্রতি অ্যাকাউন্টে একটি গন্তব্য, যা আপনি বেছে নেন। চ্যানেলগুলো একটি URL-এ দিন এবং বডিতে account_id দেখে রাউট করুন, অথবা প্রতি গ্রাহককে তাদের নিজস্ব URL দিন। প্রতিটি চ্যানেল PUT /channels/{id}/webhook থেকে নেওয়া নিজস্ব সিক্রেট দিয়ে স্বাক্ষর করে, তাই account_id বলে দেয় কোন সিক্রেট দিয়ে যাচাই করতে হবে। একটি নম্বরের মেসেজ Meta থেকে যায় তার webhook_url-এ, যা WhatsApp Business Account-এ সেট করা হয়, তাই সেগুলো phone_number_id দিয়ে রাউট করুন।
স্ট্যাটাস ইভেন্টে বোঝা যায় কোন গ্রাহকের ঘটনা?
external_ref বহন করে। প্রতি অ্যাকাউন্টের একটি ইভেন্ট URL connection.* ও channel.* ইভেন্ট পায়, প্রতিটিতে ভেতরে সংযোগ বা চ্যানেলের ভিউ থাকে, যেখানে external_ref-ও থাকে। post.published ও post.failed পোস্ট এবং তার চ্যানেল বহন করে। ইভেন্টগুলো X-EC-Signature-এ অ্যাকাউন্টের নিজস্ব সিক্রেট দিয়ে স্বাক্ষরিত, এবং আপনার এন্ডপয়েন্ট ব্যর্থ হলে পুনরায় পাঠানো হয়, তাই প্রতিটি ডেলিভারি id একবারই প্রক্রিয়া করুন।
কত দ্রুত অনেক গ্রাহককে অনবোর্ড করা যায়?
প্রতি অ্যাকাউন্টে একসঙ্গে 50টি খোলা সংযোগ সেশন এবং ঘণ্টায় 100টি নতুন সেশন। Meta প্রতিটি প্রথমবারের WhatsApp অনবোর্ডিং একটি অ্যাপ-ব্যাপী সীমার বিপরীতে গোনে, যা প্রতিটি easyCoexistence অ্যাকাউন্ট ভাগ করে নেয়, এবং সীমাগুলো একটি প্ল্যাটফর্মের বড় আমদানি যেন তা শেষ না করে সে জন্য আছে। প্রতিটি সেশন তখনই তৈরি করুন যখন গ্রাহক সংযোগ দিতে যাচ্ছেন; সীমা হলে 429 cap_reached বা rate_limited উত্তর আসে।
গ্রাহকের অ্যাকাউন্ট যদি অন্য কোথাও আগে থেকেই সংযুক্ত থাকে?
সাইন-ইন প্রত্যাখ্যান করা হয়। একটি সোশ্যাল অ্যাকাউন্ট একসঙ্গে একটি easyCoexistence অ্যাকাউন্টের সঙ্গে যুক্ত হতে পারে, তাই easyCoexistence ব্যবহার করা অন্য কোনো সার্ভিস যদি তা ধরে রাখে, সেশনের last_error সেটা বলে দেয়, এবং গ্রাহক সেখানে সেটি সরিয়ে দেন বা অন্য অ্যাকাউন্ট দিয়ে সাইন-ইন করেন। আপনার নিজের অ্যাকাউন্টের ভেতরে গ্রাহক যত দরকার তত অ্যাকাউন্ট সংযুক্ত করতে পারেন, প্রতিটি একই external_ref দিয়ে ট্যাগ করা।
একজন গ্রাহককে কীভাবে অফবোর্ড করবেন?
external_ref দিয়ে তাদের সংযোগ ও চ্যানেলের তালিকা করুন, এবং প্রতিটি মুছুন DELETE দিয়ে। একটি নম্বর সরালে Meta-তে easyCoexistence-এর অ্যাক্সেস প্রত্যাহার হয় এবং মনিটরিং বন্ধ হয়; একটি চ্যানেল সরালে নেটওয়ার্কে অ্যাক্সেস প্রত্যাহার হয় এবং সারিতে থাকা পোস্টগুলো বাতিল হয়। প্রতিটির বিল চক্র শেষে বন্ধ হয়, আর গ্রাহকের অন্য সংযোগ, অন্য টেন্যান্টদের মতোই, অপরিবর্তিত থাকে।
সাধারণ ভুলগুলো
- external_ref হিসেবে ইমেইল ব্যবহার করা। ইমেইল বদলায়, আর মানটি প্রতিটি সংযোগে সংরক্ষিত হয়, তাই আপনার নিজের ডেটাবেসের স্থায়ী id ব্যবহার করুন।
- ভুল টেন্যান্টের সিক্রেট দিয়ে ফরওয়ার্ড করা ইভেন্ট যাচাই করা। বডির account_id দিয়ে সিক্রেট খুঁজুন, কারণ প্রতিটি চ্যানেল নিজের সিক্রেট দিয়ে স্বাক্ষর করে।
- সব গ্রাহকের কাছে একসঙ্গে সংযোগের লিংক পাঠানো। প্রতি অ্যাকাউন্টে মাত্র 50টি সেশন খোলা যায়, তাই গ্রাহকদের ধাপে ধাপে আমন্ত্রণ জানান।
- শুধু নিজের ডেটাবেস থেকে একজন গ্রাহককে মুছে ফেলা। তাদের সংযোগ আপনার অ্যাকাউন্ট ও বিলে থেকে যায়, যতক্ষণ না API-র মাধ্যমে প্রতিটি সরানো হয়।
easyCoexistence-এর মাধ্যমে একটি API কী আপনার পুরো গ্রাহকভিত্তিকে সেবা দিতে পারে: তাদের WhatsApp নম্বর, Instagram, Facebook, TikTok, YouTube ও LinkedIn অ্যাকাউন্ট, এবং আরও চ্যানেল। প্রতিটি আপনার গ্রাহক id দিয়ে ট্যাগ করা, নিজস্ব টোকেন, ওয়েবহুক ও স্বাক্ষরিত ইভেন্ট নিয়ে আসে, এবং প্রতিটি সংযোগ 24/7 মনিটর হয়। প্রতি সংযোগে মাসে US$ 9 থেকে US$ 0.75, আরও সংযোগ যোগ করলে কমে; প্রথম 3 দিন ফ্রি।
প্রায়শই জিজ্ঞাসিত প্রশ্ন
আমার কি প্রতি গ্রাহকের জন্য একটি easyCoexistence অ্যাকাউন্ট লাগবে?
না। একটি অ্যাকাউন্ট ও তার কী অনেক গ্রাহকের সংযোগ ধরে রাখতে পারে, external_ref দিয়ে তারা আলাদা হয়। আলাদা বিল চাইলেই আলাদা অ্যাকাউন্ট লাগে।
আমার গ্রাহকরা কি একে অপরের অ্যাকাউন্ট দেখতে পারবে?
easyCoexistence-এর মাধ্যমে নয়। তারা আপনার কী কখনো পায় না এবং শুধু নিজের সংযোগের লিংক খোলে। আপনার পণ্যের ভেতরে প্রতি গ্রাহক কী দেখবে, তা আপনার কোড ঠিক করে।
আমি কি প্রতি গ্রাহককে আলাদা ওয়েবহুক URL দিতে পারি?
হ্যাঁ। প্রতিটি নম্বর ও প্রতিটি চ্যানেল নিজস্ব গন্তব্য নিতে পারে, তাই গ্রাহক-নির্দিষ্ট URL কাজ করে, যেমন একটি ভাগ করা URL যা account_id দিয়ে রাউট হয়।
একাধিক গ্রাহকের অ্যাকাউন্টে বিল কীভাবে হয়?
সব গ্রাহক মিলিয়ে প্রতি সংযোগে মাসে US$ 9 থেকে US$ 0.75, আপনার মোট সংখ্যার ব্যান্ড অনুযায়ী ঠিক হয়, প্রথম 3 দিন ফ্রি।
আরও পড়ুন
দুই মিনিটে আপনার প্রথম চ্যানেল সংযুক্ত করুন।
প্ল্যাটফর্মের রিভিউয়ের জন্য অপেক্ষা করতে হবে না। WhatsApp, Instagram, TikTok বা অন্য কোনো চ্যানেল সংযুক্ত করুন, তারপর আপনার AI-কে পোস্ট করতে, রিপ্লাই দিতে বা রিপোর্ট দিতে বলুন, আর নিজের চোখে দেখুন কীভাবে কাজ করে।
- 3 দিন ফ্রি
- যেকোনো সময় বাতিল করুন
- শুধুমাত্র অফিশিয়াল API
- 24/7 পর্যবেক্ষণ
যাচাই করা হয়েছে