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
GET https://api.agilize.app/messenger/chat/messageAutenticação
Envie a chave de API no cabeçalho da requisição.
Accept: application/json
x-api-key: SUA_CHAVE_APIParâ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 |
Exemplos básicos
Escolha uma linguagem para abrir o exemplo de requisição.
Testar requisição
Preencha os parâmetros, informe a chave no cabeçalho x-api-key e envie a requisição diretamente pelo navegador.