# Histórico de chats

As conversas de WhatsApp de cada número, com mensagens, arquivos, estados e transcrições.

Fonte: https://ardumaker.com/pt/docs/historial-de-chats/

- Categoria: Comunicação
- Estado: Disponível
- Requisitos: Um número de [WhatsApp](https://ardumaker.com/pt/docs/whatsapp-business-api) na conta da empresa
- Ferramentas MCP (Só leem): `listar_chat_sandbox_whatsapp`

## O que permite fazer?

- Ver as conversas de um número, cada uma com o contato e a pré-visualização da última mensagem.
- Ler as mensagens de uma conversa, da mais recente para a mais antiga.
- Abrir imagens, áudios, vídeos e documentos recebidos ou enviados.
- Ver o estado de entrega, a transcrição e os tempos de cada mensagem.
- Reenviar uma mensagem concreta aos [webhooks](https://ardumaker.com/pt/docs/webhooks-whatsapp).

## Quando convém usar?

Para rever o que se falou com um contato, auditar o que um bot respondeu ou recuperar uma mensagem que o webhook não processou.

## Como funciona na ArduMaker?

Cada número tem conversas; cada conversa agrupa as mensagens com um contato. As listagens são paginadas com `page` e `page_size` (20 por omissão, até 100). Acede-se com a sessão de um membro da empresa ou com o cabeçalho `Twilio-Api-Sid` do número.

| Dado da mensagem | 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` |

Os arquivos são guardados na ArduMaker e servidos por um URL assinado ou, para quem tem sessão, por um link autenticado.

## O que muda realmente?

Ler não muda nada. O reenvio manual registra destino, código HTTP, erro, duração e quem o pediu, sem mover o ponto a partir do qual o webhook continua a enviar.

## Resultado esperado

Um registro completo de cada conversa do número. As conversas de teste levam `es_sandbox: true`, para se separarem das reais.

## Erros e resolução

- **401**: falta a sessão ou o cabeçalho do número.
- **404**: o número ou a conversa não pertencem a essa empresa.
- **Áudio sem texto**: verificar `transcription_status` e `transcription_last_error` da mensagem.

## Relação com MCP

Via MCP só se lê o chat dos contatos de sandbox com `listar_chat_sandbox_whatsapp`, que inclui o que o bot do cliente respondeu como conteúdo não confiável. As conversas reais não são expostas via MCP. Ver [/mcp/docs](https://ardumaker.com/pt/mcp/docs).

## Funcionalidades relacionadas

- [WhatsApp Business API](https://ardumaker.com/pt/docs/whatsapp-business-api/)
- [Webhooks de WhatsApp](https://ardumaker.com/pt/docs/webhooks-whatsapp/)
- [Transcrição](https://ardumaker.com/pt/docs/transcripcion/)