Autenticação - Brainchat

Todas as chamadas à API do Brainchat (exceto endpoints públicos) exigem autenticação via header X-Client-Token.

Gerar Token

Entre no Brainchat

Faça login em brainchat.app e selecione o canal.

Abra Developers → API

No menu lateral, vá em Developers → API, aba Brainchat API.

Gere ou copie o token

Sem token ainda, clique em Gerar token. Com token criado, use Copiar token. Esse é o X-Client-Token do canal. Rotacionar token gera um novo e invalida o anterior.

Aba Brainchat API com o botão Gerar token e a lista de tokens — Developers → API, aba Brainchat API

Como usar

Inclua o token no header de todas as requisições:

curl -X POST "https://wapi.stegia.com.br/functions/v1/send-message" \
  -H "Content-Type: application/json" \
  -H "X-Client-Token: SEU_TOKEN_AQUI" \
  -d '{ ... }'

Headers obrigatórios

Header	Valor	Obrigatório
`Content-Type`	`application/json`	Sim
`X-Client-Token`	Seu token de API	Sim (exceto endpoints públicos)

Chave de embed + token

Nas rotas de atendimento (/conversations-api/...) a identificação do canal é feita pela chave de embed (embedKey, no corpo da requisição), e não pelo ID do canal.

Credencial	Papel	Pode ser rotacionada
`embedKey` (corpo)	Diz qual canal recebe a ação	Sim, em Developers → Embedding (Rotacionar Key)
`X-Client-Token` (header)	Diz quem pode executar a ação	Sim, em Developers → API (Rotacionar token)

As duas precisam pertencer ao mesmo canal; se forem de canais diferentes, a chamada é recusada com 403.

O par é obrigatório: chamadas com apenas uma das credenciais são recusadas.

Segurança

Nunca exponha o token no frontend ou código-fonte público
Armazene o token em variáveis de ambiente no servidor
Gere um novo token se suspeitar de vazamento
O token está vinculado ao seu canal

Base URL

https://wapi.stegia.com.br/functions/v1/

Todos os endpoints da API usam esta base URL.