agent-cobranca

Agente de cobrança e recuperação de inadimplência via WhatsApp. Conduz régua de cobrança humanizada e respeitando CDC e LGPD.

ICP

Empresas que se beneficiam:

Mensalidades recorrentes (escolas, clínicas, academias)
SaaS com churn por falta de pagamento
Crediário/financeiras com inadimplência leve a moderada
Infoprodutos com parcelamento próprio

Sinais de fit:

Mais de 100 inadimplências mensais
Equipe atual gasta 30+ horas/semana cobrando
Taxa de recuperação atual abaixo de 30% até 30 dias

Sinais de NÃO-fit:

Cobrança jurídica avançada (>90 dias) → vai para escritório
Empresa sem CRM/ERP integrado (não dá para automatizar)
Setor com regulação especial (cobrança bancária pesada)

Casos de Uso

Caso 1: Escola

Cenário: 200 mensalidades atrasadas/mês. Régua: 3, 7, 15 dias. Sequência: lembrete amigável → opção de negociação → handoff financeiro. Resultado esperado: 60-70% recuperação até dia 15.

Caso 2: SaaS B2B

Cenário: 50 clientes/mês com cartão recusado. Sequência: notificação → link para atualizar cartão → suspensão suave de serviço. Resultado esperado: 80% atualização de cartão sem churn.

Tools Específicas

`consultar_debito`

Busca débitos abertos do cliente (valor, vencimento, multa, juros).

@tool
def consultar_debito(tenant_id: str, contato_id: str) -> dict:
    """Retorna lista de débitos com valores atualizados (com mora)."""

`gerar_segunda_via_boleto`

Gera nova via do boleto/PIX com valor atualizado.

`gerar_proposta_negociacao`

Cria proposta dentro de regras pré-definidas (ex: parcelamento até 3x, desconto até 10%).

`registrar_promessa_pagamento`

Registra acordo verbal no CRM com data prometida.

`escalar_cobranca_humana`

Transfere para setor financeiro quando: dívida >R$ X, cliente conflituoso, dúvida jurídica.

Fluxos

Fluxo: Régua de Cobrança Padrão

class ReguaCobrancaState(BaseModel):
    dia_atraso: int
    estagio: Literal["lembrete", "cobranca_ativa", "negociacao", "ultimato"]
    promessa_anterior_quebrada: bool
    valor_total: float
    canal_preferido_cliente: str

Estágios:

Dia	Tom	Ação
-3	Lembrete amigável	”Vencimento se aproxima, posso te ajudar?“
1	Cordial	”Boleto venceu ontem, gostaria de gerar segunda via?“
3	Firme cordial	Proposta de pagamento, opções de PIX
7	Negociação ativa	Oferecer parcelamento dentro de regras
15	Ultimato	Aviso de bloqueio/protesto, última chance
30+	Handoff humano	Sai do agente, vai para financeiro/jurídico

System Prompt (template)

Você é o assistente financeiro da {{empresa.nome}}.

Sua missão é ajudar clientes a regularizar pendências financeiras
de forma respeitosa, ágil e dentro da lei.

PRINCÍPIOS INEGOCIÁVEIS (CDC):
- Nunca cobrar de forma vexatória ou ameaçadora
- Não ligar/mensagem em horário comercial fora (08h-20h, dias úteis)
- Não cobrar valor diferente do devido
- Não constranger publicamente (jamais contatar familiares/empregador)
- Sempre oferecer comprovante de pagamento e quitação

CONTEXTO DO CLIENTE:
- Nome: {{cliente.nome}}
- Débito atual: R$ {{debito.valor_total}}
- Dias em atraso: {{debito.dias_atraso}}
- Histórico: {{cliente.historico_pagamentos}}

COMPORTAMENTO:
- Tom: cordial e firme, nunca agressivo
- Reconhecer dificuldades sem julgar
- Sempre oferecer caminhos (segunda via, parcelamento, contato humano)
- Validar capacidade de pagamento antes de prometer

REGRAS DE NEGOCIAÇÃO:
- Parcelamento: até {{politica.max_parcelas}}x sem juros
- Desconto: até {{politica.max_desconto_pct}}% para pagamento à vista
- Valores acima de R$ {{politica.alcada_humano}}: handoff obrigatório

ESCALAÇÃO PARA HUMANO:
- Cliente alega não dever
- Cliente em crise emocional ou hostil
- Negociação fora das regras pré-definidas
- Dúvida jurídica

default_config.yaml

agent_type: cobranca

agente:
  nome: "Assistente Financeiro"
  tom: "cordial_firme"

modelo:
  principal: "claude-sonnet-4-5"

regua_cobranca:
  estagios:
    pre_vencimento:
      dias: -3
      tom: "lembrete_amigavel"
    apos_vencimento_3d:
      dias: 3
      tom: "cordial_com_opcoes"
    apos_vencimento_7d:
      dias: 7
      tom: "firme_com_negociacao"
    apos_vencimento_15d:
      dias: 15
      tom: "ultimato_cordial"

politica_negociacao:
  max_parcelas: 3
  max_desconto_pct: 10
  alcada_handoff_humano_brl: 1000

horario_envio:
  dias_uteis: ["segunda", "terça", "quarta", "quinta", "sexta"]
  hora_inicio: "09:00"
  hora_fim: "18:00"
  respeitar_feriados: true

compliance:
  cdc: true
  lgpd:
    base_legal: "cumprimento_obrigacao"
    finalidade: "cobranca_extrajudicial"
  proibicoes:
    - "ameacas"
    - "exposicao_publica"
    - "contato_terceiros"

tools_enabled:
  - consultar_debito
  - gerar_segunda_via_boleto
  - gerar_proposta_negociacao
  - registrar_promessa_pagamento
  - escalar_cobranca_humana

KPIs

Métrica	Meta
Taxa de recuperação até dia 15	> 60%
Taxa de promessas cumpridas	> 70%
Taxa de reclamações (Reclame Aqui, Procon)	0
Tempo médio até regularização	< 5 dias
Custo por dívida recuperada	< 5% do valor

Pricing

Setup: R$ 5.000 - R$ 8.000
Mensal: R$ 1.300 - R$ 2.300
Volume API: pass-through + 30%
Tempo de implementação: 4-5 semanas

Inclui:

Mapeamento da régua atual
Integração com sistema de boletos/PIX
Configuração de políticas de negociação
Treinamento da equipe financeira para handoff
Dashboard de inadimplência

Diferencial vs Concorrência

Vs cobradoras terceirizadas: custo fixo, sem comissão por valor recuperado
Vs régua manual: 24/7, sem fadiga emocional do operador
Vs ferramentas de boletos: vai além do envio, conduz negociação

Riscos e Cuidados Legais

ATENÇÃO: cobrança via WhatsApp tem regras específicas:

CDC Art. 42: proíbe cobrança vexatória
STJ Súmula 364: dano moral por cobrança abusiva
LGPD: cliente pode pedir extinção do tratamento (cessar mensagens)
Marco Civil: não pode bloquear cliente que pediu para parar

Salvaguardas técnicas:

Detecção automática de palavras de stress (“pare”, “estou doente”, “perdi emprego”) → handoff humano
Limite de mensagens por semana
Log completo de todas as comunicações
Botão de “parar mensagens” sempre disponível

Anti-padrões

Tom agressivo: vira processo no Procon. Sempre cordial.
Insistência diária: vexatório. Respeitar régua e janelas.
Negociar fora das regras: vira problema fiscal/contábil. Sempre dentro do config.
Ignorar pedido humano: se cliente pede pessoa, transferir imediatamente.