# 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-05-27T06:56:50.994Z

## Página

- Título: Enviar mensagem (bot)
- URL humana: https://agilize.app/docs/desenvolvedores/api/messenger-chat/message/post-messenger-chat-message-send
- Leitura completa para IA: https://agilize.app/docs/llms.txt
- Descrição: Enviar mensagem (bot)

## 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-api
- Autenticação principal: header x-api-key
- Versão da API: 0.0.12

## Conteúdo da página

Envia uma mensagem em nome do bot (`fromBot: true`), persiste em `messenger/chat/message` e faz dispatch externo (WhatsApp/Facebook/Instagram) conforme o canal da room.

## Método e URL

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

## 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 |

## Corpo da requisição

- Obrigatório: Sim
- Content-Type: application/json

### Campos do corpo

| Campo | Tipo | Obrigatório | Valores / Exemplo | Descrição |
| --- | --- | --- | --- | --- |
| room | string | Sim |  | ID da sala (room) onde a mensagem será enviada |
| message | object | Sim |  |  |
| file | MessengerChatMessageSendFile \| null | Não |  | Arquivo único (alternativa a `files`) |
| files | MessengerChatMessageSendFile[] | Não |  | Lista de arquivos (no momento a plataforma envia apenas o primeiro para canais externos) |

#### Estruturas internas

**message**

```json
{
  "text": [
    "string",
    "null"
  ],
  "buttons": "object"
}
```

**file**

```json
{
  "mimetype": "string",
  "name": "string",
  "fileUrl": "string (uri)"
}
```

**files**

```json
[
  {
    "mimetype": "string",
    "name": "string",
    "fileUrl": "string (uri)"
  }
]
```

Exemplo básico:

```json
{
  "room": "valor",
  "message": {
    "text": "valor",
    "buttons": {}
  }
}
```

## Respostas

| Status | Descrição | Conteúdo |
| --- | --- | --- |
| 200 | Mensagem processada e persistida | application/json |
| 400 | Payload inválido |  |
| 401 | API key ausente ou inválida |  |
| 403 | Sala não pertence ao projeto do usuário |  |
| 404 | Sala não encontrada |  |
| 409 | Configuração do canal não encontrada |  |
| 502 | Falha ao enviar para o provider externo | application/json |

## Testar requisição

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