Kanaalorchestratie
Bird bepaalt de standaardinstellingen. U stemt één enkele aanroep af.
Kanaalbeschikbaarheid, afzenderregels en regelgeving verschillen per land, en dat goed krijgen kost jaren werk. Bird levert dat als een basis per land: welke kanalen waar werken, welke afzenders zijn toegestaan, en verstandige standaard coderegels — afgeleid van het op schaal verwerken van e-mail en SMS. Een create-aanroep leidt al tot het juiste plan voor elk land, en het options-veld kan de kanalen herschikken of beperken, of de codelengte instellen voor die ene verificatie.
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;
Je account
Bevestig dat jij het bent.
Voer de code in die is verzonden naar
+1 ••• ••• 4567Voorbeeld van een verificatiecode
Dagelijks vertrouwd door teams die wereldklasse software bouwen
Lees meer klantverhalenDe standaardinstellingen van Bird reizen mee met elke aanroep.
Elke verificatie op de Bird Verify API wordt afgestemd op een basis per land die Bird onderhoudt op basis van jarenlange ervaring met e-mail en SMS, zodat een verificatie al in elk land correct wordt gerouteerd voordat u één regel code schrijft. Een optie per verzoek kan nog steeds één aanroep afstemmen: de kanalen herschikken of beperken, of de codelengte instellen. U begint nooit vanaf nul.
Twee lagen bepalen het plan.
De meest specifieke wint; alles wat een verzoek niet instelt, valt terug op de basis per land van Bird.
- 01
Per-request opties.
Geef channels of code_length mee bij de create-aanroep om de kanalen te herschikken of te beperken, of de codelengte in te stellen voor die ene verificatie. Laat een van beide weg en de standaardinstelling van het land wordt toegepast.
- 02
Bird's basisconfiguratie per land.
De eigen standaardinstellingen per land van Bird, afgeleid van het op schaal verwerken van e-mail en SMS: welke kanalen beschikbaar zijn, welke afzenders zijn toegestaan, en verstandige standaardwaarden voor code en TTL. Alles wat een verzoek niet overschrijft, wordt hieruit opgelost, zodat een verificatie altijd op een verstandig plan uitkomt.
Wat een verificatie oplevert.
Een Braziliaans nummer wordt afgestemd op de basis per land van Bird voor Brazilië, beperkt door eventuele opties per verzoek bij de aanroep. WhatsApp en SMS zijn daar beide beschikbaar, dus de verificatie rapporteert dat geordende plan, met het getypeerde 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"
// }
Twee plafonds boven de standaardinstellingen.
De twee bovenstaande lagen bepalen standaardinstellingen. Twee poorten bepalen wat daarbovenop is toegestaan, en elke poort beperkt alleen het opgeloste plan:
Beschikbaarheid per land. Het opgeloste plan van een land bevat alleen kanalen die Bird daar daadwerkelijk aanbiedt. De opties van een verzoek kunnen dat plan herschikken of beperken; ze kunnen geen kanaal toevoegen dat het land niet ondersteunt, aangezien beschikbaarheid een intersectie is.
Globale noodschakelaar. Wanneer een provider een incident heeft, kan Bird een kanaal overal tegelijk uitschakelen. Het opgeloste plan valt simpelweg terug op het volgende kanaal en herstelt automatisch wanneer de schakelaar wordt opgeheven.
Het plan staat in elk antwoord.
Per verificatie opgelost, teruggegeven in de response.
- 01
Het opgeloste plan staat in de response.
Elke verificatie rapporteert de geordende kanalen waarnaar het is opgelost, zodat het opgeloste plan nooit een mysterie is.
- 02
Automatische failover doorloopt het plan voor u.
Een kanaal dat faalt, stuurt de verificatie door naar het volgende kanaal in het plan, en een afleveringstimer per poging doet hetzelfde wanneer er helemaal geen bezorgstatus binnenkomt. Elke code in de sessie blijft geldig, zodat de ontvanger het bericht kan gebruiken dat hem of haar als eerste bereikt. U kunt een verificatie ook op verzoek doorzetten met een next-channel call.
Breng het in de praktijk.
Ga verder met de documentatie, gidsen en voorbeelden voor dit onderwerp. De bronnen zijn in het Engels.
De rest van het Verify-platform
Eén API, één set sleutels. Ontdek de overige mogelijkheden.
Standaardinstellingen per land die u niet zelf hoeft te bouwen.
Standaardinstellingen per land zijn één mogelijkheid van Bird Verify: de kanalen, de code en de limieten worden meegeleverd, via dezelfde create- en check-aanroepen.