Historial de chats

Las conversaciones de WhatsApp de cada número, con sus mensajes, archivos, estados y transcripciones.

Categoría: Comunicación
Estado: Disponible
Requisitos: Un número de WhatsApp en la cuenta de la empresa
Herramientas MCP (Solo leen): listar_chat_sandbox_whatsapp

¿Qué permite hacer?

Ver las conversaciones de un número, cada una con su contacto y la vista previa del último mensaje.
Leer los mensajes de una conversación, del más nuevo al más viejo.
Abrir imágenes, audios, videos y documentos recibidos o enviados.
Ver estado de entrega, transcripción y tiempos de cada mensaje.
Reenviar un mensaje puntual a los webhooks.

¿Cuándo conviene usarlo?

Para revisar qué se habló con un contacto, auditar lo que contestó un bot o recuperar un mensaje que el webhook no procesó.

¿Cómo funciona en ArduMaker?

Cada número tiene conversaciones; cada conversación agrupa los mensajes con un contacto. Los listados se paginan con page y page_size (20 por defecto, hasta 100). Se accede con la sesión de un miembro de la empresa o con la cabecera Twilio-Api-Sid del número.

Dato del mensaje	Valores
`direction`	`in`, `out`
`message_type`	`text`, `image`, `audio`, `video`, `document`, `template`
`status`	`received`, `sent`, `delivered`, `read`, `failed`
`transcription_status`	`none`, `pending`, `processing`, `done`, `failed`

Los archivos se guardan en ArduMaker y se sirven por una URL firmada o, para quien tiene sesión, por un enlace autenticado.

¿Qué cambia realmente?

Leer no cambia nada. El reenvío manual registra destino, código HTTP, error, duración y quién lo pidió, sin mover el punto desde el que el webhook sigue enviando.

Resultado esperado

Un registro completo de cada conversación del número. Las conversaciones de prueba llevan es_sandbox: true, así se separan de las reales.

Errores y resolución

401: falta sesión o la cabecera del número.
404: el número o la conversación no son de esa empresa.
Audio sin texto: revisar transcription_status y transcription_last_error del mensaje.

Relación con MCP

Por MCP solo se lee el chat de los contactos de sandbox con listar_chat_sandbox_whatsapp, que incluye lo que contestó el bot del cliente como contenido no confiable. Las conversaciones reales no se exponen por MCP. Ver /mcp/docs.