Magpadala ng verification code (OTP) sa WhatsApp
Para magpadala ng verification code (OTP) sa WhatsApp, gumagawa ang negosyo ng authentication template, ang fixed na format ng Meta na "<code> is your verification code." na may copy-code o one-tap button, at ipinapadala ito ng backend nito sa pamamagitan ng Cloud API, kasama ang code na nakalagay nang dalawang beses: sa body at sa button. Hanggang 15 characters ang puwedeng code, at ang opsyonal na babala tungkol sa expiry ay 1 hanggang 90 minuto.
Ina-connect ng easyCoexistence ang numero ng WhatsApp Business ninyo sa Cloud API ng Meta sa pamamagitan ng Coexistence, at ibinibigay sa backend ninyo ang kailangan para magpadala ng authentication template: ang Send endpoint, ang access token, at sa pamamagitan ng AI ninyo, ang create_template at get_template_status.
Pinakamahabang parameter na tinatanggap ng authentication template; bawal ang URL, media, at emoji sa content o parameters nito.
Saklaw ng code_expiration_minutes, na nagdadagdag ng linyang "This code expires in N minutes." sa mensahe.
Default na time-to-live ng authentication template; maaaring itakda mula 30 segundo hanggang 15 minuto.
Error na ibinabalik kapag ang authentication template ay ipinadala sa user ID na nakatali sa negosyo sa halip na numero ng telepono.
Ang mga authentication na mensahe ay naihahatid lang sa pangunahing device ng user sa WhatsApp; ang mga naka-link na device ay makikitang prompt na lang.
Fixed na throughput ng isang Coexistence na numero, ang pinakamataas na bilang ng login code sa biglaang pagdagsa.
Ano ang authentication template sa WhatsApp?
Ito ang tanging format na pinapayagan ng Meta para sa one-time password at verification code: kung nag-aalok ang app ng code sa pamamagitan ng WhatsApp, kailangan nitong gumamit nito, at hindi puwedeng may passcode ang utility o marketing template. Nakapirmi ang teksto, "<code> is your verification code.", na may dalawang opsyonal na linya, "For your security, do not share this code." at "This code expires in <N> minutes." Ang pipiliin ninyo ay ang button. Dine-disable ng WhatsApp ang forwarding ng mga mensaheng ito, at sa iOS 26 pataas, iniaalok din ang code bilang keyboard suggestion nang walang kailangang gawin sa panig ninyo.
Paano gumawa ng authentication template?
Piliin ito mula sa Template Library sa WhatsApp Manager, o i-submit sa pamamagitan ng API, na magagawa ng AI ninyo gamit ang create_template at category na AUTHENTICATION. Hindi kayo maglalagay ng body text: isusulat ito ng Meta mula sa settings ninyo, sa wikang pipiliin ninyo, at gagawing URL button ang OTP button pagkagawa. Isang template bawat wika. Hindi ipinapasa ng create_template ng connector ang message_send_ttl_seconds, kaya ang default na 10-minutong time-to-live ang masusunod maliban kung babaguhin ninyo ito sa API ng Meta.
{
"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" }
]}
]
}Paano ipinapadala ng backend ninyo ang code?
Isang request sa /messages endpoint ng numero para sa bawat code, gamit ang access token mula sa get_api_credentials o sa card ng dashboard na "Plug in your own system". Ilalagay ang parehong code nang dalawang beses: sa body parameter at sa URL button parameter sa index 0, at dapat numero ng telepono ang tatanggap. Bago magpadala, gagawin ng backend ang code, iimbak ang hash nito kasama ang oras ng expiry at attempt counter, at pagkatapos ay ikukumpara ng backend ang tinype ng user sa hash na iyon.
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" }] }
]
}
}Bakit galing sa backend ninyo ang code at hindi sa automation?
Dahil ang sistemang nagpapa-login sa user ang dapat gumawa, tandaan, at suriin ang code, at tanging ang sistemang iyon ang nakakaalam kung kailan kailangan ang code. Sinasagot ng automation ang mga mensaheng ipinapadala ng customer, at hindi kailanman nagsusulat sa numero ninyo ang login screen. Ibinubukod din ito ng mismong template: dala ng OTP button ang code bilang button variable, at tanging body variables lang ang pinupunan ng Send a template step, kaya hindi nito maipapadala ang authentication template. Maipapadala ito ng AI ninyo sa pamamagitan ng send_template, na nagpapasa ng button components sa Meta, pero para sa test iyon, hindi para sa login flow.
Ano ang nagpapaligtas sa WhatsApp OTP flow?
Magkatulad ang rekomendasyon ng best practices ng Meta at ang limitasyon ng format. Wala sa mga ito ang nangangailangan ng higit pa sa backend ninyo at sa Cloud API:
- Kumpirmahin ang numero ng WhatsApp sa user bago ang unang code, at sabihing darating ang code sa WhatsApp.
- Itakda ang time-to-live na katumbas o mas mababa sa expiry ng code, para hindi kailanman makita ng user ang patay na code kapag late dumating.
- Limitahan ang mga attempt at resend kada numero, at i-expire ang code sa unang gamit.
- Huwag gawing nag-iisang factor ng pagbawi ng account ang WhatsApp code: maaari pa ring maabot ng na-recycle na numero ng telepono ang lumang WhatsApp account.
- Bantayan ang status webhook at mag-alok ng SMS o email kapag hindi naihatid ang code.
Ano ang nagbabago kapag tumatakbo rin ang numero sa WhatsApp Business app?
Gumagana ang pagpapadala gaya ng sa anumang Cloud API na numero, hanggang 20 mensahe kada segundo. Ipinapakita ng Meta sa mga chat ng app ang mga mensaheng ipinadala sa pamamagitan ng API, kaya sa Coexistence na numero, lalabas din sa mga chat na iyon sa telepono ng negosyo ang mga code na ipinapadala ninyo. Ingatan ang telepono na iyon sa mga taong pinagkakatiwalaan ninyo, o magpadala ng code mula sa hiwalay na numero. Hinihiling din ng best practices ng Meta sa bawat negosyo na magpadala ng authentication template mula sa sarili nitong numero, hindi kailanman mula sa numerong pinagsasaluhan ng magkakaibang negosyo. Ang authentication ay isang bayad na template category na sinisingil kada naihatid na mensahe ayon sa bansa ng tatanggap, may hiwalay na authentication-international rate sa ilang merkado; walang dagdag na markup ang easyCoexistence.
Paano ito i-set up
- 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.
Mga karaniwang pagkakamali
- Paglalagay ng code sa utility template gaya ng "Your code is {{1}}". Ang passcode ay pinapayagan lang sa authentication template, at tinatanggihan ng Meta ang utility o marketing template na makikitang may laman nito.
- Pagpapadala ng code sa body lang. Kailangan ng copy-code button ang parehong value bilang parameter nito; inaasahan ng Meta na nasa request ang code nang dalawang beses.
- Pagpapanatili ng 30-araw na time-to-live sa lumang authentication template. Ang telepono na naka-offline nang isang oras ay makakatanggap ng expired na code; itakda ito na katumbas o mas mababa sa expiry ng code.
- Pagtatarget ng code sa user ID na nakatali sa negosyo. Sa numero ng telepono lang napupunta ang authentication template, at nagbabalik ang Meta ng error 131062.
Mino-monitor ang numero 24/7, kaya ang pag-disconnect na hihinto sa login code ay makakarating sa inyo sa pamamagitan ng email. Mula US$ 9 kada naka-connect na numero kada buwan, bumababa hanggang US$ 0.75 habang dumarami ang mga numero, at may unang 3 araw na free trial.
Mga madalas itanong
Mas mura ba ang WhatsApp OTP kaysa sa SMS code?
Sinisingil ng Meta ang bawat naihatid na authentication na mensahe ayon sa rate para sa bansa ng tatanggap, may espesyal na rate sa ilang merkado. Nag-iiba ang presyo ng SMS ayon sa carrier at route ng provider, at walang dagdag na markup ang easyCoexistence sa rate na ito. Ikumpara ang rate card ng Meta sa rate ng SMS provider ninyo para sa pangunahing bansa ninyo bago lumipat.
Pareho ba ito sa two-step verification PIN ng WhatsApp?
Hindi. Ang two-step verification ay anim na digit na PIN na nagpoprotekta sa sariling WhatsApp numero ng negosyo. Ang authentication template ay nagpapadala ng code sa mga customer ninyo para makumpirma ng app o site ninyo kung sino sila.
Kailangan bang mag-opt in ang user para makatanggap ng code?
Oo. Kinakailangan ng patakaran ng Meta ang pahintulot bago magpadala ang negosyo ng mensahe sa isang tao, at iminumungkahi ng gabay nito sa OTP na mag-alok ng pagpipilian ng channel, gaya ng WhatsApp, SMS o email. Ang pagpili ng WhatsApp sa login screen ninyo, sa tabi ng numero, ang siyang pahintulot na iyon.
Makapagpapadala ba ng code ang isang agency para sa ilang client mula sa iisang numero?
Hindi. Hinihiling ng best practices ng Meta na may sariling WhatsApp Business Account at numero ng telepono ang bawat negosyo para sa authentication template; ang pagbabahagi ng isang numero sa magkakaibang negosyo ay salungat sa terms at policy ng Meta. Magkonekta ng numero para sa bawat client sa halip.
Magpatuloy sa pagbabasa
Handa na po ba kayong magsimula?
I-set up ang WhatsApp Coexistence sa loob ng ilang minuto, hindi buwan. Patuloy na gumagana ang app sa telepono.
Magsimula ng Libreng TrialNa-verify noong