আপনার ব্যবহারকারীদের আপনার অ্যাপে WhatsApp, Instagram ও TikTok অ্যাকাউন্ট সংযুক্ত করার উপায়
আপনার ব্যবহারকারীরা যাতে আপনার অ্যাপে WhatsApp, Instagram ও TikTok অ্যাকাউন্ট যুক্ত করতে পারে, easyCoexistence-এর Partner API দিয়ে একটি সংযোগ সেশন তৈরি করুন এবং ব্যবহারকারীকে এর হোস্টেড URL-এ পাঠান। সেখানে তারা Meta-র Embedded Signup-এর মাধ্যমে একটি WhatsApp নম্বর সংযুক্ত করেন, অথবা Instagram, Facebook, TikTok, YouTube, LinkedIn ও আরও চ্যানেলে সাইন ইন করেন, তারপর নতুন সংযোগ বা চ্যানেলের আইডিসহ আপনার redirect_url-এ ফিরে আসেন। লিংকের মেয়াদ এক ঘণ্টা।
একটি সংযোগ লিংক কতক্ষণ কাজ করে; এরপর সেশনটি মেয়াদোত্তীর্ণ দেখায় এবং নতুন একটি লাগে।
একটি অ্যাকাউন্ট একসঙ্গে কতগুলো সংযোগ সেশন খোলা রাখতে পারে, তার পাশাপাশি প্রতি ঘণ্টায় 100টি নতুন সেশনের সীমা রয়েছে।
একটি সেশন তৈরি হয়েছে, খোলা হয়েছে, সংযুক্ত হয়েছে, বাতিল হয়েছে বা মেয়াদোত্তীর্ণ হয়েছে, যেমনটি GET /connect-sessions/:id জানায়।
Meta যে সর্বোচ্চ বিকল্প কলব্যাক URL গ্রহণ করে, যা একটি WhatsApp নম্বরের মেসেজ ওয়েবহুক অন্য জায়গায় পাঠাতে ব্যবহৃত হয়।
একটি সংযোগ লিংক কীভাবে কাজ করে?
একটি চেকআউট পেজের মতো। আপনার ব্যাকএন্ড একটি সেশন তৈরি করে, আপনার ইন্টারফেস গ্রাহককে এর URL-এ পাঠায়, গ্রাহক easycoexistence.com-এর একটি পেজে সংযুক্ত হন, এবং ব্রাউজার আপনার redirect_url-এ ফিরে আসে। এরপর আপনার ব্যাকএন্ড ফলাফল নিশ্চিত করে এবং নতুন সংযোগের ক্রেডেনশিয়াল আনে, সবই আপনার API কী দিয়ে।
রিকোয়েস্টে কী থাকে?
পাঠানো হয় https://easycoexistence.com/api/v1/connect-sessions ঠিকানায়, আপনার API কী দিয়ে একটি Bearer টোকেন হিসেবে একটি JSON বডি। শুধু redirect_url আবশ্যক:
redirect_url: একটি https URL, যেখানে গ্রাহক পরে পৌঁছায়।- channel: whatsapp, ডিফল্ট মান, অথবা আপনার অ্যাকাউন্টের জন্য খোলা কোনো সোশ্যাল নেটওয়ার্ক, এর ছোট হাতের নামে, যেমন instagram, tiktok বা youtube।
external_ref: এই গ্রাহকের জন্য আপনার নিজের আইডি, সর্বোচ্চ 200 অক্ষর।partner_name: হোস্টেড পেজে যে নাম দেখানো হয়, সর্বোচ্চ 80 অক্ষর; ডিফল্টভাবে আপনার অ্যাকাউন্টের নাম।webhook_urlওwebhook_verify_token: শুধু নম্বরের জন্য, এবং সবসময় একসঙ্গে। সংযুক্ত হওয়ার মুহূর্ত থেকে Meta নম্বরের মেসেজ এখানে পাঠায়।
curl -X POST https://easycoexistence.com/api/v1/connect-sessions \
-H "Authorization: Bearer $EC_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"channel": "whatsapp",
"redirect_url": "https://app.example.com/connect/return",
"external_ref": "customer_4821",
"partner_name": "ClinicApp",
"webhook_url": "https://hooks.example.com/wa/<long-random-secret>",
"webhook_verify_token": "another-long-random-string"
}'কী ফেরত আসে?
একটি 201 প্রতিক্রিয়ায় সেশনটি ফেরত আসে। গ্রাহককে URL-এ পাঠান এবং id রাখুন, যা cs_ দিয়ে শুরু হয়, যাতে পরে সেশনটি খোঁজা যায়। expires_at তৈরির এক ঘণ্টা পর পড়ে, আর গ্রাহক সংযুক্ত হলে connection_id বা channel_id পূর্ণ হয়, সেশনের চ্যানেল অনুযায়ী। GET /connect-sessions/:id যেকোনো সময় একই আকৃতি ফেরত দেয়।
{
"id": "cs_…",
"url": "https://easycoexistence.com/connect/cs_…",
"channel": "whatsapp",
"status": "created",
"external_ref": "customer_4821",
"connection_id": null,
"channel_id": null,
"token_ready": false,
"redirect_url": "https://app.example.com/connect/return",
"webhook_url": "https://hooks.example.com/wa/<long-random-secret>",
"last_error": null,
"expires_at": "2026-10-31T15:00:00.000Z",
"opened_at": null,
"finished_at": null,
"created_at": "2026-10-31T14:00:00.000Z"
}সেশন তৈরিতে কোন ত্রুটি আসতে পারে?
প্রতিটি ত্রুটির একই বডি থাকে, একটি অবজেক্ট যাতে code ও message থাকে, এবং মেসেজে লেখা থাকে কী ঠিক করতে হবে। সেশন তৈরি করলে যা ফেরত আসতে পারে:
- 400
invalid_jsonবাinvalid_request: বডিটি একটি JSON অবজেক্ট নয়, অথবা কোনো ফিল্ড যাচাইয়ে ব্যর্থ হয়েছে, যেমন এমনredirect_urlযা https নয়। - 400
channel_unavailable: চ্যানেলটি এই অ্যাকাউন্টের জন্য খোলা নয়; মেসেজে খোলা চ্যানেলগুলোর তালিকা থাকে। - 401 unauthorized: API কী নেই বা অবৈধ।
- 402
billing_required: অ্যাকাউন্টে এখনও কার্ড নেই, এবং এর মাধ্যমে সংযুক্ত সবকিছুর বিল এই অ্যাকাউন্টে যায়। - 429
cap_reached: ইতিমধ্যে 50টি সেশন খোলা আছে; কিছু শেষ হওয়া বা মেয়াদোত্তীর্ণ হওয়ার জন্য অপেক্ষা করুন। - 429
rate_limited: এই ঘণ্টায় 100টির বেশি সেশন; মেসেজে লেখা থাকে কতক্ষণ অপেক্ষা করতে হবে।
গ্রাহক পরে কোথায় পৌঁছায়?
আপনার redirect_url-এ, ফলাফলটি তার কোয়েরি স্ট্রিংয়ে যোগ করা থাকে। একই ফলাফল সেশনেও থাকে, যা আপনার ব্যাকএন্ড GET /connect-sessions/:id দিয়ে পড়ে:
- session: সেশন আইডি, cs_ এর পরে এলোমেলো অক্ষর।
- status: connected, অথবা cancelled যখন গ্রাহক Cancel and go back বেছে নেয়।
external_ref: গ্রাহকের জন্য আপনার আইডি, যদি সেশনে তা থাকে।connection_id: নতুন নম্বরের আইডি, /connections-এর জন্য।channel_id: নতুন সোশ্যাল অ্যাকাউন্টের আইডি, /channels-এর জন্য।
https://app.example.com/connect/return?session=cs_…&status=connected&external_ref=customer_4821&connection_id=…সেশনের কী কী স্ট্যাটাস হতে পারে?
পাঁচটি। GET /connect-sessions/:id বর্তমানটি জানায়, সঙ্গে opened_at, finished_at এবং last_error, যা বলে শেষ চেষ্টাটি কেন ব্যর্থ হয়েছে:
- created: আপনার ব্যাকএন্ড তৈরি করেছে, এখনও খোলা হয়নি।
- opened: গ্রাহক হোস্টেড পেজটি লোড করেছেন।
- connected: একটি নম্বর বা সোশ্যাল অ্যাকাউন্ট সংযুক্ত হয়েছে, এবং তার আইডি সেশনে আছে।
- cancelled: গ্রাহক Cancel and go back বেছে নিয়ে বেরিয়ে গেছেন।
- expired: সেশনটি শেষ হওয়ার আগেই এক ঘণ্টা শেষ হয়ে গেছে।
একটি লিংক কতক্ষণ কাজ করে?
তৈরির এক ঘণ্টা পর পর্যন্ত। এরপর হোস্টেড পেজ গ্রাহককে জানায় লিংকের মেয়াদ শেষ হয়েছে, সঙ্গে একটি বোতাম যা আপনার redirect_url-এ ফেরত নেয়, status=cancelled চিহ্নিত করে, এবং সেশনটি expired দেখায়। একটি অ্যাকাউন্ট একসঙ্গে 50টি খোলা সেশন রাখতে পারে এবং ঘণ্টায় 100টি তৈরি করতে পারে, কারণ Meta প্রতিটি প্রথমবারের অনবোর্ডিং একটি অ্যাপ-ব্যাপী সীমার বিরুদ্ধে গণনা করে, যা প্রতিটি অ্যাকাউন্ট ভাগ করে নেয়।
external_ref কী করে?
এটি প্রতিটি সংযোগকে আপনার গ্রাহকের সঙ্গে যুক্ত করে। আপনি যে মান পাঠান তা সেশনটি যে নম্বর বা চ্যানেল তৈরি করে সেখানে সংরক্ষিত হয়, রিডাইরেক্টে যোগ হয় এবং তার সম্পর্কে প্রতিটি স্ট্যাটাস ইভেন্টে অন্তর্ভুক্ত থাকে। তাই GET /connections?external_ref=customer_4821 এবং GET /channels?external_ref=customer_4821 তালিকাভুক্ত করে ওই গ্রাহক কী কী সংযুক্ত করেছে। Facebook বা LinkedIn সাইন-ইন একসঙ্গে একাধিক Page আনতে পারে: রিডাইরেক্টে প্রথমটির নাম থাকে, এবং ফিল্টারে বাকিগুলো তালিকাভুক্ত হয়। আপনার নিজের ডেটাবেসের একটি স্থির আইডি ব্যবহার করুন, এমন ইমেল নয় যা বদলাতে পারে।
গ্রাহক বাতিল করলে বা সাইন-ইন ব্যর্থ হলে কী হয়?
এটি কোথায় ঘটেছে তার ওপর নির্ভর করে, এবং সেশন রেকর্ডটি রাখে:
- Meta-র পপআপ ব্যর্থ হলে বা বন্ধ করা হলে: লিংক খোলা থাকা অবস্থায় গ্রাহক একই পেজে আবার Connect চাপেন।
- একটি সোশ্যাল সাইন-ইন বাতিল বা প্রত্যাখ্যাত হলে: গ্রাহক কারণসহ হোস্টেড পেজে ফিরে যান এবং লিংকের মেয়াদ শেষ না হওয়া পর্যন্ত আবার চেষ্টা করতে পারেন।
- অ্যাকাউন্টটি ইতিমধ্যে অন্য একটি easyCoexistence অ্যাকাউন্টের মাধ্যমে সংযুক্ত থাকলে:
last_errorতা জানায়, এবং গ্রাহক অন্য একটি দিয়ে সাইন ইন করেন। - গ্রাহক Cancel and go back বেছে নিলে: আপনার
redirect_urlপায় status=cancelled এবং সেশন বন্ধ হয়, তাই অন্যবার চেষ্টার জন্য নতুন সেশন তৈরি করুন। - লিংকের মেয়াদ শেষ হলে: নতুন সেশন তৈরি করুন।
নম্বর সংযুক্ত হলেও গ্রাহকের টোকেন না থাকলে কী হয়?
Meta কখনও কখনও গ্রাহকের নিজস্ব ব্যবসার টোকেন ইস্যু না করেই Embedded Signup শেষ করে। তখন হোস্টেড পেজ আরও একবার ধাপ সম্পন্ন করতে বলে, যাতে কয়েক সেকেন্ড সময় লাগে। গ্রাহক এড়িয়ে গেলে সেশনটি connected দেখায় এবং token_ready false থাকে, আর আপনার ইভেন্ট URL-এ connection.token_missing যায়: নম্বরটি মেসেজ পায়, কারণ এর আইডিগুলো বৈধ, তবে টোকেন ইস্যু না হওয়া পর্যন্ত, অর্থাৎ একটি নতুন সংযোগ সেশন এটিকে পুনরায় সংযুক্ত না করা পর্যন্ত, মেসেজ পাঠাতে পারে না।
webhook_url Meta-র যাচাই পাস না করলে কী হয়?
নম্বরটি তবুও সংযুক্ত হয়। Meta একটি GET হ্যান্ডশেক দিয়ে webhook_url যাচাই করে, যা আপনার এন্ডপয়েন্ট পাস করে hub.verify_token মিললে hub.challenge ফেরত দিয়ে। ব্যর্থ হলে সেশনের last_error ‘webhook_url was not applied’ দিয়ে শুরু হয় এবং Meta-র কারণ দেয়, আর PUT /connections/:id/webhook এন্ডপয়েন্ট উত্তর দিলে গন্তব্য ঠিক করে দেয়। সংযোগের 24 ঘণ্টার মধ্যে সেট করলে এটি এখনও কন্টাক্টের এক-বারের ইমপোর্ট এবং, গ্রাহক শেয়ার করতে সম্মত হলে, চ্যাট ইতিহাস গ্রহণ করে।
গ্রাহক কী দেখে?
easycoexistence.com-এর একটি পেজ, যেখানে partner_name থেকে আপনার নাম থাকে, এবং পূরণ করার জন্য কোনো অ্যাকাউন্ট, ইমেল বা কার্ড নেই। একটি WhatsApp নম্বরের জন্য এটি একটি সংক্ষিপ্ত যোগ্যতার চেকলিস্ট দেখায়, তারপর Meta-র পপআপ এবং WhatsApp Business অ্যাপ দিয়ে স্ক্যান করার জন্য একটি QR কোড। একটি সোশ্যাল অ্যাকাউন্টের জন্য এটি একটি মাত্র বোতাম দেখায়, যেমন Continue with TikTok, যা নেটওয়ার্কের নিজস্ব সম্মতি পর্দা একই ট্যাবে খোলে, তাই ফোনেও কাজ করে।
সাধারণ ভুলগুলো
- শুধু কোয়েরি স্ট্রিংয়ের ওপর ভরসা করা। যে কেউ URL-এ status=connected টাইপ করতে পারে, তাই গ্রাহককে সংযুক্ত চিহ্নিত করার আগে আপনার ব্যাকএন্ড থেকে GET /connect-sessions/:id দিয়ে নিশ্চিত করুন।
- লিংকটি iframe-এ এমবেড করা। রিডাইরেক্ট বা নতুন ট্যাবের মাধ্যমে গ্রাহককে পাঠান, কারণ হোস্টেড পেজ ও এর খোলা সাইন-ইনগুলো এভাবেই চলার জন্য তৈরি।
- আগে থেকে লিংক তৈরি করা। প্রতিটি লিংক এক ঘণ্টা কাজ করে এবং প্রতিটি খোলা সেশন 50-এর সীমায় গণনা হয়, তাই গ্রাহক সংযুক্ত হতে যাওয়ার সময় সেশন তৈরি করুন।
- 200 অক্ষরের বেশি webhook_url পাঠানো। Meta সর্বোচ্চ 200 অক্ষরের বিকল্প কলব্যাক URL গ্রহণ করে, তাই এর চেয়ে লম্বাটি প্রয়োগ হয় না এবং নম্বরটি সেটি ছাড়াই সংযুক্ত হয়।
easyCoexistence আপনার গ্রাহকদের WhatsApp নম্বর এবং তাদের Instagram, Facebook, TikTok, YouTube ও LinkedIn অ্যাকাউন্ট, সঙ্গে আরও চ্যানেল, একটি হোস্টেড লিংকের মাধ্যমে আপনার সফটওয়্যারের সঙ্গে সংযুক্ত করে, তারপর আপনার ব্যাকএন্ডকে প্রতিটি সংযোগের ক্রেডেনশিয়াল, ওয়েবহুক ও স্বাক্ষরযুক্ত স্ট্যাটাস ইভেন্ট দেয়। প্রতি সংযোগে প্রতি মাসে US$ 9 থেকে US$ 0.75, সংযোগ বাড়ানোর সঙ্গে কমে, প্রথম 3 দিন ফ্রি ট্রায়াল।
প্রায়শই জিজ্ঞাসিত প্রশ্ন
একটি সংযোগ লিংক কি দুবার ব্যবহার করা যায়?
না। একটি লিংক একটি নম্বর দিয়ে, বা একটি সোশ্যাল সাইন-ইন দিয়ে শেষ হয়, যা Facebook বা LinkedIn-এ একাধিক Page আনতে পারে। এরপর এটি connected দেখায়, তাই পরের সংযোগের জন্য নতুন সেশন তৈরি করুন।
লিংকটি কি ইমেল বা চ্যাটে পাঠানো যায়?
হ্যাঁ, যতক্ষণ গ্রাহক এক ঘণ্টার মধ্যে এটি খোলেন। URL-এর সেশন আইডিটি পেজটিকে অনুমোদন দেয়, তাই প্রতিটি লিংক শুধু যে গ্রাহকের জন্য তৈরি হয়েছে তাকেই পাঠান।
হোস্টেড পেজটি কি ফোনে কাজ করে?
সোশ্যাল সাইন-ইন কাজ করে, কারণ সেগুলো একই ট্যাবে খোলে। একটি WhatsApp নম্বর সবচেয়ে ভালোভাবে কম্পিউটার থেকে সংযুক্ত করা হয়: ফোনে Meta-র পপআপ নতুন ট্যাব হিসেবে খোলে, এবং QR কোড স্ক্যান করার জন্য ফোনটিই প্রয়োজন।
পোলিং না করে কীভাবে জানব যে গ্রাহক সংযুক্ত হয়েছেন?
ড্যাশবোর্ডে Profile, Developers-এর অধীনে একটি স্ট্যাটাস ইভেন্ট URL সেট করুন। সংযোগ সম্পন্ন হলেই easyCoexistence connection.connected বা channel.connected পাঠায়, যা স্বাক্ষরযুক্ত এবং আপনার external_ref বহন করে।
আরও পড়ুন
দুই মিনিটে আপনার প্রথম চ্যানেল সংযুক্ত করুন।
প্ল্যাটফর্মের রিভিউয়ের জন্য অপেক্ষা করতে হবে না। WhatsApp, Instagram, TikTok বা অন্য কোনো চ্যানেল সংযুক্ত করুন, তারপর আপনার AI-কে পোস্ট করতে, রিপ্লাই দিতে বা রিপোর্ট দিতে বলুন, আর নিজের চোখে দেখুন কীভাবে কাজ করে।
- 3 দিন ফ্রি
- যেকোনো সময় বাতিল করুন
- শুধুমাত্র অফিশিয়াল API
- 24/7 পর্যবেক্ষণ
যাচাই করা হয়েছে