--- title: Errores principales de envío de plantillas (WhatsApp API) description: Identifica el código que devuelve Meta al fallar el envío de una plantilla y corrige errores como 131047, 131049 o 131042 en la API de WhatsApp. --- [Ir directamente al contenido](https://help.whaticket.com/es/articles/21529-errores-principales-de-envio-de-plantillas#main-content) - [Español](https://help.whaticket.com/es/articles/21529-errores-principales-de-envio-de-plantillas) - [Português](https://help.whaticket.com/pt/articles/21529-erros-comuns-ao-enviar-modelos-api-do-whatsapp) Español Traducciones de Mostrar submenú de [![Logo Blanco (1)](https://help.whaticket.com/hs-fs/hubfs/Logo%20Blanco%20(1).png?width=200&height=37&name=Logo%20Blanco%20(1).png)](https://help.whaticket.com/?hsLang=es) Abrir navegación principal Cerrar navegación principal - - [Español](https://help.whaticket.com/es/articles/21529-errores-principales-de-envio-de-plantillas) - [Português](https://help.whaticket.com/pt/articles/21529-erros-comuns-ao-enviar-modelos-api-do-whatsapp) Español Traducciones de Mostrar submenú de - [Login](https://app.whaticket.com/?utm_source=helpdesk&utm_medium=referral&utm_campaign=app&utm_content=header) [Login](https://app.whaticket.com/?utm_source=helpdesk&utm_medium=referral&utm_campaign=app&utm_content=header) ¿Cómo podemos ayudarte? - No hay sugerencias porque el campo de búsqueda está vacío. 1. [Centro de Ayuda Whaticket: Guías y Soporte](https://help.whaticket.com/es/articles?hsLang=es) 2. [Whatsapp API](https://help.whaticket.com/es/articles/whatsapp-api?hsLang=es) 3. [Plantillas de mensajes](https://help.whaticket.com/es/articles/whatsapp-api?hsLang=es#plantillas-de-mensajes) # Errores principales de envío de plantillas (WhatsApp API) ## ¿Cómo identificar el error? Si acabas de configurar tu API y al enviar una plantilla de mensaje aparece un error, es importante revisar el detalle que muestra la plataforma. Coloca el cursor sobre el **segundo ícono rojo (error)** que aparece en el mensaje. Ahí podrás ver el código y la descripción del error que devuelve Meta. ### ![Prueba](https://help.whaticket.com/hs-fs/hubfs/imagens%20userguiding/file-1774983863985.png?width=758&name=file-1774983863985.png) Ícono de error donde se muestra el detalle del problema de envío. Meta siempre indica el motivo exacto por el cual no se pudo enviar el mensaje. Identificar este error es fundamental para poder aplicar la solución correcta. Errores principales (causa y solución) ![](https://help.whaticket.com/hs-fs/hubfs/imagens%20userguiding/file-1774984737851.png?width=562&name=file-1774984737851.png) 200 — Error genérico de solicitud **Causa:** - Error en la estructura de la solicitud enviada Datos incompletos o inválidos en la API Problemas en el formato del request - **Solución:** - Revisar la estructura del request enviado Validar que todos los campos obligatorios estén completos Confirmar que los datos estén en el formato correcto Revisar logs o respuesta detallada de la API ## 100 — Invalid parameter **Causa:** - Parámetros incorrectos en la solicitud Campos mal enviados en la plantilla Error en variables o estructura del mensaje - **Solución:** - Validar los parámetros enviados en la API Revisar que las variables coincidan con la plantilla Confirmar nombres de campos y estructura del JSON Comparar con la documentación oficial de Meta ### 131026 — Message Undeliverable **Causa:** - El número no tiene WhatsApp El cliente bloqueó tu número El cliente está en un país restringido Aplicación desactualizada o términos no aceptados - **Solución:** - Verificar que el número tenga WhatsApp Pedir al cliente que desbloquee el número Solicitar actualización de la app Probar envío manual ### 131031 — Account has been locked **Causa:** - Cuenta bloqueada por políticas Problema con verificación (PIN 2FA incorrecto) - **Solución:** - Desactivar 2FA Registrar nuevamente el número Activar 2FA nuevamente Si continúa → solicitar revisión a Meta ### 131042 — Payment / billing issue **Causa:** - Falta de método de pago Línea de crédito inválida Cuenta mal configurada - **Solución:** - Configurar [método de pago en Meta](https://business.facebook.com/) Revisar cuenta en Business Manager Validar moneda y configuración ### 131047 — Fuera de ventana de 24h **Causa:** - Intento de envío fuera de la ventana de 24 horas sin plantilla - **Solución:** - Enviar mensaje con plantilla aprobada O esperar respuesta del cliente ### 131049 — Envío bloqueado por Meta **Causa:** - Envíos masivos muy rápidos Baja calidad del número Usuarios no interactúan o reportan - **Solución:** - Esperar al menos 24 horas Reducir volumen de envíos Usar contactos con consentimiento (opt-in) Escalar envíos progresivamente ### 130497 — País restringido **Causa:** - Cuenta no habilitada para enviar a ese país - **Solución:** - Subir nivel de cuenta (tier) Esperar liberación Validar país permitido ### 131037 — Display name no aprobado **Causa:** - Nombre del número no aprobado por Meta - **Solución:** - Solicitar aprobación del nombre Ajustar configuración en Meta ### 130472 — Usuario en experimento **Causa:** - Meta está realizando pruebas internas - **Solución:** - No hay acción directa Intentar nuevamente más tarde Evitar reintentos masivos ### 132000 — Variables incorrectas **Causa:** - Variables mal configuradas Parámetros incompletos - **Solución:** - Revisar estructura del template Validar orden y cantidad de variables ### 132001 — Template no aprobado **Causa:** - Plantilla no aprobada Idioma incorrecto - **Solución:** - Verificar estado en Meta Confirmar nombre e idioma ### 131021 — Envío al mismo número **Causa:** - Intento de enviar mensaje al mismo número - **Solución:** - Usar un número diferente como destino ## Resumen rápido para soporte - **Problemas de entrega** 131026 → número / cliente 131049 → bloqueo por comportamiento 130497 → país restringido - **Problemas de cuenta** 131031 → cuenta bloqueada 131042 → pago - **Problemas de plantilla** 132000 / 132001 → variables o aprobación - **Otros importantes** 131047 → fuera de ventana 130472 → experimento **Documentación oficial de Meta** Puedes consultar todos los errores directamente en la documentación oficial: [https://developers.facebook.com/docs/whatsapp/cloud-api/support/error-codes/](https://developers.facebook.com/docs/whatsapp/cloud-api/support/error-codes/) ## Importante Identificar correctamente el error mostrado por Meta es clave para resolver el problema. Cada código indica una causa específica, por lo que siempre debes validar el mensaje antes de intentar reenviar. **¿Tienes dudas adicionales? No te preocupes, estamos aquí para ayudarte.** **Entra en contacto con nuestro equipo presionando el botón de "Soporte" ubicado en el menú izquierdo de nuestra plataforma.** ![](https://help.whaticket.com/hubfs/imagens%20userguiding/file-1774983387101.png) - [Primeros Pasos](https://help.whaticket.com/es/articles/primeros-pasos?hsLang=es) - [Conexiones](https://help.whaticket.com/es/articles/conexiones?hsLang=es#main-content) - [Whatsapp](https://help.whaticket.com/es/articles/conexiones?hsLang=es#whatsapp) - [Telegram](https://help.whaticket.com/es/articles/conexiones?hsLang=es#telegram) - [Web Chat](https://help.whaticket.com/es/articles/conexiones?hsLang=es#web-chat) - [Facebook e Instagram](https://help.whaticket.com/es/articles/conexiones?hsLang=es#facebook-e-instagram) - [TikTok](https://help.whaticket.com/es/articles/conexiones?hsLang=es#tiktok) - [Whatsapp API](https://help.whaticket.com/es/articles/whatsapp-api?hsLang=es#main-content) - [Whatsapp Business API Coexistencia](https://help.whaticket.com/es/articles/whatsapp-api?hsLang=es#whatsapp-business-api-coexistencia) - [Whatsapp Business API Cloud](https://help.whaticket.com/es/articles/whatsapp-api?hsLang=es#whatsapp-business-api-cloud) - [Plantillas de mensajes](https://help.whaticket.com/es/articles/whatsapp-api?hsLang=es#plantillas-de-mensajes) - [Configuración general](https://help.whaticket.com/es/articles/whatsapp-api?hsLang=es#configuraci%C3%B3n-general) - [Chats](https://help.whaticket.com/es/articles/chats?hsLang=es#main-content) - [Historial y administración](https://help.whaticket.com/es/articles/chats?hsLang=es#historial-y-administraci%C3%B3n) - [Atención y flujo](https://help.whaticket.com/es/articles/chats?hsLang=es#atenci%C3%B3n-y-flujo) - [Horarios y disponibilidad](https://help.whaticket.com/es/articles/chats?hsLang=es#horarios-y-disponibilidad) - [Contactos](https://help.whaticket.com/es/articles/contactos?hsLang=es) - [Etiquetas](https://help.whaticket.com/es/articles/etiquetas?hsLang=es) - [Respuestas rápidas](https://help.whaticket.com/es/articles/respuestas-r%C3%A1pidas?hsLang=es) - [Automatización de Mensajes](https://help.whaticket.com/es/articles/automatizaci%C3%B3n-de-mensajes?hsLang=es#main-content) - [Envío masivo](https://help.whaticket.com/es/articles/automatizaci%C3%B3n-de-mensajes?hsLang=es#env%C3%ADo-masivo) - [Mensajes programados](https://help.whaticket.com/es/articles/automatizaci%C3%B3n-de-mensajes?hsLang=es#mensajes-programados) - [Wäbot IA](https://help.whaticket.com/es/articles/w%C3%A4bot-ia?hsLang=es#main-content) - [Configuración y activación](https://help.whaticket.com/es/articles/w%C3%A4bot-ia?hsLang=es#configuraci%C3%B3n-y-activaci%C3%B3n) - [Créditos y token OpenAI](https://help.whaticket.com/es/articles/w%C3%A4bot-ia?hsLang=es#cr%C3%A9ditos-y-token-openai) - [Base de conocimiento](https://help.whaticket.com/es/articles/w%C3%A4bot-ia?hsLang=es#base-de-conocimiento) - [Equipo](https://help.whaticket.com/es/articles/equipo?hsLang=es) - [Departamentos y Chatbots](https://help.whaticket.com/es/articles/departamentos-y-chatbots?hsLang=es#main-content) - [Departamentos y distribución](https://help.whaticket.com/es/articles/departamentos-y-chatbots?hsLang=es#departamentos-y-distribuci%C3%B3n) - [Chatbot](https://help.whaticket.com/es/articles/departamentos-y-chatbots?hsLang=es#chatbot) - [Informes](https://help.whaticket.com/es/articles/informes?hsLang=es#main-content) - [Encuesta de Satisfacción (CSAT)](https://help.whaticket.com/es/articles/informes?hsLang=es#encuesta-de-satisfacci%C3%B3n-csat) - [Métricas generales](https://help.whaticket.com/es/articles/informes?hsLang=es#m%C3%A9tricas-generales) - [Integraciones y API](https://help.whaticket.com/es/articles/integraciones-y-api?hsLang=es#main-content) - [MCP](https://help.whaticket.com/es/articles/integraciones-y-api?hsLang=es#mcp) - [Make](https://help.whaticket.com/es/articles/integraciones-y-api?hsLang=es#make) - [N8N](https://help.whaticket.com/es/articles/integraciones-y-api?hsLang=es#n8n) - [Zapier](https://help.whaticket.com/es/articles/integraciones-y-api?hsLang=es#zapier) - [Tokens y Documentación de la API](https://help.whaticket.com/es/articles/integraciones-y-api?hsLang=es#tokens-y-documentaci%C3%B3n-de-la-api) - [Mi cuenta](https://help.whaticket.com/es/articles/mi-cuenta?hsLang=es#main-content) - [Perfil y acceso](https://help.whaticket.com/es/articles/mi-cuenta?hsLang=es#perfil-y-acceso) - [Disponibilidad](https://help.whaticket.com/es/articles/mi-cuenta?hsLang=es#disponibilidad) - [Suscripción](https://help.whaticket.com/es/articles/suscripci%C3%B3n?hsLang=es#main-content) - [Planes](https://help.whaticket.com/es/articles/suscripci%C3%B3n?hsLang=es#planes) - [Pagos y reembolsos](https://help.whaticket.com/es/articles/suscripci%C3%B3n?hsLang=es#pagos-y-reembolsos) - [Preguntas frecuentes](https://help.whaticket.com/es/articles/preguntas-frecuentes?hsLang=es#main-content) - [Producto y políticas](https://help.whaticket.com/es/articles/preguntas-frecuentes?hsLang=es#producto-y-pol%C3%ADticas) - [Errores técnicos](https://help.whaticket.com/es/articles/preguntas-frecuentes?hsLang=es#errores-t%C3%A9cnicos) - [Configuración](https://help.whaticket.com/es/articles/configuraci%C3%B3n?hsLang=es) - [Kanban](https://help.whaticket.com/es/articles/kanban?hsLang=es) [![Logos Whaticket](https://help.whaticket.com/hs-fs/hubfs/Logos%20Whaticket.png?width=282&height=50&name=Logos%20Whaticket.png "Logos Whaticket")](http:/?hsLang=es) [mailto:contact@whaticket.com](mailto:contact@whaticket.com) Copyright © 2026, Whaticket