Transfert vers un numéro
Transférez les appels vers des numéros de téléphone externes ou des URI SIP selon des conditions définies.
Vue d’ensemble
L’outil système transfer_to_number permet à un agent ElevenLabs de transférer l’appel en cours vers un numéro de téléphone ou une URI SIP spécifié lorsque certaines conditions sont remplies. Les agents peuvent ainsi transférer les problèmes complexes, les demandes spécifiques ou les situations nécessitant l’intervention d’un interlocuteur humain à un opérateur en direct.
Cette fonctionnalité prend en charge les transferts via des numéros de téléphonie. Lorsqu’il est déclenché, l’agent peut transmettre un message à l’utilisateur pendant son attente, ainsi qu’un message distinct résumant la situation à l’opérateur humain qui reçoit l’appel.
L’outil système transfer_to_number est disponible uniquement pour les appels téléphoniques et ne l’est pas dans le
widget de chat.
Règles de transfert
-
Une règle de transfert indique quand l’agent doit transférer l’appel et comment chaque fournisseur de téléphonie effectue le transfert.
-
Chaque règle comprend une condition et une configuration par fournisseur.
-
L’outil peut être configuré avec plusieurs règles de transfert.
-
Pendant un appel, l’agent ne voit que les règles correspondant au fournisseur sur lequel l’appel est en cours.
-
Condition : texte brut prenant en charge les variables dynamiques, qui décrit quand utiliser cette méthode de transfert, par exemple « L’appelant pose une question sur la facturation »
-
La configuration du fournisseur est une liste avec au maximum une entrée par fournisseur. Si une règle ne comporte aucune entrée pour un fournisseur, elle n’existe pas pour les appels de ce fournisseur.
Types de transfert
- Conférence : comportement par défaut qui appelle la destination et place l’appelant ainsi que l’opérateur humain dans une salle de conférence
- SIP REFER : utilise le protocole SIP REFER pour transférer directement les appels vers la destination. Fonctionne avec les numéros de téléphone et les URI SIP, mais est disponible uniquement lorsque le protocole SIP est utilisé pendant la conversation et requiert que votre trunk SIP autorise le transfert via SIP REFER
Stratégies de transfert
- À froid : transfère directement l’appel, sans communiquer le résumé de la situation à l’opérateur humain qui reçoit l’appel.
- À chaud : transfère l’appel en résumant la situation à l’opérateur humain qui reçoit l’appel.
Options de transfert disponibles par fournisseur
SIP
- Conférence à froid : (
sip_cold_conference_transfer) Le destinataire est ajouté à l’appel sans annonce- Prend uniquement en charge les numéros de téléphone
- SIP REFER : (
sip_cold_refer_transfer) L’appel est transféré vers la destination via SIP REFER sans annonce- Prend en charge les numéros de téléphone et les URI SIP
- En-têtes SIP personnalisés, variables statiques ou dynamiques
- UUI (informations d’utilisateur à utilisateur) pour transmettre du contexte, tel qu’un identifiant CRM
- Jouer la tonalité de sonnerie (activé par défaut) : l’appelant entend une sonnerie pendant que le transfert s’effectue. Désactivez cette option pour qu’il n’entende rien.
Twilio
- À froid : (
twilio_cold_blind_transfer) Le destinataire est ajouté à l’appel sans annonce- Prend uniquement en charge les numéros de téléphone
- Chiffres post-numérotation : tonalités DTMF envoyées après la connexion de l’appel
- À chaud : (
twilio_warm_conference_transfer) Le destinataire entend le résumé de l’agent, puis est mis en relation- Prend uniquement en charge les numéros de téléphone
- Chiffres post-numérotation : tonalités DTMF envoyées après la connexion de l’appel
Exotel
- À froid : (
exotel_warm_transfer) Le destinataire est ajouté à l’appel sans annonce- Prend uniquement en charge les numéros de téléphone
- À chaud : (
twilio_warm_conference_transfer) Le destinataire entend le résumé de l’agent, puis est mis en relation- Prend uniquement en charge les numéros de téléphone
Détails de la configuration supplémentaire
Chiffres post-numérotation
- Tonalités DTMF envoyées après la connexion de l’appel, par exemple
w1W234 - Chaque
wcorrespond à une pause de 0,5 s - Chaque
Wcorrespond à une pause de 1 s
En-têtes SIP personnalisés
En-têtes SIP supplémentaires envoyés avec le transfert afin que le système destinataire (PBX, centre de contact) reçoive vos données, par exemple X-Customer-ID: 12345.
- Emplacement : trunk SIP, SIP REFER uniquement.
- Limites :
- Maximum 20 en-têtes par transfert.
- Nom : jusqu’à 64 caractères. Lettres, chiffres et traits d’union simples uniquement
Les en-têtes système X-Conversation-ID et X-Caller-ID sont automatiquement inclus par ElevenLabs et
remplacent tous les en-têtes personnalisés portant les mêmes noms, sans distinction des majuscules et des minuscules.
UUI (informations d’utilisateur à utilisateur)
Configurez l’UUI pour chaque règle de transfert à l’aide de l’objet uui :
data: la charge utile à envoyer, en texte brut. ElevenLabs l’encode en hexadécimal et ajoute;encoding=hex. Elle peut être un texte statique ou inclure des variables dynamiques. Maximum 256 octets (UTF-8), appliqué après le remplacement des variables dynamiques. Pour du texte ASCII simple, cela correspond à 256 caractères, moins pour les caractères sur plusieurs octets.protocol_discriminator: un seul octet hexadécimal, par exemple04. Incluez-le pour les plateformes qui suppriment le premier octet de la charge utile ; omettez-le pour celles qui transmettent la charge utile telle quelle.protocol_discriminator_mode:prefix(par défaut) ajoute l’octet au début, produisant04<hex>;encoding=hex.pd_parameterl’ajoute comme paramètre distinct, produisant<hex>;pd=04;encoding=hex.
Talkdesk transmet la valeur sans la modifier, omettez donc le discriminateur de protocole. Genesys Cloud
supprime le premier octet de la charge utile, sauf si un discriminateur est présent. Incluez donc un
protocol_discriminator. Consultez les formats de données UUI de Genesys.
La limite de 256 octets s’applique après le remplacement des variables dynamiques. Transmettez des identifiants ou des codes courts, tels qu’un identifiant de compte, et non du texte libre comme un résumé complet de l’appel, qui dépasse la limite et est supprimé du transfert.
Pour recevoir des UUI lors d’appels SIP entrants, aucune configuration n’est requise. Lorsqu’un INVITE entrant contient un en-tête User-to-User, sa valeur est exposée à l’agent sous la forme des variables dynamiques {{sip_uui_raw}} et {{sip_uui_data}}. Consultez la référence SIP.
Activer le transfert vers un intervenant humain
Ajouter l’outil de transfert
Activez le transfert vers un intervenant humain en sélectionnant l’outil système transfer_to_number dans la configuration de votre agent, dans l’onglet Agent. Choisissez « Transfer to Human » lors de l’ajout d’un outil.
Configurer la description de l’outil (facultatif)
Vous pouvez fournir une description personnalisée pour indiquer au LLM quand déclencher un transfert. Si vous la laissez vide, une description par défaut listant les règles de transfert du fournisseur de téléphonie de l’appel actuel est utilisée.
(Configurations héritées uniquement) Passer aux règles de transfert par fournisseur
Ignorez cette étape, sauf si l’outil utilise encore les transferts hérités. Dans Human Transfer Rules, sélectionnez Per-provider. Les règles par fournisseur vous permettent de configurer le déroulement de chaque transfert sur chaque fournisseur de téléphonie utilisé par votre agent (Twilio, trunk SIP, Exotel), et elles donnent accès à toutes les nouvelles options de transfert.
Vos transferts hérités sont convertis en règles par fournisseur équivalentes lors du changement. Le comportement des appels existants ne change pas tant que vous ne modifiez pas les règles.
Un outil utilise soit les transferts hérités, soit les règles par fournisseur, jamais les deux. La configuration héritée applique un type de transfert unique à chaque fournisseur et ne bénéficie pas des nouveaux fournisseurs ni des nouvelles options de transfert.
Ajouter une règle et sa condition
Cliquez sur Add Rule et renseignez la Condition : une description en langage naturel précisant quand l’agent doit utiliser ce transfert (par exemple, « L’utilisateur demande explicitement à parler à un interlocuteur humain » ou « L’utilisateur doit mettre à jour des informations de compte sensibles »). La condition peut inclure des variables dynamiques.
Le LLM utilise ces conditions, ainsi que la description de l’outil, pour décider quand et vers quelle destination transférer l’appel. Lorsque l’agent sélectionne une destination qui n’existe pas et qu’une seule destination est configurée, celle-ci est utilisée. S’il y en a plusieurs, le transfert est rejeté et les options valides sont indiquées à l’agent.
Ajouter une configuration pour chaque fournisseur de téléphonie
Sous Provider configuration, ajoutez une entrée pour chaque fournisseur de téléphonie sur lequel l’agent peut recevoir des appels. Une nouvelle règle commence avec les fournisseurs des numéros de téléphone attribués à l’agent. Cliquez sur + pour en ajouter d’autres.
Chaque fournisseur ne peut être configuré qu’une fois par règle.
Définissez ensuite la destination :
- Type de destination : Phone Number ou SIP URI. Seul SIP REFER peut effectuer un transfert vers une URI SIP. Tous les autres types de transfert nécessitent un numéro de téléphone.
- Phone Number / SIP URI : la cible au format approprié, saisie directement ou sous forme de variable dynamique (par exemple
{{phone_number}}) :- Numéros de téléphone : format E.164 (par exemple +12125551234)
- URI SIP : format SIP (par exemple sip:1234567890@example.com)
Une règle n’existe que pour les appels dont le fournisseur dispose d’une configuration. Si un appel utilise un numéro de trunk SIP et que la règle ne possède qu’une configuration Twilio, l’agent ne peut pas proposer ce transfert pendant l’appel.
Les transferts SIP REFER nécessitent le protocole SIP pendant la conversation, et votre trunk SIP doit autoriser le transfert via SIP REFER.
Deux règles ne peuvent pas pointer vers la même destination chez le même fournisseur, car l’agent ne pourrait pas les distinguer. Vous pouvez toujours modifier la condition pour inclure les deux cas.
Implémentation de l’API
Vous pouvez configurer l’outil système transfer_to_number lors de la création ou de la mise à jour d’un agent via l’API (Créer un agent, Mettre à jour un agent). L’outil permet de définir des messages à la fois pour le client (l’utilisateur transféré) et pour l’agent (l’opérateur humain qui reçoit l’appel).
Référence de la documentation API
Configuration héritée
Documentation sur les transferts hérités
Types de transfert
Le système prend en charge trois types de transferts :
- Transfert avec conférence : comportement par défaut qui appelle la destination et ajoute le participant à une salle de conférence, puis retire l’agent IA afin que seuls l’appelant et le participant transféré restent présents. Avec l’intégration Twilio native, prend en charge un message de transfert assisté (
agent_message) lu à l’intervenant humain. - Transfert aveugle : transfère l’appel directement vers la destination, sans message de transfert assisté destiné à l’intervenant humain. Préserve l’identifiant de l’appelant d’origine. Disponible uniquement lorsque le numéro de téléphone de l’agent est importé via l’intégration Twilio native.
- Transfert SIP REFER : utilise le protocole SIP REFER pour transférer les appels directement vers la destination. Fonctionne avec les numéros de téléphone et les URI SIP, mais est disponible uniquement lorsque le protocole SIP est utilisé pendant la conversation et requiert que votre trunk SIP autorise le transfert via SIP REFER. Ne prend pas en charge les messages de transfert assisté.
Les messages de transfert assisté (agent_message) sont disponibles uniquement lorsque le numéro de téléphone de l’agent est
importé via l’intégration Twilio
native. Les transferts basés sur SIP
ne prennent pas en charge les messages de transfert assisté.
Les transferts aveugles sont disponibles uniquement lorsque le numéro de téléphone de l’agent est importé via l’intégration
Twilio native et
doivent actuellement être configurés via l’éditeur JSON de l’interface utilisateur. Sélectionnez « Edit as JSON » dans la configuration de l’outil de
transfert et définissez "transfer_type": "blind" pour la règle de transfert souhaitée.
Objectif : Transférer de manière fluide les conversations à des opérateurs humains lorsque l’assistance de l’IA ne suffit pas.
Conditions de déclenchement : le LLM doit appeler cet outil lorsque :
- Des problèmes complexes nécessitent un jugement humain
- L’utilisateur demande explicitement une assistance humaine
- L’IA atteint les limites de ses capacités pour la demande concernée
- Les protocoles d’escalade sont déclenchés
Paramètres :
reason(chaîne, facultatif) : la raison du transferttransfer_number(chaîne, obligatoire) : le numéro de téléphone vers lequel transférer l’appel, il doit correspondre aux numéros configurésclient_message(chaîne, obligatoire) : message lu au client pendant l’attente du transfertagent_message(chaîne, obligatoire) : message destiné à l’opérateur humain qui reçoit l’appel
Format d’appel de fonction :
Mise en œuvre : configurez les numéros de téléphone et les conditions de transfert. Définissez les messages destinés au client et à l’opérateur humain qui reçoit l’appel. Compatible avec Twilio et le trunking SIP.
Numéros vers lesquels effectuer un transfert
Le transfert vers un intervenant humain permet de transférer vers des numéros de téléphone externes à l’aide du trunking SIP et des numéros de téléphone Twilio.
Activer le transfert vers un intervenant humain
Le transfert vers un intervenant humain se configure à l’aide de l’outil système transfer_to_number.
Ajouter l’outil de transfert
Activez le transfert vers un intervenant humain en sélectionnant l’outil système transfer_to_number dans la configuration de votre agent, sous l’onglet Agent. Lors de l’ajout d’un outil, choisissez « Transfer to Human ».

Configurer la description de l’outil (facultatif)
Vous pouvez fournir une description personnalisée pour indiquer au LLM quand déclencher un transfert. Si vous la laissez vide, la description par défaut, qui englobe les règles de transfert définies, sera utilisée.

Définir les règles de transfert
Configurez les règles spécifiques de transfert vers des numéros de téléphone ou des URI SIP. Pour chaque règle, indiquez :
- Type de transfert : choisissez entre les méthodes de transfert avec conférence (par défaut), aveugle ou SIP REFER
- Type de numéro : sélectionnez Téléphone pour les numéros de téléphone classiques ou URI SIP pour les adresses SIP
- Numéro de téléphone/URI SIP : la destination cible au format approprié :
- Numéros de téléphone : format E.164 (par exemple, +12125551234)
- URI SIP : format SIP (par exemple, sip:1234567890@example.com)
- Condition : description en langage naturel des circonstances dans lesquelles le transfert doit avoir lieu (par exemple, « L’utilisateur demande explicitement à parler à un intervenant humain », « L’utilisateur doit mettre à jour des informations sensibles de son compte »).
Le LLM utilisera ces conditions, ainsi que la description de l’outil, pour décider quand effectuer un transfert et vers quelle destination.
Les transferts SIP REFER requièrent le protocole SIP pendant la conversation, et votre trunk SIP doit autoriser le transfert via SIP REFER. Seul SIP REFER permet un transfert vers une URI SIP.
Les transferts aveugles sont disponibles uniquement lorsque le numéro de téléphone de l’agent est importé via l’intégration Twilio native et doivent être configurés via l’éditeur JSON. L’identifiant de l’appelant d’origine est préservé, mais aucun message de transfert assisté n’est envoyé à l’intervenant humain.

Vérifiez que les destinations sont correctement formatées :
- Numéros de téléphone : format E.164 et associés à un compte correctement configuré
- URI SIP : format SIP valide (sip:user@domain ou sips:user@domain)
Configurer des en-têtes SIP REFER personnalisés (facultatif)
Lorsque vous utilisez des transferts SIP REFER, vous pouvez inclure des en-têtes SIP personnalisés afin de transmettre des informations supplémentaires au système destinataire.
Pour chaque en-tête personnalisé, indiquez :
- Nom de l’en-tête : le nom de l’en-tête SIP (par exemple,
X-Customer-ID,X-Priority) - Valeur de l’en-tête : la valeur de l’en-tête, qui peut être du texte statique ou inclure des variables dynamiques
Les en-têtes SIP REFER personnalisés sont inclus uniquement avec les transferts SIP REFER. Les transferts avec conférence ne prennent pas en charge les en-têtes personnalisés.
Les en-têtes système X-Conversation-ID et X-Caller-ID sont automatiquement inclus par ElevenLabs et remplacent tout en-tête personnalisé portant le même nom, sans distinction entre majuscules et minuscules.
Configurer les informations utilisateur à utilisateur (UUI) (facultatif)
Les transferts SIP REFER peuvent transmettre des informations utilisateur à utilisateur (UUI), une petite charge utile livrée à la plateforme destinataire, par exemple Talkdesk ou Genesys Cloud, dans le paramètre User-to-User de l’en-tête Refer-To. Les UUI sont envoyées uniquement lors des transferts SIP REFER vers une destination URI SIP ; les destinations de numéro de téléphone (tel:) ne les transmettent pas.
Configurez les UUI pour chaque règle de transfert avec l’objet uui :
data: la charge utile à envoyer, en texte brut. ElevenLabs l’encode en hexadécimal et ajoute;encoding=hex. Elle peut être du texte statique ou inclure des variables dynamiques. Limite de 256 octets (UTF-8), appliquée après le remplacement des variables dynamiques. Pour du texte ASCII brut, cela représente 256 caractères, moins pour les caractères sur plusieurs octets.protocol_discriminator: un seul octet hexadécimal, par exemple04. Incluez-le pour les plateformes qui suppriment le premier octet de la charge utile ; omettez-le pour celles qui transmettent la charge utile telle quelle.protocol_discriminator_mode:prefix(par défaut) ajoute l’octet au début et produit04<hex>;encoding=hex.pd_parameterl’ajoute comme paramètre distinct et produit<hex>;pd=04;encoding=hex.
Talkdesk transmet la valeur telle quelle ; omettez donc le discriminateur de protocole. Genesys Cloud supprime le premier octet de la charge utile à moins qu’un discriminateur soit présent ; incluez donc un protocol_discriminator. Consultez les formats de données UUI de Genesys.
La limite de 256 octets s’applique après le remplacement des variables dynamiques. Transmettez des identifiants ou des codes courts, comme un identifiant de compte, et non du texte libre tel qu’un résumé complet de l’appel, qui dépasse la limite et est exclu du transfert.
Aucune configuration n’est requise pour recevoir des UUI sur les appels SIP entrants. Lorsqu’une requête INVITE entrante contient un en-tête User-to-User, sa valeur est exposée à l’agent sous forme de variables dynamiques {{sip_uui_raw}} et {{sip_uui_data}}. Consultez la référence SIP.
Configurer les chiffres post-composition (facultatif)
Les chiffres post-composition sont des tonalités DTMF retransmises une fois que le téléphone est connecté à la destination du transfert. Ils sont utiles pour saisir automatiquement des extensions ou naviguer dans les menus SVI (serveur vocal interactif).
Pour chaque règle de transfert, vous pouvez indiquer une chaîne post_dial_digits contenant :
- Chiffres (
0-9) : tonalités DTMF standard w: délai de 0,5 secondeW: délai de 1 seconde*et#: tonalités DTMF spéciales
Par exemple, ww1234 attend 1 seconde après la connexion de l’appel, puis compose l’extension 1234.
Les chiffres post-composition sont disponibles uniquement lorsque le numéro de téléphone de l’agent, c’est-à-dire le numéro qui initie le transfert, est importé via l’intégration Twilio native. Le numéro de destination peut être n’importe quel numéro de téléphone.
Les chiffres post-composition sont pris en charge uniquement pour les types de transfert avec conférence et aveugle. Les transferts SIP REFER ne prennent pas en charge les chiffres post-composition.
Implémentation de l’API
Vous pouvez configurer l’outil système transfer_to_number lors de la création ou de la mise à jour d’un agent via l’API (Créer un agent, Mettre à jour un agent). L’outil permet de spécifier des messages à la fois pour le client, c’est-à-dire l’utilisateur transféré, et pour l’agent, c’est-à-dire l’intervenant humain qui reçoit l’appel.