Hantar kod pengesahan (OTP) di WhatsApp
Untuk menghantar kod pengesahan (OTP) di WhatsApp, perniagaan mencipta authentication template, format tetap Meta: “<kod> ialah kod pengesahan anda.” dengan butang salin kod atau butang satu ketukan. Backend perniagaan kemudian menghantarnya melalui Cloud API dengan kod diisi dua kali, dalam badan mesej dan pada butang. Kod boleh mencapai 15 aksara, dan amaran tamat tempoh pilihan berjalan antara 1 hingga 90 minit.
easyCoexistence menyambungkan nombor WhatsApp Business anda kepada Cloud API Meta melalui Coexistence dan memberi backend anda apa yang diperlukan untuk menghantar authentication template: endpoint Send, token akses dan, melalui AI anda, create_template dan get_template_status.
Parameter terpanjang yang diterima oleh authentication template; URL, media dan emoji tidak dibenarkan dalam kandungan atau parameternya.
Julat code_expiration_minutes, yang menambah baris “Kod ini tamat tempoh dalam N minit.” pada mesej.
Masa hidup lalai (TTL) bagi authentication template; ia boleh ditetapkan dari 30 saat hingga 15 minit.
Ralat yang dikembalikan apabila authentication template dihantar kepada ID pengguna berskop perniagaan dan bukan nombor telefon.
Mesej pengesahan hanya dihantar ke peranti WhatsApp utama pengguna; peranti yang dipautkan melihat gesaan sebaliknya.
Throughput tetap bagi nombor Coexistence, had maksimum untuk letupan kod log masuk.
Apakah authentication template WhatsApp?
Satu-satunya format yang dibenarkan Meta untuk kata laluan sekali guna dan kod pengesahan: jika sesuatu aplikasi menawarkan kod melalui WhatsApp, ia mesti menggunakan templat ini, dan utility template atau marketing template tidak boleh membawa kata laluan. Teksnya tetap, “<kod> ialah kod pengesahan anda.”, dengan dua baris pilihan, “Demi keselamatan anda, jangan kongsi kod ini.” dan “Kod ini tamat tempoh dalam <N> minit.” Pilihan anda ialah butang. WhatsApp melumpuhkan pemajuan mesej ini, dan pada iOS 26 ke atas kod turut ditawarkan sebagai cadangan papan kekunci tanpa sebarang kerja di pihak anda.
Bagaimana anda mencipta authentication template?
Pilih daripada Template Library dalam WhatsApp Manager, atau hantar melalui API, yang boleh dilakukan oleh AI anda dengan create_template dan kategori AUTHENTICATION. Anda tidak menghantar teks badan: Meta menulisnya daripada tetapan anda, dalam bahasa yang anda pilih, dan menukar butang OTP kepada butang URL semasa penciptaan. Satu template bagi setiap bahasa. create_template penyambung tidak menghantar message_send_ttl_seconds, jadi lalai TTL 10 minit terpakai melainkan anda menukarnya melalui API 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" }
]}
]
}Bagaimana backend anda menghantar kod?
Satu permintaan ke endpoint /messages bagi setiap kod ke nombor, dengan token akses daripada get_api_credentials atau kad “Plug in your own system” pada dashboard. Kod yang sama dimasukkan dua kali, dalam parameter badan dan dalam parameter butang URL pada indeks 0, dan penerima mesti berupa nombor telefon. Sebelum menghantar, backend menjana kod, menyimpan hash kod bersama masa tamat tempoh dan pembilang cubaan, kemudian membandingkan apa yang dimasukkan pengguna dengan hash tersebut.
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" }] }
]
}
}Mengapa kod datang daripada backend dan bukan automasi?
Kerana sistem yang melog masuk pengguna mesti menjana kod, mengingatinya dan menyemaknya, dan hanya sistem itu tahu bila kod diperlukan. Automasi menjawab mesej yang dihantar pelanggan, dan skrin log masuk tidak pernah menulis kepada nombor anda. Template itu sendiri juga menghalangnya: butang OTP membawa kod sebagai pemboleh ubah butang, dan langkah Send a template hanya mengisi pemboleh ubah badan, jadi ia tidak boleh menghantar authentication template. AI anda boleh menghantar satu melalui send_template, yang menghantar komponen butang kepada Meta, tetapi itu untuk ujian, bukan aliran log masuk.
Apakah yang menjadikan aliran OTP WhatsApp selamat?
Amalan terbaik Meta dan had format menunjuk kepada senarai semak yang sama. Tiada yang memerlukan apa-apa melangkaui backend anda dan Cloud API:
- Sahkan nombor WhatsApp dengan pengguna sebelum kod pertama, dan nyatakan bahawa kod akan tiba di WhatsApp.
- Tetapkan masa hidup pada atau di bawah tempoh tamat kod, supaya penghantaran lewat tidak pernah menunjukkan kod yang sudah tamat.
- Hadkan percubaan dan penghantaran semula bagi setiap nombor, dan tamatkan kod selepas kegunaan pertama.
- Jangan jadikan kod WhatsApp satu-satunya faktor untuk pemulihan akaun: nombor telefon yang dikitar semula masih boleh sampai ke akaun WhatsApp lama.
- Pantau webhook status dan tawarkan SMS atau e-mel apabila kod gagal dihantar.
Apakah yang berubah apabila nombor turut berjalan dalam aplikasi WhatsApp Business?
Penghantaran berfungsi seperti pada mana-mana nombor Cloud API, sehingga 20 mesej sesaat. Meta memantulkan mesej yang dihantar melalui API ke dalam sembang aplikasi, jadi pada nombor Coexistence kod yang anda hantar juga muncul dalam sembang tersebut di telefon perniagaan; simpan telefon itu bersama orang yang anda percayai, atau hantar kod dari nombor berasingan. Amalan terbaik Meta juga meminta setiap perniagaan menghantar authentication template dari nombornya sendiri, bukan nombor yang dikongsi antara perniagaan. Pengesahan ialah kategori template berbayar yang dicaj bagi setiap mesej yang dihantar mengikut negara penerima, dengan kadar authentication-international berasingan di sesetengah pasaran; easyCoexistence tidak menambah markup.
Cara menetapkannya
- 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.
Kesilapan biasa
- Menulis kod ke dalam utility template seperti “Kod anda ialah {{1}}”. Meta hanya membenarkan kata laluan dalam authentication template dan menolak utility atau marketing template yang didapatinya membawa kata laluan.
- Menghantar kod dalam badan sahaja. Butang salin kod memerlukan nilai yang sama sebagai parameternya; Meta menjangka kod dimasukkan dua kali dalam permintaan.
- Mengekalkan masa hidup 30 hari pada authentication template lama. Telefon yang luar talian selama sejam kemudian menerima kod yang sudah tamat; tetapkan pada atau di bawah tempoh tamat kod.
- Mengalamatkan kod kepada ID pengguna berskop perniagaan. Authentication template hanya dihantar ke nombor telefon, dan Meta mengembalikan ralat 131062.
Nombor dipantau 24/7, jadi sebarang putus sambungan yang boleh menghentikan kod log masuk akan sampai kepada anda melalui e-mel. Daripada US$ 9 hingga US$ 0.75 bagi setiap nombor yang disambungkan sebulan, menurun apabila anda menambah nombor, dengan 3 hari pertama percuma.
Soalan lazim
Adakah OTP WhatsApp lebih murah daripada kod SMS?
Kadar Meta bagi setiap mesej pengesahan ialah kadar untuk negara penerima, dengan kadar khas di sesetengah pasaran, dan harga SMS berbeza mengikut pembawa dan laluan. Bandingkan kadar Meta dengan kadar penyedia SMS anda untuk negara utama anda sebelum beralih.
Adakah ini sama seperti PIN pengesahan dua langkah WhatsApp?
Tidak. Pengesahan dua langkah ialah PIN enam digit yang melindungi nombor WhatsApp Business perniagaan itu sendiri. Authentication template menghantar kod kepada pelanggan anda supaya aplikasi atau laman anda dapat mengesahkan siapa mereka.
Adakah pengguna perlu memberi kebenaran untuk menerima kod?
Ya. Dasar Meta memerlukan kebenaran sebelum perniagaan menghantar mesej kepada seseorang, dan panduan OTP mereka mencadangkan pilihan saluran, seperti WhatsApp, SMS atau e-mel. Memilih WhatsApp pada skrin log masuk anda, di sebelah nombor, ialah kebenaran tersebut.
Bolehkah agensi menghantar kod untuk beberapa klien daripada satu nombor?
Tidak. Amalan terbaik Meta memerlukan setiap perniagaan mempunyai Akaun WhatsApp Business dan nombor telefon sendiri untuk authentication template; berkongsi satu nombor antara perniagaan melanggar terma dan dasar Meta. Sambungkan satu nombor bagi setiap klien.
Teruskan membaca
Sedia untuk bermula?
Sediakan WhatsApp Coexistence dalam beberapa minit, bukan berbulan-bulan. Aplikasi terus berfungsi pada telefon.
Mulakan Percubaan PercumaDisahkan pada