Présentation de Voice
Bird Voice vous permet d'appeler des numéros de téléphone et de répondre aux appels reçus sur les numéros que vous détenez. Connectez un système téléphonique via SIP, passez un appel depuis le navigateur ou utilisez le concepteur de séquences pour exécuter un flux d'appel enregistré. Bird relie les appels au réseau téléphonique public, le PSTN.
La connexion entre votre système téléphonique et Bird est un trunk SIP. SIP (Session Initiation Protocol) établit les appels entre systèmes téléphoniques. Bird attribue à votre espace de travail une adresse de trunk, que votre système téléphonique utilise pour les appels sortants vers le réseau téléphonique, et que Bird utilise en sens inverse pour livrer les appels arrivant sur vos numéros.
Vous n'avez pas besoin d'un système téléphonique pour passer le premier appel : le téléphone du tableau de bord en passe un directement depuis le navigateur, via l'un de vos trunks.
Vous pouvez aussi créer une séquence dans le tableau de bord et la lancer avec l'API Create Call. La séquence gère les annonces, les choix au clavier et le routage de l'appel une fois que le destinataire a décroché.
Comment un appel est passé
Votre système téléphonique envoie un SIP INVITE à l'adresse du trunk pour lancer un appel. Bird vérifie l'identifiant de l'appelant, le pays de destination, les limites et le solde du portefeuille avant de contacter un opérateur. Si l'appel passe, Bird l'achemine et relaie l'audio. Chaque connexion est un segment. Quand un segment se termine, Bird enregistre sa trace sous Voice > Legs et émet un voice_call.ended événement.
Un appel qui échoue à une vérification est refusé avant qu'un opérateur n'intervienne, et la raison précise est inscrite sur la trace du segment. Passer des appels détaille ce que Bird lit sur chaque appel, et Appels rejetés liste chaque motif de refus et la marche à suivre.
Comment un appel entrant est pris en charge
Chaque numéro de votre espace de travail possède une action à la fois pour les appels entrants, définie sur le numéro : transmettre l'appel à l'un de vos trunks SIP, le transférer vers un numéro vérifié, exécuter une séquence publiée ou le rejeter. Chaque nouveau numéro rejette les appels par défaut ; tant qu'il n'est pas configuré, il refuse les appelants.
Lorsqu'un appel arrive, Bird vérifie les limites du compte et le portefeuille de la même manière que pour un appel sortant, puis applique la réponse du numéro et enregistre cette réponse sur l'appel. Recevoir des appels explique comment associer un numéro à une réponse, ce qu'un transfert présente à la personne qui décroche, et comment interpréter un refus.
Avant votre premier appel
Pour les appels passant par votre propre équipement SIP, préparez les éléments suivants. Les appels par API suivent les prérequis de Create Call.
- Créer un trunk SIP, activer les appels sortants et autoriser les appelants : une plage IP ou une clé API pour votre propre équipement, des identifiants de session pour un navigateur ou le CLI.
- Choisir un identifiant d'appelant éligible : utilisez un numéro détenu par votre espace de travail via Bird, ou enregistrez un numéro externe et confirmez-le par un appel de vérification.
- Activer vos destinations : activez les pays que vous appelez.
Passez votre premier appel guide à travers les trois prérequis et se termine par un appel réel.
Consulter les traces d'appels nécessite voice:read ; passer des appels nécessite voice:write. La gestion des trunks, des routes de numéros, des identifiants d'appelant et des séquences utilise les permissions voice_management. L'accès à une page n'accorde pas le droit de modifier ses paramètres ou de passer un appel facturable.
L'application Voice dans le tableau de bord
| Page | À quoi elle sert |
|---|---|
| Metrics | Volume d'appels et taux de réponse dans le temps, résultats des appels, principaux pays, et répartition entrant/sortant. Voir Métriques Voice |
| Legs | Traces par segment pour les appels de l'espace de travail, avec les totaux de consommation du mois |
| Calls | Segments et participants associés regroupés en un seul appel |
| Numbers | Chaque numéro que l'espace de travail peut utiliser pour la voix, et ce que chacun fait d'un appel entrant |
| SIP Trunks | Vos trunks, leur domaine SIP, qui peut y envoyer du trafic, et où les appels entrants sont livrés |
| Destinations | Les pays que votre espace de travail peut appeler, désactivés par défaut |
| Sequences | Créer, prévisualiser et publier des flux d'appels, puis examiner leurs exécutions |
| Phone | Un téléphone flottant qui passe des appels depuis le navigateur, via l'un de vos trunks |
Visibilité
Un appel peut contenir plusieurs segments. Le journal contient une trace par segment, qu'il ait abouti, sonné dans le vide ou été refusé. Les appels transférés ou multipartites peuvent donc avoir plusieurs entrées :
- Journal des segments : la vue par segment sur la page Legs. Statut, les deux numéros, le trunk sur lequel le segment est arrivé, la réponse SIP qui l'a terminé, heures de réponse et de fin, durée facturable et coût. Filtrez-le, puis exportez le résultat en CSV.
- Événements Voice : voice_call.initiated, voice_call.answered et voice_call.ended livrés à votre propre endpoint, pour que vos systèmes soient informés d'un appel sans interrogation périodique.
La référence API liste les contrats HTTP publics pris en charge et les méthodes SDK. La référence CLI et la référence de l'outil MCP décrivent leurs opérations publiées. Ces surfaces peuvent exposer des opérations différentes ; une action du tableau de bord ou une commande CLI ne constitue pas en soi une méthode SDK publique.
Limites
Trois plafonds s'appliquent à vos appels, dans les deux sens : le nombre d'appels simultanés autorisés, le nombre de nouveaux appels par seconde, et le montant que vous pouvez dépenser en voix par jour UTC. Chacun est défini par organisation, et les montants dépendent de votre forfait. Un appel qui dépasse l'un d'entre eux est refusé à l'établissement, et son enregistrement indique lequel, sous Appels rejetés.
Le plafond par seconde est la politique voice_call dans Limitation du débit, qui explique aussi comment votre limite effective est déterminée et comment demander plus de capacité.
Étapes suivantes
| Page | Ce qu'elle couvre |
|---|---|
| Passez votre premier appel | D'un espace de travail vide à un téléphone qui sonne |
| Phone | Appeler depuis le tableau de bord, les prérequis, et ce que vous pouvez faire en cours d'appel |
| Trunks SIP | Créer un trunk, ses paramètres de connexion, et contrôler qui peut envoyer du trafic |
| Passer des appels | Ce que Bird attend sur le INVITE, et ce que coûte un appel |
| Recevoir des appels | Associer un numéro à un trunk ou un transfert, et ce qui est enregistré |
| Identifiants d'appelant | Enregistrer un numéro et prouver que vous le détenez par un appel de vérification |
| Destinations Voice | Activer les pays que vous appelez, et ce que signifie « risque élevé » |
| Journal des segments | Consulter, filtrer et exporter vos traces de segments |
| Événements Voice | Les trois événements d'appel et leurs payloads |
| Dépannage | Diagnostiquer un appel qui n'aboutit pas, à partir de son symptôme |
| Webhooks et événements | Configuration de l'endpoint, vérification de la signature, réessais et rejeu |
Ressources associées
Poursuivez avec la documentation, les guides et les exemples sur ce sujet. Les ressources sont en anglais.