# Historial de chats

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

Fuente: https://ardumaker.com/docs/historial-de-chats/

- Categoría: Comunicación
- Estado: Disponible
- Requisitos: Un número de [WhatsApp](https://ardumaker.com/docs/whatsapp-business-api) 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](https://ardumaker.com/docs/webhooks-whatsapp).

## ¿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](https://ardumaker.com/mcp/docs).

## Funciones relacionadas

- [WhatsApp Business API](https://ardumaker.com/docs/whatsapp-business-api/)
- [Webhooks de WhatsApp](https://ardumaker.com/docs/webhooks-whatsapp/)
- [Transcripción](https://ardumaker.com/docs/transcripcion/)