Documentação — Strato AI Agent

O que é

O Strato AI Agent conecta seu número ao painel via WhatsApp Web (método não oficial) e permite que um agente de IA responda mensagens seguindo um prompt (regras/estilo) e que um humano assuma a conversa quando necessário.

O que o agente pode e não pode fazer

• Pode: ler mensagens de texto recebidas, gerar respostas com IA e enviar mensagens (texto) pelo seu número.
• Não pode: acessar seu WhatsApp como humano, clicar em telas, fazer pagamentos, abrir links ou executar ações fora do sistema sem integração explícita.

Risco e estabilidade

Por ser integração não oficial, pode haver quedas. O produto exige aceite explícito antes de conectar.

1) Criar conta

1. Acesse /auth.
2. Escolha Cadastro.
3. Preencha empresa, nome, e-mail e senha.
4. Entre e acesse o painel /app/dashboard.

2) Assinar (Stripe)

1. Acesse /checkout.
2. Clique em Ir para pagamento.
3. Após confirmação do Stripe, o painel libera as funções.

Passo a passo

1. Abra /app/whatsapp.
2. Leia o termo, marque o checkbox e clique Registrar aceite.
3. Clique Gerar QR / Conectar.
4. Abra o WhatsApp no celular → Aparelhos conectados → Conectar um aparelho → escaneie o QR.

Expiração do QR

O QR Code expira. Quando isso acontecer, o painel avisa e você precisa clicar em Gerar QR / Conectar para obter um novo.

Desconectar

O botão Desconectar só aparece quando o status está CONNECTED. Ao desconectar, o número deixa de responder via agente.

Onde configura

Vá em /app/agent e ajuste:

• Nome do agente
• Persona (papel, estilo, postura)
• Tom de voz (ex.: objetivo e educado)
• Prompt (regras operacionais e como responder)
• WhatsApp do humano (para alertas/handoff, quando habilitado)

Exemplos de prompt

Você é um SDR de IA da clínica. Objetivo: qualificar e agendar.
Regras:
- Responda sempre em português.
- Seja curto.
- Faça 1 pergunta por vez.
- Se a pessoa pedir preço, diga que varia e peça procedimento + cidade.
- Se a pessoa ficar irritada, ofereça falar com humano.

Você é suporte do produto. Objetivo: resolver rápido.
Regras:
- Confirme e-mail/empresa.
- Peça print/erro.
- Se for crítico, encaminhe para humano.

Ver conversas

Acesse /app/conversations para listar as conversas. Clique em Ver mensagens para abrir o histórico.

Assumir / Devolver

• Assumir (takeover): o humano assume e a IA deve parar de interferir.
• Devolver pra IA: libera para a IA voltar a responder.

O painel exibe uso estimado. Ao atingir limites, o sistema pode entrar em modo econômico (quando habilitado) para reduzir custo.

Não aparece QR

• Confirme que você registrou o aceite do termo.
• Clique novamente em Gerar QR / Conectar.
• Se continuar, desconecte e reconecte.

Caiu / Desconectou

• Acesse /app/whatsapp e gere QR novamente se necessário.
• Confirme se o WhatsApp no celular não removeu o aparelho conectado.

IA respondeu errado

• Refine o prompt (regras mais claras, exemplos, limites).
• Use takeover humano nas conversas sensíveis.

Suporte: suporte@stratoai.com.br.