Passez votre premier appel

Passez un vrai appel téléphonique depuis le tableau de bord. Le téléphone du tableau de bord est un client SIP qui utilise les mêmes paramètres de trunk, d'identifiant d'appelant et de destination que votre système téléphonique.

Après l'appel, vous pouvez inspecter son enregistrement dans le tableau de bord ou via l'API Voice.

Prérequis

Avant de commencer, assurez-vous de disposer des éléments suivants :

Un espace de travail avec Phone sous Voice. Le tableau de bord l'affiche lorsque la région de votre espace de travail prend en charge les appels depuis le navigateur et que vous disposez d'un accès Voice au niveau Write.
Un numéro de téléphone qui vous appartient et un téléphone capable de répondre aux appels de vérification et de test.
Un navigateur avec un microphone fonctionnel.

1. Ouvrir le téléphone

Sélectionnez Voice > Phone dans le tableau de bord. Le téléphone s'ouvre dans une fenêtre flottante et reste ouvert pendant votre navigation.

Si votre espace de travail n'est pas prêt à passer des appels, le téléphone affiche Finish setup to place calls. Sa liste de contrôle identifie chaque prérequis manquant et renvoie vers l'action requise. La création d'un trunk prêt à appeler et la vérification d'un identifiant d'appelant complètent la liste.

2. Créer un trunk prêt à appeler

Sélectionnez Create a trunk dans la liste de contrôle. Saisissez un nom, puis sélectionnez Create trunk.

Le tableau de bord active les appels sortants et les identifiants de session lors de la création du trunk. Le trunk fournit également le condensé MD5 utilisé par le navigateur. La liste de contrôle marque tous les prérequis du trunk comme remplis.

3. Vérifier votre identifiant d'appelant

Sélectionnez Verify a number you own dans la liste de contrôle. Saisissez un numéro qui vous appartient dans le champ Phone number au format E.164 : un + en tête, l'indicatif du pays et le numéro national. Puis sélectionnez Send verification call.

Répondez à l'appel de vérification et notez le code à six chiffres. Saisissez-le dans le champ Verification code, puis sélectionnez Verify caller ID.

Le tableau de bord affiche Caller ID verified, supprime l'avis de configuration et ajoute le numéro à la ligne From du téléphone.

4. Activer le pays de destination

Ouvrez Voice > Destinations. Trouvez le pays que vous prévoyez d'appeler et activez son commutateur.

Les appels vers des pays désactivés sont rejetés avant que la plateforme ne contacte un opérateur.

5. Passer l'appel

Saisissez le numéro que vous avez vérifié dans la ligne To, puis sélectionnez Call. Si votre navigateur demande l'accès au microphone, autorisez-le.

Votre téléphone sonne et affiche l'identifiant d'appelant vérifié. Répondez à l'appel et confirmez que l'audio fonctionne dans les deux sens. Pour mettre fin à l'appel depuis le tableau de bord, sélectionnez Hang up.

6. Inspecter l'enregistrement d'appel

Ouvrez Voice > Legs. La page liste les appels par heure de début, du plus récent au plus ancien : votre appel apparaît donc sur la première ligne. Sélectionnez-le pour voir quand il a été décroché, sa durée facturable et son coût une fois la tarification terminée.

Les mêmes enregistrements d'appel sont disponibles via l'API :

for await (const leg of bird.voice.legs.list()) {
  console.log(leg.id, leg.status);
}

for leg in client.voice.legs.list():
    print(leg.id, leg.status)

for leg, err := range client.Voice.Legs.List(context.Background(), bird.VoiceLegsListParams{}) {
	if err != nil {
		log.Fatal(err)
	}
	fmt.Println(leg.Id, leg.Status)
}

foreach ($bird->voice->legs->list() as $leg) {
    echo $leg->getId(), ' ', $leg->getStatus(), "\n";
}

bird voice legs list

curl -X GET "https://{region}.platform.bird.com/v1/voice/legs" \
  -H "Authorization: Bearer $TOKEN" \
  --url-query "limit=25"

Utilisez l'enregistrement d'appel pour investiguer les échecs d'appels futurs. Un appel refusé stocke sa cause dans rejection_reason. Pour les filtres du tableau de bord, les champs d'enregistrement et l'accès API, consultez le guide du journal d'appels.

Résoudre les problèmes de l'appel de test

Le téléphone affiche toujours Finish setup to place calls : complétez chaque prérequis non coché en utilisant le lien dans la ligne correspondante de la liste de contrôle.
Le téléphone affiche un motif de rejet : destination_not_enabled signifie que le pays de destination est désactivé. caller_id_not_verified signifie que le numéro dans la ligne From n'est pas vérifié. La référence des appels rejetés couvre chaque motif et sa résolution.
L'appel se connecte, mais un côté n'a pas d'audio : vérifiez l'autorisation microphone de votre navigateur et le sélecteur de microphone dans le téléphone. Le guide des commandes en appel couvre les sélecteurs de périphériques.

Dépannage Voice traite les mêmes symptômes pour n'importe quel client.

Étapes suivantes

Appels de test depuis le terminal : passez le même appel avec bird voice tools test-call.
Configurer un client SIP : connectez Asterisk, FreePBX, Zoiper ou un autre client au trunk.
Configurer les trunks SIP : passez en revue les paramètres activés par le trunk prêt à appeler et les autres méthodes d'admission.
Passer des appels : comprenez comment la plateforme achemine et tarifie les appels.
Inspecter le journal d'appels : filtrez les enregistrements, examinez les champs, récupérez les appels via l'API ou exportez les données en CSV.
S'abonner aux événements vocaux : envoyez les résultats d'appels à vos systèmes au lieu d'interroger l'API.

Ressources associées

Poursuivez avec la documentation, les guides et les exemples sur ce sujet. Les ressources sont en anglais.

Comprendre le conceptWhat is a voice API?Explorer la fonctionnalitéVoice Guide d'implémentationVoice overview

Obtenir un guide d'implémentation