# Agilize Docs para IA - Página atual

Este arquivo contém uma versão focada e legível por IA da página aberta na documentação pública da Agilize.
Use esta versão quando a pergunta do usuário estiver restrita ao documento atual.

Última geração: 2026-10-02T05:13:29.335Z

## Página

- Título: Mensagens - Busca por sala
- URL humana: https://agilize.app/docs/desenvolvedores/referencia-tecnica/api/messenger-chat/message/get-messenger-chat-message
- Leitura completa para IA: https://agilize.app/docs/llms.txt
- Descrição: Mensagens - Busca por sala

## Seções

- Método e URL
- Autenticação
- Parâmetros
- Corpo da requisição

## Contexto técnico

- OpenAPI JSON atual: https://agilize.app/api/docs/openapi/agilize
- Referência interativa da API: https://agilize.app/docs/desenvolvedores/referencia-tecnica/referencia-api
- Autenticação principal: header x-api-key
- Versão da API: 0.0.12

## Conteúdo da página

Exige room com o ID de uma única sala e lista mensagens exclusivamente do projeto vinculado à chave de API. Room não aceita listas nem operadores; _id ou tl sozinhos não substituem room. O filtro project enviado pelo cliente é substituído pelo projeto da chave. Retorna um array, sem contagem total. Limite padrão e máximo: 500 mensagens. Rate limit: 300 consultas por minuto por projeto, compartilhado entre todas as chaves. Ordenação somente por _id, decrescente por padrão. Para continuar, use _id[$lt]=<último _id> (ou $gt na ordem crescente), mantendo room. $skip aceita até 1000. Filtros adicionais permitidos: _id, tl, user, createdAt, status, fromBot, isInternal e isDel. Operadores permitidos nesses filtros: $in/$nin (até 100 valores), $ne, $gt, $gte, $lt, $lte e $exists. Busca textual e regex não são disponibilizadas nesta listagem.

## Método e URL

```http
GET https://api.agilize.app/messenger/chat/message
```

## Autenticação

Envie a chave de API no cabeçalho da requisição.

```http
Accept: application/json
x-api-key: SUA_CHAVE_API
```

## Parâmetros

| Nome | Origem | Obrigatório | Tipo | Descrição |
| --- | --- | --- | --- | --- |
| x-api-key | header | Sim | string | Chave da API de integração gerada em seu painel gerencial. |
| content-type | header | Sim | string | application/json |
| $limit | query | Não | integer |  |
| $skip | query | Não | integer |  |
| $sort | query | Não | object |  |
| filter | query | Sim | object |  |

## Corpo da requisição

Este método não utiliza corpo de requisição.

## Respostas

| Status | Descrição | Conteúdo |
| --- | --- | --- |
| 200 | Lista de mensagens da sala no projeto da chave, sem contagem total. Anexos incluem downloadUrl, downloadUrlExpiresAt (null) e downloadRequiresAuth, somente nesta consulta via API. Arquivos gerenciados, galeria e mídias Meta/Telegram usam rotas autenticadas relativas ao host da API. URLs externas já disponíveis são reutilizadas. A listagem não consulta arquivos, provedores ou Google, não assina URLs nem baixa, migra ou verifica arquivos. O acesso e a eventual assinatura ocorrem somente quando o consumidor chama downloadUrl. Siga os redirecionamentos; o download revalida o projeto e pode retornar 404 para anexo ausente ou de outro projeto. | application/json |
| 400 | Room ausente ou inválida, filtro, limite ou ordenação inválidos |  |
| 401 | Chave de API ausente ou inválida |  |
| 403 | Chave de API sem projeto |  |
| 429 | Limite de 300 consultas por minuto por projeto atingido |  |
| 500 | general error |  |
| 503 | Proteção de consultas temporariamente indisponível |  |

## Testar requisição

Preencha os parâmetros, informe a chave no cabeçalho `x-api-key` e envie a requisição diretamente pelo navegador.