Destinations Verify

Lorsque vous vérifiez un numéro de téléphone, le pays de destination détermine comment le code est acheminé : quels canaux sont disponibles, lequel est essayé en premier, si la vérification est autorisée, et quelle langue le message utilise par défaut. La page Destinations vous permet de gérer tout cela, une ligne par pays. Les destinataires uniquement par e-mail ne sont pas concernés : une adresse e-mail n'a pas de pays, donc la configuration par pays s'applique aux vérifications dont le destinataire inclut un numéro de téléphone.

Par défaut, chaque pays est activé avec le routage plateforme de Bird. Utilisez cette page pour désactiver les pays que vous ne desservez pas, réordonner les canaux ou associer un expéditeur par pays. Désactiver les destinations inutilisées réduit aussi l'exposition au SMS pumping.

La page Destinations

Les pays sont regroupés par région, avec une carte et un récapitulatif du nombre de pays activés dans chaque région. Chaque ligne affiche le pays, son ordre de canaux effectif, l'expéditeur utilisé par chaque canal et un bouton d'activation/désactivation. Filtrez par statut, région ou canal, ou recherchez par nom de pays. Un pays désactivé affiche ses canaux sélectionnés en grisé, pour que vous voyiez ce que son activation utilisera.

Le bouton active ou désactive le pays entier. Si un destinataire inclut un numéro de téléphone dans un pays désactivé, la vérification ne résout aucun canal et la création échoue avec 422. Une adresse e-mail sur le même destinataire ne contourne pas le blocage. L'activation d'un pays conserve ses choix de canaux, d'ordre et d'expéditeurs. Un pays activé sans canal sélectionné affiche No channels selected, et les vérifications vers ce pays échouent avec 422 tant que vous n'avez pas choisi de canaux dans son panneau de routage.

Les modifications sur cette page ne sont pas enregistrées immédiatement. Le bouton d'activation, Enable all et Disable all d'une région, ainsi que les actions groupées ci-dessous, s'accumulent dans une barre en bas de la page, qui compte les modifications non enregistrées. Choisissez Save changes pour les appliquer ensemble, ou Discard pour les abandonner. L'enregistrement applique toutes les modifications ou aucune. Un enregistrement qui désactive un pays ou active une destination à haut risque demande d'abord une confirmation.

Avec un accès en écriture à Verify settings, vous pouvez modifier plusieurs pays à la fois. Cochez leurs cases, ou la case d'une région pour sélectionner tous ses pays. La sélection est conservée lorsque vous modifiez la recherche ou les filtres. Vérifiez le nombre de pays sélectionnés avant de choisir une action :

• Status : choisissez Turn on ou Turn off pour les pays sélectionnés.
• Channels : chaque canal indique combien de pays sélectionnés l'utilisent, avec un interrupteur à moitié activé lorsque ces pays diffèrent. Activez ou désactivez un canal, puis choisissez Apply. Un canal que vous ne modifiez pas conserve le réglage actuel de chaque pays, et le bouton d'annulation à côté d'un interrupteur rétablit ce réglage. Les modifications s'appliquent aux pays sélectionnés qui proposent le canal.
• Channel order : faites glisser les canaux dans l'ordre dans lequel Bird doit les essayer, puis choisissez Apply. Un pays qui ne propose pas un canal l'ignore.

Activer un canal active aussi les pays sélectionnés qui le proposent. Les expéditeurs restent des paramètres propres à chaque pays, dans le panneau de routage.

Routage par pays

Cliquez sur le nom d'un pays pour ouvrir son panneau de routage :

• Channel order : faites glisser les canaux pour définir l'ordre dans lequel Bird les essaie pour ce pays, par exemple SMS avant WhatsApp. Une vérification parcourt la liste jusqu'à ce qu'un envoi réussisse.
• Per-channel enable : désactivez un canal individuel sans désactiver le pays. Les canaux que Bird n'a pas rendus disponibles dans un pays ne peuvent pas être activés ; la plateforme fixe ce plafond par pays. La voix est désactivée au départ ; activez-la ici pour chaque pays où vous souhaitez que les codes soient lus lors d'un appel téléphonique.
• Per-channel sender : choisissez l'expéditeur pour l'e-mail, SMS ou WhatsApp dans ce pays. Héritez de la valeur par défaut de votre configuration, choisissez une identité gérée par Bird, ou utilisez votre domaine e-mail vérifié, un Sender ID SMS ou un numéro WhatsApp connecté avec un modèle d'authentification approuvé. Un choix par pays l'emporte sur la valeur par défaut de la configuration. Un Sender ID SMS propre à un pays n'utilise pas l'expéditeur par défaut de secours.

Où WhatsApp ne peut pas acheminer un code de vérification

L'expéditeur WhatsApp partagé de Bird ne distribue pas de codes de vérification vers le Bangladesh, l'Égypte, l'Inde, l'Indonésie, l'Irak, le Kazakhstan, le Koweït, la Malaisie, le Maroc, le Népal, le Nigéria, Oman, le Pakistan, l'Arabie saoudite, l'Afrique du Sud, le Sri Lanka, l'Ukraine ou les Émirats arabes unis. WhatsApp apparaît toujours dans l'ordre des canaux de ces pays et vous pouvez toujours le placer en tête, mais l'envoi est refusé lorsque Verify atteint ce canal, et la vérification passe au canal suivant de la liste.

La tentative refusée est enregistrée comme tout autre échec, avec la raison channel_restricted, de sorte qu'un événement verify.attempt.undelivered indique pourquoi WhatsApp n'a pas distribué le message. Consultez Événements et webhooks.

Gardez au moins un autre canal activé dans ces pays. Une vérification dont le seul canal est WhatsApp n'a aucun canal suivant, et la création échoue donc avec 422.

Pourquoi désactiver un pays

Les schémas de SMS pumping déclenchent des envois de codes de vérification vers des numéros situés dans des pays que votre entreprise ne dessert pas, ce qui consomme le solde de votre portefeuille. Si votre produit dessert un ensemble connu de marchés, désactivez les autres. Les plafonds de la plateforme de Verify offrent une limite supplémentaire, mais un pays désactivé ne peut pas engendrer de frais de distribution.

Étapes suivantes