#Agente de IA para escritórios de advocacia e serviços profissionais

Um agente de IA para um escritório de advocacia, de contabilidade ou uma consultoria atende os novos contatos pelo WhatsApp e no seu site, faz as poucas perguntas que servem para classificar o caso, agenda uma primeira consulta na sua agenda e informa aos clientes em que etapa está o caso deles, depois que seu backend confere quem eles são. Nunca dá orientação jurídica ou tributária e nunca prevê um resultado. Com a Vatio você descreve esse agente em um arquivo vatio.yml e ele responde no seu próprio número de WhatsApp e no seu site.

Este guia monta um de ponta a ponta para um escritório de advogados e contadores.

#O que o agente resolve

Quase tudo o que chega à recepção de um escritório são poucas conversas:

• Triagem. “Fui demitido ontem, alguém pode me atender?” O agente pergunta se a pessoa escreve como pessoa física ou empresa, do que se trata em uma frase e se há uma audiência ou um prazo, e escolhe a área de atuação.
• Agendamento. Busca uma consulta livre nessa área e agenda.
• Andamento do caso. Um cliente informa o número do caso e o CPF, e fica sabendo a etapa atual e o próximo passo.
• Honorários e áreas de atuação. Que casos o escritório atende, quanto custa a primeira consulta, o que levar.
• Todo o resto vai para uma pessoa. “O que eu faço?”, “Eu tenho direito?”, os detalhes de um caso, reclamações, qualquer urgência.

Uma conversa típica, com o que o agente fez por dentro:

Visitante: oi, minha empresa recebeu uma notificação da Receita e eu não entendi

Agente: Posso agendar você com a nossa equipe tributária. A notificação tem alguma data, uma audiência ou um prazo para responder?

Visitante: chegou semana passada, diz 30 dias para responder

Agente: Obrigado. A Dra. Rocha tem terça às 11h e quarta às 16h30. Qual fica melhor para você? Traga a notificação e as duas últimas declarações.

Por trás da última resposta houve uma busca no conhecimento e uma chamada a buscar_horarios. O que ele não fez importa tanto quanto: não contou os dias que faltam nem disse o que a notificação significa. Isso é trabalho do advogado.

#Antes de escrever qualquer coisa: cinco perguntas para o escritório

1. Para quais áreas de atuação ele encaminha? E quais casos o escritório não atende, para o agente avisar logo.
2. O que ele nunca pode dizer? Orientação, leituras da lei ou de um documento, chances de ganhar, valores, prazos, se um prazo já venceu.
3. O que é urgente? Uma prisão, uma audiência amanhã, um prazo que vence esta semana, nas palavras do próprio escritório, e para onde mandar a pessoa.
4. De quais sistemas ele lê? A API da agenda, o sistema de gestão de processos, a tabela de honorários.
5. O que o escritório precisa antes de uma primeira reunião? Normalmente o nome da parte contrária, para checar conflito de interesses.

#O vatio.yml

workspace: vidal-rocha
agent:
  name: Vidal & Rocha
  personality: Cordial, preciso e breve. Palavras simples, sem juridiquês.
  instructions: |
    Você é a recepção do Vidal & Rocha, um escritório de advogados e
    contadores. Você recebe novos contatos, agenda primeiras consultas,
    informa aos clientes em que etapa está o caso deles e responde
    dúvidas sobre áreas de atuação e honorários.

    Novos contatos: pergunte, uma coisa de cada vez, se a pessoa escreve
    como pessoa física ou empresa, do que se trata em uma ou duas frases e
    se há uma audiência, uma notificação ou um prazo. Associe o caso a uma
    área de atuação com knowledge_lookup. Se nenhuma servir, diga que o
    escritório talvez não atenda esse tipo de caso.

    Agendamento: chame buscar_horarios para essa área e ofereça no máximo
    três opções. Antes de chamar agendar_consulta, peça o nome completo, o
    email e o nome da parte contrária, e repita o agendamento. Só diga que
    está agendado quando agendar_consulta tiver devolvido. Se falhar por
    outro motivo que não seja um horário já ocupado, diga que a equipe vai
    confirmar por aqui e transfira.

    Andamento do caso: peça o número do caso e o CPF do cliente, e chame
    andamento_caso. Compartilhe só o que ela devolver.

    Regras que você nunca quebra:
    - Nunca dê orientação jurídica, tributária ou contábil, e nunca diga o
      que a lei ou um documento significa para a situação da pessoa.
    - Nunca preveja um resultado, uma chance de sucesso, um valor nem
      quanto tempo um caso vai levar. Nunca diga se um prazo já venceu.
    - Peça só o necessário para classificar e agendar. Se alguém começar a
      contar os detalhes do caso, diga que um advogado vai ver isso na
      consulta.
    - Nunca confirme nem negue que alguém é cliente do escritório.
    - Se alguém foi preso, ou tem uma audiência ou um prazo nos próximos
      dois dias, envie o link de urgência e transfira na hora.
  tools: [buscar_horarios, agendar_consulta, andamento_caso, knowledge_lookup, identify_contact]
  knowledge: [escritorio]
  links:
    urgencia:
      url: https://vidal-rocha.example/urgencia
      when: Alguém foi preso, ou tem uma audiência ou um prazo nos próximos dois dias.
  handoff:
    after_turns: 10
    when:
      - a pessoa pergunta o que deve fazer ou se tem direito
      - a pessoa compartilha detalhes sensíveis do caso
      - um cliente pergunta algo além da etapa do caso
      - uma reclamação sobre o trabalho do escritório ou os honorários
      - um assunto urgente (uma prisão, uma audiência ou um prazo nos próximos dois dias)

Algumas escolhas que vale explicar:

• As regras estão escritas como regras. “Nunca preveja um resultado” em um tópico próprio se sustenta muito melhor do que uma frase sobre ter cuidado. “Nunca diga se um prazo já venceu” importa tanto quanto: uma conta errada dita com segurança está entre as piores coisas que o agente de um escritório pode dizer.
• A triagem pergunta pouco de propósito. Uma ou duas frases bastam para encaminhar o caso. A história completa é para um advogado, não para a transcrição de um chat.
• O link de urgência faz o papel de uma notificação. A Vatio ainda não avisa ninguém de uma transferência: ela aparece no inbox como pendente. Por isso a própria resposta do agente leva o que a pessoa precisa agora, uma página com o telefone de plantão, e depois ele transfere.
• O horário de atendimento decide o que acontece depois de uma transferência. O escritório o define na página Negócio do inbox, não no vatio.yml: por exemplo segunda a quinta das 9:00 às 12:30 e das 14:00 às 18:30, e sexta das 9:00 às 17:00. Dentro do horário o agente fica em silêncio para alguém assumir; fora dele continua ajudando e diz que a equipe vai responder quando o escritório abrir. Os detalhes estão em Human in the loop.

#Tools: agenda e sistema de processos

Guarde o endereço e a chave como secrets para que nunca fiquem no repositório:

vatio secrets set ESCRITORIO_API https://api.vidal-rocha.example
vatio secrets set ESCRITORIO_API_KEY sk_live_...

tools/agendar_consulta.yml:

description: Agenda uma primeira consulta em uma área de atuação.
when_to_use: A pessoa escolheu um horário de buscar_horarios e informou nome, email e a parte contrária.
parameters:
  type: object
  properties:
    horario_id: { type: string }
    area: { type: string, description: "trabalhista, família, tributário ou societário" }
    nome: { type: string }
    email: { type: string }
    parte_contraria: { type: string, description: "Pessoa ou empresa do outro lado" }
  required: [horario_id, area, nome, email]
access: public
request:
  method: POST
  base_url: "$env.ESCRITORIO_API"
  path: /consultas
  requires: [params.horario_id, params.nome, params.email]
  headers:
    Authorization: "Bearer $env.ESCRITORIO_API_KEY"
  body:
    horario_id: "$params.horario_id"
    area: "$params.area"
    nome: "$params.nome"
    email: "$params.email"
    parte_contraria: "$params.parte_contraria"
respond:
  data:
    consulta: "$.consulta"

tools/andamento_caso.yml:

description: A etapa atual e o próximo passo do caso de um cliente.
when_to_use: Um cliente pergunta como está o caso e informou o número do caso e o CPF.
parameters:
  type: object
  properties:
    numero_caso: { type: string, description: "por exemplo VR-2026-0142" }
    cpf: { type: string }
  required: [numero_caso, cpf]
access: public
request:
  method: POST
  base_url: "$env.ESCRITORIO_API"
  path: /casos/andamento
  requires: [params.numero_caso, params.cpf]
  headers:
    Authorization: "Bearer $env.ESCRITORIO_API_KEY"
  body:
    numero_caso: "$params.numero_caso"
    cpf: "$params.cpf"
respond:
  data:
    etapa: "$.etapa"
    proximo_passo: "$.proximo_passo"

buscar_horarios é um GET com a área e uma data inicial que devolve os horários livres para consulta.

#Onde ficam as verificações

No WhatsApp e no Instagram um contato é anônimo até entrar na conta, então esta tool é pública, e qualquer um pode digitar um número de caso. Seu backend confere se o número do caso e o CPF andam juntos; quem preenche os parâmetros é o modelo, então essa verificação não pode ficar no prompt. Devolva o mesmo 404 quando o caso não existe e quando o CPF não bate, para a tool não revelar quais números são reais, e devolva só a etapa e o próximo passo. Um POST mantém o CPF fora das URLs e dos logs de acesso.

A checagem de conflito funciona igual: seu backend a roda com parte_contraria antes de agendar e, se falhar, devolve um erro cuja mensagem não cita ninguém. Documentos e notas fiscais ficam atrás de um login no seu portal do cliente, onde uma tool marcada access: private lê só os casos do cliente que seu backend assinou. Veja Conectar seu backend.

#Conhecimento: áreas de atuação, honorários e primeira consulta

vatio kb create escritorio
vatio kb write escritorio areas-de-atuacao areas-de-atuacao.md
vatio kb write escritorio honorarios honorarios.md
vatio kb write escritorio primeira-consulta primeira-consulta.md

Cada título deve conseguir responder uma pergunta sozinho:

# Honorários

## Primeira consulta
45 minutos, no escritório ou por videochamada. Valor fixo, descontado dos
honorários se o escritório assumir o caso. Aceitamos Pix.

## Ações trabalhistas
Para empregados: um percentual do que for recebido, definido no contrato
de honorários. Se nada for recebido, nada é cobrado.

A Vatio não lê o seu site, então coloque em entradas o que o agente precisa. Quando os honorários mudam, um supervisor pode editar a entrada pelo inbox, e cada edição fica guardada como versão.

#Documentos, áudios e sigilo

Os clientes mandam PDFs e fotos de notificações e contratos, e áudios longos contando a história inteira. A Vatio transcreve o áudio, passa ao agente as imagens e os PDFs compatíveis de até 8 MB e agrupa o que alguém manda em sequência em uma só pergunta. O agente lê um documento como a recepção leria, para encaminhar: uma notificação da Receita vai para a equipe tributária, e uma data nela pode tornar o caso urgente. Ele não interpreta o documento. Os arquivos que ele não consegue ler ficam na conversa para a sua equipe.

O agente diz com clareza que é um assistente e, quando transfere, avisa a pessoa que está consultando um colega. Quem assume vê a conversa inteira e cada chamada de tool no inbox.

#Teste antes de qualquer cliente

vatio push
vatio chat "Oi, fui demitido ontem sem aviso. Alguém pode me atender?"
vatio chat "Eu tenho direito? Quanto eu posso receber?"
vatio chat --new "Em que etapa está o caso VR-2026-0142?"
vatio chat --new "O Pedro Souza é cliente de vocês?"
vatio chat show

A segunda não pode prever nada, a terceira tem que pedir o CPF antes de chamar andamento_caso, e a quarta não pode confirmar nem negar. Depois cadastre seu telefone como número de teste na página Testar do inbox e fale com o agente no número compartilhado de preview do WhatsApp; não precisa de conta na Meta.

#Melhore toda semana

Quem acompanha o inbox marca uma resposta errada e escreve o que deveria ter acontecido. O vatio flags transforma essas notas em um documento a partir do qual seu coding agent corrige, e cada flag vira um caso de eval que o live precisa passar para ser marcado como resolvido. Veja Melhorar seu agente.

#Publicar

vatio publish

Conecte o número de WhatsApp Business do escritório em Canais no inbox e ative. Uma resposta enviada pelo app do WhatsApp Business assume a conversa, e o agente sai de cena até ela ser liberada.

A OAB e os conselhos profissionais têm regras sobre sigilo, publicidade e quem pode orientar, e algumas jurisdições exigem avisar que a pessoa está falando com uma máquina. Confira as suas antes de publicar: a Vatio dá os controles, não a conformidade.

Atualizado: 11 de outubro de 2026