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 de :

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. Ouvrez 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 exigence manquante 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 de contrôle.

2. Créez 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 propose également le condensé MD5 utilisé par le navigateur. La liste de contrôle marque chaque exigence du trunk comme complète.

3. Vérifiez 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 + initial, l'indicatif du pays et le numéro national. Puis sélectionnez Send verification call.

Répondez à l'appel de vérification et écoutez 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. Activez le pays de destination

Ouvrez Voice > Destinations. Trouvez le pays que vous souhaitez appeler et activez son bouton bascule.

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

5. Passez 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 vous avez un audio bidirectionnel. Pour mettre fin à l'appel depuis le tableau de bord, sélectionnez Hang up.

6. Inspectez l'enregistrement d'appel

Ouvrez Voice > Calls. La page liste les appels par heure de début, du plus récent au plus ancien, de sorte que votre appel apparaît dans la première ligne. Sélectionnez-le pour inspecter l'heure de réponse, la durée facturable et le coût une fois la tarification terminée.

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

for await (const call of bird.voice.list({ status: ["ringing", "in_progress"] })) {
  console.log(call.id, call.status);
}

for call in client.voice.list(status=["ringing", "in_progress"]):
    print(call.id, call.status)

for call, err := range client.Voice.List(context.Background(), bird.VoiceListParams{
	Status: []bird.VoiceCallStatus{"ringing", "in_progress"},
}) {
	if err != nil {
		log.Fatal(err)
	}
	fmt.Println(call.Id, call.Status)
}

foreach ($bird->voice->list(['status' => ['ringing', 'in_progress']]) as $call) {
    echo $call->getId(), ' ', $call->getStatus(), "\n";
}

bird voice list

{
  "name": "voice_list"
}

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

Utilisez l'enregistrement d'appel pour investiguer les échecs d'appel 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 exigence non cochée 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 la permission du microphone de votre navigateur et le sélecteur de microphone dans le téléphone. Le guide des commandes en cours d'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 : examinez 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 CSV.
S'abonner aux événements vocaux : envoyez les résultats d'appel à vos systèmes au lieu d'interroger périodiquement.

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