> ## Documentation Index
> Fetch the complete documentation index at: https://docs.synax.app.br/llms.txt
> Use this file to discover all available pages before exploring further.

# Mensagens

> Como consultar mensagens de conversas via API

# Mensagens

O recurso `messages` permite consultar o histórico de mensagens das conversas.

<Note>
  Mensagens são somente leitura via API. Para enviar mensagens via WhatsApp, use o app.
</Note>

## Listar mensagens de uma conversa

Use o filtro `conversation_id` para buscar mensagens de uma conversa específica:

```bash theme={null}
curl "https://api.synax.app.br/functions/v1/api-proxy/messages?conversation_id={id}&order=created_at.asc" \
  -H "Authorization: Bearer sk_live_SuaChaveAqui"
```

### Campos da mensagem

| Campo         | Tipo   | Descrição                                                   |
| ------------- | ------ | ----------------------------------------------------------- |
| `direction`   | string | `in` (recebida), `out` (enviada), `internal` (nota interna) |
| `type`        | string | `text`, `image`, `audio`, `video`, `document`, `location`   |
| `content`     | string | Conteúdo textual                                            |
| `media_url`   | string | URL da mídia (quando aplicável)                             |
| `sender_name` | string | Nome do remetente                                           |
| `created_at`  | string | Data/hora da mensagem                                       |