Kanaalorchestratie
In previewBegin met onze standaardinstellingen. Overschrijf alleen wat u nodig hebt.
Kanaalbeschikbaarheid, afzenderregels en regelgeving verschillen per land, en het juist configureren ervan kost jaren werk. Bird levert dat als een basisconfiguratie per land: welke kanalen waar werken, welke afzenders zijn toegestaan en verstandige standaard code-instellingen. Uw instellingen komen daar bovenop. U wijzigt één ding voor één land; alles wat u niet aanraakt valt door naar de laag eronder. Dat is routing per land als eersteklas API-resource — de controle die de meeste verificatie-API's u niet bieden.
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();U erft Bird's standaardinstellingen en bouwt daarop voort.
Elke verificatie via de Bird Verify API bepaalt zijn instellingen via een cascade. Onderaan staat een basisconfiguratie per land die Bird onderhoudt op basis van jarenlange ervaring met e-mail en SMS — dus voordat u iets configureert, wordt een verificatie al correct gerouteerd in elk land. Uw configuratie en per-land overschrijvingen komen daar bovenop, en een per-request optie kan een enkele aanroep afstemmen. U begint nooit vanaf nul en u beheert alleen de beslissingen die u daadwerkelijk wilt nemen.
De waardecascade.
De hoogste laag die een waarde instelt wint; alles wat u niet instelt valt door naar de laag eronder.
- 01
Per-request opties.
Velden op de create-aanroep (codelengte, kanaalvoorkeur, taal) winnen voor die ene verificatie. De lichtste, meest lokale overschrijving.
- 02
Uw per-land overschrijvingen.
Wijzig de kanaalvolgorde of een afzender voor één land. Een overschrijving wordt samengevoegd: het raakt de velden die u instelt, en de rest van dat land erft nog steeds van onderaf.
- 03
Uw configuratiestandaarden.
Uw app-brede plan- en coderegels — de kanaalvolgorde, codelengte, TTL en pogingen die u overal wilt waar u geen landoverschrijving hebt ingesteld.
- 04
Bird's basisconfiguratie per land.
De onderste laag: Bird's eigen standaardinstellingen per land, gebaseerd op het verzenden van e-mail en SMS op schaal. Alles wat u niet instelt valt hiernaar door, zodat een verificatie altijd een verstandig plan oplevert.
Overschrijf een land, erf de rest.
Stel uw plan één keer in en pas alleen de landen aan die iets anders nodig hebben. Hier begint Brazilië met WhatsApp, daarna SMS; elk ander land valt door naar uw standaardinstellingen en Bird's basisconfiguratie.
// 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();Wat een verificatie oplevert.
Een Braziliaans nummer onder deze configuratie wordt via de cascade opgelost. De BR-overschrijving stelt WhatsApp eerst in, dan SMS, beide zijn beschikbaar, en de verificatie rapporteert het geordende plan dat het zal gebruiken, met zijn getypeerde vrf_-id.
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"
// }Twee plafonds boven de cascade.
De cascade bepaalt standaardinstellingen. Twee poorten bepalen wat is toegestaan — ze begrenzen het opgeloste plan in plaats van waarden te leveren die doorvallen:
Beschikbaarheid per land. U kunt alleen kanalen inschakelen die Bird daadwerkelijk in een land aanbiedt. Een kanaal inschakelen dat we daar niet ondersteunen is een no-op, geen stille fout — beschikbaarheid is een doorsnede, nooit een overschrijving.
Globale noodschakelaar. Wanneer een provider een incident heeft, kan Bird een kanaal overal tegelijk uitschakelen. Uw configuratie wordt niet aangepast; het opgeloste plan valt simpelweg terug naar het volgende kanaal en herstelt wanneer de schakelaar wordt opgeheven.
Routing die u instelt, geen ticket dat u indient.
Per verificatie opgelost, teruggegeven in de response.
- 01
Routes per land, op basis van het nummer.
Het land wordt afgeleid van het E.164-nummer van de ontvanger — u geeft het niet door. Stel een route in voor een land en het overschrijft de volgorde en afzenders daar.
- 02
Kanalen in- en uitschakelen.
Elk kanaal heeft een in-/uitschakelstatus, zodat u er een kunt uitschakelen voor een land zonder de positie in het plan te verliezen.
- 03
Het opgeloste plan staat in de response.
Elke verificatie rapporteert de geordende kanalen waarnaar het is opgelost, zodat wat de cascade besliste nooit een raadsel is.
- 04
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.
Veelgestelde vragen over kanaalorchestratie
Wat is de configuratiecascade?+
Wat biedt Bird's landspecifieke basis mij?+
Vervangt een landspecifieke overschrijving het hele plan?+
Kan ik een kanaal inschakelen dat Bird niet aanbiedt in een land?+
Hoe wordt het land bepaald?+
Van wie zien mijn gebruikers de code?+
De rest van het Verify-platform
Eén API, één set sleutels. Ontdek de overige mogelijkheden.
De landspecifieke controle die geen enkele andere verificatie-API u biedt.
Orchestratie is één mogelijkheid van Bird Verify: de kanalen, de code en de limieten worden meegeleverd, op dezelfde twee endpoints.