Identifiants d'appelant

Un identifiant d'appelant est un numéro que votre espace de travail peut présenter lors d'un appel sortant. Bird vérifie l'en-tête SIP From de chaque appel par rapport aux numéros Bird que cet espace de travail peut présenter et à ses numéros externes vérifiés. Les appels présentant un numéro non admissible sont refusés.

Gérez les identifiants d'appelant sous Voice > Numbers, qui répertorie tous les numéros que votre espace de travail peut utiliser pour la voix. Un numéro acheté chez nous et un numéro vérifié par vos soins apparaissent dans la même liste, une ligne par numéro. Un numéro qui est les deux n'apparaît qu'une fois. Un numéro acheté chez nous est prêt à être présenté dès que vous le détenez, sans appel de vérification : le détenir constitue la preuve. La procédure ci-dessous concerne un numéro que vous possédez ailleurs.

Chaque ligne affiche le nom, le numéro et son pays, son Provider, les directions prises en charge et son utilisation. Un numéro en attente de son code affiche Verifying ; un numéro dont le code a expiré ou dont les tentatives sont épuisées affiche Failed. Chaque page contient jusqu'à 25 numéros. Sélectionnez une ligne pour ouvrir la page du numéro.

Enregistrer un numéro

1. Sélectionnez Add number > Verify a number you own.
2. Saisissez le numéro au format E.164 : un + initial, l'indicatif du pays et le numéro national. Un numéro ne peut être enregistré qu'une seule fois dans votre espace de travail.
3. Enregistrez-le. Un appel de vérification est immédiatement passé vers le numéro.
4. Répondez à l'appel et écoutez le code à six chiffres.
5. Saisissez le code dans le tableau de bord. Vous disposez de cinq tentatives, et un code accepté fait passer le statut à Verified.

La vérification de l'identifiant d'appelant ne facture pas votre espace de travail pour l'appel de vérification. L'enregistrement nécessite tout de même la permission de gestion Voice et l'approbation du compte pour enregistrer des numéros vérifiés. Nommez le numéro ensuite sur sa propre page. Voir Nommer un numéro.

Après la vérification, vérifiez le pays que vous souhaitez appeler sous Voice > Destinations. La vérification tente d'activer le pays du numéro vérifié, mais des pays indisponibles ou un échec de mise à jour des paramètres peuvent le laisser désactivé. Un identifiant d'appelant vérifié et une destination activée sont deux exigences distinctes.

Enregistrer et vérifier via API

Enregistrez un numéro pour lancer son appel de vérification, puis envoyez le code avec l'ID que renvoie l'enregistrement. Listez vos identifiants d'appelant pour trouver un numéro enregistré dans le tableau de bord. Vous pouvez aussi renommer ou supprimer un identifiant d'appelant. Les lectures nécessitent voice_management:read ; l'enregistrement, la vérification, le renommage et la suppression nécessitent voice_management:write. La référence API comprend des exemples SDK, Bird en ligne de commande et MCP.

Si l'appel de vérification initial n'a pas pu démarrer, l'envoi du code peut déclencher un autre appel vers le numéro enregistré. Votre organisation doit toujours satisfaire aux exigences d'enregistrement. Si le code expire ou que les tentatives sont épuisées, supprimez l'identifiant d'appelant et enregistrez à nouveau le numéro, ce qui déclenche un nouvel appel de vérification, puis envoyez le nouveau code avec l'ID que renvoie cet enregistrement. Si le code est accepté mais que l'activation renvoie 412 ou 503, la propriété reste prouvée et l'identifiant d'appelant indique verified avec outbound_enabled: false. Un 412 signifie que la vérification d'identité est incomplète, ce que vous terminez dans le tableau de bord, ou qu'un examen ou un refus d'éligibilité nécessite le support. Un 503 signifie que l'évaluation d'éligibilité est en attente ou indisponible : réessayez plus tard. Une fois le problème résolu, envoyez une requête de vérification vide pour le même ID ; ne le supprimez pas et ne l'enregistrez pas à nouveau.

Après la vérification, vérifiez vos destinations Voice et activez le pays du numéro si cette destination est prise en charge et si nécessaire. La vérification tente de l'activer, mais une vérification réussie de l'identifiant d'appelant peut laisser la destination désactivée et les appels sortants vers ce pays bloqués.

Une seule vérification à la fois

L'enregistrement peut renvoyer E21036 lorsque le fournisseur de vérification a déjà un défi en cours pour ce numéro appartenant à un autre espace de travail ou à un autre usage. Attendez que cette vérification se termine ou expire, puis enregistrez le numéro à nouveau. Une preuve obtenue pour un autre espace de travail ne vérifie pas le numéro dans le vôtre.

Le même refus s'applique à un numéro occupé pour une autre raison : un code de connexion ou une vérification Trust Hub déjà en cours vers celui-ci. Si aucun autre espace de travail ne vérifie le numéro, c'est généralement la cause, et l'attente est la même.

Une vérification déjà terminée ailleurs ne vous bloque pas : le même numéro peut être un identifiant d'appelant vérifié dans plusieurs espaces de travail, et chacun le prouve séparément.

Statuts

Get a new code enregistre le numéro à nouveau et l'appelle avec un nouveau code. Si le premier appel n'est jamais arrivé et que le numéro est toujours en attente, supprimez l'identifiant d'appelant et ajoutez le numéro à nouveau.

Si vous lisez ces valeurs depuis vos propres outils, traitez celles que vous gérez et considérez toute autre valeur comme un statut que vous ne gérez pas plutôt que comme une erreur.

Clause de non-responsabilité relative à la vérification et à la livraison CLI

Bird effectue une vérification CLI (Calling Line Identification) pour confirmer qu'un numéro A est valide et autorisé avant que des appels sortants puissent être passés depuis la plateforme. Cette vérification garantit que le numéro est légitime et sous le contrôle du client.

Cependant, la vérification ne garantit pas la livraison de bout en bout du CLI ni la connexion de l'appel lorsque le CLI n'est pas un numéro obtenu via Bird. Les opérateurs en aval et les opérateurs internationaux appliquent leurs propres réglementations nationales et politiques de trafic, qui échappent au contrôle de Bird. Celles-ci peuvent inclure :

• Cadres d'authentification de l'identifiant d'appelant et de lutte contre l'usurpation (par ex. STIR/SHAKEN aux États-Unis, directives CLI de l'Ofcom au Royaume-Uni)
• Exigences imposant que le CLI soit un numéro enregistré localement ou dans le pays
• Filtrage du spam et de la fraude appliqué par les opérateurs de terminaison
• Restrictions sur des catégories de trafic spécifiques, telles que les jeux d'argent, les promotions financières, le recouvrement de créances ou la messagerie politique
• Blocage des appels internationaux présentant un CLI national (restrictions "origin-based")
• Listes de numéros interdits à l'émission et blocages imposés par les régulateurs

Pour ces raisons, Bird peut vérifier un CLI mais ne peut garantir que (1) le CLI sera préservé et affiché au destinataire de l'appel, ou (2) l'appel sera acheminé via des trunks nationaux ou des partenaires et opérateurs internationaux de niveau 1. Pour maximiser la livraison du CLI et les taux d'aboutissement des appels, nous recommandons d'utiliser des numéros obtenus via Bird, qui sont provisionnés et routés conformément aux exigences réglementaires locales.

Nommer un numéro

Un nom identifie le numéro dans le tableau de bord et dans la liste Call from du composeur. Il n'est pas transmis avec l'appel.

Sélectionnez le numéro dans la liste Numbers pour ouvrir sa page, puis définissez Name et enregistrez. Laissez le champ vide pour afficher uniquement le numéro. Le nommage fonctionne quel que soit le statut et ne modifie ni le numéro ni sa vérification.

Vérifier un numéro auquel vous ne pouvez pas répondre

Quelqu'un doit répondre à l'appel de vérification et écouter son code. Si le numéro aboutit normalement à un système sans surveillance, redirigez-le temporairement vers un téléphone auquel vous pouvez répondre, puis rétablissez le routage. Contactez le support si le numéro ne peut pas recevoir d'appels.

Supprimer un identifiant d'appelant

Utilisez Remove caller ID sur la ligne du numéro. La suppression de la vérification retire cette preuve pour les nouveaux appels. Un numéro détenu par votre espace de travail via Bird peut rester éligible grâce à son allocation ; un numéro externe qui perd sa preuve est refusé avec caller_id_not_verified. Les appels déjà en cours continuent, et les traces d'appels existants ne changent pas.

Étapes suivantes