Trunking SIP Bandwidth | ElevenLabs Documentation

Avant de suivre ce guide, nous vous recommandons de consulter le guide sur le trunking SIP pour comprendre comment ElevenLabs prend en charge les trunks SIP.

Vue d’ensemble

Ce guide explique comment connecter directement vos trunks SIP Bandwidth à ElevenAgents. Cette intégration vous permet d’utiliser vos numéros de téléphone et votre infrastructure Bandwidth existants tout en tirant parti des capacités avancées d’IA vocale d’ElevenLabs, pour les appels entrants comme sortants.

Fonctionnement du trunking SIP avec Bandwidth

Le trunking SIP établit une connexion directe entre votre infrastructure de téléphonie Bandwidth et la plateforme ElevenLabs :

Appels entrants : les appels provenant de Bandwidth sont acheminés vers la plateforme ElevenLabs à l’aide de notre URI d’origine. Vous la configurez dans l’application Bandwidth à l’aide d’un Voice Configuration Package (VCP).
Appels sortants : les appels initiés par ElevenLabs sont acheminés vers votre trunk SIP Bandwidth via le FQDN de votre realm ou les adresses SBC de terminaison, ce qui permet à vos agents d’effectuer des appels sortants.
Authentification : Bandwidth fournit une authentification SIP pour les trunks Unified Communications (UC), en utilisant l’authentification Digest via des identifiants SIP (network bridge). Cette méthode est essentielle pour faciliter les appels sortants depuis ElevenLabs et garantir une communication sécurisée.
Signalisation et média : l’établissement initial de l’appel (signalisation) utilise UDP/TLS. Une fois l’appel établi, les données audio (flux RTP) sont transmises via UDP.

Configuration requise

Avant de configurer l’intégration du trunk SIP Bandwidth, assurez-vous de disposer des éléments suivants :

Un compte ElevenLabs actif
Un compte Bandwidth Universal Platform actif avec le trunking SIP activé (avec sip-auth activé)
Au moins un numéro de téléphone acheté ou porté sur votre compte Bandwidth
Un accès administrateur à votre compte dans l’application Bandwidth

Configuration des appels entrants (Bandwidth vers ElevenLabs)

Configurez les paramètres d’origine Bandwidth afin d’acheminer les appels entrants vers ElevenLabs.

Se connecter à l'application Bandwidth

Connectez-vous à l’application Bandwidth.

Créer un Voice Configuration Package

Accédez à l’onglet Service Management et sélectionnez Voice Configuration.
Cliquez sur Create New pour commencer à créer un nouveau Voice Configuration Package.
Saisissez un nom de package unique.
Cliquez sur Add Route.
Choisissez Route to Domain Name.
Saisissez dans le champ prévu le FQDN fourni par ElevenLabs. Il s’agit généralement de sip.rtc.elevenlabs.io. Si votre compte ElevenLabs utilise une région de résidence des données isolée ou l’infrastructure SIP statique, utilisez plutôt le point de terminaison SIP correspondant. Consultez la section sur la résidence des données pour connaître les régions disponibles.
Cliquez sur Save pour terminer la création du Voice Configuration Package.

Consultez la documentation Bandwidth sur les VCP pour plus de détails.

Vérifier le format E.164

Bandwidth envoie les appels entrants au format E.164. Lors de l’importation du numéro de téléphone dans ElevenLabs, utilisez le même format avec un + initial (par exemple, +15551234567).

Configuration des appels sortants (ElevenLabs vers Bandwidth)

Pour les appels sortants, ElevenLabs doit s’authentifier auprès de Bandwidth. L’approche recommandée consiste à utiliser l’authentification SIP Digest avec un realm et des identifiants.

Créer un realm

Dans l’application Bandwidth, sélectionnez Account et cliquez sur SIP Credentials.
Faites défiler jusqu’à Manage Realms et cliquez sur Add.
Saisissez un nom de realm et une description facultative, puis cliquez sur Add.

Bandwidth crée un FQDN de realm au format {realmname}.{hash}.auth.bandwidth.com. Notez ce FQDN, vous l’utiliserez comme adresse sortante dans ElevenLabs.

Si vous ne voyez pas l’onglet SIP Credentials, contactez votre responsable de compte Bandwidth ou ouvrez un ticket auprès du support Bandwidth afin d’activer l’authentification SIP sur votre compte.

Créer des identifiants SIP

Dans la section SIP Credentials, cliquez sur Add.
Saisissez un Username et un Password.
Sélectionnez le realm créé à l’étape précédente.
Cliquez sur Add SIP Credentials.

Conservez le nom d’utilisateur et le mot de passe en lieu sûr. Vous les saisirez dans la configuration du trunk SIP ElevenLabs.

Noter le FQDN de votre realm

Votre adresse de terminaison sortante est le FQDN de realm affiché après sa création (par exemple, myrealm-a1b2c3.auth.bandwidth.com). Saisissez ce nom d’hôte dans le champ Address lors de la configuration des paramètres sortants dans ElevenLabs.

Pour vérifier les adresses IP SBC associées à votre realm, effectuez une recherche SRV :

nslookup -type=SRV _sip._{udp/tls}.{realm_FQDN}

Bandwidth fournit une paire d’adresses IP SBC appariées pour la redondance. Les deux doivent être accessibles au trafic sortant.

Finaliser la configuration dans ElevenLabs

Après avoir configuré ces paramètres dans l’application Bandwidth, importez votre numéro de téléphone dans ElevenLabs :

Importer le numéro de téléphone du trunk SIP

Suivez le guide sur le trunking SIP pour importer votre numéro de téléphone Bandwidth. Utilisez les paramètres suivants :

Type de transport : UDP (ou TLS si votre trunk Bandwidth utilise une signalisation chiffrée)
Chiffrement média : doit correspondre à la configuration de votre trunk Bandwidth
Adresse sortante : le FQDN de votre realm (par exemple, myrealm-a1b2c3.auth.bandwidth.com)
Nom d’utilisateur et mot de passe du trunk SIP : les identifiants créés dans l’application Bandwidth

Attribuer un agent

Après l’importation, attribuez un agent au numéro de téléphone dans le Dashboard Phone Numbers.

Après avoir configuré votre trunk SIP Bandwidth, suivez le guide sur le trunking SIP pour finaliser la configuration dans ElevenLabs.

Dépannage

Les appels entrants ne parviennent pas à se connecter

Vérifiez que sip.rtc.elevenlabs.io est saisi comme destination de routage dans les paramètres d’origine VCP de Bandwidth.
Confirmez que le numéro de téléphone est attribué au VCP avec les paramètres d’origine corrects.
Assurez-vous que le format du numéro de téléphone dans ElevenLabs correspond au format E.164 envoyé par Bandwidth (avec un + initial).
Vérifiez que votre pare-feu autorise le trafic de signalisation SIP sur le protocole de transport et le port configurés (5060 pour UDP, 5061 pour TLS), et que les ports RTP ne sont pas bloqués.

Les appels sortants reçoivent une erreur 407 ou d'authentification

Confirmez que le nom d’utilisateur du trunk SIP, le mot de passe et le realm dans ElevenLabs correspondent aux identifiants créés dans l’application Bandwidth.
Vérifiez que le champ Address contient uniquement le nom d’hôte FQDN du realm, sans le préfixe sip:.
Assurez-vous que le type de transport dans les paramètres sortants d’ElevenLabs correspond à la configuration de votre trunk Bandwidth (UDP ou TLS).

Audio unidirectionnel ou absence d'audio

Confirmez que les ports RTP sont ouverts pour le trafic média et ne sont pas bloqués par votre pare-feu.
Vérifiez la compatibilité avec le codec G711ulaw. Bandwidth et ElevenLabs prennent tous deux en charge G711.

FAQ

Quel transport et quels ports de signalisation Bandwidth exige-t-il ?

Bandwidth et ElevenLabs utilisent UDP sur le port 5060 pour la signalisation SIP. Si votre trunk Bandwidth est configuré pour un transport chiffré, utilisez plutôt TLS sur le port 5061.

Quel format de numéro de téléphone dois-je utiliser ?

Utilisez le format E.164 avec un + initial (par exemple, +19192971100). Bandwidth envoie et attend les numéros dans ce format.

Quels codecs audio sont compatibles ?

ElevenLabs prend en charge G711 et G722. Bandwidth prend en charge G711ulaw et G729a. G711ulaw est le codec recommandé pour assurer la compatibilité entre les deux plateformes.