Enviar mensagem (bot)

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

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

Autenticação

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

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

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

file

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

files

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

Exemplo básico:

{
  "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.

Carregando teste interativo do endpoint...

POST`/messenger/chat/message/send`