আপনার টেস্ট স্ট্যাকে প্রজাতন্ত্র কঙ্গোর (+242) ভেরিফিকেশন কোড রাউট করা

শুরু থেকে শেষ পর্যন্ত একটি +242 কোড আনতে কোন API কলগুলো লাগে?

সবকিছু https://otproute.com/api/v1-এর অধীনে, এবং or_live_ দিয়ে শুরু হওয়া একটি Bearer কী দিয়ে অথেন্টিকেট হয়। Developer console-এ কী তৈরি করুন; একটি অ্যাকাউন্টে সর্বোচ্চ 10টি রাখা যায়, ফলে স্টেজিং, CI এবং কোনো সহকর্মীর ল্যাপটপের জন্য আলাদা, স্বাধীনভাবে বাতিলযোগ্য ক্রেডেনশিয়াল দেওয়া সহজ।

ব্রাজাভিল-বাজারের একটি সাধারণ টেস্ট রান এমন:

1. GET /api/v1/services ও GET /api/v1/countries টেনে আইডিগুলো ক্যাশ করুন। প্রজাতন্ত্র কঙ্গোর আইডি cg (এর বড় প্রতিবেশীর সঙ্গে গুলিয়ে ফেলবেন না, যার নিজস্ব আইডি এবং কঙ্গো (DRC) নামে আলাদা পেজ আছে)।
2. যে অ্যাপ টেস্ট করছেন তার লাইভ দাম ও প্রাপ্যতার জন্য GET /api/v1/prices?country=cg&service=<id> কল করুন।
3. {"service": "telegram", "country": "cg"}-এর মতো বডিসহ POST /api/v1/activations দিয়ে অ্যাক্টিভেশন তৈরি করুন। একটি অ্যাক্টিভেশন আইডি এবং একটি +242 নম্বর পাবেন।
4. নম্বরটি আপনার নিজের প্রোডাক্টের সাইন-আপ বা লগইন স্ক্রিনে দিন।
5. কঙ্গোলিজ কোডটি ওয়েবহুক ডেলিভারি থেকে বা GET /api/v1/activations/{id} পোল করে নিন। টেস্ট মাঝপথে বন্ধ হলে POST /api/v1/activations/{id}/cancel দিয়ে ছেড়ে দিন।

সুট শুরুর আগে GET /api/v1/balance চালান, যাতে ওয়ালেট খালি থাকলে জব মাঝপথে না ভেঙে শুরুতেই ব্যর্থ হয়। প্রতি মিনিটে 300 রিকোয়েস্টের সীমা কয়েকটি সমান্তরাল ওয়ার্কারের জন্য যথেষ্ট জায়গা রাখে। রিকোয়েস্ট ও রেসপন্সের পূর্ণ আকার ডেভেলপার ডকুমেন্টেশনে আছে।

কঙ্গোলিজ অ্যাক্টিভেশনের জন্য সাইন করা ওয়েবহুক কীভাবে জুড়ব?

একজন ইঞ্জিনিয়ার ফ্লো ক্লিক করে দেখলে পোলিং চলে; CI ফ্লিটের জন্য ওয়েবহুক অনেক ভদ্র। Developer console-এ একটি এন্ডপয়েন্ট যোগ করুন (প্রতি অ্যাকাউন্টে পাঁচটি অনুমোদিত) এবং activation.sms_received, activation.expired ও activation.cancelled সাবস্ক্রাইব করুন।

প্রতিটি রিকোয়েস্টে X-OTPRoute-Signature: t=<unix>,v1=<hex> থাকে। ওই এন্ডপয়েন্টের সিক্রেট দিয়ে "<t>.<raw body>"-এর HMAC-SHA256 আবার তৈরি করুন, কনস্ট্যান্ট-টাইম চেকে v1-এর সঙ্গে মেলান, এবং যার টাইমস্ট্যাম্প পুরোনো তা বাদ দিন। JSON পার্স করার আগেই raw বাইটের হ্যাশ নিন, কারণ পুনরায় সিরিয়ালাইজ করা JSON বাইটে বাইটে মেলে না বললেই চলে।

ইভেন্টগুলোকে অ্যাক্টিভেশন আইডি ধরে দেখুন। একই ইভেন্ট দুবার এলে আপনার হ্যান্ডলার যেন বুঝতে পারে আইডিটি আগেই সমাধান হয়ে গেছে এবং শুধু সফলতার স্ট্যাটাস ফেরত দেয়। ধীর টেস্ট রানারকে টাইমআউট থেকে বাঁচানোর কিউইং প্যাটার্ন নিয়ে ওয়েবহুক ক্যাপচার গাইডে আলোচনা আছে।

একটি কঙ্গো ভেরিফিকেশন নম্বর কোন সার্ভিসগুলো কভার করতে পারে?

cg-এর আজকের স্ন্যাপশটে আছে WhatsApp, Telegram, Google (Gmail & YouTube), Facebook, Instagram, TikTok, X (Twitter), ChatGPT (OpenAI), Claude, Microsoft & Outlook, LinkedIn, Signal, Viber এবং imo। সব মিলিয়ে OTP Gateway-তে দেশটির 1,000-এর বেশি সার্ভিস আছে।

রুট খোলা ও বন্ধ হওয়ার সঙ্গে সঙ্গে দিনের মধ্যে এই তালিকা বদলায়, তাই কখনো এটি হার্ড-কোড করবেন না। আপনার টেস্ট হার্নেস যে নির্দিষ্ট সার্ভিসটি চায় তার জন্য প্রাইস এন্ডপয়েন্টকে জিজ্ঞাসা করুক, এবং প্রাপ্যতা ফাঁকা থাকলে ভদ্রভাবে এড়িয়ে যাক বা পুনরায় সময় নির্ধারণ করুক। কঙ্গোলিজ তালিকায় মেসেজিং অ্যাপের আধিপত্য থাকে, যা সেখানকার বহু গ্রাহকের নতুন প্রোডাক্টের সঙ্গে প্রথম পরিচয়ের ধরনের সঙ্গে মেলে: অ্যাপ-স্টোরে খোঁজার বদলে চ্যাট গ্রুপে শেয়ার করা লিংকের মাধ্যমে।

+242 নম্বর কীভাবে সংরক্ষণ ও নরমালাইজ করা উচিত?

প্রজাতন্ত্র কঙ্গোর নম্বর দেশ কোডের পর নয় ডিজিট দীর্ঘ, এবং অনেক পরিকল্পনার বিপরীতে শুরুর 0 এখানে ট্রাঙ্ক প্রিফিক্স নয়, গ্রাহক নম্বরের অংশ। মোবাইল লাইন সাধারণত স্থানীয়ভাবে 06… বা 05… এবং আন্তর্জাতিকভাবে +242 06… আকারে লেখা হয়। ইউরোপীয় কোডবেস থেকে কপি করা, যেকোনো শুরুর শূন্য ছেঁটে ফেলা নরমালাইজার এগুলোকে নীরবে নষ্ট করবে, তাই API যে E.164 স্ট্রিং দেয় ঠিক সেটিই সংরক্ষণ করুন এবং একটি বৈশ্বিক নিয়মের বদলে প্রতিটি দেশের জন্য আলাদাভাবে দৈর্ঘ্য যাচাই করুন।

সরকারি ভাষা ফরাসি এবং এটিই সাধারণত ভেরিফিকেশন SMS-এর ভাষা, যদিও লিংগালা ও কিটুবা দৈনন্দিন জীবনে বহুল প্রচলিত। কিছু টেমপ্লেটে অ্যাকসেন্টযুক্ত অক্ষর আশা করুন, এবং নির্দিষ্ট ইংরেজি শব্দের উপর নির্ভর না করে প্যাটার্ন দিয়ে ডিজিট বের করার মতো করে আপনার পার্সার বানান।

টিমগুলো সাধারণত এখানে টেস্ট করে যখন তারা ফরাসি-ভাষী মধ্য আফ্রিকায় প্রোডাক্ট ছড়ায়, ব্রাজাভিল বা পয়েন্ট-নোয়ারের অপারেশনস স্টাফদের সহায়তা করে, অথবা বিদেশে থাকা কঙ্গোলিজ গ্রাহকদের সেবা দেয় যাঁরা এখনও দেশের নম্বর দিয়ে সাইন-আপ করেন। প্রকৃত +242 রুটে পুরো ফ্লো যাচাই করলে এমন ফরম্যাটিং ও কপির সমস্যা ধরা পড়ে যা সিমুলেটর মিস করত।

+242 নম্বরে কোনো কোড না পৌঁছালে কী করব?

নীরবতা সাধারণত রুট বা গ্রহণযোগ্যতার সমস্যা, ইন্টিগ্রেশনের বাগ নয়। একটি যুক্তিসঙ্গত প্লেবুক:

• কোনো সিদ্ধান্তে আসার আগে 20 মিনিটের উইন্ডোটি পুরোটা চলতে দিন; কিছু প্রেরক তাদের আউটবাউন্ড ট্রাফিক ব্যাচে পাঠায়।
• নিশ্চিত করুন লক্ষ্য সার্ভিস ভার্চুয়াল নম্বর গ্রহণ করে। বেশ কয়েকটি করে না, আর ঠিক সেজন্যই না-পাওয়া কোডের কোনো খরচ নেই।
• ঘন ঘন লুপে নতুন অর্ডার দিয়ে রেট লিমিট ক্ষয় না করে পরে আবার চেষ্টা করুন, অথবা অন্য সার্ভিস রুটে যান।
• যে নম্বর আর লাগবে না তা বাতিল করুন, যাতে মেয়াদ শেষের অপেক্ষা না করে অর্থ সঙ্গে সঙ্গে ফিরে আসে।

ব্যাকঅফ ও রিট্রাই বাজেট নিয়ে আরও বিস্তারিত আমাদের ব্যর্থ OTP ডেলিভারি কমানোর লেখায় আছে।

আমি কি একটি দীর্ঘমেয়াদি কঙ্গোলিজ লাইন রাখতে পারি?

প্রজাতন্ত্র কঙ্গোর জন্য নিজে-থেকে-কেনা কোনো দীর্ঘমেয়াদি নম্বর নেই। OTP Gateway প্রতি ভেরিফিকেশন কোডের জন্য একটি নম্বর দেয়, এবং এই মুহূর্তে cg-এর জন্য কেবল সেই প্রোডাক্টটিই দেওয়া হয়।

OTP Route-এর Dedicated Virtual Numbers যুক্তরাষ্ট্র ও কানাডার প্রোডাক্ট, মাসিক $1.95 থেকে শুরু, যাতে ইনবাউন্ড ও আউটবাউন্ড SMS এবং ব্রাউজার কলিং আছে। আপনার টিমের সত্যিই একটি স্থায়ী কঙ্গোলিজ লাইন দরকার হলে [email protected]এ ইমেইল করুন; কিছু ব্যবস্থা করা সম্ভব কি না তা স্থানীয় নিয়মের উপর নির্ভর করে, তাই এটিকে প্রতিশ্রুতি নয়, একটি প্রশ্ন হিসেবে দেখুন। সমঝোতাগুলোর সারসংক্ষেপ আছে অস্থায়ী বনাম ডেডিকেটেড নম্বর লেখায়।

একটি কঙ্গো OTP রাউটিং সেটআপের বিলিং কীভাবে হয়, আর নিরাপদে টেস্ট কীভাবে করব?

বিলিং চলে একটিমাত্র প্রিপেইড USD ওয়ালেট থেকে, কোনো সাবস্ক্রিপশন বা প্ল্যান টিয়ার নেই। কার্ড বা USDT/USDC স্টেবলকয়েন দিয়ে টপ-আপ করুন, এবং প্রতিটি টপ-আপে আপনার ফাইন্যান্স টিমের জন্য ইমেইলে একটি PDF ইনভয়েস তৈরি হয়।

পাইপলাইনে আসল টাকা জোড়ার আগে সাপোর্টকে বলুন একটি ডেভেলপমেন্ট অ্যাকাউন্টকে sandbox মোডে নিতে। এটি সিমুলেটেড নম্বর ও কোড ফেরত দেয়, ফলে কিছু খরচ না করেই পুরো SMS ভেরিফিকেশন API পথ এন্ড-টু-এন্ড চালিয়ে দেখা যায়। OTP Route কেবল আপনার নিজের প্রোডাক্ট ও যে অ্যাকাউন্ট চালানোর অধিকার আপনার আছে তাতে ব্যবহার করুন; প্রতিটি সার্ভিসের শর্তাবলি এবং আমাদের Acceptable Use Policy তখনও প্রযোজ্য। ওয়ালেটে চার্জ ও রিফান্ড কীভাবে দেখায় তা জানতে প্রাইসিং দেখুন।

সাধারণ জিজ্ঞাসা

OTP Route API-তে প্রজাতন্ত্র কঙ্গোর কান্ট্রি আইডি কী?

এটি cg। গণতান্ত্রিক প্রজাতন্ত্র কঙ্গো আলাদা দেশ, তার নিজস্ব আইডি আছে, তাই আপনার কনফিগ কোনটির কথা বলছে তা দুবার মিলিয়ে নিন।

স্থানীয় SIM ছাড়া কি আমার অ্যাপের কঙ্গোলিজ সাইন-আপ ফ্লো টেস্ট করতে পারি?

হ্যাঁ। টেস্টিংয়ের জন্য OTP Gateway থেকে একটি +242 নম্বর অর্ডার করুন, অ্যাপে দিন, এবং ড্যাশবোর্ডে বা API দিয়ে কোডটি পড়ুন।

+242 নম্বর সংরক্ষণের সময় কি শুরুর শূন্য বাদ দেব?

না। প্রজাতন্ত্র কঙ্গোতে 0 হলো নয় ডিজিটের গ্রাহক নম্বরের অংশ, তাই API যেমন ফেরত দেয় ঠিক তেমনই E.164 মান রেখে দিন।

কঙ্গোলিজ ভেরিফিকেশন বার্তা কোন ভাষায় আসবে?

বেশিরভাগ আসে ফরাসিতে, আন্তর্জাতিক অ্যাপের ক্ষেত্রে কখনো ইংরেজিতে। নির্দিষ্ট শব্দ মেলানোর বদলে প্যাটার্ন দিয়ে ডিজিট বের করুন।

কোড কখনো না এলে কি আমার চার্জ কাটা হয়?

না। SMS ছাড়া উইন্ডো বন্ধ হলে, অথবা আপনি আগে বাতিল করলে, পুরো অর্থ স্বয়ংক্রিয়ভাবে ওয়ালেটে ফিরে আসে।

কঙ্গোর SMS OTP পেতে কত খরচ হয়?

প্রতি কোড $0.20 থেকে; প্রতিটি অ্যাপের +242 দাম লাইভ উদ্ধৃত হয়, তাই অর্ডারের আগে কোয়েরি করে নিন।

ইন্টিগ্রেশন বানানোর জন্য কি কোনো sandbox আছে?

হ্যাঁ, অনুরোধ করলে। সাপোর্ট একটি ডেভেলপমেন্ট অ্যাকাউন্টকে sandbox মোডে নিতে পারে, যা ওয়ালেটের টাকা না ছুঁয়ে সিমুলেটেড নম্বর ও কোড ফেরত দেয়।

সার্ভিসের নামগুলো সংশ্লিষ্ট মালিকদের ট্রেডমার্ক। OTP Route তাদের সঙ্গে সম্পর্কিত নয়। নম্বর আইনসম্মতভাবে ব্যবহার করুন এবং প্রতিটি সার্ভিসের শর্ত ও আমাদের গ্রহণযোগ্য ব্যবহার নীতি মেনে চলুন।