SGT.ai Contábil Homologação (staging)+ Nova análise

Config WhatsApp

Integração com Evolution API. Secrets ficam no .env, nunca no navegador.

🔒 A `EVOLUTION_API_KEY` e o `WEBHOOK_SECRET` ficam no `.env` do servidor. Esta tela não revela secrets.

Conectar WhatsApp

Evolution acessível
…
Instância
—
Estado da conexão
—
Webhook configurado
…
Resposta automática
…
Como escanear
  1. Abra o WhatsApp no celular.
  2. Vá em Aparelhos conectados.
  3. Toque em Conectar aparelho.
  4. Escaneie o QR Code acima.
  5. Aguarde o estado mudar para Conectado (clique em Verificar conexão).

Status

WhatsApp habilitado
sim
Provider
evolution_api
Pronto (enabled + URL + key)
sim
Status da instância
not_created

Diagnóstico

Instância
not_created
Webhook configurado
não
Resposta automática
desligada
Última mensagem recebida
nenhuma
Webhook (Evolution → SGT.ai)
não configurado
Último erro de envio
nenhum

Resposta automática

WHATSAPP_ENABLED
true
WHATSAPP_AUTO_REPLY_ENABLED
false
WHATSAPP_MAX_AUTO_REPLY_RISK
low
WHATSAPP_REQUIRE_REVIEW_HIGH_RISK
true

Auto-resposta desativada: o sistema registra a mensagem e cria conversa/tarefa quando possível, mas não responde automaticamente.

Modo interno (contadores autorizados)

Modo interno
desligado
Telefones autorizados podem usar IA
sim
Telefones autorizados podem usar Claude
sim
Exige empresa vinculada
não
Permite análises gerais internas
sim
Resposta automática
desligada
Risco máx. de auto resposta
low

⚠️ Este modo é recomendado apenas para uso interno. Não libere publicamente sem autenticação, limites e revisão humana. Respostas de risco alto/crítico saem como rascunho técnico interno com aviso obrigatório — nunca como parecer final.

Telefones autorizados usam o SGT.ai sem precisar de CNPJ/empresa. A empresa vinculada é apenas contexto preferencial. Gerencie os contatos em WhatsApp.

O menu do WhatsApp permite:
  • cadastrar cliente
  • consultar cliente
  • fazer pergunta geral
  • enviar documentos
  • ver relatórios/resumos

O contato envia "menu" no WhatsApp para ver as opções.

Evolution API

URL configurada
http://127.0.0.1:8080
API key configurada
sim
Instância
sgt-ai
Webhook URL
https://staging-api.sgtpremmia.com.br/whatsapp/webhook
Webhook secret configurado
sim

Perguntas de teste (WhatsApp)

Depois de conectar, mande estas mensagens do seu celular para o número conectado:

  1. Pergunta simples: “Quais documentos preciso separar para apurar o DAS mensal?”
    Esperado: mensagem registrada; cria tarefa para análise (ou rascunho seguro se auto-resposta estiver ativa e risco baixo).
  2. Pergunta com empresa: “Empresa Simples Teste LTDA: quais cuidados preciso ter para apurar o DAS?”
    Esperado: se a empresa não for identificada pelo contato, o bot pede o CNPJ. Identificada, cria tarefa.
  3. Pergunta crítica: “Recebi uma intimação da Receita Federal sobre divergência em DCTFWeb. Como responder?”
    Esperado: vai para revisão humana. Nunca parecer técnico automático.
Respostas esperadas do bot
  • Sem empresa identificada: “Para eu analisar com segurança, preciso identificar a empresa. Envie o CNPJ ou selecione a empresa no painel do SGT.ai.”
  • Pergunta simples: mensagem registrada; com auto-resposta + risco baixo, responde rascunho seguro; senão cria tarefa para análise.
  • Pergunta crítica: “Recebi sua demanda e ela foi enviada para revisão no SGT.ai. Um responsável deve validar antes de qualquer resposta técnica.”

Como configurar (resumo)

  1. Suba a Evolution API: docker compose --profile whatsapp up -d.
  2. No .env: WHATSAPP_ENABLED=true, EVOLUTION_API_URL, EVOLUTION_API_KEY, WEBHOOK_SECRET (troque o change_me).
  3. Acima, clique em Criar instância → Gerar QR Code e escaneie no WhatsApp.
  4. Configure o webhook na Evolution apontando para
    POST {PUBLIC_API_URL}/webhooks/whatsapp/evolution com header x-webhook-secret.
  5. Detalhes em docs/16_WHATSAPP_QRCODE_TESTE_REAL.md e docs/14_WHATSAPP_OPERACAO.md.

Ver conversas em WhatsApp.