Configurar

Personalización

Aprende a personalizar el comportamiento de tu agente mediante variables dinámicas y anulaciones.

Descripción general

La personalización te permite adaptar el comportamiento de tu agente a cada usuario, lo que facilita conversaciones más naturales y relevantes según el contexto. ElevenLabs ofrece varios enfoques de personalización:

  1. Variables dinámicas: inserta valores en tiempo de ejecución en prompts y mensajes.
  2. Anulaciones: sustituye por completo los prompts o mensajes del sistema.
  3. Webhooks de inicio de conversación: obtén esos datos de tu servidor cuando se inicie una conversación.

Métodos de personalización

Variables dinámicas

Define valores en tiempo de ejecución con la sintaxis {{ var_name }} para personalizar los mensajes, prompts del sistema y herramientas de tu agente.

Anulaciones

Sustituye por completo los prompts del sistema, los primeros mensajes, el idioma o los ajustes de voz de cada conversación.

Webhooks de inicio de conversación

Obtén variables dinámicas y anulaciones de tu servidor para conversaciones entrantes.

Estructura de datos del cliente para el inicio de conversación

El objeto conversation_initiation_client_data define qué se puede personalizar al iniciar una conversación. Los clientes pueden enviarlo directamente. Un webhook de inicio de conversación devuelve el mismo objeto.

{
  "type": "conversation_initiation_client_data",
  "conversation_config_override": {
    "agent": {
      "prompt": {
        "prompt": "overriding system prompt",
        "llm": "gpt-5.6-luna"
      },
      "first_message": "overriding first message",
      "language": "en"
    },
    "tts": {
      "voice_id": "voice-id-here"
    },
    "conversation": {
      "text_only": false
    },
    "asr": {
      "keywords": ["Acme Corp", "Contoso"]
    }
  },
  "custom_llm_extra_body": {
    "temperature": 0.7,
    "max_tokens": 100
  },
  "dynamic_variables": {
    "string_var": "text value",
    "number_var": 1.2,
    "integer_var": 123,
    "boolean_var": true
  },
  "user_id": "your_custom_user_id",
  "branch_id": "agtbrch_xxxx",
  "environment": "production"
}

Las variables dinámicas del sistema (las que tienen el prefijo system__) no se pueden enviar ni anular en la carga útil de inicio del cliente. Solo se pueden establecer variables dinámicas personalizadas mediante el campo dynamic_variables.

Webhooks de inicio de conversación

Para telefonía y mensajería entrantes, ElevenAgents puede obtener estos datos de inicio de tu servidor en lugar de hacerlo del cliente. Cuando el webhook está activado, ElevenAgents envía una solicitud POST y aplica el JSON que devuelvas.

Configura la URL del webhook y los secretos de las cabeceras en la configuración de Agents. En la pestaña Seguridad del agente, activa Obtener datos del cliente de inicio desde un webhook y todos los campos de anulación que pueda incluir tu respuesta.

El webhook se ejecuta para una nueva conversación entrante en Twilio Voice, Exotel, troncal SIP, WhatsApp o Twilio SMS cuando todavía no existen datos de inicio del cliente.

Las llamadas salientes de Twilio Voice, Exotel, SIP y WhatsApp solo lo activan si la solicitud saliente no incluía conversation_initiation_client_data. Los mensajes salientes de WhatsApp nunca lo activan; pasa las variables dinámicas en la solicitud saliente.

No se ejecuta para conversaciones de widgets o SDK, otras integraciones de mensajería ni hilos reanudados de WhatsApp y SMS.

Las conversaciones de vista previa iniciadas desde la página de configuración del agente no activan webhooks de inicio de conversación. Usa los marcadores de posición de Variables dinámicas en el editor del agente mientras realizas pruebas en Vista previa. Esos marcadores de posición no se usan en conversaciones entrantes de producción.

ElevenAgents envía el contexto de quien llama en el cuerpo de la solicitud:

{
  "caller_id": "+15551234567",
  "called_number": "+15557654321",
  "agent_id": "agent_7101k5zvyjhmfg983brhmhkd98n6",
  "call_sid": "CAaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
  "conversation_id": "conv_8901k5zvyjhmfg983brhmhkd98n6"
}

caller_id y called_number son números de teléfono en Twilio, Exotel, SIP y SMS. En WhatsApp entrante, son el ID de usuario de WhatsApp y el ID de número de teléfono de WhatsApp. En las llamadas salientes, caller_id es tu número y called_number es la persona a la que se llama. call_sid es el SID de llamada del proveedor en telefonía y una cadena vacía en WhatsApp y SMS. Las llamadas SIP también pueden incluir call_id y sip_headers.

Tu respuesta debe usar la estructura conversation_initiation_client_data anterior. Incluye todas las variables dinámicas personalizadas que defina el agente. Las anulaciones son opcionales y deben activarse en Seguridad. El cuerpo de la respuesta HTTP debe tener 256 KB o menos (262.144 bytes).

Un webhook que falle o agote el tiempo de espera puede impedir que se inicie la conversación. Para configurar Twilio, consulta la personalización de Twilio. Este webhook es independiente de los webhooks posteriores a la llamada.

Elegir el enfoque adecuado

MétodoIdeal paraImplementación
Variables dinámicas
  • Insertar datos específicos de cada usuario en contenido con plantilla - Mantener un comportamiento coherente del agente con detalles personalizados - Personalizar parámetros de herramientas
Define variables con {{ variable_name }} y pasa valores en tiempo de ejecución
Anulaciones
  • Cambiar por completo el comportamiento del agente según el usuario - Cambiar idiomas o voces - Aplicaciones heredadas (considera migrar a Variables dinámicas)

Activa permisos de anulación específicos en la configuración de seguridad y pasa contenido de sustitución completo

Webhooks de inicio de conversación
  • Personalizar conversaciones entrantes de Twilio, SIP, WhatsApp o SMS desde tu servidor - Consultar el contexto de quien llama antes de que se inicie la conversación

Activa el webhook en la configuración de Seguridad y devuelve conversation_initiation_client_data

Más información