Estados de un envío y eventos de facturación
Qué significa cada estado de un mensaje saliente y qué eventos avisan del consumo de tu cuenta.
API de WhatsApp y CRM
Necesitas una clave de API. Pídela a nuestro equipo de soporte o créala desde la plataforma.
Estados de un mensaje saliente
Cada envío avanza por estos estados, y cada cambio llega a tu webhook:
| Estado | Qué significa |
|---|---|
sent | La plataforma aceptó el mensaje y lo envió a WhatsApp |
delivered | Llegó al teléfono del cliente |
read | El cliente abrió la conversación |
failed | No se pudo entregar: el evento trae el motivo |
Un mensaje puede quedarse en sent y no llegar nunca a delivered. Eso no siempre es un error tuyo: el cliente puede tener el teléfono apagado o haber bloqueado el número.
Los motivos de fallo más comunes
- Número inexistente o no registrado en WhatsApp.
- Plantilla pausada, rechazada o sin coincidencia cuando la conversación ya no está dentro de la ventana de 24 horas.
- Cliente que se dio de baja y no acepta más mensajes.
- Saldo insuficiente en la cuenta.
- Medio inválido: URL inaccesible o tamaño fuera del límite.
Facturación
La conversación de 24 horas y las plantillas fuera de ventana se cobran distinto. Los eventos de facturación te dicen cuánto consumió cada envío y con qué categoría, para que puedas conciliar tu consumo sin esperar el cierre del mes.
Buenas prácticas
- Guarda el estado final de cada mensaje y el motivo del fallo: es la base de cualquier reclamo.
- No reintentes automáticamente un
failedpor plantilla o por baja del cliente: vuelve a fallar y consume. - Cruza el estado con tu propio registro de envío: si tú marcaste error y la plataforma
delivered, gana la plataforma.
¿Te sirvió esta página?