Orkestrasi kanal
Bird menentukan default-nya. Anda menyesuaikan satu panggilan.
Ketersediaan channel, aturan pengirim, dan regulasi berbeda di setiap negara, dan menanganinya dengan benar membutuhkan bertahun-tahun kerja. Bird menyediakannya sebagai basis per negara: channel mana yang tersedia di mana, pengirim mana yang diizinkan, dan default kode yang masuk akal, diambil dari pengalaman menjalankan email dan SMS dalam skala besar. Panggilan create sudah otomatis menentukan rencana yang tepat untuk negara mana pun, dan field options-nya dapat mengurutkan ulang atau mempersempit channel atau mengatur panjang kode untuk verifikasi tersebut.
import { BirdClient } from "@messagebird/sdk";
const bird = new BirdClient({
apiKey: process.env.BIRD_API_KEY!,
});
// Send the code, then check it by recipient.
await bird.verify.verifications.create({
to: { phone_number: "+15551234567" },
}).safe();
const { data, error } = await bird.verify.verifications.check({
to: { phone_number: "+15551234567" },
code: userInput,
}).safe();
if (error) throw error;
Akun Anda
Konfirmasi identitas Anda.
Masukkan kode yang dikirim ke
+1 ••• ••• 4567Contoh kode verifikasi
Dipercaya setiap hari oleh tim yang membangun perangkat lunak kelas dunia
Baca lebih banyak kisah pelangganDefault Bird menyertai setiap panggilan.
Setiap verifikasi di Bird Verify API diselesaikan berdasarkan basis per negara yang dikelola Bird dari pengalaman bertahun-tahun menjalankan email dan SMS, sehingga verifikasi sudah ter-routing dengan tepat di setiap negara sebelum Anda menulis satu baris kode pun. Opsi per-permintaan tetap dapat menyesuaikan satu panggilan: mengurutkan ulang atau mempersempit channel, atau mengatur panjang kode. Anda tidak pernah memulai dari nol.
Dua lapisan menentukan rencana.
Yang lebih spesifik menang; apa pun yang tidak diatur oleh permintaan akan mengacu ke basis per negara dari Bird.
- 01
Opsi per permintaan.
Kirimkan channels atau code_length pada panggilan create untuk mengurutkan ulang atau mempersempit channel, atau mengatur panjang kode, untuk verifikasi tersebut. Abaikan salah satunya dan default negara yang berlaku.
- 02
Basis per negara Bird.
Default per negara milik Bird, diambil dari pengalaman menjalankan email dan SMS dalam skala besar: channel mana yang tersedia, pengirim mana yang diizinkan, serta default kode dan TTL yang masuk akal. Apa pun yang tidak di-override oleh permintaan akan diselesaikan dari sini, sehingga verifikasi selalu mendapatkan rencana yang tepat.
Hasil resolusi verifikasi.
Nomor Brasil diselesaikan berdasarkan basis per negara Bird untuk Brasil, dipersempit oleh opsi per-permintaan pada panggilan tersebut. WhatsApp dan SMS keduanya tersedia di sana, sehingga verifikasi melaporkan rencana terurut tersebut, dengan id vrf_ yang memiliki tipe.
const { data, error } = await bird.verify.verifications.create({
to: { phone_number: "+5511998765432" }, // Brazil
}).safe();
if (error) throw error;
// Resolved from the per-country base, capped by availability and the kill-switch:
// {
// id: "vrf_01k2m9q8e7fh3v0b7m4d2a9xzt",
// status: "pending",
// channels: [{ channel: "whatsapp" }, { channel: "sms" }],
// last_channel: "whatsapp"
// }
Dua batas berada di atas default.
Dua lapisan di atas menentukan default. Dua gerbang menentukan apa yang diizinkan di atasnya, dan masing-masing hanya mempersempit rencana yang telah diselesaikan:
Ketersediaan per negara. Rencana yang diselesaikan untuk suatu negara hanya mencakup channel yang benar-benar ditawarkan Bird di sana. Opsi permintaan dapat mengurutkan ulang atau mempersempit rencana tersebut; tidak bisa menambahkan channel yang tidak didukung negara tersebut, karena ketersediaan adalah irisan.
Kill-switch global. Saat penyedia mengalami insiden, Bird dapat menarik channel di mana saja sekaligus. Rencana yang diselesaikan cukup beralih ke channel berikutnya, lalu pulih otomatis saat switch dibersihkan.
Rencana ada di setiap respons.
Diselesaikan per verifikasi, dikembalikan dalam respons.
- 01
Rencana yang dihasilkan ada di respons.
Setiap verifikasi melaporkan channel terurut yang telah diselesaikan, sehingga rencana yang dihasilkan tidak pernah menjadi misteri.
- 02
Failover otomatis menjalankan rencana untuk Anda.
Channel yang gagal akan meneruskan verifikasi ke channel berikutnya dalam rencana, dan timer pengiriman per percobaan akan meneruskannya jika tidak ada status pengiriman yang diterima sama sekali. Setiap kode dalam sesi tetap valid, sehingga penerima dapat menggunakan pesan mana pun yang sampai kepada mereka. Anda juga dapat meneruskan verifikasi sesuai permintaan dengan panggilan next-channel.
Terapkan dalam praktik.
Lanjutkan dengan dokumentasi, panduan, dan contoh untuk topik ini. Sumber daya tersedia dalam bahasa Inggris.
Platform Verify lainnya
Satu API, satu set kunci. Jelajahi kemampuan lainnya.
Default per negara yang tidak perlu Anda bangun sendiri.
Default per negara adalah salah satu kapabilitas Bird Verify: channel, kode, dan batasannya sudah tersedia, pada panggilan create dan check yang sama.