Passer à la navigation

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 w correspond à une pause de 0,5 s
  • Chaque W correspond à 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 exemple 04. 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, produisant 04<hex>;encoding=hex. pd_parameter l’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

1

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.

2

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.

3

(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.

4

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.

5

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).

from elevenlabs import AgentConfig, ConversationalConfig, ElevenLabs
elevenlabs = ElevenLabs(api_key="YOUR_API_KEY")
billing_destination = {"type": "phone", "destination": "+15551234567"}
human_destination = {"type": "phone", "destination": "+15559876543"}
# Each rule lists one config per telephony provider. A call only sees the rules
# that have a config for its provider (twilio, sip_trunk or exotel).
transfer_rules = [
{
"condition": "When the user asks for billing support.",
"provider_configs": [
{
"type": "twilio",
"config": {
"type": "twilio_warm_conference_transfer",
"transfer_destination": billing_destination,
# Wait 1s, then dial extension 1234 (Twilio only)
"post_dial_digits": {"type": "static", "value": "ww1234"},
},
},
{
"type": "sip_trunk",
"config": {
"type": "sip_cold_conference_transfer",
"transfer_destination": billing_destination,
},
},
{
"type": "exotel",
"config": {
"type": "exotel_warm_transfer",
"transfer_destination": billing_destination,
},
},
],
},
{
"condition": "When the user asks to speak to a human.",
"provider_configs": [
{
"type": "twilio",
"config": {
# Preserves caller ID, no warm transfer message
"type": "twilio_cold_blind_transfer",
"transfer_destination": human_destination,
},
},
{
"type": "exotel",
"config": {
"type": "exotel_cold_blind_transfer",
"transfer_destination": human_destination,
},
},
],
},
{
"condition": "When the user requests to file a formal complaint.",
"provider_configs": [
{
"type": "sip_trunk",
"config": {
"type": "sip_cold_refer_transfer",
"transfer_destination": {"type": "sip_uri", "destination": "sip:support@example.com"},
"custom_sip_headers": [
{"type": "static", "key": "X-Department", "value": "complaints"},
{"type": "static", "key": "X-Priority", "value": "high"},
# "dynamic" takes the dynamic variable's name, without {{ }}
{"type": "dynamic", "key": "X-Customer-ID", "value": "customer_id"},
],
"uui": {
"data": "account_id={{customer_id}}",
"protocol_discriminator": "04", # Genesys Cloud; omit for Talkdesk
"protocol_discriminator_mode": "prefix", # or "pd_parameter"
},
},
},
],
},
]
response = elevenlabs.conversational_ai.agents.create(
conversation_config=ConversationalConfig(
agent=AgentConfig(
first_message="Hi, how can I help you today?",
prompt={
"prompt": "You are a helpful assistant.",
"built_in_tools": {
"transfer_to_number": {
"type": "system",
"name": "transfer_to_number",
"description": "Transfer the user to a human operator based on their request.",
"params": {
"system_tool_type": "transfer_to_number",
# Still required, and must be empty when transfer_rules is set
"transfers": [],
"transfer_rules": transfer_rules,
},
}
},
},
),
),
)

Référence de la documentation API

Configuration héritée

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 transfert
  • transfer_number (chaîne, obligatoire) : le numéro de téléphone vers lequel transférer l’appel, il doit correspondre aux numéros configurés
  • client_message (chaîne, obligatoire) : message lu au client pendant l’attente du transfert
  • agent_message (chaîne, obligatoire) : message destiné à l’opérateur humain qui reçoit l’appel

Format d’appel de fonction :

{
"type": "function",
"function": {
"name": "transfer_to_number",
"arguments": "{\"reason\": \"Complex billing issue\", \"transfer_number\": \"+15551234567\", \"client_message\": \"I'm transferring you to a billing specialist who can help with your account.\", \"agent_message\": \"Customer has a complex billing dispute about order #12345 from last month.\"}"
}
}

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.

1

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 ».

Ajouter l’outil de transfert vers un intervenant humain
Sélectionner l’outil « Transfer to Human »
2

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.

Description de l’outil de transfert vers un intervenant humain
Configurer la description de l’outil de transfert
3

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.

Configuration des règles de transfert vers un intervenant humain
Définir des règles de transfert avec un numéro de téléphone et une condition

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)
4

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.

5

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 exemple 04. 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 produit 04<hex>;encoding=hex. pd_parameter l’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.

6

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 seconde
  • W : 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.

from elevenlabs import AgentConfig, ConversationalConfig, ElevenLabs
elevenlabs = ElevenLabs(api_key="YOUR_API_KEY")
# Define transfer rules
transfer_rules = [
{
"transfer_destination": {"type": "phone", "phone_number": "+15551234567"},
"condition": "When the user asks for billing support.",
"transfer_type": "conference",
# Wait 1s, then dial extension 1234 (native Twilio only)
"post_dial_digits": {"type": "static", "value": "ww1234"},
},
{
"transfer_destination": {"type": "phone", "phone_number": "+15559876543"},
"condition": "When the user asks to speak to a human.",
# Native Twilio integration only, preserves caller ID, no warm transfer message
"transfer_type": "blind",
},
{
"transfer_destination": {"type": "sip_uri", "sip_uri": "sip:support@example.com"},
"condition": "When the user requests to file a formal complaint.",
"transfer_type": "sip_refer",
"custom_sip_headers": [
{"type": "static", "key": "X-Department", "value": "complaints"},
{"type": "static", "key": "X-Priority", "value": "high"},
# Use "dynamic" to read the value from a dynamic variable
{"type": "dynamic", "key": "X-Customer-ID", "value": "{{customer_id}}"},
],
"uui": {
"data": "account_id={{customer_id}}",
"protocol_discriminator": "04", # Genesys Cloud; omit for Talkdesk
"protocol_discriminator_mode": "prefix", # or "pd_parameter"
},
},
]
response = elevenlabs.conversational_ai.agents.create(
conversation_config=ConversationalConfig(
agent=AgentConfig(
first_message="Hi, how can I help you today?",
prompt={
"prompt": "You are a helpful assistant.",
"built_in_tools": {
"transfer_to_number": {
"type": "system",
"name": "transfer_to_number",
# Optional custom description
"description": "Transfer the user to a human operator based on their request.",
"params": {
"system_tool_type": "transfer_to_number",
"transfers": transfer_rules,
},
}
},
},
),
),
)
# Note: When the LLM decides to call this tool, it needs to provide:
# - transfer_number: The phone number to transfer to (must match one defined in rules).
# - client_message: Message read to the user during transfer.
# - agent_message: Message read to the human operator receiving the call (native Twilio integration only, not used for blind transfers or SIP).