DéployerTéléphonieFournisseurs de téléphonie

Trunking SIP Sinch

Connectez Sinch Elastic SIP Trunking à ElevenLabs Agents.

Avant de suivre ce guide, nous vous recommandons de lire le guide sur le trunking SIP d’ElevenLabs et le guide sur le trunking SIP de Sinch Voice.

Présentation

Ce guide explique comment connecter directement une application Sinch Voice à ElevenLabs Agents. L’intégration vous permet de conserver vos numéros et votre routage Sinch tandis qu’ElevenLabs gère l’expérience de l’agent d’IA vocale.

Fonctionnement du trunking SIP avec Sinch

Un trunk SIP Sinch est une connexion bidirectionnelle entre le réseau Sinch et la plateforme ElevenLabs :

  1. Appels entrants : Un DID attribué à votre application Sinch Voice reçoit un appel. Sinch envoie l’INVITE à l’adresse d’origine ElevenLabs configurée comme point de terminaison statique dans les paramètres entrants du trunk.
  2. Appels sortants : Les appels initiés par ElevenLabs sont envoyés à l’adresse SIP du nom de domaine complet (FQDN) de votre application, que Sinch achemine vers le PSTN.
  3. Authentification : Sinch exige une authentification sortante (identifiants SIP) et prend en charge l’authentification ACL (autorisation d’adresses IP) pour le trafic arrivant sur le trunk.

Prérequis

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

  1. Un compte ElevenLabs actif avec un agent configuré
  2. Un compte Sinch avec une application vocale créée dans le Dashboard Sinch Build
  3. Au moins un numéro de téléphone (DID) acheté dans Sinch et attribué à l’application

Configuration des appels entrants (de Sinch vers ElevenLabs)

Configurez le renvoi d’appels de votre application vers l’adresse SIP ElevenLabs.

1

Connectez-vous au Dashboard Sinch Build

Connectez-vous à votre compte Sinch et accédez à l’application que vous souhaitez connecter.

2

Ajoutez un point de terminaison statique pour ElevenLabs

Dans les paramètres de renvoi d’appels de l’application, définissez le gestionnaire d’événements d’appel sur SIP Forwarding et ajoutez un URI SIP statique ciblant l’adresse d’origine ElevenLabs :

  • DID : le numéro de téléphone Sinch que vous souhaitez composer
  • Adresse : sip.rtc.elevenlabs.io
  • Port et transport : 5061/TLS, 5060/TCP

Par exemple : sip:15551234567@sip.rtc.elevenlabs.io:5061;transport=tls.

Si votre Workspace ElevenLabs utilise une région isolée de résidence des données ou l’infrastructure SIP à IP statique, utilisez le point de terminaison correspondant au lieu de sip.rtc.elevenlabs.io. Consultez la résidence des données pour connaître les régions disponibles.

3

Attribuez votre DID à l’application

Attribuez à cette application le numéro de téléphone qui doit joindre votre agent.

Configuration des appels sortants (d’ElevenLabs vers Sinch)

Pour les appels sortants, ElevenLabs envoie un INVITE SIP à votre application Sinch et s’y authentifie.

1

Notez le FQDN de votre région Sinch

Récupérez le FQDN SIP de votre région Sinch. Il s’agit de l’adresse de terminaison à saisir dans ElevenLabs. Saisissez uniquement le nom d’hôte, sans préfixe sip:.

2

Saisissez les identifiants SIP

Copiez de manière sécurisée la clé et le secret de votre application Sinch. Ils serviront de nom d’utilisateur et de mot de passe dans ElevenLabs.

3

Numéro de renvoi

Votre application Sinch renverra l’appel vers son adresse de renvoi. Pour effectuer un appel sortant vers le numéro indiqué dans la requête d’appel sortant, laissez ce champ vide dans les paramètres de votre application.

Finaliser la configuration dans ElevenLabs

1

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

Suivez le guide sur le trunking SIP pour importer votre numéro Sinch avec les paramètres suivants :

ParamètreValeur
Numéro de téléphoneVotre DID Sinch, par exemple 15551234567
Type de transportTLS
Chiffrement des médiasDisabled pour TCP ; Allowed ou Required lorsque le trunk est configuré pour TLS et SRTP
AdresseFQDN de votre trunk Sinch, nom d’hôte uniquement
Nom d’utilisateur du trunk SIPClé de l’application Sinch
Mot de passe du trunk SIPSecret de l’application Sinch

Conservez des paramètres de transport et de chiffrement cohérents des deux côtés.

2

Attribuez un agent

Attribuez un agent au numéro dans le Dashboard Phone Numbers. Les appels entrants vers le DID seront alors dirigés vers cet agent.

3

Testez un appel sortant

Effectuez un appel depuis l’agent via votre application Sinch, soit depuis le menu des numéros de téléphone, soit via l’API d’appels sortants :

curl -X POST https://api.elevenlabs.io/v1/convai/sip-trunk/outbound-call \
  -H "xi-api-key: $ELEVENLABS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "agent_id": "agent_7101k5zvyjhmfg983brhmhkd98n6",
    "agent_phone_number_id": "phnum_8901k4t9z5defmb8vh3e9361y7nj",
    "to_number": "+15551234567"
  }'

Consultez Appel sortant via un trunk SIP pour le schéma complet de la requête, et Appels par lots pour lancer des campagnes sortantes.

Configuration des transferts

Les agents transfèrent les appels à un humain à l’aide de l’outil système transfer_to_number.

Seuls les transferts par conférence fonctionnent sur un trunk Sinch. SIP REFER et les transferts aveugles échouent.

Transferts par conférence

ElevenLabs compose le numéro de destination via votre trunk Sinch, réunit les deux parties dans une conférence, puis déconnecte l’agent.

Utiliser plutôt l’API Sinch Voice v2

La configuration ci-dessus confie à ElevenLabs l’ensemble du chemin vocal. Si vous avez besoin que Sinch contrôle les appels, l’API Sinch Voice v2 peut répondre à un appel, appliquer sa propre logique et relier une seconde branche à votre agent ElevenLabs via SVAML, sans serveur relais. Ce modèle est plus adapté si vous souhaitez ajouter des fonctionnalités Sinch telles que la détection de répondeur, l’enregistrement des appels ou le masquage des numéros avant que l’agent ne rejoigne l’appel, ou lorsque l’agent constitue une étape dans un flux d’appels Sinch plus large.

Consultez le tutoriel Sinch Intégrer un agent IA ElevenLabs via SIP pour d’autres scénarios courants.

Résolution des problèmes

  • Vérifiez que le point de terminaison entrant statique du trunk cible sip.rtc.elevenlabs.io avec le port et le transport que vous souhaitez utiliser.
  • Vérifiez que le DID est attribué à ce trunk.
  • Vérifiez que le numéro dans ElevenLabs correspond à celui envoyé par Sinch, y compris le + initial.
  • Attendez au moins 60 secondes après avoir modifié les points de terminaison ou les ACL, puis réessayez.
  • Vérifiez que votre pare-feu autorise la signalisation SIP sur le port 5060 pour TCP ou 5061 pour TLS, et qu’il ne bloque pas RTP.
  • Vérifiez que le nom d’utilisateur et le mot de passe du trunk SIP dans ElevenLabs correspondent aux identifiants du trunk Sinch.
  • Vérifiez que le champ Adresse contient uniquement le FQDN du trunk, sans préfixe sip:.
  • Vérifiez que les autorisations de pays sont activées sur le trunk pour le pays de destination.
  • Vérifiez que l’identifiant d’appelant présenté est un numéro accepté par Sinch sur ce trunk.
  • Si vous utilisez l’authentification ACL, gardez à l’esprit que la signalisation ElevenLabs provient d’un pool d’adresses distribué. Passez à l’authentification Digest ou utilisez l’infrastructure à IP statique.
  • Vérifiez que votre pare-feu autorise RTP via UDP dans les deux sens et n’est pas limité à des adresses statiques spécifiques.
  • Vérifiez que le chiffrement des médias correspond : un trunk Sinch TLS attend SRTP, définissez donc le chiffrement des médias sur Allowed ou Required dans ElevenLabs.
  • Testez avec TCP et le chiffrement des médias désactivé afin d’isoler si le problème est lié à TLS ou à SRTP.
  • Vérifiez que G711 est proposé sur le trunk. ElevenLabs prend en charge G711 et G722.

Une réponse 481 à un BYE signifie généralement que la requête a atteint un serveur SIP ne disposant pas de l’état de dialogue de cet appel. Envoyez les requêtes au sein du dialogue vers l’URI Contact renvoyé dans le 200 OK, plutôt que vers l’adresse partagée sip.rtc.elevenlabs.io. Si BYE ou REFER via TLS échoue à la validation du certificat, ajoutez le FQDN pour lequel le certificat de votre trunk est émis au champ Domaines distants des paramètres du numéro de téléphone.

FAQ

Utilisez TLS sur le port 5061 pour la production, avec des médias SRTP sur le trunk Sinch. TCP sur le port 5060 constitue un bon point de départ pour la validation. UDP est expérimental sur ElevenLabs et ne doit pas transporter de trafic de production.

ElevenLabs prend en charge G711 (8 kHz) et G722 (16 kHz). Conservez G711 proposé sur le trunk Sinch comme dénominateur commun.

Les en-têtes personnalisés X- de l’INVITE entrant sont exposés sous forme de variables dynamiques, X-Contact-ID devenant par exemple {{sip_contact_id}}. X-Call-ID et X-Caller-ID correspondent à system__call_sid et system__caller_id. Consultez Trunking SIP pour connaître l’ensemble des règles de normalisation.

Liens utiles