Overzicht van Verify

Bird Verify bevestigt dat een gebruiker een e-mailadres of telefoonnummer beheert. Vraag Bird om een eenmalige verificatiecode te versturen, vang deze op in je app en vraag Bird of de code klopt. De flow gebruikt twee API-calls: POST /v1/verify/verifications verstuurt de code en POST /v1/verify/verifications/check controleert hem. De gedeelde afzenders van Bird vereisen geen afzenderregistratie of templateconfiguratie. E-mail, SMS en WhatsApp kunnen standaard Bird Verify, Authifly of een afzender van je werkruimte gebruiken; Telegram gebruikt zijn eigen geverifieerde notificatie-account. Afzenders en branding behandelt de keuze.

Je maakt een verificatie aan met een ontvanger: een e-mailadres, een telefoonnummer, of beide. Bird genereert een numerieke verificatiecode en bezorgt deze via de kanalen van de ontvanger. Een e-mailadres ontvangt de code per e-mail; een telefoonnummer ontvangt hem via SMS of WhatsApp, in de volgorde en beschikbaarheid die je landconfiguratie voor het bestemmingsland instelt. De gebruiker typt de code in je app, en je stuurt hem naar het check-endpoint, dat success: true of false antwoordt met een reden.

Een verificatie doorloopt een kleine levenscyclus: ze begint pending en eindigt verified (een correcte code kwam op tijd binnen), failed (te veel foute pogingen) of expired (het tijdvenster verstreek). De pagina Verifications toont elke verificatie en de status ervan; elke status en reden wordt behandeld in Verificaties verzenden.

In het dashboard is Verify een van de apps van de werkruimte. De pagina's, en waar de bijbehorende gids staat:

De pagina Verifications toont elke verificatie in de werkruimte en opent de ontvanger, het kanaalplan en de timingdetails ervan. Programmatisch bevat het check-antwoord de huidige status van de verificatie. Abonneer je op Verify-events voor updates over aanmaak, bezorging en geslaagde verificatie. Lijst- en lees-endpoints zijn beschikbaar voor het dashboard, maar niet voor de publieke API.

Verify bezorgt codes via vier kanalen. Welk kanaal een ontvanger krijgt, hangt af van het ontvangertype en, bij telefoonnummers, je landconfiguratie.

Bij een telefonontvanger wordt WhatsApp eerst geprobeerd en fungeert SMS in de meeste landen als fallback, hoewel sommige landen standaard SMS eerst gebruiken. Telegram staat na SMS en vóór e-mail in de fallbackvolgorde van het platform. Je kunt de volgorde aanpassen of een kanaal per land uitschakelen. Als een verzending mislukt, gaat de bezorging door naar het volgende kanaal in het plan. Je kunt ook handmatig doorschakelen wanneer een gebruiker meldt dat de code niet is aangekomen; zie De code via een ander kanaal verzenden. Afzenders en branding toont elk bericht en de beschikbare afzenderinstellingen.

Je werkruimte begint met de platformstandaarden van Bird voor de code zelf (lengte, levensduur), de limiet op controlepogingen en de herverzendings-cooldown. Elk is aanpasbaar in het dashboard onder Configure, en codelengte ook per verzoek; de waarden en bereiken staan in Verificatie-instellingen. Daarbovenop zitten misbruikbeveiligingen die je niet configureert: verzend- en controlelimiet per ontvanger, vermeld in Misbruikbeveiligingen. Het codebericht gebruikt standaard de taal van het telefoonnummer van de ontvanger, een van 40 ingebouwde vertalingen, en options.language overschrijft dit per verzoek. Zie Berichttaal.