🛠️ GUÍA DE ERRORES COMUNES Y SUS SOLUCIONES
Al construir flujos automatizados, es normal encontrarse con algunos obstáculos técnicos. 🚧
En WHAPIFY hemos recopilado los errores más frecuentes organizados por plataforma, junto con sus soluciones rápidas, para que puedas resolverlos en tiempo récord. 👇
🟢 Errores en WhatsApp
Error: URL button is not supported
Causa/Solución: Los flujos regulares de WhatsApp no soportan botones que abran sitios web (URL). Solo puedes insertar una URL dentro de un botón si estás utilizando un Mensaje de Plantilla (Template Message) aprobado por Meta.
Error: (#100) The parameter text[‘body’] is required
Causa/Solución: Este error ocurre cuando intentas enviar un bloque de mensaje vacío. Asegúrate de que tus bloques de texto siempre tengan contenido.
Error: (#1008) Required parameter is missing
Causa/Solución: Faltan parámetros en tu mensaje de plantilla de WhatsApp. Revisa la plantilla que intentas enviar y asegúrate de haber llenado todas las variables requeridas.
Error: (#470) Message failed to send because more than 24 hours have passed
Causa/Solución: El mensaje no pudo enviarse porque han pasado más de 24 horas desde que el cliente respondió por última vez. Recuerda que fuera de esta ventana solo puedes usar Mensajes de Plantilla.
Error: (#2012) Parameter format does not match format in the created template
Causa/Solución: El formato de los parámetros que envías no coincide con el de la plantilla. Por ejemplo, Meta esperaba una Imagen y recibió un formato desconocido. Revisa los adjuntos de tu plantilla.
Error: There can be no more than 30 product_items across sections
Causa/Solución: El número máximo de productos que se pueden mostrar a la vez en un mensaje de WhatsApp es 30. Reduce la cantidad de productos en tu lista.
Error: (#131053) Unsupported Image mime type image/gif
Causa/Solución: El bot de WhatsApp no soporta imágenes en formato GIF. Por favor, cambia la imagen a formato PNG o JPEG.
Error: Invalid catalog Id
Causa/Solución: Asegúrate de que tu catálogo esté correctamente conectado al Administrador de WhatsApp. Te recomendamos añadir tus productos al catálogo utilizando una hoja de cálculo (Spreadsheet) siguiendo la documentación oficial de Meta.
Error: (#1005) Additional compliance information for your business and catalog items may be required
Causa/Solución: Faltan requisitos de cumplimiento en tu catálogo. Te aconsejamos subir tus productos mediante una hoja de cálculo desde el Administrador de Ventas de Meta para evitar este error.
Error: (#131053) Downloading media from weblink failed with http code 404
Causa/Solución: Nuestro sistema no pudo descargar la imagen o archivo multimedia desde la URL proporcionada. La mejor solución es intentar subir el archivo a otro servidor o usar una URL de un dominio diferente.
Error: (#131053) Unsupported Audio mime type image/jpeg
Causa/Solución: El archivo de audio proporcionado no es compatible. Asegúrate de utilizar un archivo con extensión MPEG, AMR, MP4 o AAC.
🔵 Errores en Messenger / Instagram (IG)
Error: (#100) Message cannot be empty, must provide valid attachment or text
Causa/Solución: Estás intentando enviar un bloque de mensaje vacío. Esto suele pasar si usas un campo personalizado como {{Response}} y este no tiene ningún valor guardado. Asegúrate de que el campo contenga texto.
Error: (#10) This message is sent outside of the allowed window
Causa/Solución: Estás intentando enviar un mensaje fuera de la ventana de 24 horas. El contacto debe interactuar con el bot primero. También puede ocurrir si intentas hacer una vista previa (Preview) de un flujo; simplemente interactúa con tu bot y vuelve a intentarlo.
Error: Please go to Settings > Channels and reconnect your Messenger/Instagram bot
Causa/Solución: La conexión ha caducado. Ve a Ajustes → Canales y vuelve a conectar tu bot de Messenger o Instagram según corresponda.
Error: (#10) Message failed to send because another app is controlling this thread now
Causa/Solución: Asegúrate de que nuestra aplicación sea el «Receptor Principal» (Primary Receiver) en la configuración del Protocolo de Transferencia de tu página de Facebook. Además, desactiva el Livechat para el usuario moviendo la conversación a la carpeta «Hecho» (Done).
Error: (#100) name_placeholder[buttons][0][url] should represent a valid URL
Causa/Solución: Todos los botones de URL o URLs de imágenes deben comenzar obligatoriamente con https://.
Error: (#551) This person isn’t available right now
Causa/Solución: Ocurre si la persona bloqueó los mensajes de tu página (un administrador puede intentar escribirle manualmente desde el Inbox). También pasa si una persona comentó en un post, no interactuó con tu mensaje Opt-in, y tu página intentó enviarle mensajes usando Smart Delays, Secuencias o bloques de «Escribiendo…».
Error: (#100) Cannot set thread level persistent menu now because another app is controlling the thread
Causa/Solución: Estás intentando configurar el menú persistente, pero nuestra App no tiene el control principal. Ve a la configuración de tu página de Facebook y asegura que somos el receptor principal.
Error: (#100) Upload failed
Causa/Solución: El archivo que intentas subir no es compatible con Messenger. Intenta con un archivo diferente o cambia la extensión del mismo.
Error: (#10) You need one time notification permission for this message
Causa/Solución: Para enviar mensajes usando la etiqueta de notificación, necesitas solicitar el permiso de Notificación Única (OTN) en tu página de Facebook. Ve a Configuración de la página → Mensajería Avanzada y solicita el permiso.
Error: (#200) User does not have sufficient administrative permission for this action on this page
Causa/Solución: Necesitas permisos de administrador en la página de Facebook para crear un Menú Persistente. Si la página requiere Autenticación de Dos Factores (2FA), el usuario también debe habilitarla en su perfil.
📧 Errores de Correo y SMS (SendMail, SendGrid, MailerLite, Twilio)
Error: Send SMS – Please connect Twilio account
Causa/Solución: Estás intentando enviar un SMS desde tu flujo, pero no tienes una cuenta de Twilio o Clicksend conectada en tus integraciones.
Error: SendMail SMTP Error: Could not authenticate
Causa/Solución: Tus credenciales de inicio de sesión (Correo y Contraseña) son incorrectas. Si usas Gmail y estás seguro de tus datos, debes crear una Contraseña de Aplicación en tu cuenta de Google y usar esa clave en los ajustes SMTP de Whapify.
Error: SendMail – No email address (TO)
Causa/Solución: El contacto al que intentas enviar el correo no tiene una dirección registrada. Verifica que la variable {{email}} del usuario tenga algún valor.
Error: SendGrid – No email or opted-in to receive email
Causa/Solución: Asegúrate de que el destinatario tenga un correo válido y haya aceptado explícitamente recibir tus correos electrónicos (Opt-in).
Error: (#302) API-Key Unauthorized (MailerLite)
Causa/Solución: La clave API (API Key) que proporcionaste es incorrecta. Por favor, verifica en tu cuenta de MailerLite y cópiala nuevamente.
🔌 Errores de Integraciones Externas
Error: External Request – Fail to execute the request
Causa/Solución: La acción de solicitud externa (API/Webhook) falló al ejecutarse. Revisa cuidadosamente los encabezados (Headers) y el cuerpo (Body) de tu solicitud.
Error: (invalid_grant) Bad Request (Google Sheets)
Causa/Solución: Los permisos de acceso han caducado o son inválidos. Ve a tus integraciones, desconecta tu cuenta de Google Sheets y vuelve a conectarla.
🗣️ Errores de Comentarios en Facebook y Ads
Error: Facebook comment can only reply with 1 message due to Facebook limitation
Causa/Solución: Debido a las limitaciones de Facebook, las automatizaciones de comentarios solo pueden responder con un (1) único mensaje de texto. No puedes usar el nodo «Continuar» (Continue) en el paso inicial.
💡 Tip: Puedes responder con un bloque de texto que contenga un botón; ese botón sí puede iniciar un flujo más complejo.
Error: Facebook Ads – Error validating access token
Causa/Solución: La sesión se ha invalidado porque el usuario cambió su contraseña o Facebook cerró la sesión por seguridad. Ve a Ajustes y vuelve a conectar tu bot.
🎯 Conclusión
Conocer estos errores comunes te ahorrará horas de dolores de cabeza y te permitirá construir flujos mucho más robustos y profesionales.
En WHAPIFY queremos que tu experiencia sea lo más fluida posible. Si te encuentras con un error que no está en esta lista, ¡no dudes en contactar a nuestro equipo de soporte! 🚀