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. 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.
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.
5. Límites de marketing — Meta limita cuántas plantillas de marketing 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.
• 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 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 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 que devuelva todas las variables que requiere el agente; consulta el contexto de inicialización. 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 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.
• 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.
• El espacio de trabajo del agente está en Modo de retención cero, 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.

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:

Para consultar la lista completa, revisa la referencia de códigos de error de Meta.

Preguntas frecuentes