> ## Documentation Index
> Fetch the complete documentation index at: https://help.treble.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# fact_agent_conversation_messages

> Cada mensagem trocada dentro das conversas de agentes.

# fact\_agent\_conversation\_messages

Cada linha é uma mensagem dentro de uma conversa de agente: o que o cliente escreveu, o que o agente respondeu, e quando foi entregue e lida. Ela substitui a antiga `fact_agent_messages`.

## Que perguntas ela responde?

* O que foi dito em uma conversa de agente, em ordem?
* Quantas mensagens cada agente envia por dia?
* Com que rapidez as mensagens dos agentes são lidas pelos clientes?
* Qual parcela do tráfego dos agentes é mídia vs texto?

## Colunas

| Coluna                  | Tipo       | Descrição                                                                                                                                                     |
| ----------------------- | ---------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `message_id`            | Int32      | Identificador único da mensagem                                                                                                                               |
| `company_id`            | Int32      | Sua empresa (filtrada automaticamente)                                                                                                                        |
| `agent_conversation_id` | Int32      | A conversa de agente à qual pertence                                                                                                                          |
| `session_id`            | Int64      | O fluxo de conversa de origem; `0` se não houver                                                                                                              |
| `created_at`            | DateTime64 | Quando a mensagem foi enviada                                                                                                                                 |
| `sender`                | String     | `USER` (cliente), `AGENT` (agente humano) ou `AI` (assistente de IA respondendo na conversa)                                                                  |
| `category`              | String     | `text`, `image`, `audio`, `video`, `document`, `hsm`, `sticker`, `location`, `contacts`, `whatsapp_flow`, `whatsapp_flow_response`, `call_request_permission` |
| `content`               | String     | Conteúdo da mensagem (texto, ou URL da mídia para arquivos)                                                                                                   |
| `agent_id`              | Int32      | Agente que a enviou; `0` para mensagens de `USER` e `AI`                                                                                                      |
| `agent_name`            | String     | Nome desse agente                                                                                                                                             |
| `tag_id`                | Int32      | Tag da conversa no momento do envio                                                                                                                           |
| `team_name`             | String     | Nome da equipe                                                                                                                                                |
| `read_at`               | DateTime64 | Quando o destinatário a leu; `NULL` se não lida                                                                                                               |
| `delivered_at`          | DateTime64 | Quando o WhatsApp confirmou a entrega                                                                                                                         |
| `wa_id`                 | String     | ID da mensagem no WhatsApp (`wamid`)                                                                                                                          |
| `reply_provider_msg_id` | String     | Se cita/responde outra mensagem, o `wamid` dessa mensagem                                                                                                     |
| `reaction`              | String     | Reação de emoji, se houver                                                                                                                                    |
| `synced_at`             | DateTime64 | Quando esta linha foi gravada/corrigida pela última vez                                                                                                       |

<Note>
  Mensagens pertencentes a conversas que foram apagadas na plataforma ficam de fora — cada linha aqui tem uma conversa pai existente em [`fact_agent_conversations`](/pt/docs/data-warehouse-v2/fact-agent-conversations).
</Note>

## Exemplos de consultas

### Reconstruir uma conversa de agente

```sql theme={null}
SELECT created_at, sender, agent_name, category, content
FROM fact_agent_conversation_messages
WHERE agent_conversation_id = {your_conversation_id}
ORDER BY created_at
```

### Mensagens enviadas por agente por dia

```sql theme={null}
SELECT
    agent_name,
    toDate(created_at) AS day,
    count()            AS messages_sent
FROM fact_agent_conversation_messages
WHERE sender = 'AGENT'
  AND created_at >= today() - 7
GROUP BY agent_name, day
ORDER BY day, messages_sent DESC
```