Histórico de chats

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

Categoria: Comunicação
Estado: Disponível
Requisitos: Um número de WhatsApp 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.

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.