WhatsApp-এ যাচাইকরণ কোড (OTP) পাঠান
WhatsApp-এ যাচাইকরণ কোড (OTP) পাঠাতে একটি ব্যবসা প্রমাণীকরণ টেমপ্লেট তৈরি করে, যার ফরম্যাট Meta-র নির্দিষ্ট: “<code> is your verification code.” এর সঙ্গে থাকে একটি কোড কপি বা ওয়ান-ট্যাপ বাটন। ব্যবসার ব্যাকএন্ড Cloud API দিয়ে এটি পাঠায়, যেখানে কোডটি দুবার বসে: মেসেজের বডিতে এবং বাটনে। কোড সর্বোচ্চ 15 অক্ষরের হতে পারে, আর ঐচ্ছিক মেয়াদ-সতর্কবার্তা 1 থেকে 90 মিনিট পর্যন্ত চলে।
easyCoexistence আপনার WhatsApp Business নম্বরকে Coexistence-এর মাধ্যমে Meta-র Cloud API-র সঙ্গে যুক্ত করে এবং আপনার ব্যাকএন্ডকে প্রমাণীকরণ টেমপ্লেট পাঠানোর জন্য যা লাগে তা দেয়: Send এন্ডপয়েন্ট, অ্যাক্সেস টোকেন এবং আপনার AI-র মাধ্যমে create_template ও get_template_status।
প্রমাণীকরণ টেমপ্লেট যে সবচেয়ে দীর্ঘ প্যারামিটার গ্রহণ করে; এর কনটেন্ট বা প্যারামিটারে URL, মিডিয়া ও ইমোজি অনুমোদিত নয়।
code_expiration_minutes-এর পরিসর, যা মেসেজে “This code expires in N minutes.” লাইনটি যোগ করে।
প্রমাণীকরণ টেমপ্লেটের ডিফল্ট টাইম-টু-লাইভ; এটি 30 সেকেন্ড থেকে 15 মিনিট পর্যন্ত সেট করা যায়।
প্রমাণীকরণ টেমপ্লেট ফোন নম্বরের বদলে ব্যবসা-ভিত্তিক ইউজার আইডিতে পাঠানো হলে যে ত্রুটি ফেরত আসে।
প্রমাণীকরণ মেসেজ শুধু ব্যবহারকারীর প্রাথমিক WhatsApp ডিভাইসে যায়; লিংক করা ডিভাইসে তার বদলে একটি প্রম্পট দেখা যায়।
একটি Coexistence নম্বরের স্থির থ্রুপুট, যা লগ ইন কোডের হঠাৎ ঢলের জন্য সর্বোচ্চ সীমা।
WhatsApp প্রমাণীকরণ টেমপ্লেট কী?
ওয়ান-টাইম পাসওয়ার্ড (OTP) ও যাচাইকরণ কোডের জন্য Meta-র একমাত্র অনুমোদিত ফরম্যাট এটি। কোনো অ্যাপ WhatsApp দিয়ে কোড দিতে চাইলে এই টেমপ্লেট ব্যবহার করতে হবে, আর ইউটিলিটি বা মার্কেটিং টেমপ্লেটে পাসকোড রাখা যায় না। লেখাটি নির্দিষ্ট: “<code> is your verification code.”। দুটি ঐচ্ছিক লাইন যোগ হতে পারে: “For your security, do not share this code.” এবং “This code expires in <N> minutes.”। আপনি শুধু বাটনটি বেছে নেন। WhatsApp এই মেসেজ ফরওয়ার্ড করা বন্ধ রাখে, আর iOS 26 ও তার পরের সংস্করণে কোডটি কিবোর্ড সাজেশন হিসেবেও দেখা যায়, এজন্য আপনাকে কিছু করতে হয় না।
প্রমাণীকরণ টেমপ্লেটটি কীভাবে তৈরি করবেন?
WhatsApp Manager-এর টেমপ্লেট লাইব্রেরি থেকে বেছে নিন, অথবা API দিয়ে জমা দিন; আপনার AI এটি create_template এবং ক্যাটাগরি AUTHENTICATION দিয়ে করতে পারে। আপনাকে কোনো বডি টেক্সট পাঠাতে হয় না: Meta আপনার সেটিংস থেকে, আপনার বেছে নেওয়া ভাষায় লেখাটি তৈরি করে এবং তৈরির সময় OTP বাটনকে URL বাটনে পরিণত করে। প্রতি ভাষায় একটি টেমপ্লেট। কানেক্টরের create_template message_send_ttl_seconds পাস করে না, তাই Meta-র API দিয়ে বদলানো না হলে 10 মিনিটের ডিফল্ট টাইম-টু-লাইভ প্রযোজ্য হয়।
{
"connection_id": "<from list_numbers>",
"name": "login_code",
"language": "en_US",
"category": "AUTHENTICATION",
"components": [
{ "type": "BODY", "add_security_recommendation": true },
{ "type": "FOOTER", "code_expiration_minutes": 5 },
{ "type": "BUTTONS", "buttons": [
{ "type": "OTP", "otp_type": "COPY_CODE", "text": "Copy code" }
]}
]
}আপনার ব্যাকএন্ড কীভাবে কোড পাঠায়?
নম্বরের /messages এন্ডপয়েন্টে প্রতি কোডের জন্য একটি রিকোয়েস্ট যায়, সঙ্গে অ্যাক্সেস টোকেন থাকে, যা get_api_credentials থেকে বা ড্যাশবোর্ডের “আপনার নিজের সিস্টেম যুক্ত করুন” কার্ড থেকে আসে। একই কোড দুবার যায়: বডি প্যারামিটারে এবং URL বাটনের প্যারামিটারে ইনডেক্স 0-তে, আর প্রাপককে অবশ্যই একটি ফোন নম্বর হতে হবে। পাঠানোর আগে ব্যাকএন্ড কোড তৈরি করে, তার একটি হ্যাশ মেয়াদ-সময় ও চেষ্টার গণনাসহ সংরক্ষণ করে, এবং পরে ব্যবহারকারী যা টাইপ করেন তা ওই হ্যাশের সঙ্গে মেলায়।
POST https://graph.facebook.com/<VERSION>/<PHONE_NUMBER_ID>/messages
Authorization: Bearer <ACCESS_TOKEN>
{
"messaging_product": "whatsapp",
"to": "5511987654321",
"type": "template",
"template": {
"name": "login_code",
"language": { "code": "en_US" },
"components": [
{ "type": "body",
"parameters": [{ "type": "text", "text": "482913" }] },
{ "type": "button", "sub_type": "url", "index": "0",
"parameters": [{ "type": "text", "text": "482913" }] }
]
}
}কোডটি অটোমেশন থেকে না এসে কেন আপনার ব্যাকএন্ড থেকে আসে?
কারণ যে সিস্টেম ব্যবহারকারীকে লগ ইন করায়, কোডটি তাকেই তৈরি করতে হয়, মনে রাখতে হয় ও যাচাই করতে হয়; কখন কোড লাগবে তা শুধু সেই সিস্টেমই জানে। অটোমেশন গ্রাহকদের পাঠানো মেসেজের উত্তর দেয়, আর লগইন স্ক্রিন কখনো আপনার নম্বরে লেখে না। টেমপ্লেটটি নিজেও এগুলো বাদ দেয়: OTP বাটনে কোড একটি বাটন ভেরিয়েবল হিসেবে থাকে, আর “টেমপ্লেট পাঠান” ধাপ শুধু বডি ভেরিয়েবল পূরণ করে, তাই প্রমাণীকরণ টেমপ্লেট পাঠাতে পারে না। আপনার AI send_template দিয়ে একটি পাঠাতে পারে, যা Meta-তে বাটন কম্পোনেন্ট পাস করে, কিন্তু সেটি পরীক্ষার জন্য, লগইন ফ্লোর জন্য নয়।
একটি WhatsApp OTP ফ্লো কীসে নিরাপদ হয়?
Meta-র সেরা চর্চা ও ফরম্যাটের সীমা একই চেকলিস্টের দিকে নির্দেশ করে। এর কোনোটির জন্য আপনার ব্যাকএন্ড ও Cloud API-র বাইরে কিছু লাগে না:
- প্রথম কোড পাঠানোর আগে ব্যবহারকারীর সঙ্গে WhatsApp নম্বরটি নিশ্চিত করুন, এবং বলুন কোডটি WhatsApp-এ আসবে।
- টাইম-টু-লাইভ কোডের মেয়াদের সমান বা তার চেয়ে কম রাখুন, যাতে দেরিতে পৌঁছানো কোড কখনো মেয়াদোত্তীর্ণ না দেখায়।
- প্রতি নম্বরে চেষ্টা ও পুনরায় পাঠানো সীমিত করুন, আর প্রথমবার ব্যবহারের পরই কোডের মেয়াদ শেষ করুন।
- অ্যাকাউন্ট পুনরুদ্ধারের একমাত্র উপাদান হিসেবে WhatsApp কোড রাখবেন না: পুনর্ব্যবহৃত ফোন নম্বর এখনো পুরোনো WhatsApp অ্যাকাউন্টে পৌঁছাতে পারে।
- স্ট্যাটাস ওয়েবহুক পর্যবেক্ষণ করুন, আর কোড ডেলিভার না হলে SMS বা ইমেইল অফার করুন।
নম্বরটি WhatsApp Business অ্যাপেও চললে কী বদলায়?
পাঠানো Cloud API নম্বরের মতোই কাজ করে, সেকেন্ডে 20টি মেসেজ পর্যন্ত। API দিয়ে পাঠানো মেসেজ Meta অ্যাপের চ্যাটেও প্রতিফলিত করে, তাই একটি Coexistence নম্বরে আপনার পাঠানো কোডগুলো ব্যবসার ফোনের ওই চ্যাটেও দেখা যাবে; ফোনটি এমন মানুষের কাছে রাখুন যাদের আপনি বিশ্বাস করেন, অথবা কোড আলাদা নম্বর থেকে পাঠান। Meta-র সেরা চর্চা আরও বলে, প্রতিটি ব্যবসা প্রমাণীকরণ টেমপ্লেট নিজের নম্বর থেকে পাঠাবে, কখনো একাধিক ব্যবসার মধ্যে ভাগ করা নম্বর থেকে নয়। প্রমাণীকরণ একটি পেইড টেমপ্লেট ক্যাটাগরি, যেখানে প্রতি ডেলিভার করা মেসেজের জন্য প্রাপকের দেশ অনুযায়ী বিল হয়; কয়েকটি বাজারে আলাদা প্রমাণীকরণ-আন্তর্জাতিক রেট আছে। easyCoexistence এতে কোনো অতিরিক্ত মার্কআপ যোগ করে না।
কীভাবে সেট আপ করবেন
- Connect the numberConnect your WhatsApp Business number to easyCoexistence through Meta's Coexistence flow, or use a separate number reserved for codes.
- Create the authentication templateAsk your AI to submit login_code with create_template, category AUTHENTICATION, a copy-code button and an expiry, then check get_template_status for APPROVED.
- Store the credentials on your serverCall get_api_credentials or open "Plug in your own system" in the dashboard, and put the Send endpoint and access token in your backend's secrets.
- Build generate, send and verifyGenerate the code, store its hash with an expiry, send the template with the code in the body and button, then check the user's entry against the hash.
- Handle failuresRead failed statuses from the number's webhook, then offer SMS or email and show the user which number the code went to.
সাধারণ ভুলগুলো
- ইউটিলিটি টেমপ্লেটে কোড লেখা, যেমন “Your code is {{1}}”। Meta শুধু প্রমাণীকরণ টেমপ্লেটে পাসকোড অনুমোদন করে, আর ইউটিলিটি বা মার্কেটিং টেমপ্লেটে পাসকোড পেলে সেগুলো প্রত্যাখ্যান করে।
- কেবল বডিতে কোড পাঠানো। কোড কপি বাটনের প্যারামিটারেও একই মান লাগে; Meta রিকোয়েস্টে কোডটি দুবার আশা করে।
- পুরোনো প্রমাণীকরণ টেমপ্লেটে 30 দিনের টাইম-টু-লাইভ রাখা। এক ঘণ্টা অফলাইন থাকা ফোন মেয়াদোত্তীর্ণ কোড পায়; এটি কোডের মেয়াদের সমান বা কম রাখুন।
- ব্যবসা-ভিত্তিক ইউজার আইডিতে কোড পাঠানোর ঠিকানা দেওয়া। প্রমাণীকরণ টেমপ্লেট শুধু ফোন নম্বরে যায়, আর Meta ত্রুটি 131062 ফেরত দেয়।
নম্বরটি 24/7 পর্যবেক্ষণ করা হয়, তাই যে সংযোগ-বিচ্ছিন্নতা লগইন কোড থামিয়ে দিতে পারে, তা ইমেইলে আপনাকে জানানো হয়। প্রতি নম্বরে প্রতি মাসে US$ 9 থেকে US$ 0.75 পর্যন্ত, নম্বর যোগ করার সঙ্গে কমে, প্রথম 3 দিন ফ্রি।
প্রায়শই জিজ্ঞাসিত প্রশ্ন
WhatsApp OTP কি SMS কোডের চেয়ে সস্তা?
Meta প্রতি ডেলিভার করা প্রমাণীকরণ মেসেজের জন্য প্রাপকের দেশের রেট নেয়, কিছু বাজারে বিশেষ রেটও আছে; আর SMS-এর দাম প্রদানকারী ও রুট অনুযায়ী বদলায়। স্যুইচ করার আগে আপনার প্রধান দেশগুলোর জন্য Meta-র রেট কার্ড ও আপনার SMS প্রদানকারীর রেট কার্ড পাশাপাশি রেখে তুলনা করুন।
এটি কি WhatsApp-এর টু-স্টেপ যাচাইকরণ PIN-এর মতোই?
না। টু-স্টেপ যাচাইকরণ হলো ছয় সংখ্যার PIN, যা ব্যবসার নিজের WhatsApp নম্বর রক্ষা করে। প্রমাণীকরণ টেমপ্লেট গ্রাহকদের কোড পাঠায়, যাতে আপনার অ্যাপ বা সাইট যাচাই করতে পারে তারা কে।
কোড পেতে ব্যবহারকারীদের কি অপ্ট-ইন করতে হয়?
হ্যাঁ। Meta-র নীতি অনুযায়ী কাউকে মেসেজ পাঠানোর আগে অনুমতি লাগে, আর OTP নির্দেশিকা পরামর্শ দেয় একাধিক চ্যানেলের পছন্দ দিতে, যেমন WhatsApp, SMS বা ইমেইল। আপনার লগইন স্ক্রিনে নম্বরের পাশে WhatsApp বেছে নেওয়াটাই সেই অনুমতি।
একটি এজেন্সি কি একটি নম্বর থেকে কয়েকটি ক্লায়েন্টের কোড পাঠাতে পারে?
না। Meta-র সেরা চর্চা অনুযায়ী প্রমাণীকরণ টেমপ্লেটের জন্য প্রতিটি ব্যবসার নিজস্ব WhatsApp Business অ্যাকাউন্ট ও ফোন নম্বর থাকতে হয়; একাধিক ব্যবসার মধ্যে একটি নম্বর ভাগ করা Meta-র শর্ত ও নীতির পরিপন্থী। বরং প্রতি ক্লায়েন্টের জন্য আলাদা নম্বর সংযুক্ত করুন।
আরও পড়ুন
শুরু করতে প্রস্তুত?
মাস নয়, কয়েক মিনিটেই WhatsApp Coexistence সেট আপ করুন। ফোনে অ্যাপটি কাজ করতে থাকে।
ফ্রি ট্রায়াল শুরু করুনযাচাই করা হয়েছে