Tema
Chat do site (rotas públicas)
Rotas que o widget usa no site do cliente. Não pedem login da equipe: o visitante recebe um token próprio ao abrir a conversa. Normalmente você só precisa do código de instalação (veja Chat do site); use estas rotas se quiser montar um chat próprio.
Instalar o widget
html
<script src="https://<seu-painel>/widget.js" data-canal="<chave-do-canal>" async></script>A chave fica em Canais → chat do site. O painel só aceita os domínios cadastrados no canal.
Rotas
| Método | Rota | Para quê |
|---|---|---|
| GET | /api/at/webchat/:chave/config | Aparência, textos, campos do formulário, equipe online e logo |
| POST | /api/at/webchat/:chave/sessao | Abre a conversa. Corpo: { campos: { nome, email, telefone, ... }, consentimento: true, pagina? }. Resposta: { token } |
| GET | /api/at/webchat/historico | Mensagens da conversa do visitante (Authorization: Bearer <token do visitante>) |
| POST | /api/at/webchat/mensagens | Envia mensagem: { texto, opcao_id?, arquivo?: { base64, mime, nome }, pagina? } |
| POST | /api/at/webchat/encerrar | O visitante encerra a conversa |
Tempo real do visitante
Socket.IO em path: /api/socket, namespace /webchat, com auth: { token } do visitante. Eventos: mensagem, digitando, encerrada.
Campos do formulário
Os campos são os configurados no painel. nome, email e telefone vão para o cadastro do cliente; os demais ficam nos dados extras do contato e da conversa.