Errores y FAQ¶
Códigos de error Meta¶
| Código | Qué significa | Cómo resolverlo |
|---|---|---|
| 131026 | El número destino no tiene WhatsApp activo, no está registrado o bloqueó tu cuenta | Verificar el número del cliente |
| 131042 | Problema de pago con tu cuenta WhatsApp Business | Revisar Meta Business Manager → Configuración → Pagos |
| 131047 | Ventana de 24h cerrada | Usar una plantilla aprobada en lugar de texto libre |
| 131048 | El cliente bloqueó tu número | Contactar al cliente por otra vía |
| 131049 | Bloqueado por engagement (anti-spam) | Reducir frecuencia, mejorar calidad de plantillas |
| 131051 | Tipo de mensaje no soportado | Solo texto y plantillas — evitar audios/videos no compatibles |
| 132000 | Variables no coinciden | Revisar cantidad de {{1}}, {{2}} aprobadas vs enviadas |
| 132001 | Plantilla no existe o sin aprobación | Crear/esperar aprobación de la plantilla en el idioma |
| 132007 | Plantilla pausada por baja calidad | Mejorar redacción, volver a someter |
| 132015 | Plantilla pausada por Meta | Esperar reactivación o crear nueva versión |
| 132016 | Plantilla deshabilitada | Crear una nueva con redacción diferente |
| 133010 | Número remitente no registrado | Verificar inbox en Chatwoot |
La pestaña Soporte te dice qué hacer con cada error
En panel → pestaña Soporte → Mensajes con problemas, cada error muestra el detalle accionable según el tipo:
- Número que falló → ves exactamente a qué número no se pudo entregar.
- Error de plantilla (132000/132001…) → te indica que la plantilla no cumple el formato y te lleva directo a tu tab Plantillas para corregirla, sin tener que perderte en Meta.
- Problema de pago/facturación (131042) → te lleva a tu cuenta de WhatsApp Business en Meta, que es donde se resuelve.
FAQ¶
¿Cuánto cuesta enviar un mensaje?¶
Los mensajes están incluidos en tu plan, sin tope por unidad. Lo que se factura es plan + agentes/números extra.
¿Puedo enviar a varios países?¶
Sí. HybsChat normaliza automáticamente el formato a E.164 (con código de país).
Mi cliente recibió el mensaje 2 veces¶
Probablemente tu sistema disparó la notificación 2 veces (típico en WHMCS con eventos InvoiceCreated + AcceptOrder). HybsChat tiene deduplicación interna por 90 segundos por (evento + receptor) — si ves duplicados más allá de ese tiempo, revisa tu sistema o contacta soporte.
¿Puedo enviar imágenes o archivos?¶
Sí. El bot puede enviar imágenes, PDF y videos desde tu biblioteca de medios (ver Biblioteca de medios): subes el archivo una vez y el bot lo manda cuando corresponde (en un flujo o cuando la IA lo decide). Para los envíos por plantilla Meta (notificaciones masivas iniciadas por tu sistema), las plantillas con imagen en el header están en el roadmap.
¿Cuántos agentes puedo tener?¶
| Plan | Agentes | Inboxes |
|---|---|---|
| INICIO | 2 | 1 |
| BASIC | 5 | 2 |
| PRO | 10 | 2 |
Más agentes extra a $5/mes c/u. Más números a $10/mes c/u.
Mi cliente no recibe el mensaje pero el panel dice "enviado"¶
"Enviado" significa que HybsChat lo entregó a Meta. Meta puede tardar en entregar al destinatario (sobre todo si el destino tiene el WhatsApp cerrado o sin Internet). Si después de 24 h sigue sin entregar, ver código de error en el panel → pestaña Soporte → Mensajes con problemas.