# Chat history

Each number's WhatsApp conversations, with messages, files, statuses and transcriptions.

Source: https://ardumaker.com/en/docs/historial-de-chats/

- Category: Communication
- Status: Available
- Requirements: A [WhatsApp](https://ardumaker.com/en/docs/whatsapp-business-api) number in the company account
- MCP tools (Read only): `listar_chat_sandbox_whatsapp`

## What can you do with it?

- See a number's conversations, each with its contact and the last message preview.
- Read a conversation's messages, newest first.
- Open received or sent images, audio, video and documents.
- See each message's delivery status, transcription and timings.
- Resend a specific message to the [webhooks](https://ardumaker.com/en/docs/webhooks-whatsapp).

## When should you use it?

To review what was said with a contact, audit what a bot answered or recover a message the webhook did not process.

## How does it work in ArduMaker?

Each number has conversations; each conversation groups the messages with one contact. Listings are paged with `page` and `page_size` (20 by default, up to 100). Access is with a company member's session or the number's `Twilio-Api-Sid` header.

| Message field | Values |
| --- | --- |
| `direction` | `in`, `out` |
| `message_type` | `text`, `image`, `audio`, `video`, `document`, `template` |
| `status` | `received`, `sent`, `delivered`, `read`, `failed` |
| `transcription_status` | `none`, `pending`, `processing`, `done`, `failed` |

Files are stored in ArduMaker and served through a signed URL or, for signed-in users, through an authenticated link.

## What actually changes?

Reading changes nothing. A manual resend records destination, HTTP status, error, duration and who requested it, without moving the point from which the webhook keeps sending.

## Expected result

A complete record of each conversation on the number. Test conversations carry `es_sandbox: true`, so they are kept apart from real ones.

## Errors and troubleshooting

- **401**: missing session or number header.
- **404**: the number or conversation does not belong to that company.
- **Audio without text**: check the message's `transcription_status` and `transcription_last_error`.

## MCP access

Through MCP only sandbox contact chats can be read, with `listar_chat_sandbox_whatsapp`, which includes what the customer's bot answered as untrusted content. Real conversations are not exposed through MCP. See [/mcp/docs](https://ardumaker.com/en/mcp/docs).

## Related features

- [WhatsApp Business API](https://ardumaker.com/en/docs/whatsapp-business-api/)
- [WhatsApp webhooks](https://ardumaker.com/en/docs/webhooks-whatsapp/)
- [Transcription](https://ardumaker.com/en/docs/transcripcion/)