Log Verify

Verify log, yang ditampilkan di halaman Verifications pada Verify > Verifications, adalah catatan workspace Anda untuk setiap sesi verifikasi. Verifikasi terbaru muncul paling atas. Gunakan log ini untuk memastikan verifikasi telah dibuat, mengikuti setiap upaya pengiriman dan pemeriksaan per saluran, serta memeriksa waktu konversi dan biaya per upaya. Kode verifikasi sekali pakai yang dibuat tidak pernah disimpan sebagai teks biasa atau ditampilkan di dasbor.

Halaman Verifications yang mencantumkan verifikasi dengan kolom status, ID verifikasi, penerima, saluran, biaya, dan waktu pembuatan

Daftar verifikasi

Setiap baris mewakili satu sesi verifikasi. Kolomnya adalah:

Kolom	Yang ditampilkan
Status	Status sesi saat ini (Pending, Converted, Failed, Expired, Canceled, atau Blocked; lihat Status)
Verification	ID verifikasi (`vrf_...`)
Recipient	Nomor telepon atau alamat email yang diverifikasi
Channel	Kanal pengiriman yang digunakan untuk percobaan terakhir (`Email`, `SMS`, `WhatsApp`, `Telegram`, atau `Voice`)
Cost	Total biaya yang dikenakan untuk semua percobaan pengiriman dalam sesi
Created	Waktu verifikasi dibuat

Daftar ini menampilkan 25 verifikasi per halaman.

Mencari dan memfilter

Halaman ini menyediakan pencarian penerima dan tiga filter di atas linimasa volume. Anda dapat menggabungkan filter untuk mempersempit daftar:

Search by phone number: Cocokkan nomor telepon penerima yang persis sama dalam format E.164, misalnya +14155550100.
Status: Saring menurut Pending, Converted (verified), Failed, atau Expired.
Channel: Saring menurut saluran pengiriman (Email, SMS, WhatsApp, Telegram, atau Voice).
Date range: Pilih rentang waktu prasetel atau tentukan rentang kustom dari kalender atau strip linimasa.

Jika tidak ada verifikasi yang cocok dengan filter aktif, gunakan Clear filters untuk mengatur ulang tampilan.

Status

Verifikasi dimulai dengan status Pending (pending) dan berakhir satu kali pada status akhir:

Label dasbor	API `status`	Arti
Pending	`pending`	Verifikasi aktif dan menunggu pemeriksaan kode verifikasi yang cocok sebelum `expires_at`
Converted	`verified`	Panggilan pemeriksaan memberikan kode yang cocok sebelum kedaluwarsa
Failed	`failed`	Sesi telah menghabiskan jatah upaya pemeriksaan (`attempts_exhausted`) atau pengiriman gagal di semua channel
Expired	`expired`	Masa berlaku kode telah habis (`ttl_elapsed`) tanpa pemeriksaan yang berhasil dan tanpa habisnya jatah upaya
Canceled	`canceled`	Sesi dibatalkan sebelum selesai
Blocked	`blocked`	Verifikasi diblokir oleh pemeriksaan keamanan atau kebijakan

Untuk mengetahui bagaimana transisi status dan alasan status akhir berinteraksi dengan pengiriman ulang dan fallback saluran, lihat Mengirim verifikasi.

Memeriksa verifikasi

Pilih baris mana pun untuk membuka lembar detail verifikasi. Lembar ini membagi sesi ke dalam tiga bagian:

Ringkasan

Header ringkasan mencatat hasil dan konfigurasi sesi:

Outcome: Untuk sesi yang berhasil dikonversi, durasi konversi (Converted in) dan percobaan pemeriksaan ke berapa yang cocok (misalnya, Code matched on 1st check). Untuk sesi yang gagal, jumlah pemeriksaan yang gagal.
Code: Panjang digit dan jangka waktu kedaluwarsa yang dikonfigurasi untuk sesi tersebut.
Channels used: Setiap saluran yang mencoba melakukan pengiriman selama sesi berlangsung.
Metadata: Pasangan kunci-nilai apa pun yang Anda teruskan di metadata saat membuat verifikasi.

Linimasa siklus hidup

Linimasa mengurutkan setiap langkah dalam sesi, mulai dari pembuatan hingga penyelesaian:

Channel attempts: Setiap pengiriman kode verifikasi (SMS, WhatsApp, Telegram, Voice, atau Email), pengirimnya, hasil pengirimannya (sent, delivered, atau undelivered beserta alasan kesalahannya), waktu pengiriman yang berlalu, dan biaya per percobaan. Kanal cadangan terencana yang belum dijalankan muncul sebagai langkah mendatang selama sesi masih tertunda.
Code checks: Setiap panggilan POST /v1/verify/verifications/check dan apakah kodenya cocok.
Terminal state: Waktu sesi mencapai status akhirnya.

Rincian biaya

Jika sesi memiliki percobaan yang dikenai biaya, Cost breakdown mengelompokkan biaya menurut kanal dan kelas pengirim (Shared sender, Custom domain, Dedicated sender, atau Managed sender) bersama Total sesi dalam mata uang workspace Anda.

Daftar verifikasi dan tampilan detailnya hanya tersedia di dasbor, dan tidak ada endpoint API publik untuk menampilkan daftar atau membacanya. Untuk melacak pembuatan verifikasi, pengiriman per percobaan, dan konversi secara terprogram, gunakan respons pemeriksaan sinkron dan berlanggananlah ke peristiwa Verify.

Langkah berikutnya

Peristiwa Verify: terima pengiriman webhook untuk peristiwa verify.verification.* dan verify.attempt.*.
Mengirim verifikasi: konfigurasikan masa berlaku kode, batas percobaan, pengiriman ulang, dan kanal cadangan multikanal.
Tujuan Verify: aktifkan negara tujuan dan sesuaikan urutan fallback channel.

Lanjutkan dengan dokumentasi, panduan, dan contoh untuk topik ini.

Coba praktiknya dan dapatkan ringkasan implementasi

Sumber daya terkait