Afzenders en branding

Elke Verify-code bereikt je gebruiker als e-mail, SMS, WhatsApp of Telegram-bericht. Voor e-mail, SMS en WhatsApp kies je een door Bird beheerde identiteit, Bird Verify of Authifly, of gebruik je een afzender uit je eigen werkruimte. Telegram gebruikt een eigen geverifieerd notificatieaccount en heeft geen afzender om te selecteren.

De voorbeelden op deze pagina tonen de Engelstalige versies van de berichten van Bird. De e-mail, SMS en gedeelde WhatsApp-berichten van Bird worden in 40 vertalingen geleverd, per verificatie gekozen op basis van het telefoonnummer van de ontvanger of je options.language. Je eigen WhatsApp-template levert zijn eigen goedgekeurde talen en tekst. Zie Berichttaal.

De afzenders staan op het tabblad Channels van de Configure-pagina, één rij per kanaal:

Van wie je codes afkomstig zijn

E-mail, SMS en WhatsApp bieden deze afzenderkeuzes:

• Bird Verify is de standaard en vereist geen configuratie. Codes gaan uit onder de eigen identiteit van Bird.
• Authifly is het zelfstandige verificatiemerk van Bird. Codes gaan uit onder Authifly, zodat er geen platformleverancier zichtbaar is voor je gebruikers. Een ontvanger die het opzoekt vindt authifly.com, dat uitlegt dat Authifly eenmalige codes namens een bedrijf aflevert.
• Je eigen afzender is een geverifieerd verzenddomein voor e-mail, een bestaand Sender ID uit je werkruimte voor SMS, of een gekoppeld werkruimtenummer met een goedgekeurd authenticatietemplate voor WhatsApp. Zie Eigen e-mailafzender, Je SMS Sender ID en Je WhatsApp-nummer.

Selecteer een afzender per kanaal op het tabblad Channels. Je kunt ook een andere afzender kiezen voor één land in de landconfiguratie; de landkeuze wint van de kanaalstandaard voor ontvangers daar.

Het wisselen van identiteit wijzigt de afzender die je gebruiker ziet. De code, de geldigheidsduur en alle andere verificatie-instellingen blijven ongewijzigd.

De e-mail die je gebruiker ontvangt

Standaard komt de code-e-mail van Bird Verify <otp@verify.bird.com> met als onderwerp "Your verification code". Op Authifly komt hij van Authifly OTP <otp@verify.authifly.com>, met hetzelfde onderwerp.

De body is een enkele kaart: een bovenregel met de naam van de gedeelde identiteit, de code groot in monospace, de geldigheidsduur en een disclaimer. Elke identiteit heeft eigen kleuren. De platte-tekstversie bevat dezelfde inhoud:

Your verification code is 123456.

gevolgd door de geldigheidsduur met de waarschuwing de code nooit te delen, en een slotregel dat de e-mail veilig genegeerd kan worden als de code niet is aangevraagd.

De geldigheidsregel toont de geconfigureerde codelevensduur bij de eerste verzending en het resterende venster bij een hernieuwde verzending. Het onderwerp en de body worden gerenderd in de berichttaal van de verificatie. Arabisch en Hebreeuws worden van rechts naar links opgemaakt, met de code zelf van links naar rechts. OTP-e-mail bevat geen open- of kliktracking omdat er geen link in staat, en trackingpixels kunnen de afleverbaarheid van transactionele e-mail schaden.

Het SMS dat je gebruiker ontvangt

Het SMS begint met de code, waar een snelle blik (en de automatische code-invulling van het OS) als eerste kijkt:

123456 is your verification code. It expires in 10 minutes. Do not share it.

In landen die alfanumerieke Sender ID's met merknaam toestaan, komt de code van Bird Verify, Authifly of je geselecteerde Sender ID. Landen die een lokaal nummer of een shortcode vereisen, tonen die afzender in plaats daarvan. De berichttekst gebruikt het OTP-template van Bird in de berichttaal van de verificatie.

Het WhatsApp-bericht dat je gebruiker ontvangt

Met een gedeelde WhatsApp-afzender komt de code van een door Bird beheerd zakelijk nummer als authenticatietemplatebericht: standaard het Bird Verify-nummer, of het Authifly-nummer wanneer je die identiteit selecteert. WhatsApp bepaalt de layout van deze authenticatietemplates, dus de body begint met de code en biedt een Copy code-knop met één tik:

123456 is your verification code. For your security, do not share this code.

Bij de gedeelde templates van Bird is de code de enige variabele en volgt de tekst de berichttaal van de verificatie. Mongools is de enige vertaling die deze templates niet bevatten, dus die taal verstuurt Engels via een gedeelde afzender.

De twee identiteiten verschillen op één zichtbare manier. Onder Authifly bevat het bericht een tweede knop, een antwoord met de tekst "I didn't request a code", dat WhatsApp genereert voor authenticatietemplates. Het Bird Verify-template heeft één knop, de codecopy. WhatsApp beheert de extra knop volledig: een tik blijft binnen WhatsApp, bereikt geen webhook en laat de verificatie doorlopen. Er is geen API-aanroep om een afgewezen verificatie te annuleren; behandel het antwoord als signaal in je eigen fraudelogica.

Aflevering is een gewone WhatsApp-templateverzending, dus de ontvanger moet WhatsApp op dat nummer hebben; als dat niet zo is, of het bericht niet kan worden afgeleverd, gaat de verificatie verder naar het volgende kanaal.

Je SMS Sender ID

Om sms'jes te versturen met je eigen afzender, voeg je een Sender ID toe in dezelfde werkruimte en rond je eventuele registratie af die de bestemmingslanden vereisen. Ga naar Configure > Channels, open het SMS-afzendermenu, selecteer Your SMS Sender IDs en kies er een uit de lijst. Het menu linkt naar Manage Sender IDs als je er een moet toevoegen. Je kunt ook een Sender ID kiezen voor een enkel land op de Countries-pagina.

Een SMS Sender ID moet ondersteund en geregistreerd zijn voor het land van de ontvanger en toegestaan voor authenticatieberichten. Als je configuratiestandaard een van die controles niet doorstaat, probeert Verify het opnieuw met de Bird Verify-afzender voor die bestemming. Andere fouten, waaronder facturerings- of providerfouten, wisselen de afzender niet. Een Sender ID dat specifiek voor een land is geselecteerd krijgt deze afzenderfallback nooit; als het daar niet kan verzenden, probeert Verify het volgende kanaal in het verificatieplan.

Je WhatsApp-nummer

Om te verzenden vanaf je eigen WhatsApp-nummer, koppel je het nummer aan dezelfde werkruimte en zorg je voor een goedgekeurd authenticatietemplate in het WhatsApp Business Account. Ga naar Configure > Channels, open het WhatsApp-afzendermenu, selecteer Your WhatsApp numbers, kies vervolgens het nummer en een bestaand goedgekeurd authenticatietemplate. De nummer- en templatemenu's linken naar hun beheerpagina's. Je kunt ook een ander paar kiezen voor één land op de Countries-pagina.

Verify voegt de verificatiecode in het geselecteerde template in. De goedgekeurde talen en het taalbeleid van het template bepalen de tekst en welke verzoeken het kan versturen. Als het geen verzendbare taal heeft voor een verificatie, mislukt die WhatsApp-poging en probeert Verify het volgende kanaal. Verify maakt of dient nooit een template voor je in.

Als het template een Code expiration (minutes)-footer heeft, stem die dan af op Duration op de Configure-pagina van Verify. Verify verstuurt alleen de verificatiecode en werkt de footer van het template niet bij en controleert die ook niet. Een verschil kan ontvangers de verkeerde verlooptijd tonen. De footer ondersteunt 1–90 hele minuten; andere Verify-duren komen daar niet exact mee overeen.

Het Telegram-bericht dat je gebruiker ontvangt

Op Telegram komt de code van Telegrams eigen geverifieerde notificatieaccount. Telegram beheert het account, de berichtlayout en de tekst, dus het kanaal heeft geen afzender om te selecteren, en noch Bird noch je organisatie verschijnt als afzender:

123456 is your verification code.

Het telefoonnummer van de ontvanger moet bij Telegram geregistreerd zijn. Er wordt gecontroleerd of een nummer een Telegram-bericht kan ontvangen voordat er een wordt verstuurd; als dat niet zo is, gaat de verificatie verder naar het volgende kanaal zonder dat er een bericht wordt verzonden.

Eigen e-mailafzender

Je kunt de gedeelde e-mailafzender vervangen door een adres op je eigen domein, zodat codes aankomen van verify@yourdomain.com in plaats van een door Bird beheerd adres. De voorwaarde is een geverifieerd verzenddomein in dezelfde werkruimte: Verify verstuurt niet vanaf een domein waarvan je niet hebt bewezen dat het van jou is.

Open op het tabblad Channels de afzenderinstelling van de e-mailrij, selecteer Custom sender, kies een lokaal deel (het deel vóór de @) en een van je geverifieerde domeinen, en sla op. Door Bird Verify (default) of Authifly te selecteren schakel je op elk moment terug naar een gedeelde identiteit. Je kunt ook een andere afzender vastpinnen voor één land in de landconfiguratie; een keuze per land wint van deze standaard voor ontvangers daar.

Twee dingen om te weten voordat je overschakelt:

• De body noemt geen identiteit meer. De body van een gedeelde identiteit vertelt de lezer dat Bird Verify of Authifly nooit om de code zal vragen. Versturen vanaf je eigen domein laat die naam weg in plaats van hem te vervangen, omdat je ontvangers geen relatie hebben met beide: de bovenregel toont "Verification" en de waarschuwing wordt "Don't share it with anyone." Het onderwerp en de code-layout blijven ongewijzigd, de tekst wordt nog steeds weergegeven in de berichttaal van de verificatie, en je kunt het template niet aanpassen.
• Het domein moet geverifieerd blijven. Een domein dat een actieve configuratie vastpint kan niet worden verwijderd, maar een domein waarvan de DNS terugvalt kan niet meer verzenden. Verzendingen vanaf dat domein mislukken dan, en de bezorging gaat verder naar het volgende kanaal van de verificatie in plaats van stilzwijgend terug te vallen op een gedeelde identiteit. Herstel het domein, of schakel het kanaal terug naar een gedeelde identiteit.

Volgende stappen