Kanaalorchestratie
Bird decides the defaults. You tune a single call.
Channel availability, sender rules, and regulations differ by country, and getting them right is years of work. Bird ships that as a per-country base: which channels land where, which senders are allowed, and sane code defaults, drawn from running email and SMS at scale. A create call already resolves to the right plan for any country, and its options field can reorder or narrow the channels or set the code length for that one verification.
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;
Bird's defaults travel with every call.
Every verification on the Bird Verify API resolves against a per-country base Bird maintains from years of running email and SMS, so a verification already routes sensibly in every country before you write a line of code. A per-request option can still tune a single call: reorder or narrow the channels, or set the code length. You're never starting from a blank slate.
Two layers decide the plan.
The narrower one wins; whatever a request doesn't set falls through to Bird's per-country base.
- 01
Per-request opties.
Pass channels or code_length on the create call to reorder or narrow the channels, or set the code length, for that one verification. Omit either and the country's default applies.
- 02
Bird's basisconfiguratie per land.
Bird's own per-country defaults, drawn from running email and SMS at scale: which channels are available, which senders are allowed, and sane code and TTL defaults. Whatever a request doesn't override resolves from this, so a verification always lands on a sensible plan.
Wat een verificatie oplevert.
A Brazilian number resolves against Bird's per-country base for Brazil, narrowed by any per-request options on the call. WhatsApp and SMS are both available there, so the verification reports that ordered plan, with its typed vrf_ id.
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"
// }
Two ceilings sit above the defaults.
The two layers above decide defaults. Two gates decide what's allowed on top of that, and each one only narrows the resolved plan:
Per-country availability. A country's resolved plan only ever includes channels Bird actually offers there. A request's options can reorder or narrow that plan; they can't add a channel the country doesn't support, since availability is an intersection.
Global kill-switch. When a provider has an incident, Bird can pull a channel everywhere at once. The resolved plan simply falls back to the next channel, then restores automatically when the switch clears.
The plan is on every response.
Per verificatie opgelost, teruggegeven in de response.
- 01
Het opgeloste plan staat in de response.
Every verification reports the ordered channels it resolved to, so the resolved plan is never a mystery.
- 02
Automatische failover wordt uitgerold.
Bezorgingsgestuurde voortgang door het plan (het volgende kanaal proberen wanneer er een niet aankomt) wordt uitgerold zodra de bezorgingsstatus beschikbaar is. Het plan wordt vandaag al opgelost en teruggegeven.
De rest van het Verify-platform
Eén API, één set sleutels. Ontdek de overige mogelijkheden.
Per-country defaults you don't have to build yourself.
Per-country defaults are one capability of Bird Verify: the channels, the code, and the limits ship with it, on the same create and check calls.