Orkestrasi kanal
Dalam pratinjauMulai dari default kami. Timpa hanya yang Anda butuhkan.
Ketersediaan kanal, aturan pengirim, dan regulasi berbeda di setiap negara, dan menyesuaikannya butuh bertahun-tahun. Bird menyediakan itu sebagai konfigurasi dasar per negara: kanal mana yang tersedia di mana, pengirim mana yang diizinkan, dan default kode yang masuk akal. Pengaturan Anda diterapkan di atasnya. Anda mengubah satu hal untuk satu negara; semua yang tidak Anda sentuh diteruskan ke lapisan di bawahnya. Itulah routing per negara sebagai resource API kelas utama, kontrol yang kebanyakan API verifikasi tidak berikan.
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 } = await bird.verify.verifications.check({
to: { phone_number: "+15551234567" },
code: userInput,
}).safe();Anda mewarisi default Bird, lalu membangun di atasnya.
Setiap verifikasi di Bird Verify API menentukan pengaturannya melalui kaskade. Di bagian paling bawah adalah basis per negara yang dikelola Bird dari pengalaman bertahun-tahun menjalankan email dan SMS — jadi sebelum Anda mengonfigurasi apa pun, verifikasi sudah diarahkan secara tepat di setiap negara. Konfigurasi dan override per negara Anda diterapkan di atasnya, dan opsi per permintaan dapat menyesuaikan satu panggilan tertentu. Anda tidak pernah memulai dari nol, dan Anda hanya mengelola keputusan yang benar-benar ingin Anda buat.
Kaskade nilai.
Tingkat tertinggi yang menetapkan nilai akan menang; apa pun yang tidak Anda atur akan diteruskan ke tingkat di bawahnya.
- 01
Opsi per permintaan.
Field pada panggilan create (panjang kode, preferensi kanal, locale) berlaku untuk satu verifikasi itu. Override paling ringan dan paling lokal.
- 02
Override per negara Anda.
Ubah urutan kanal atau pengirim untuk satu negara. Override digabungkan: hanya menyentuh field yang Anda atur, dan sisanya untuk negara tersebut tetap diwarisi dari bawah.
- 03
Default konfigurasi Anda.
Rencana dan aturan kode seluruh aplikasi Anda — urutan kanal, panjang kode, TTL, dan percobaan yang Anda inginkan di mana pun Anda belum menetapkan override negara.
- 04
Basis per negara Bird.
Lapisan paling bawah: default per negara milik Bird sendiri, diambil dari pengalaman menjalankan email dan SMS dalam skala besar. Apa pun yang tidak Anda atur akan diteruskan ke sini, sehingga verifikasi selalu menghasilkan rencana yang masuk akal.
Timpa satu negara, warisi sisanya.
Tetapkan rencana Anda sekali, lalu sentuh hanya negara yang membutuhkan sesuatu berbeda. Di sini Brasil mengutamakan WhatsApp, lalu SMS; setiap negara lain tetap diteruskan ke default Anda dan basis Bird.
// Your app-wide default plan.
await bird.verify.verifications.configurations.update("vfc_login", {
channels: [
{ channel: "email", state: "enabled" },
{ channel: "sms", state: "enabled" },
],
}).safe();
// Override one country; the rest inherits.
await bird.verify.verifications.configurations.countries.upsert("vfc_login", "BR", {
channels: [
{ channel: "whatsapp", state: "enabled" },
{ channel: "sms", state: "enabled" },
],
}).safe();Hasil resolusi verifikasi.
Nomor Brasil dengan konfigurasi ini diselesaikan melalui kaskade. Override BR mengurutkan WhatsApp lalu SMS, keduanya tersedia, dan verifikasi melaporkan rencana terurut yang akan digunakan, dengan id vrf_ bertipe.
const { data } = await bird.verify.verifications.create({
configuration_id: "vfc_login",
to: { phone_number: "+5511998765432" }, // Brazil
}).safe();
// Resolved through the cascade + availability/kill-switch ceilings:
// {
// id: "vrf_01k2m9q8e7fh3v0b7m4d2a9xzt",
// status: "pending",
// channels: [{ channel: "whatsapp" }, { channel: "sms" }],
// last_channel: "whatsapp"
// }Dua batas berada di atas kaskade.
Kaskade menentukan default. Dua gerbang menentukan apa yang diizinkan — mereka membatasi rencana yang dihasilkan, bukan menyediakan nilai yang diteruskan ke bawah:
Ketersediaan per negara. Anda hanya bisa mengaktifkan kanal yang benar-benar ditawarkan Bird di suatu negara. Mengaktifkan kanal yang tidak kami dukung di sana adalah no-op, bukan kegagalan diam — ketersediaan adalah irisan, bukan override.
Kill-switch global. Saat penyedia mengalami insiden, Bird dapat menarik kanal di mana pun sekaligus. Konfigurasi Anda tidak diubah; rencana yang dihasilkan cukup beralih ke kanal berikutnya, lalu dipulihkan saat switch dibersihkan.
Routing yang Anda atur, bukan tiket yang Anda ajukan.
Diselesaikan per verifikasi, dikembalikan dalam respons.
- 01
Rute per negara, berdasarkan nomor.
Negara diturunkan dari nomor E.164 penerima — Anda tidak perlu mengirimkannya. Tetapkan rute untuk suatu negara dan itu akan menimpa urutan dan pengirim di sana.
- 02
Aktifkan dan nonaktifkan kanal.
Setiap kanal memiliki status aktif/nonaktif, sehingga Anda dapat menonaktifkan satu kanal untuk suatu negara tanpa kehilangan posisinya dalam rencana.
- 03
Rencana yang dihasilkan ada di respons.
Setiap verifikasi melaporkan kanal terurut yang dihasilkan, sehingga keputusan kaskade tidak pernah menjadi misteri.
- 04
Failover otomatis sedang diluncurkan.
Pengalihan berbasis pengiriman melalui rencana (mencoba kanal berikutnya saat satu tidak terkirim) sedang diluncurkan seiring status pengiriman tersedia. Rencana sudah diselesaikan dan dikembalikan hari ini.
FAQ orkestrasi kanal
Apa itu kaskade konfigurasi?+
Apa yang diberikan basis per-negara Bird kepada saya?+
Apakah override per-negara menggantikan seluruh rencana?+
Bisakah saya mengaktifkan channel yang tidak ditawarkan Bird di suatu negara?+
Bagaimana negara ditentukan?+
Dari siapa pengguna saya melihat kode tersebut?+
Platform Verify lainnya
Satu API, satu set kunci. Jelajahi kemampuan lainnya.
Kontrol per-negara yang tidak diberikan API verifikasi lain kepada Anda.
Orkestrasi adalah salah satu kemampuan Bird Verify: channel, kode, dan limit disertakan di dalamnya, pada dua endpoint yang sama.