Conceitos-chave
Conta
A entidade raiz do Retuno. Uma conta por SaaS cliente. Isola dados, estratégias, base de conhecimento, conversas e configurações. Nada é compartilhado entre contas.Webhook receiver
Endpoint HTTPS do Retuno que recebe eventos do seu SaaS (cancelamento, inatividade, queda de uso, falha de pagamento). É você quem dispara — o Retuno não observa seu produto por fora. Veja Enviando eventos ao Retuno e Webhooks & Eventos.Agente
Identidade conversacional única por conta: nome, tom de voz, mensagem de abertura. O agente conduz a conversa seguindo um fluxo que o Retuno controla passo a passo. Veja Identidade do agente.Base de conhecimento
Documentos, URLs e textos que o agente consulta para responder objeções específicas. Sem ela, o agente responde genérico. Com ela, cita a feature real que o cliente disse não ter encontrado. Veja Base de conhecimento.Playbooks
Estratégias aprovadas por tipo de objeção (ex.: dúvida de preço, falta de feature). O agente só age em resolução quando há uma estratégia aprovada para aquele tipo de objeção. Veja Playbooks.Guardrails
Regras de autonomia do agente, como percentual máximo de desconto e limite de extensão de trial, além dos critérios de escalação para humano. Veja Guardrails.Modo Supervisão
Camada de aprovação humana sobre ações sensíveis — aplicar desconto, estender trial, escalar para humano. Cada ação pode serauto (executa na hora) ou approve (espera aprovação do operador). Veja Modo Supervisão.
Como as peças se conectam
- Seu SaaS envia um evento para o webhook receiver — ex.:
subscription.cancelledcom os dados do usuário. - O Retuno classifica o risco e o agente abre uma conversa no WhatsApp com mensagem curta e uma pergunta aberta.
- O agente diagnostica a objeção real usando o que o cliente responde.
- Quando a objeção está classificada, o agente segue a estratégia aprovada para aquele tipo de objeção e tenta resolver sem custo.
- Se o cliente ainda resiste, o agente pode escalar a oferta sempre dentro dos limites configurados na conta.
- O cliente aceita, recusa ou o agente escala para humano.
- Se o cliente permanece pagando por 30 dias após a conversa, conta como receita atribuída.