Operando a plataforma via IA
Ponto de partida para agentes de IA (Claude, Codex e similares) operarem a plataforma com segurança — o mapa das funções.
Este é o manual do operador IA: o que um agente (Claude, Codex ou similar) precisa para ler e alterar a plataforma de verdade — fluxos, assistentes, etiquetas, departamentos, remarketing, webhooks — sem quebrar o atendimento real.
Condensa 3 fontes (verificadas em 2026-09-04):
- Vault — fonte de verdade:
Conhecimento/Automação/Runbooks Sagazchat/(23 runbooks de módulo + índice de scripts Playwright, atualizados até 2026-08-30). - Espelho no repo:
central_de_ajuda/processo-central-ajuda-ia/runbooks/(22 arquivos). - Skill
sagazchat-platform: referência da API interna, camada mais nova (até julho/2026).
O detalhe exaustivo (seletores Playwright, payloads completos, quirks de UI) continua nos runbooks. Estas páginas são o mapa + regras duráveis: o suficiente para operar com segurança e saber onde aprofundar.
Regra de ouro: leia o estado real antes de afirmar
Antes de listar pendências, descrever um fluxo ou propor mudança, faça GET /flowbuilder/flow/{id} e audite contra o estado real. Vault, checkpoints e memória podem estar desatualizados ou inventados — o backend é a única fonte confiável no momento da operação.
As APIs (não confunda as três)
| API | Base | Auth | Serve para |
|---|---|---|---|
| Mensagens (pública) | https://backend.sagazchat.com/api/messages | Authorization: Bearer <token da conexão> — um token por canal conectado, não por usuário/empresa | Sistemas externos enviarem texto, mídia, áudio e figurinha. Detalhe em API de Mensagens |
| Interna do app | https://backend.sagazchat.com | JWT de login (POST /auth/login), dura ~24h | Tudo deste manual: fluxos, etiquetas, departamentos, assistentes, remarketing etc. É a API que o próprio frontend usa |
| Assistentes IA + KB | Mesma base interna | Mesmo JWT | CRUD de agentes (/assistents — com esse typo mesmo), vínculo com base de conhecimento, configs por canal |
Os 3 sistemas de IA (não misture)
- Assistentes de atendimento (
/assistents) — respondem o cliente no WhatsApp. - Assistente pessoal do dono (
/advisor,/internal-assistant) — agenda e finanças do dono. - Base de conhecimento (
/kb) — help center público + RAG vetorial, que pode ser vinculada a um assistente do tipo 1.
O manual por função
| Página | Quando usar |
|---|---|
| Autenticação | Entrar na API interna, reusar token, armadilhas de rede e de troca de empresa |
| Fluxos | Listar, ler, criar e publicar fluxos sem quebrar o atendimento |
| Blocos e armadilhas | Schemas dos nodes e os erros que silenciosamente não funcionam |
| Assistentes IA | Criar agentes, vincular base de conhecimento e ligar no canal |
| Módulos e segurança | Mapa módulo → endpoint, o que é seguro vs destrutivo, scripts |
Para o passo a passo humano (cliques na interface), use as categorias Automação, IA Sagaz e Configurações. Para setup de cliente novo, a sequência completa está na skill (§16 Padrão Completo de Setup) e no formulário de setup em processo-central-ajuda-ia/.
O detalhe completo: categoria Runbooks
Os 24 runbooks do vault estão publicados na categoria Runbooks — um por módulo (fluxos, assistentes IA, webhooks, etiquetas, departamentos, horários, KB, biblioteca de mídias, instagram-posts, índice de scripts Playwright…), com seletores, payloads, quirks e scripts validados. É para lá que cada página deste manual aponta quando o assunto aprofunda.
Validade deste manual
Síntese fiel das fontes em 2026-09-04. Trechos marcados [a validar] nos runbooks continuam pendentes (ex.: ordem de prioridade entre disparadores, diferença prática audio-rec vs audio-forward, limites de rate). Se a plataforma mudou depois desta data, o GET no backend prevalece sobre qualquer texto aqui.