Mensajes
Historial de los mensajes enviados y recibidos por tus instancias: filtra, revisa el estado de entrega, el motivo de un fallo y descarga los archivos recibidos.
Descripción
Mensajes es la bitácora de todo lo que envían y reciben tus instancias, ya sea desde el panel o desde tu sistema por la API. Aquí confirmas si un mensaje llegó, cuándo lo leyeron o por qué falló.
Guía de implementación
- Conecta al menos una instancia
- Envía un mensaje de prueba desde el detalle de la instancia
- Abre Mensajes y sigue su estado con «Actualizar»
Depende de
Lo usan
Funcionalidades
- Historial de mensajes entrantes y salientes de todas tus instancias
- Filtros por instancia, dirección, estado, chat y referencia
- Estado de cada envío: En cola, Enviando, Enviado, Entregado, Leído, Reproducido o Fallido
- Detalle con el motivo del error de un mensaje fallido
- Descarga de archivos recibidos
- Búsqueda por la referencia que envía tu sistema
Manual de usuario
Consultar el historial y filtrar #
La tabla muestra fecha, instancia, dirección (↓ Entrantes, ↑ Salientes), chat, contenido, estado y referencia. Los mensajes con archivo muestran un clip 📎.
- Paso 1: Entra a Mensajes en el menú lateral
- Paso 2: Elige los filtros que necesitesInstancia, Dirección (Entrantes o Salientes), Estado, Chat ID (p. ej. 5215512345678@c.us) y Referencia (p. ej. pedido-1234).
- Paso 3: Haz clic en «Filtrar»
- Paso 4: Para quitar los filtros, haz clic en «Limpiar»
- Paso 5: Haz clic en «Ver» para abrir el detalle de un mensaje
Estados de un mensaje #
- Inicio: En colaqueued
- Paso: Enviandosending
- Paso: Enviadosent: salió del teléfono
- Paso: Entregadodelivered: llegó al destinatario
- Fin: Leídoread (Reproducido en notas de voz)
En cualquier punto puede quedar como «Fallido» (failed); el detalle dice por qué. Los entrantes aparecen como «Recibido».
Un mensaje saliente entra primero a una cola por instancia y sale en orden, con una pausa de unos segundos entre mensajes para reducir el riesgo de bloqueo de WhatsApp. Después WhatsApp informa si se entregó y si se leyó.
Mensajes fallidos y por qué #
Abre el detalle con «Ver»: el recuadro «Error» explica el motivo. Los más comunes son: «El número no tiene WhatsApp» (el destino no está registrado); «Expiró en cola: la instancia no se conectó a tiempo» (se pidió encolar pero la instancia no se conectó en 24 horas); «Instancia eliminada»; «WhatsApp rechazó el mensaje»; y «Envío interrumpido por reinicio del servidor; verifique antes de reenviar».
- Paso 1: Filtra por Estado → Fallido
- Paso 2: Haz clic en «Ver» en el mensaje
- Paso 3: Lee el motivo en «Error» y corrige la causaPor ejemplo, verifica el número desde el detalle de la instancia o vuelve a iniciar la instancia.
- Paso 4: Reenvía el mensaje desde tu sistema o con un mensaje de prueba
Relacionado: Instancias
Descargar archivos recibidos #
Cuando un cliente te manda una imagen, documento o audio, el detalle del mensaje muestra el nombre y tipo del archivo y el botón «Descargar archivo».
- Paso 1: Filtra por Dirección → Entrantes
- Paso 2: Haz clic en «Ver» en el mensaje con 📎
- Paso 3: Haz clic en «Descargar archivo»Verás «Descarga iniciada.» y el archivo se guarda en tu equipo.
Preguntas frecuentes
¿Por qué mi mensaje se queda «En cola»?
Los mensajes salen en orden y con pausa entre uno y otro. Si la instancia no está conectada y el envío se hizo con «Encolar si está desconectada» (o queueIfOffline en la API), el mensaje espera hasta 24 horas a que la instancia se conecte.
Dice «Enviado» pero no «Entregado». ¿Llegó?
«Enviado» significa que salió de tu número. «Entregado» llega cuando el teléfono del destinatario lo recibe; si lo tiene apagado o sin internet, puede tardar.
¿Qué es la «Referencia»?
Es un identificador que tu sistema manda al enviar por la API (p. ej. el número de pedido). Sirve para encontrar el mensaje con el filtro «Referencia» y viaja también en los webhooks.