WhatsApp پر تصدیقی کوڈ (OTP) بھیجیں
WhatsApp پر تصدیقی کوڈ (OTP) بھیجنے کے لیے کاروبار ایک توثیقی ٹیمپلیٹ بناتا ہے، جو Meta کا مقررہ فارمیٹ ہے: <code> آپ کا تصدیقی کوڈ ہے۔ اس کے ساتھ کاپی کوڈ یا ایک ٹیپ بٹن ہوتا ہے، اور اس کا بیک اینڈ اسے Cloud API کے ذریعے بھیجتا ہے، جس میں کوڈ دو بار بھرا جاتا ہے: متن اور بٹن میں۔ کوڈ 15 حروف تک ہو سکتا ہے، اور میعاد کی اختیاری یاددہانی 1 سے 90 منٹ تک چلتی ہے۔
easyCoexistence آپ کے WhatsApp Business نمبر کو Coexistence کے ذریعے Meta کے Cloud API سے جوڑتا ہے، اور آپ کے بیک اینڈ کو توثیقی ٹیمپلیٹ بھیجنے کے لیے درکار سب کچھ دیتا ہے: Send اینڈ پوائنٹ، ایکسیس ٹوکن، اور آپ کے AI کے ذریعے create_template اور get_template_status۔
توثیقی ٹیمپلیٹ کے قبول کردہ پیرامیٹر کی زیادہ سے زیادہ لمبائی؛ اس کے متن یا پیرامیٹرز میں URL، میڈیا اور ایموجی کی اجازت نہیں۔
code_expiration_minutes کی حد، جو پیغام میں یہ جملہ شامل کرتی ہے: یہ کوڈ N منٹ میں ختم ہوتا ہے۔
توثیقی ٹیمپلیٹ کا ڈیفالٹ TTL؛ اسے 30 سیکنڈ سے 15 منٹ تک سیٹ کیا جا سکتا ہے۔
ایرر جو اس وقت آتا ہے جب توثیقی ٹیمپلیٹ فون نمبر کے بجائے کاروبار سے مخصوص صارف ID پر بھیجا جائے۔
توثیقی پیغامات صرف صارف کے بنیادی WhatsApp ڈیوائس پر پہنچتے ہیں؛ لنک شدہ ڈیوائسز اس کے بجائے ایک پرامپٹ دیکھتی ہیں۔
Coexistence نمبر کی مقررہ رفتار، جو لاگ اِن کوڈز کی اچانک بھیڑ کی حد ہے۔
WhatsApp توثیقی ٹیمپلیٹ کیا ہے؟
یہ ایک بار استعمال ہونے والے پاس ورڈ اور تصدیقی کوڈز کے لیے Meta کا واحد اجازت یافتہ فارمیٹ ہے۔ اگر کوئی ایپ WhatsApp پر کوڈ دیتی ہے تو اسے یہی ٹیمپلیٹ استعمال کرنا ہوگا، اور یوٹیلیٹی یا مارکیٹنگ ٹیمپلیٹ میں پاس کوڈ نہیں ہو سکتا۔ متن مقرر ہے: <code> آپ کا تصدیقی کوڈ ہے۔ اس کے ساتھ دو اختیاری سطریں ہو سکتی ہیں: اپنی حفاظت کے لیے یہ کوڈ کسی کے ساتھ شیئر نہ کریں، اور یہ کوڈ N منٹ میں ختم ہو جاتا ہے۔ آپ جو منتخب کرتے ہیں وہ بٹن ہے۔ WhatsApp ان پیغامات کی فارورڈنگ بند کر دیتا ہے، اور iOS 26 اور اس کے بعد کے ورژنز پر کوڈ کی کی بورڈ سجھاؤ کے طور پر بھی پیش کیا جاتا ہے، جس کے لیے آپ کو کچھ نہیں کرنا۔
توثیقی ٹیمپلیٹ کیسے بنائیں؟
اسے WhatsApp Manager میں ٹیمپلیٹ لائبریری سے چنیں، یا API کے ذریعے جمع کریں، جو آپ کا AI create_template اور کیٹیگری AUTHENTICATION کے ساتھ کر سکتا ہے۔ آپ کوئی متن نہیں بھیجتے: Meta اسے آپ کی سیٹنگز سے، آپ کی منتخب کردہ زبان میں خود لکھتا ہے، اور تخلیق کے وقت OTP بٹن کو URL بٹن میں بدل دیتا ہے۔ ہر زبان کے لیے ایک ٹیمپلیٹ درکار ہے۔ کنیکٹر کا create_template message_send_ttl_seconds نہیں بھیجتا، اس لیے جب تک آپ اسے Meta کے API سے نہیں بدلتے، 10 منٹ کا ڈیفالٹ TTL لاگو رہتا ہے۔
{
"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 یا ڈیش بورڈ کے اپنا سسٹم جوڑیں کارڈ سے لیا جاتا ہے۔ وہی کوڈ دو بار جاتا ہے: باڈی پیرامیٹر میں اور انڈیکس 0 پر URL بٹن کے پیرامیٹر میں، اور وصول کنندہ کا فون نمبر ہونا ضروری ہے۔ بھیجنے سے پہلے بیک اینڈ کوڈ بناتا ہے، اس کا ہیش میعاد کے وقت اور کوشش کاؤنٹر کے ساتھ محفوظ کرتا ہے، اور بعد میں صارف جو ٹائپ کرتا ہے اسے اس ہیش سے ملاتا ہے۔
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 پر آئے گا۔
- TTL کو کوڈ کی میعاد کے برابر یا اس سے کم رکھیں، تاکہ تاخیر سے پہنچنے والا پیغام کبھی ختم شدہ کوڈ نہ دکھائے۔
- ہر نمبر کے لیے کوششوں اور دوبارہ بھیجنے کی حد مقرر کریں، اور کوڈ پہلی بار استعمال ہوتے ہی ختم کر دیں۔
- اکاؤنٹ بحال کرنے کے لیے صرف WhatsApp کوڈ کو واحد فیکٹر نہ بنائیں: دوبارہ تفویض شدہ فون نمبر اب بھی کسی پرانے WhatsApp اکاؤنٹ تک پہنچ سکتے ہیں۔
- اسٹیٹس ویب ہک پر نظر رکھیں، اور کوڈ نہ پہنچنے کی صورت میں SMS یا ای میل کا آپشن دیں۔
جب یہی نمبر WhatsApp Business ایپ میں بھی چلتا ہو تو کیا بدلتا ہے؟
بھیجنا کسی بھی Cloud API نمبر کی طرح کام کرتا ہے، فی سیکنڈ 20 پیغامات تک۔ Meta API سے بھیجے گئے پیغامات کو ایپ کی چیٹس میں دکھاتا ہے، اس لیے 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 دن کا TTL رکھنا۔ ایک گھنٹے سے آف لائن فون کو پھر ختم شدہ کوڈ ملتا ہے؛ TTL کو کوڈ کی میعاد کے برابر یا اس سے کم رکھیں۔
- کوڈ کو کاروبار سے مخصوص صارف ID پر بھیجنا۔ توثیقی ٹیمپلیٹ صرف فون نمبروں پر جاتے ہیں، اور 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 چند منٹ میں سیٹ اپ کریں، مہینوں میں نہیں۔ ایپ فون پر کام کرتی رہتی ہے۔
فری ٹرائل شروع کریںتصدیق شدہ تاریخ