Verify-logboek
Het Verify log, dat je vindt op de pagina Verifications onder Verify > Verifications, registreert elke verificatiesessie in je werkruimte. De nieuwste verificaties staan bovenaan. Hier controleer je of een verificatie is aangemaakt, volg je elke kanaalpoging en controle, en bekijk je de conversietijd en de kosten per poging. De gegenereerde eenmalige verificatiecode wordt nooit als platte tekst opgeslagen of in het dashboard getoond.
De verificatielijst
Elke rij is één verificatiesessie. De kolommen zijn:
| Kolom | Wat de kolom toont |
|---|---|
| Status | De huidige status van de sessie (Pending, Converted, Failed, Expired, Canceled of Blocked; zie Statussen) |
| Verification | De verificatie-ID (vrf_...) |
| Recipient | Het telefoonnummer of e-mailadres dat wordt geverifieerd |
| Channel | Het afleverkanaal van de laatste poging (Email, SMS, WhatsApp, Telegram of Voice) |
| Cost | Totaal in rekening gebracht bedrag over alle afleverpogingen in de sessie |
| Created | Wanneer de verificatie is aangemaakt |
De lijst toont 25 verificaties per pagina.
Zoeken en filteren
Boven een tijdlijn met het volume vind je een zoekveld voor ontvangers en drie filters. Je kunt filters combineren om de lijst te verfijnen:
- Search by phone number: zoek op een exact telefoonnummer van de ontvanger in E.164-notatie, zoals
+14155550100. - Status: filter op Pending, Converted (
verified), Failed of Expired. - Channel: filter op afleveringskanaal (
Email,SMS,WhatsApp,TelegramofVoice). - Date range: kies een vooraf ingestelde periode of selecteer een eigen periode in de kalender of de tijdlijnbalk.
Als er geen verificaties zijn die aan de actieve filters voldoen, klik je op Clear filters om de weergave te resetten.
Statussen
Een verificatie begint als Pending (pending) en gaat eenmalig over naar een eindstatus:
| Label in dashboard | API status | Betekenis |
|---|---|---|
| Pending | pending | De verificatie is actief en wacht op een controle met de juiste verificatiecode vóór expires_at |
| Converted | verified | Een controleaanroep leverde de juiste code aan voordat deze verliep |
| Failed | failed | De sessie heeft alle toegestane controlepogingen gebruikt (attempts_exhausted) of de bezorging is via elk kanaal mislukt |
| Expired | expired | De geldigheidsduur van de code is verstreken (ttl_elapsed) zonder geslaagde controle en zonder dat de pogingen op waren |
| Canceled | canceled | De sessie is geannuleerd voordat deze was afgerond |
| Blocked | blocked | De verificatie is geblokkeerd door een veiligheids- of beleidscontrole |
Zie Verificaties verzenden voor hoe statusovergangen en eindredenen samenhangen met opnieuw verzenden en terugvallen op een ander kanaal.
Een verificatie bekijken
Selecteer een rij om het detailvenster van de verificatie te openen. Daarin is de sessie verdeeld over drie secties:
Samenvatting
De kop met de samenvatting toont de uitkomst en de configuratie van de sessie:
- Outcome: bij een geconverteerde sessie de duur tot de conversie (
Converted in) en welke controlepoging overeenkwam (bijvoorbeeldCode matched on 1st check). Bij een mislukte sessie het aantal mislukte controles. - Code: het ingestelde aantal cijfers en de geldigheidsduur voor de sessie.
- Channels used: elk kanaal waarmee tijdens de sessie een bezorgpoging is gedaan.
- Metadata: alle sleutel-waardeparen die je in
metadatahebt meegegeven bij het aanmaken van de verificatie.
Tijdlijn van de levenscyclus
De tijdlijn toont elke stap van de sessie in volgorde, van aanmaak tot afronding:
- Channel attempts: elke verzending van een verificatiecode (
SMS,WhatsApp,Telegram,VoiceofEmail), de afzender, het afleverresultaat (sent,deliveredofundeliveredmet de foutreden), de verstreken afleveringstijd en de kosten per poging. Geplande fallbackkanalen die nog niet zijn ingezet, verschijnen als komende stappen zolang de sessie in behandeling is. - Code checks: elke
POST /v1/verify/verifications/check-aanroep en of de code overeenkwam. - Terminal state: het moment waarop de sessie haar eindstatus bereikte.
Kostenoverzicht
Als een sessie betaalde pogingen heeft, groepeert Cost breakdown de kosten per kanaal en afzenderklasse (Shared sender, Custom domain, Dedicated sender of Managed sender), samen met het sessietotaal Total in de valuta van je werkruimte.
De verificatielijst en de detailweergaven zijn alleen beschikbaar in het dashboard. Er is geen openbaar API-endpoint om ze op te vragen of uit te lezen. Wil je het aanmaken van verificaties, de aflevering per poging en conversies programmatisch volgen, gebruik dan het synchrone controleantwoord en abonneer je op Verify-events.
Volgende stappen
- Verify-events: ontvang webhookberichten voor
verify.verification.*- enverify.attempt.*-events. - Verificaties verzenden: stel de geldigheidsduur van de code, pogingslimieten, opnieuw verzenden en fallback over meerdere kanalen in.
- Verify-bestemmingen: schakel bestemmingslanden in en pas de volgorde van de fallbackkanalen aan.
Gerelateerde bronnen
Ga verder met de documentatie, handleidingen en voorbeelden voor dit onderwerp.