Ringkasan Verify

Bird Verify mengonfirmasi bahwa pengguna menguasai alamat email atau nomor telepon. Minta Bird mengirim kode verifikasi sekali pakai, kumpulkan kode tersebut di aplikasi Anda, lalu minta Bird memeriksa kecocokannya. Alur ini menggunakan dua panggilan API: POST /v1/verify/verifications mengirim kode, dan POST /v1/verify/verifications/check memeriksanya. Pengirim bersama Bird tidak memerlukan pendaftaran pengirim atau penyiapan template. Email, SMS, dan WhatsApp dapat menggunakan Bird Verify secara default, Authifly, atau pengirim milik workspace Anda; Telegram menggunakan akun notifikasi terverifikasinya sendiri. Pengirim dan branding membahas pilihan ini.

Anda membuat verifikasi dengan penerima: alamat email, nomor telepon, atau keduanya. Bird menghasilkan kode verifikasi numerik dan mengirimkannya melalui kanal penerima. Alamat email menerima kode lewat email; nomor telepon menerima lewat SMS atau WhatsApp, sesuai urutan dan ketersediaan yang ditetapkan konfigurasi negara Anda untuk negara tujuan. Pengguna mengetik kode tersebut di aplikasi Anda, lalu Anda mengirimkannya ke endpoint pemeriksaan, yang menjawab success: true atau false beserta alasannya.

Verifikasi menjalani siklus hidup singkat: dimulai dengan pending, dan berakhir verified (kode yang benar tiba tepat waktu), failed (terlalu banyak percobaan salah), atau expired (jendela waktu habis). Halaman Verifications menampilkan setiap verifikasi dan statusnya; setiap status dan alasan dibahas di Mengirim verifikasi.

Di dashboard, Verify adalah salah satu aplikasi workspace. Halaman-halamannya, dan di mana panduan masing-masing berada:

Halaman Verifications mencantumkan setiap verifikasi di workspace dan membuka detail penerima, rencana kanal, dan waktu masing-masing. Secara programatis, respons pemeriksaan memuat status verifikasi saat ini. Berlangganan event Verify untuk pembaruan pembuatan, pengiriman, dan verifikasi berhasil. Endpoint list dan read tersedia untuk dashboard tetapi tidak untuk API publik.

Verify mengirim kode melalui empat kanal. Kanal mana yang diterima penerima bergantung pada jenis penerima dan, untuk nomor telepon, konfigurasi negara Anda.

Untuk penerima telepon, WhatsApp dicoba lebih dulu dan SMS bertindak sebagai fallback di sebagian besar negara, meskipun beberapa negara mengutamakan SMS. Telegram berada setelah SMS dan sebelum email dalam urutan fallback platform. Anda dapat mengubah urutan atau menonaktifkan kanal per negara. Jika pengiriman gagal, pengiriman lanjut ke kanal berikutnya dalam rencana. Anda juga dapat memajukannya saat pengguna melaporkan bahwa kode tidak sampai; lihat Kirim kode di kanal lain. Pengirim dan branding menampilkan setiap pesan dan kontrol pengirim yang tersedia.

Workspace Anda dimulai dengan default platform Bird untuk kode itu sendiri (panjang, masa berlaku), batas percobaan pemeriksaan, dan jeda kirim ulang. Masing-masing dapat disesuaikan di dashboard pada Configure, dan panjang kode juga per permintaan; nilai dan rentangnya ada di Pengaturan verifikasi. Di atasnya terdapat pagar penyalahgunaan yang tidak perlu Anda konfigurasi: batas kirim dan periksa per penerima, tercantum di Pagar penyalahgunaan. Pesan kode sendiri secara default menggunakan bahasa nomor telepon penerima, salah satu dari 40 terjemahan bawaan, dan options.language menimpanya per permintaan. Lihat Bahasa pesan.