MasukMulai uji coba gratis
Meta Tech Provider

Kirim kode verifikasi (OTP) di WhatsApp

Untuk mengirim kode verifikasi (OTP) di WhatsApp, bisnis membuat template autentikasi, yaitu format tetap dari Meta “<code> is your verification code.” dengan tombol salin kode atau satu ketuk. Backend bisnis lalu mengirimkannya melalui Cloud API dengan kode yang diisi dua kali, di body dan di tombol. Kode maksimal 15 karakter, dan peringatan kedaluwarsa opsional rentangnya 1 sampai 90 menit.

easyCoexistence menghubungkan nomor WhatsApp Business Anda ke Cloud API Meta melalui Coexistence dan memberi backend Anda apa yang dibutuhkan untuk mengirim template autentikasi: endpoint Send, token akses, dan, lewat AI Anda, create_template serta get_template_status.

15 characters

Parameter terpanjang yang diterima template autentikasi; URL, media, dan emoji tidak diizinkan di isi maupun parameternya.

1 to 90 minutes

Rentang code_expiration_minutes, yang menambahkan baris “This code expires in N minutes.” ke pesan.

10 minutes

Masa berlaku default (time-to-live) template autentikasi; dapat diatur dari 30 detik sampai 15 menit.

131062

Kesalahan yang dikembalikan saat template autentikasi dikirim ke ID pengguna berlingkup bisnis, bukan ke nomor telepon.

Primary device

Pesan autentikasi hanya dikirim ke perangkat WhatsApp utama pengguna; perangkat tertaut hanya menampilkan prompt.

20 msg/s

Throughput tetap dari nomor Coexistence, batas atas untuk lonjakan kode login.

Apa itu template autentikasi WhatsApp?

Satu-satunya format yang diizinkan Meta untuk kata sandi sekali pakai dan kode verifikasi. Jika aplikasi menawarkan kode lewat WhatsApp, aplikasi wajib memakai format ini, dan template utility atau marketing tidak boleh memuat kode sandi. Teksnya tetap, “<code> is your verification code.”, dengan dua baris opsional, “For your security, do not share this code.” dan “This code expires in <N> minutes.” Yang Anda pilih adalah tombolnya. WhatsApp menonaktifkan penerusan pesan ini, dan di iOS 26 ke atas kode juga ditawarkan sebagai saran keyboard tanpa pengaturan tambahan dari Anda.

Copy codeTapping copies the code to the clipboard; the user pastes it in your app or site
One-tap autofillAndroid: the button opens your app and hands it the code; needs app changes and a handshake
Zero-tapAndroid only, no button: your app receives the code through a broadcast receiver

Bagaimana cara membuat template autentikasi?

Pilih dari Template Library di WhatsApp Manager, atau kirim lewat API, yang bisa dilakukan AI Anda dengan create_template dan kategori AUTHENTICATION. Anda tidak mengirim teks body: Meta menulisnya dari pengaturan Anda, dalam bahasa yang Anda pilih, dan mengubah tombol OTP menjadi tombol URL saat dibuat. Satu template untuk setiap bahasa. create_template dari konektor tidak meneruskan message_send_ttl_seconds, sehingga masa berlaku default 10 menit tetap berlaku kecuali Anda mengubahnya lewat API Meta.

create_template arguments for a copy-code template
{
  "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 mengirim kode?

Satu permintaan ke endpoint /messages milik nomor untuk setiap kode, dengan token akses dari get_api_credentials atau kartu “Plug in your own system” di dashboard. Kode yang sama dimasukkan dua kali, di parameter body dan di parameter tombol URL indeks 0, dan penerimanya harus berupa nomor telepon. Sebelum mengirim, backend membuat kode, menyimpan hash-nya beserta waktu kedaluwarsa dan penghitung percobaan, lalu membandingkan apa yang diketik pengguna dengan hash tersebut.

Sending a login code from your backend
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 kode berasal dari backend dan bukan dari otomatisasi?

Karena sistem yang memproses login harus membuat kode, mengingatnya, dan memeriksanya, dan hanya sistem itu yang tahu kapan kode dibutuhkan. Otomatisasi menjawab pesan yang dikirim pelanggan, sedangkan layar login tidak pernah menulis ke nomor Anda. Template itu sendiri juga menutup jalan ini: tombol OTP membawa kode sebagai variabel tombol, sedangkan langkah Send a template hanya mengisi variabel body, sehingga tidak bisa mengirim template autentikasi. AI Anda bisa mengirim satu lewat send_template, yang meneruskan komponen tombol ke Meta, tetapi itu untuk uji coba, bukan alur login.

Apa yang membuat alur OTP WhatsApp aman?

Praktik terbaik Meta dan batasan format menunjuk ke daftar periksa yang sama. Tidak ada yang membutuhkan apa pun selain backend Anda dan Cloud API:

  • Konfirmasi nomor WhatsApp dengan pengguna sebelum kode pertama, dan beri tahu bahwa kode akan datang lewat WhatsApp.
  • Atur time-to-live sama dengan atau di bawah masa berlaku kode, sehingga pengiriman yang terlambat tidak pernah menampilkan kode yang sudah kedaluwarsa.
  • Batasi percobaan dan kirim ulang per nomor, dan kedaluwarsakan kode saat pertama kali dipakai.
  • Jangan jadikan kode WhatsApp satu-satunya faktor untuk pemulihan akun: nomor telepon yang didaur ulang masih bisa menjangkau akun WhatsApp lama.
  • Pantau webhook status dan tawarkan SMS atau email saat kode gagal terkirim.

Apa yang berubah jika nomor juga dipakai di aplikasi WhatsApp Business?

Pengiriman berjalan seperti pada nomor Cloud API mana pun, hingga 20 pesan per detik. Meta mencerminkan pesan yang dikirim lewat API ke percakapan di aplikasi, sehingga pada nomor Coexistence, kode yang Anda kirim juga muncul di percakapan itu pada ponsel bisnis. Pastikan ponsel itu hanya dipegang orang yang Anda percaya, atau kirim kode dari nomor terpisah. Praktik terbaik Meta juga meminta setiap bisnis mengirim template autentikasi dari nomornya sendiri, tidak pernah dari nomor yang dipakai bersama antarbisnis. Autentikasi adalah kategori template berbayar yang ditagih per pesan terkirim sesuai negara penerima, dengan tarif authentication-international terpisah di beberapa pasar. easyCoexistence tidak menambahkan markup.

Cara mengonfigurasi

  1. Connect the numberConnect your WhatsApp Business number to easyCoexistence through Meta's Coexistence flow, or use a separate number reserved for codes.
  2. 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.
  3. 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.
  4. 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.
  5. Handle failuresRead failed statuses from the number's webhook, then offer SMS or email and show the user which number the code went to.

Kesalahan umum

  • Menulis kode ke dalam template utility seperti “Your code is {{1}}”. Meta hanya mengizinkan kode sandi di template autentikasi dan menolak template utility atau marketing yang memuatnya.
  • Mengirim kode hanya di body. Tombol salin kode membutuhkan nilai yang sama sebagai parameternya, dan Meta mengharapkan kode muncul dua kali dalam permintaan.
  • Mempertahankan time-to-live 30 hari pada template autentikasi lama. Ponsel yang offline selama satu jam lalu menerima kode yang sudah kedaluwarsa; atur sama dengan atau di bawah masa berlaku kode.
  • Mengirim kode ke ID pengguna berlingkup bisnis. Template autentikasi hanya dikirim ke nomor telepon, dan Meta mengembalikan kesalahan 131062.
Melakukan ini dengan EasyCoexistence

Nomor dipantau 24/7, sehingga jika koneksi terputus dan bisa menghentikan kode login, Anda diberi tahu lewat email. US$ 9 hingga US$ 0.75 per nomor per bulan, turun seiring Anda menambah nomor, dengan 3 hari pertama gratis.

Pertanyaan yang sering diajukan

Apakah OTP WhatsApp lebih murah daripada kode SMS?

Tergantung negaranya. Meta menagih setiap pesan autentikasi yang terkirim sesuai tarif negara penerima, dengan tarif khusus di beberapa pasar, sedangkan harga SMS berbeda menurut operator dan rute. Bandingkan daftar tarif Meta dengan penyedia SMS Anda untuk negara-negara utama Anda sebelum beralih.

Apakah ini sama dengan PIN verifikasi dua langkah WhatsApp?

Tidak. Verifikasi dua langkah adalah PIN enam digit yang melindungi nomor WhatsApp bisnis itu sendiri. Template autentikasi mengirim kode kepada pelanggan Anda agar aplikasi atau situs Anda dapat memastikan siapa mereka.

Apakah pengguna harus memberi persetujuan (opt-in) untuk menerima kode?

Ya. Kebijakan Meta mewajibkan izin sebelum bisnis mengirim pesan kepada seseorang, dan panduan OTP-nya menyarankan pilihan saluran, misalnya WhatsApp, SMS, atau email. Memilih WhatsApp di layar login, di samping nomor, adalah izin tersebut.

Bisakah agensi mengirim kode untuk beberapa klien dari satu nomor?

Tidak. Praktik terbaik Meta mewajibkan setiap bisnis memiliki WhatsApp Business Account dan nomor telepon sendiri untuk template autentikasi. Berbagi satu nomor antarbisnis melanggar ketentuan dan kebijakan Meta. Hubungkan satu nomor untuk setiap klien sebagai gantinya.

Lanjut membaca

Siap memulai?

Konfigurasikan WhatsApp Coexistence dalam hitungan menit, bukan bulan. Aplikasi tetap berfungsi di ponsel.

Mulai uji coba gratis

Diverifikasi pada