> This is a page from the ElevenLabs documentation. For a complete page index, fetch https://elevenlabs.io/docs/llms.txt. For the full documentation in a single file, fetch https://elevenlabs.io/docs/llms-full.txt.

# WhatsApp

## Resumen

Puedes conectar tu cuenta de WhatsApp Business a un agente de ElevenLabs. El agente podrá gestionar:

* Conversaciones por mensajes: texto, notas de voz, contenido multimedia y [mensajes interactivos](/docs/es/eleven-agents/whatsapp/interactive-messages)
* Llamadas: entrantes y [salientes](/docs/es/eleven-agents/whatsapp/outbound#scheduling-an-outbound-call)

Los agentes de otros canales también pueden enviar mensajes de WhatsApp mediante [herramientas de WhatsApp](/docs/es/eleven-agents/whatsapp/tools).

¿Es la primera vez que usas WhatsApp en ElevenLabs? Sigue la [guía de primeros pasos](/docs/es/eleven-agents/whatsapp/getting-started).

## Importar una cuenta de WhatsApp Business

#### Importa tu cuenta

Ve a la [página de WhatsApp](https://elevenlabs.io/app/agents/whatsapp) y haz clic en el botón ***Importar cuenta***:

![Página de WhatsApp](/docs/_fern-img/734d6e0c2af1c50b769700e084368bed2a8c7eccf47aece6cfb6fc5ca7623f44.webp)

#### Autoriza a ElevenLabs

Se abrirá el proceso de autorización, donde podrás seleccionar tu cuenta y dar permiso a ElevenLabs para gestionarla:

![Proceso de autorización de WhatsApp](/docs/_fern-img/9e5238e98f926582db314e9debc187a7dc29fd38a980cb732b4563b373110351.webp)

#### Asigna un agente

Cuando termines de importar tu cuenta, irás a su página de configuración, donde podrás asignarle un agente:

![Página de cuenta de WhatsApp](/docs/_fern-img/f5598ac70ade00048effb5ee3bf6cbc93cd61876652eb3ce5917ac21c6209bf6.webp)

> **Info**
>
> Si no asignas un agente a tu cuenta, los mensajes entrantes se ignorarán y las llamadas entrantes
> se rechazarán. Sin embargo, podrás seguir haciendo llamadas salientes.

#### Configura WhatsApp Manager

Ve a [WhatsApp Manager](https://business.facebook.com/latest/whatsapp_manager/) para:

* Configurar tu foto de perfil, etc.: abre la página ***Números de teléfono***, selecciona un número de teléfono y ve a la pestaña ***Perfil***
* Permitir llamadas de voz: abre la página ***Números de teléfono***, selecciona un número de teléfono y ve a la pestaña ***Configuración de llamadas***
* Si quieres hacer llamadas salientes, añade un método de pago: abre la página ***Resumen*** y haz clic en el botón ***Añadir método de pago***

## Configuración de la cuenta

Cada número importado tiene ajustes que controlan el comportamiento del agente:

* **Activar mensajería**: determina si el agente responde a los mensajes. Desactívalo para que ElevenLabs gestione solo las llamadas mientras tu propia aplicación gestiona los mensajes.
* **Activar respuesta a mensajes de audio**: cuando está activado (de forma predeterminada), el agente responde a las notas de voz con notas de voz; cuando está desactivado, siempre responde con texto.
* **Activar indicador de escritura**: cuando está activado (de forma predeterminada), el agente marca los mensajes entrantes como leídos y muestra un indicador de escritura mientras redacta su respuesta.

## Conversaciones por mensajes

Las conversaciones por mensajes de WhatsApp terminan cuando el agente usa la herramienta de sistema [***Finalizar conversación***](/docs/es/eleven-agents/customization/tools/system-tools/end-call), transcurre la ***Duración máxima de la conversación*** configurada o transcurre el tiempo de espera predeterminado por inactividad desde la respuesta más reciente del agente.

> **Info**
>
> Las conversaciones por mensajes de WhatsApp tienen un tiempo de espera predeterminado por inactividad de 15 minutos, medido desde la respuesta más reciente del agente. Más información sobre los [tiempos de espera de las conversaciones](/docs/es/eleven-agents/customization/conversation-flow#maximum-conversation-duration).

### Entrantes

Puedes enviar un mensaje a tu cuenta de WhatsApp Business y el agente responderá:

![Conversación de texto de WhatsApp](/docs/_fern-img/4c31b4d2b5eccccd7cddfa81144176a6d3c32f4670add5306f3a6ef78bc05244.webp)

Cuando vence cualquiera de los tiempos de espera, ElevenAgents envía el ***mensaje de duración máxima de la conversación*** configurado antes de cerrar la conversación. Si el mensaje está vacío, la conversación se cierra sin despedida.

El agente entiende más que texto sin formato:

* **Respuestas citadas**: cuando el usuario mantiene pulsado un mensaje y responde a él, el agente sabe a qué mensaje está respondiendo.
* **Reacciones**: las reacciones con emoji a los mensajes del agente se transmiten al agente.
* **Pulsaciones en botones de plantilla**: cuando el usuario pulsa un botón de respuesta rápida en una plantilla, el agente ve qué botón se ha elegido.
* **Respuestas interactivas**: las pulsaciones en [botones y listas interactivos](/docs/es/eleven-agents/whatsapp/interactive-messages) llegan con la opción seleccionada.

> **Note**
>
> El agente responde a cada mensaje entrante de forma individual. Los mensajes consecutivos enviados rápidamente no se agrupan en una única respuesta.

### Salientes

Puedes iniciar una conversación enviando una plantilla de mensaje aprobada por Meta, desde el panel de control o la API, y programar llamadas salientes con una solicitud de permiso para llamar. Consulta [Mensajes y plantillas salientes](/docs/es/eleven-agents/whatsapp/outbound) para crear plantillas, ver ejemplos de código, conocer las reglas de formato de los destinatarios y gestionar campañas por lotes.

### Tipos de mensajes

Además de texto, también puedes enviar:

* audio
  * Las notas de voz entrantes se transcriben a texto antes de pasarse al agente.
  * De forma predeterminada, el agente responde a las notas de voz con notas de voz, generadas con la voz configurada del agente: cualquier voz, cualquier idioma. Desactiva ***Activar respuesta a mensajes de audio*** en la configuración de la cuenta para responder siempre con texto. Si falla la generación de audio, el agente recurre a una respuesta de texto.
  * Los mensajes de audio generan cargos adicionales por conversión de voz a texto y de texto a voz. El precio es el mismo que en las API de STT y TTS.
* imagen
* documento
* sticker
* ubicación
* contacto

![Conversación de audio de WhatsApp](/docs/_fern-img/372158bc0f86d62b6742f2bb44a741e5299ee7b95e36e38c3df1f9c06cffe2a0.webp)![Conversación de imágenes de WhatsApp](/docs/_fern-img/cbfbadb9d0a20f35537ce3bd137eb12b1005a862a7e1cf0155d271502fb713da.webp)![Conversación de documentos de WhatsApp](/docs/_fern-img/2b91d4077ac19a56dda9c5c016a47ed7d574ba2cb77ac89eb8785925bc89fa13.webp)![Conversación de ubicaciones de WhatsApp](/docs/_fern-img/bcd0d8f7df69d6c381be5be7c7a91ec7752b2b1894a80539823b7d9266beb3dd.webp)![Conversación de contactos de WhatsApp](/docs/_fern-img/75e56544700c87817a7f842943301a95e9e0b1fb84fc87e19139adb77f49ea5a.webp)

## Llamadas

### Entrantes

Puedes llamar a tu cuenta de WhatsApp Business y el agente responderá. Durante la llamada, también puedes enviar mensajes de texto y se incorporarán a la conversación.

### Salientes

Las llamadas salientes requieren el permiso del usuario, que se solicita mediante una plantilla. Consulta [programar una llamada saliente](/docs/es/eleven-agents/whatsapp/outbound#scheduling-an-outbound-call) para conocer el proceso, ver ejemplos de código y hacer llamadas por lotes.

## Personalización

Establecemos las [variables dinámicas](/docs/es/eleven-agents/customization/personalization/dynamic-variables) `{{system__caller_id}}` y `{{system__called_number}}` con el ID de usuario de WhatsApp y el ID de tu número de teléfono de WhatsApp (o a la inversa, según quién haya iniciado la conversación). Puedes usarlas en una herramienta o en un [webhook de inicio de conversación](/docs/es/eleven-agents/customization/personalization#conversation-initiation-webhooks) para obtener información sobre tu usuario durante la conversación.

> **Info**
>
> Puedes encontrar el ID de tu número de teléfono de WhatsApp en la [página de WhatsApp](https://elevenlabs.io/app/agents/whatsapp), haciendo clic en el menú junto a tu cuenta y seleccionando ***Copiar ID de número de teléfono***.

### Contexto de inicialización

Si tu agente utiliza [variables dinámicas](/docs/es/eleven-agents/customization/personalization/dynamic-variables) además de las variables de sistema anteriores, tendrás que planificar de dónde proceden sus valores. Si tu agente no utiliza variables dinámicas, nada de esto se aplica.

Las **conversaciones entrantes** empiezan sin variables dinámicas proporcionadas por el usuario. La forma compatible de proporcionar valores es mediante un [webhook de inicio de conversación](/docs/es/eleven-agents/customization/personalization#conversation-initiation-webhooks): cuando un mensaje de WhatsApp inicia una conversación, ElevenAgents llama a tu ruta de API con el ID de usuario de WhatsApp como `caller_id` y el ID de tu número de teléfono de WhatsApp como `called_number`, y aplica las variables dinámicas que devuelve tu respuesta. Haz que el webhook devuelva siempre todas las variables que requiere el agente: un valor del CRM cuando lo tengas o una constante alternativa en caso contrario.

> **Warning**
>
> Los valores introducidos en **Variables dinámicas** en el editor de agentes son marcadores de posición de prueba para previsualizar el agente. No se usan en producción ni actúan como valores predeterminados para las conversaciones entrantes.

Las **conversaciones salientes** reciben sus valores del campo `conversation_initiation_client_data.dynamic_variables` de la [solicitud de mensaje o llamada saliente](/docs/es/eleven-agents/whatsapp/outbound#dynamic-variables-branches-and-environments). Estos valores se conservan durante la conversación y siguen estando disponibles cuando responde el usuario. Los parámetros de plantilla son un campo independiente y no rellenan las variables dinámicas.

Una variable obligatoria que termine sin valor hará que la conversación falle. Consulta [variables dinámicas ausentes](/docs/es/eleven-agents/whatsapp/troubleshooting#the-agent-doesnt-respond-to-inbound-messages) en la guía de resolución de problemas.

> **Note**
>
> El valor de `system__called_number` es el **ID de número de teléfono** de WhatsApp, no el número de teléfono en sí. Los identificadores de usuario de WhatsApp también están migrando a [Business-Scoped User IDs (BSUIDs)](https://developers.facebook.com/documentation/business-messaging/whatsapp/business-scoped-user-ids); ElevenAgents admite BSUID, por lo que las conversaciones funcionan incluso cuando Meta proporciona un ID en lugar del número de teléfono del usuario.

## Limitaciones

Actualmente no se admite lo siguiente:

* **WhatsApp Flows**: no se pueden enviar formularios interactivos y las respuestas de Flow no se transmiten al agente.
* **Mensajes de vídeo**: los vídeos entrantes no se transmiten al agente.
* **Agrupación de mensajes**: el agente responde a cada mensaje de forma individual en lugar de agrupar mensajes consecutivos enviados rápidamente.
* **Números gestionados por otro proveedor**: no se puede importar un número registrado con otro proveedor de WhatsApp o activo en la aplicación WhatsApp Business. Estamos trabajando con Meta para habilitar [Multi-Solution Conversations](https://developers.facebook.com/documentation/business-messaging/whatsapp/solution-providers/multi-solution-conversations); las configuraciones solo de voz ya podrían ser posibles mediante SIP (consulta las [preguntas frecuentes](/docs/es/eleven-agents/whatsapp/troubleshooting#faq)).
* **WABA creadas en una aplicación de desarrollador**: no se pueden importar mediante el proceso estándar.
* **Metadatos de referencia de anuncios**: los datos de atribución de anuncios Click-to-WhatsApp no se exponen al agente (consulta las [preguntas frecuentes](/docs/es/eleven-agents/whatsapp/troubleshooting#faq)).
* **Transferencia a un agente humano**: próximamente (consulta las [preguntas frecuentes](/docs/es/eleven-agents/whatsapp/troubleshooting#faq)).

## Preguntas frecuentes

Las preguntas habituales sobre precios, configuraciones con varios proveedores, transferencia a un agente humano, modo de retención cero, OTP y cumplimiento normativo tienen respuesta en [Resolución de problemas y preguntas frecuentes](/docs/es/eleven-agents/whatsapp/troubleshooting).