WhatsApp හරහා සත්යාපන කේත (OTP) යවන්න
WhatsApp හරහා සත්යාපන කේතයක් (OTP) යැවීමට, ව්යාපාරයක් authentication template එකක් සාදයි. ඒ Meta හි ස්ථාවර format එකයි: “<code> is your verification code.” එහි copy-code හෝ one-tap බොත්තමක් ඇත. එහි backend එක Cloud API හරහා එය යවන අතර, කේතය body එකේත් බොත්තමේත් දෙවරක් පිරවේ. කේත අක්ෂර 15 දක්වා දිග විය හැක. විකල්ප කල් ඉකුත්වීමේ අනතුරු ඇඟවීම මිනිත්තු 1 සිට 90 දක්වා ක්රියා කරයි.
easyCoexistence ඔබේ WhatsApp Business අංකය Coexistence හරහා Meta හි Cloud API එකට සම්බන්ධ කරන අතර, authentication templates යැවීමට ඔබේ backend එකට අවශ්ය දේ ලබා දෙයි: Send endpoint එක, access token එක, සහ ඔබේ AI හරහා create_template සහ get_template_status.
authentication template එකට පිළිගත හැකි දිගම පරාමිතිය; එහි අන්තර්ගතයේ හෝ පරාමිතිවල URL, මාධ්ය සහ emoji අවසර නැත.
code_expiration_minutes හි පරාසය, එය පණිවිඩයට “This code expires in N minutes.” රේඛාව එක් කරයි.
authentication template එකේ පෙරනිමි time-to-live; එය තත්පර 30 සිට මිනිත්තු 15 දක්වා සැකසිය හැක.
authentication template එක දුරකථන අංකයක් වෙනුවට business-scoped user ID එකකට යවන විට ලැබෙන දෝෂය.
Authentication පණිවිඩ ලැබෙන්නේ පරිශීලකයාගේ ප්රාථමික WhatsApp උපාංගයට පමණි; සම්බන්ධිත උපාංග prompt එකක් දකී.
Coexistence අංකයේ ස්ථාවර throughput, එය login කේත burst සඳහා උපරිමය.
WhatsApp authentication template යනු කුමක්ද?
එක්වරක් භාවිත කළ හැකි මුරපද සහ සත්යාපන කේත සඳහා Meta අවසර දෙන එකම format එක එයයි. WhatsApp හරහා කේත ලබා දෙන යෙදුමකට එකක් භාවිත කළ යුතුය; utility හෝ marketing templates වලට මුරපදයක් ගෙන යා නොහැක. පෙළ ස්ථාවරයි: “<code> is your verification code.” විකල්ප රේඛා දෙකක් සහිතව: “For your security, do not share this code.” සහ “This code expires in <N> minutes.” ඔබ තෝරන්නේ බොත්තමයි. මෙම පණිවිඩවල forwarding WhatsApp විසින් අක්රිය කරයි. iOS 26 සහ ඊට පසු අනුවාදවල කේතය keyboard යෝජනාවක් ලෙසද දිස්වන අතර, ඔබේ පැත්තෙන් කිසිම වැඩක් අවශ්ය නොවේ.
authentication template එක ඔබ සාදන්නේ කෙසේද?
WhatsApp Manager හි Template Library එකෙන් එය තෝරන්න, නැතහොත් API හරහා ඉදිරිපත් කරන්න. ඔබේ AI හට AUTHENTICATION category එක සමඟ create_template භාවිතයෙන් එය කළ හැක. ඔබ body පෙළක් නොයවයි: Meta එය ඔබේ සැකසුම් වලින්, ඔබ තෝරන භාෂාවෙන් ලියයි, සහ සාදන විට OTP බොත්තම URL බොත්තමක් බවට පත් කරයි. භාෂාවකට එක් template එකක්. connector හි create_template මගින් message_send_ttl_seconds නොයවන බැවින්, Meta හි API හරහා වෙනස් නොකළහොත් විනාඩි 10 ක පෙරනිමි time-to-live එක අදාළ වේ.
{
"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" }
]}
]
}ඔබේ backend එක කේතය යවන්නේ කෙසේද?
කේතයකට එක් request එකක් අංකයේ /messages endpoint එකට යවයි, get_api_credentials හෝ dashboard හි “Plug in your own system” card එකෙන් ලබාගත් access token සමඟ. එම කේතය body parameter එකේද, index 0 හි URL බොත්තම් parameter එකේද දෙවරක් යයි, සහ ලබන්නා දුරකථන අංකයක් විය යුතුය. යැවීමට පෙර backend එක කේතය සාදා, එහි hash එකක්, කල් ඉකුත් වන වේලාවක් සහ උත්සාහ counter එකක් ගබඩා කරයි. පසුව පරිශීලකයා ටයිප් කරන දේ එම hash එකට සසඳයි.
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" }] }
]
}
}කේතය automation එකෙන් නොව ඔබේ backend එකෙන් එන්නේ ඇයි?
මන්ද පරිශීලකයා ලොග් කරන පද්ධතිය කේතය සෑදිය යුතුය, එය මතක තබාගෙන පරීක්ෂා කළ යුතුය, සහ කේතය අවශ්ය වන විට දන්නේ එම පද්ධතිය පමණි. Automations මගින් පාරිභෝගිකයින් යවන පණිවිඩවලට පිළිතුරු දෙයි; login තිරයක් ඔබේ අංකයට කිසි විටෙක ලියන්නේ නැත. Template එමද අවස්ථාව වළක්වයි: OTP බොත්තම කේතය button variable එකක් ලෙස රැගෙන යන අතර, “Send a template” step එක body variables පමණක් පුරවයි, එබැවින් එයට authentication template එකක් යැවිය නොහැක. ඔබේ AI හට send_template හරහා එකක් යැවිය හැක, එය Meta වෙත button components ගෙන යයි, නමුත් එය පරීක්ෂණයකට, login flow එකකට නොවේ.
WhatsApp OTP flow එකක් ආරක්ෂිත කරන්නේ කුමක්ද?
Meta හි හොඳම භාවිත ක්රම සහ format එකේ සීමා එකම පරීක්ෂා ලැයිස්තුවකට යොමු කරයි. ඒ සියල්ල ඔබේ backend එකට සහ Cloud API එකට අමතරව කිසිවක් අවශ්ය නොකරයි:
- පළමු කේතයට පෙර පරිශීලකයා සමඟ WhatsApp අංකය තහවුරු කර, කේතය WhatsApp හරහා පැමිණෙන බව කියන්න.
- time-to-live එක කේතයේ කල් ඉකුත්වීමට සමාන හෝ ඊට අඩුව සකසන්න, එවිට ප්රමාද වූ ලබා දීමක් කාලය ඉකුත් වූ කේතයක් නොපෙන්වයි.
- අංකයකට උත්සාහ සහ නැවත යැවීම් සීමා කර, පළමු භාවිතයෙන් පසු කේත කල් ඉකුත් කරන්න.
- WhatsApp කේතයක් ගිණුම් ප්රතිසාධනය සඳහා එකම සාධකය නොකරන්න: නැවත භාවිත වූ දුරකථන අංක තවමත් පැරණි WhatsApp ගිණුමකට ළඟා විය හැක.
- status webhook එක නිරීක්ෂණය කර, කේතය ලබා දීමට අසමත් වූ විට SMS හෝ email ලබා දෙන්න.
අංකය WhatsApp Business app එකෙහිද ධාවනය වන විට කුමක් වෙනස් වේද?
යැවීම ඕනෑම Cloud API අංකයක් මෙන් ක්රියා කරයි, තත්පරයට පණිවිඩ 20 දක්වා. Meta API හරහා යවන පණිවිඩ app එකේ chat වලටද පිළිබිඹු කරයි, එබැවින් Coexistence අංකයක ඔබ යවන කේතද ව්යාපාරික දුරකථනයේ එම chat වල දිස්වේ. එම දුරකථනය ඔබ විශ්වාස කරන අය සමඟ තබා ගන්න, නැතහොත් කේත වෙනම අංකයකින් යවන්න. Meta හි හොඳම භාවිත ක්රම ද ප්රකාශ කරන්නේ, සෑම ව්යාපාරයක්ම authentication templates තම අංකයෙන් යැවිය යුතු බවයි; ව්යාපාර අතර බෙදාගත් එකක් කිසිවිටෙක නොවේ. Authentication යනු ගෙවන template ප්රවර්ගයකි, ලැබුණු පණිවිඩයකට ලබන්නාගේ රටට අනුව බිල් කරයි, සමහර වෙළඳපොලවල වෙනම authentication-international අනුපාත සහිතව. easyCoexistence කිසිම markup එකක් එක් නොකරයි.
එය සකසන ආකාරය
- 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}}” වැනි utility template එකකට කේතය ලිවීම. Meta මුරපද අවසර දෙන්නේ authentication templates වලට පමණි; utility හෝ marketing templates එවැනි දෙයක් සොයාගත් විට ප්රතික්ෂේප කරයි.
- කේතය body එකේ පමණක් යැවීම. copy-code බොත්තමට එහි parameter එකට එම අගයම අවශ්යයි; Meta ඉල්ලීමේ කේතය දෙවරක් අපේක්ෂා කරයි.
- පැරණි authentication template එකක දින 30ක time-to-live එක තබා ගැනීම. පැයක් ඔෆ්ලයින් වූ දුරකථනයකට කල් ඉකුත් වූ කේතයක් ලැබේ; එය කේතයේ කල් ඉකුත්වීමට සමාන හෝ ඊට අඩුව සකසන්න.
- කේතය business-scoped user ID එකකට යොමු කිරීම. Authentication templates යවන්නේ දුරකථන අංක වලට පමණි; Meta දෝෂය 131062 ලබා දෙයි.
අංකය පැය 24/7 නිරීක්ෂණය කරයි, එබැවින් login කේත නවත්වන විසන්ධි වීමක් email මගින් ඔබ වෙත පැමිණේ. සම්බන්ධිත අංකයකට මාසිකව US$ 9 සිට US$ 0.75 දක්වා, අංක එකතු වන විට පහළ වේ, පළමු දින 7 නොමිලේ.
නිතර අසන ප්රශ්න
WhatsApp OTP කේතයක් SMS කේතයකට වඩා අඩුමිලද?
Meta ලැබුණු authentication පණිවිඩයක් ලබන්නාගේ රටේ අනුපාතයට බිල් කරයි, සමහර වෙළඳපොලවල විශේෂ අනුපාත සමඟ. SMS මිල carrier සහ route අනුව වෙනස් වේ. මාරු වීමට පෙර, ඔබේ ප්රධාන රටවල Meta හි rate card එක ඔබේ SMS provider හි එකට සසඳන්න.
WhatsApp හි two-step verification PIN එකම ද මෙය?
නැත. Two-step verification යනු ව්යාපාරයේ තමන්ගේම WhatsApp අංකය ආරක්ෂා කරන ඉලක්කම් 6 ක PIN එකයි. authentication template එකක් පාරිභෝගිකයින්ට කේතයක් යවන අතර, ඔබේ යෙදුම හෝ වෙබ් අඩවිය ඔවුන් කවුද යන්න තහවුරු කළ හැකිය.
ලැබීමට පරිශීලකයින් opt in විය යුතුද?
ඔව්. Meta ප්රතිපත්තිය අනුව ව්යාපාරයක් කෙනෙකුට පණිවිඩ යැවීමට පෙර අවසරය අවශ්යයි, සහ එහි OTP මාර්ගෝපදේශය WhatsApp, SMS හෝ email වැනි නාලිකා තේරීමක් ලබා දීමට යෝජනා කරයි. ඔබේ login තිරයේ අංකය ළඟ WhatsApp තේරීම එම අවසරයයි.
එක් අංකයකින් ගනුදෙනුකරුවන් කිහිප දෙනෙකුට ඒජන්සියකට කේත යැවිය හැකිද?
නැත. Meta හි හොඳම භාවිත ක්රම අනුව, සෑම ව්යාපාරයකටම authentication templates සඳහා තමන්ගේම WhatsApp Business Account එකක් සහ දුරකථන අංකයක් තිබිය යුතුය. ව්යාපාර අතර එකක් බෙදා ගැනීම Meta හි නියමවලට සහ ප්රතිපත්තියට විරුද්ධය. ඒ වෙනුවට සෑම ගනුදෙනුකරුවෙකුටම අංකයක් සම්බන්ධ කරන්න.
තවදුරටත් කියවන්න
ආරම්භ කිරීමට සූදානම්ද?
WhatsApp Coexistence මිනිත්තු කිහිපයකින් සකසන්න, මාස ගණනකින් නොව. යෙදුම දුරකථනයේ දිගටම ක්රියා කරයි.
නොමිලේ trial කාලය ආරම්භ කරන්නසත්යාපනය කළේ