← NEW FLOW LEGAL

Attorney Setup & Kickoff

3ª etapa do NEW FLOW LEGAL - agente de comunicação com o cliente (Agno)

Agente Agno · ativo Canal: Yousa Chat (WhatsApp) · ativ. 7 e 37 Gate humano: Attorney aprova a mensagem Integra Google Forms + Calendar

O Attorney BR recebe o caso (evento de kickoff já aberto em "waiting scheduling"), define possíveis datas de kickoff e aprova a mensagem. A partir daí o agente conversa com o cliente - manda as datas e explica o app, troca mensagens até a confirmação, envia o Google Forms nos casos de asilo, e ao confirmar grava a data no Case Event e na agenda do Attorney.

Onde entra no fluxo

→
Attorney BR
Setup + aprova msg
datas, estratégia, mensagem ao cliente
→
Agente
fala com o cliente
datas + app · multicanal · (asilo: Forms)
→
Agente
trocas até confirmar
conduz a conversa
→
Data confirmada
grava data
Case Event + agenda Google do Attorney

O setup do Attorney (antes do agente disparar)

  1. Define possíveis datas de kickoffO evento já está aberto em "waiting scheduling".
  2. Confirma estratégia e filingsValida a direção definida no Coordinator Setup.
  3. Aciona o Specialist (se preciso)Para confirmar estratégia/filings.
  4. Aprova a mensagem ao clienteGate humano: o agente só dispara o que o Attorney confirmar.
  5. Aciona o Legal AssistantApoio inicial quando necessário.
  6. Define o conteúdoEm todos os casos: kickoff + app; em asilo, também o Google Forms.
✋
Gate humano (importante): o agente não fala com o cliente por conta própria. O Attorney aprova a mensagem inicial; o agente conduz a conversa a partir dela. Mensagens ao cliente brasileiro em português claro (política de comunicação com cliente).

O que o agente faz

Disparo

📣 Mensagem inicial

Envia as opções de data de kickoff e explica o app do cliente - por WhatsApp, e-mail e/ou app, conforme o caso.

Conversa

💬 Trocas até confirmar

Responde dúvidas e reenvia opções até o cliente confirmar uma data. Acompanha sem precisar do Legal Assistant a cada passo.

Asilo

📝 Google Forms

Nos casos de asilo, envia o formulário (Google Forms) junto com as mensagens iniciais, antes do kickoff, e acompanha o preenchimento.

Confirmação

📅 Grava a data

Data confirmada → atualiza o Case Event de Kickoff no sistema e adiciona o evento na agenda Google do Attorney.

Integrações necessárias

IntegraçãoUsoStatus no sistema
Yousa Chat (WhatsApp da firma)Canal do agente com o cliente (envio + webhook de resposta + varredura do CRM a cada 2 min)Canal trocado pelo Yousa Chat na ativ. 37; identifica o cliente pelo telefone E.164; primeira mensagem por template na conexão oficial. NPS usa Meta à parte.
App mobile do clientePush/in-app + onboarding ("o app")yousa-mobile (Flutter) - a integrar
Google FormsFormulário de asiloA integrar
Google Calendar / MeetAo confirmar a data, o backend chama o dash-backend (yousa-sales) create-and-enable: cria o evento (com Meet) + liga a transcrição e devolve google_event_id/google_space_id. Nosso backend não guarda creds Google.A integrar (ativ. 7) · contrato em setup-meet-sync-monorepo.md
Case Event (sistema)Evento de kickoff: status + dataJá existe (Coordinator abre em "waiting scheduling")

Compliance & limites

COMP-05

✅ Mensagem aprovada

Comunicação com cliente passa pela aprovação do Attorney antes do disparo. Em português claro para cliente BR.

COMP-04 / 06

🔒 PII & uso de IA

PII do cliente tratada com cuidado; trocas registradas no caso. O agente não decide mérito - só agenda e orienta.

Fallback

🙋 Volta pro humano

Sem confirmação após X tentativas, dúvida fora do escopo de agendamento, ou red flag → entrega pro Legal Assistant/Attorney.

Melhorias para habilitar este agente

Para conversar com o cliente de forma segura e consistente, alguns pré-requisitos antes (ou junto) do agente:

Conteúdo

🧩 Templates aprovados

Biblioteca de mensagens aprovadas (kickoff, app, lembrete, asilo) em português, com variáveis - o que o Attorney "aprova" vira escolha de template, não texto livre.

Conversa

🧵 Inbound + parsing de data

Receber respostas (webhook WhatsApp já existe no NPS) e interpretar a confirmação de data com robustez (fuso, formatos, "pode ser na quarta").

Memória

🗂️ Histórico de conversas

Registrar a thread por caso/cliente - base para continuidade, auditoria e para os próximos agents (mesma ideia do ativo de histórico do time).

🧭
Resumo do papel: humano define e aprova (datas + mensagem); o agente executa a conversa multicanal até confirmar e registra (Case Event + agenda). É o primeiro agente que fala com o cliente - por isso o gate de aprovação e o fallback pro humano são centrais.