> 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. # Resolución de problemas y preguntas frecuentes ## Mensaje aceptado pero no entregado Una respuesta `200` de la ruta de API de mensajes salientes significa que ElevenLabs aceptó y reenvió la solicitud; la entrega sigue dependiendo de Meta. Si el mensaje nunca llega, comprueba lo siguiente en este orden: 1. **Aprobación de la plantilla** — la plantilla debe tener el estado Aprobada en [WhatsApp Manager](https://business.facebook.com/latest/whatsapp_manager/message_templates). Las plantillas pendientes o rechazadas no se entregan. 2. **Pagos** — la falta de un método de pago o pagos pendientes en tu cuenta de WhatsApp Business bloquean la entrega de plantillas (error 131042 de Meta). Añade o actualiza el método de pago en WhatsApp Manager. 3. **Estructura de los parámetros** — las entradas de `template_params` deben ser objetos de componente (`{"type": "body", "parameters": [...]}`), deben rellenarse todos los marcadores de posición de la plantilla y las plantillas con nombre necesitan un `parameter_name` en cada valor. Consulta los [parámetros de plantilla](/docs/es/eleven-agents/whatsapp/outbound#template-parameters). 4. **Formato del destinatario** — `whatsapp_user_id` solo contiene dígitos con el código de país, sin `+`. Consulta el [formato del número de destinatario](/docs/es/eleven-agents/whatsapp/outbound#recipient-number-format). 5. **Límites de marketing** — Meta limita cuántas [plantillas de marketing](https://developers.facebook.com/documentation/business-messaging/whatsapp/templates/marketing-templates/per-user-limits) puede recibir un usuario durante un periodo (error 131049). Las plantillas de utilidad no están sujetas a este límite. ## Problemas de importación * **No se puede importar el número** — está registrado con otro proveedor de WhatsApp o activo en la app WhatsApp Business. Un número solo puede registrarse con un proveedor; consulta las [Limitaciones](/docs/es/eleven-agents/whatsapp#limitations). * **Tu WABA no aparece en el flujo de importación** — confirma que has iniciado sesión en una cuenta de Facebook con acceso de administrador a la cartera empresarial propietaria del WABA y vuelve a intentar la importación. * **Los WABA creados en una app para desarrolladores de Meta** no se pueden importar mediante el flujo estándar. ### Comprueba si otro socio gestiona el número Un número que parece no ser apto, que no aparece en el flujo de importación o que da error al importarlo suele seguir registrado con un proveedor anterior. Que un socio controle el número explica tanto una importación fallida como un WABA ausente. 1. Ve a [business.facebook.com](https://business.facebook.com) y selecciona la cartera empresarial. 2. Abre **Configuración del negocio** > **Cuentas de WhatsApp**. 3. Comprueba los **Números de teléfono** de cada cuenta de WhatsApp hasta encontrar la que contiene tu número. 4. Abre **Socios**. 5. Desvincula el número de ese socio (o elimina toda la cartera empresarial) y vuelve a intentar la importación unos minutos después. ## El agente no responde a los mensajes entrantes La confirmación de lectura y el indicador de escritura ayudan a acotar la causa: se envían en cuanto se acepta un mensaje para procesarlo, antes de que el agente genere una respuesta. Con **Activar indicador de escritura** activado (la opción predeterminada), envía un mensaje de prueba y comprueba si tu mensaje se marca como leído y aparece el indicador de escritura. **Aparece el indicador de escritura, pero no llega ninguna respuesta.** El mensaje llegó a ElevenLabs y el agente empezó a trabajar; el error se produce al generar o entregar la respuesta: * El agente requiere una [variable dinámica](/docs/es/eleven-agents/customization/personalization/dynamic-variables) que no tiene valor. Las conversaciones entrantes de WhatsApp empiezan sin variables dinámicas proporcionadas por el usuario; solo se completan las variables del sistema. La solución es un [webhook de inicio de conversación](/docs/es/eleven-agents/customization/personalization#conversation-initiation-webhooks) que devuelva todas las variables que requiere el agente; consulta el [contexto de inicialización](/docs/es/eleven-agents/whatsapp#initialization-context). Los valores introducidos en **Variables dinámicas** en el editor de agentes son marcadores de posición para pruebas y no se usan en producción. * Meta rechazó la respuesta del agente; por ejemplo, por un límite de velocidad para esta pareja empresa-usuario o por un problema de pago a nivel de cuenta. Consulta la [referencia de errores](#meta-error-reference) a continuación. La conversación falla si estas variables dinámicas obligatorias no están presentes. **No aparece ningún indicador de escritura.** El mensaje se descartó antes de llegar al agente: * No hay ningún agente asignado al número o el interruptor **Activar mensajería** está desactivado; comprueba la configuración de la cuenta en la [página de WhatsApp](https://elevenlabs.io/app/agents/whatsapp). * La autorización de la cuenta ya no es válida; el token de acceso caducó o se revocó en Meta. Vuelve a importar la cuenta en la [página de WhatsApp](https://elevenlabs.io/app/agents/whatsapp). * El espacio de trabajo del agente está en [Modo de retención cero](/docs/es/eleven-api/resources/zero-retention-mode), que ignora por completo los mensajes entrantes de WhatsApp. * El mensaje entrante es de un tipo no compatible (por ejemplo, un vídeo o una respuesta de WhatsApp Flow); consulta las [Limitaciones](/docs/es/eleven-agents/whatsapp#limitations). > **Note** > > Si **Activar indicador de escritura** está desactivado para la cuenta, esta comprobación no se aplica; revisa > ambas listas. ## La primera respuesta después de una plantilla se comporta de forma inesperada Si tu agente tiene activada la anulación de **Primer mensaje** en la pestaña **Seguridad**, puede entrar en conflicto con las conversaciones de plantillas salientes: la plantilla ya ha servido como primer mensaje. Si las respuestas a plantillas se comportan de forma inesperada, elimina la anulación del primer mensaje para los agentes que se usan con mensajes salientes de WhatsApp. ## Referencia de errores de Meta Los errores que devuelve Meta durante la entrega se muestran, cuando es posible, con indicaciones para solucionarlos. Los más habituales: | Código | Significado | Qué hacer | | ------ | ------------------------------------------------------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------- | | 131042 | Problema de pago en la cuenta de WhatsApp Business | Añade o corrige el método de pago en WhatsApp Manager | | 131056 | Límite de velocidad para esta pareja empresa-usuario | Reduce la frecuencia de los mensajes a este usuario | | 131047 | Es necesario volver a interactuar | La ventana de atención al cliente se cerró; vuelve a interactuar con una plantilla | | 130497 | La empresa tiene restringido enviar mensajes a usuarios de un país | Meta ha restringido la mensajería entre países de la cuenta; resuélvelo con el soporte de Meta | | 132000 | El número de parámetros no coincide con la plantilla | Envía exactamente los parámetros que define la plantilla; consulta los [parámetros de plantilla](/docs/es/eleven-agents/whatsapp/outbound#template-parameters) | | 132001 | La plantilla no existe | Comprueba el nombre y el código de idioma de la plantilla, y que esté aprobada | | 131037 | Problema con el nombre visible del número de teléfono | Completa la aprobación del nombre visible en WhatsApp Manager | | 190 | El token de acceso ha caducado | Vuelve a importar la cuenta en la [página de WhatsApp](https://elevenlabs.io/app/agents/whatsapp) | Para consultar la lista completa, revisa la [referencia de códigos de error de Meta](https://developers.facebook.com/documentation/business-messaging/whatsapp/support/error-codes). ## Preguntas frecuentes #### ¿Cómo se factura el uso de WhatsApp? Dos partes te facturan de forma independiente. **ElevenLabs** cobra por el uso del agente: tiempo de conversación, mensajes, voz a texto y texto a voz para notas de voz, y uso de LLM, todo ello mediante los créditos de tu plan, según la [facturación estándar de ElevenLabs](/docs/es/overview/administration/billing). **Meta** cobra por separado las tarifas de WhatsApp, como mensajes de plantilla, llamadas salientes y solicitudes de permiso de llamada, a través del método de pago de WhatsApp Manager. Las tarifas varían según la categoría del mensaje y el país, y Meta ha anunciado actualizaciones de precios que entrarán en vigor el 1 de octubre de 2026; consulta los [precios de WhatsApp de Meta](https://developers.facebook.com/documentation/business-messaging/whatsapp/pricing) para conocer las tarifas aplicables a tus mercados. #### ¿Puedo usar ElevenLabs junto con otro proveedor de WhatsApp? Actualmente, un número solo puede estar registrado con un proveedor de mensajería. Si un proveedor externo (por ejemplo, Gupshup) gestiona tu cuenta, no se puede importar también en ElevenLabs. Estamos trabajando con Meta para habilitar las [Conversaciones con múltiples soluciones](https://developers.facebook.com/documentation/business-messaging/whatsapp/solution-providers/multi-solution-conversations), que permiten usar varios proveedores con un mismo número. **Voz mediante SIP.** Si tu objetivo es mantener la mensajería con tu proveedor actual y usar un agente de ElevenLabs para voz, hay una opción disponible hoy: WhatsApp Business Calling admite SIP, por lo que un proveedor que ofrezca configuración SIP puede dirigir las llamadas de WhatsApp de tu número a un [troncal SIP](/docs/es/eleven-agents/phone-numbers/sip-trunking) de ElevenLabs. Tu proveedor sigue gestionando los mensajes del número; tu agente responde las llamadas mediante SIP. Que esto funcione depende de que tu proveedor admita el enrutamiento de llamadas SIP; [contacta con nosotros](https://elevenlabs.io/contact-sales) y podremos evaluar tu configuración. Si gestionas tu propia app de WhatsApp en la misma cuenta (en lugar de usar un proveedor externo), ya puedes configurar ElevenLabs para gestionar solo las llamadas: desactiva el interruptor ***Activar mensajería*** en la configuración de la cuenta. #### ¿Cómo transfiero una conversación a una persona? Próximamente. Estamos trabajando con Meta en la coexistencia con WhatsApp Business, que permitirá a tu equipo participar en conversaciones en el mismo número que usa el agente. #### ¿Funciona el Modo de retención cero con WhatsApp? El [Modo de retención cero](/docs/es/eleven-api/resources/zero-retention-mode) limita nuestra capacidad para ofrecer funciones de WhatsApp: los mensajes entrantes se ignoran y las llamadas salientes no están permitidas. #### ¿Puedo personalizar según el anuncio de WhatsApp en el que hizo clic un usuario? Aún no. El agente recibe y responde a conversaciones iniciadas desde anuncios de clic para chatear por WhatsApp, pero los metadatos de referencia del anuncio de Meta (como `ctwa_clid` y los identificadores de campaña o creatividad) no se exponen actualmente al agente, las variables dinámicas ni los webhooks, por lo que la personalización y la atribución basadas en anuncios no son compatibles de forma nativa. Esto se sigue como una solicitud de función; si la atribución de anuncios es importante para tu caso de uso, [contacta con nosotros](https://elevenlabs.io/contact-sales). #### ¿Cómo envío códigos de verificación (OTP)? Usa una plantilla de utilidad con el código como parámetro del cuerpo, enviada mediante la [ruta de API de mensajes salientes](/docs/es/eleven-agents/whatsapp/outbound). La categoría de plantillas de autenticación de Meta (con botones para copiar códigos) todavía no tiene soporte específico. #### ¿Quién es el proveedor tecnológico de mi cuenta de WhatsApp? Al importar una cuenta de WhatsApp Business, ElevenLabs actúa como **Proveedor tecnológico** de esa cuenta según el modelo de socios de Meta. ElevenLabs es socio tecnológico de Meta, no revendedor: Meta te factura directamente las tarifas de WhatsApp mediante el método de pago de WhatsApp Manager. #### ¿Se admite la residencia de datos en la UE? La residencia de datos en la UE para ElevenAgents, incluidos los datos de conversaciones de WhatsApp, está disponible en los planes Enterprise a través del entorno aislado de la UE. Esto cubre los datos gestionados por la infraestructura de ElevenLabs; el transporte de mensajes a través de WhatsApp está sujeto a tu acuerdo con Meta.