Campanhas são o coração da cobrança automatizada. Cada campanha agrupa dívidas, define a estratégia de abordagem e controla o ciclo de vida do contato com devedores.
Endpoints
#Todos os endpoints requerem autenticação via JWT (Authorization: Bearer TOKEN).
Criar campanha
Cria uma nova campanha de cobrança. A campanha é criada com status DRAFT e precisa ser lançada separadamente.
Listar campanhas
Retorna a lista paginada de campanhas do cliente autenticado. Suporta filtros por status e ordenação por data de criação.
Estatísticas da campanha
Retorna KPIs da campanha: total de dívidas, valor pendente, taxa de recuperação, conversas ativas e pagamentos confirmados.
Preview de dívidas
Retorna uma amostra das dívidas que serão contactadas quando a campanha for lançada. Útil para validar filtros antes do disparo.
Lançar campanha
Altera o status da campanha para ACTIVE e inicia o envio de mensagens via WhatsApp. Essa ação não pode ser desfeita, apenas pausada.
Pausar campanha
Pausa uma campanha ativa. Novas mensagens não serão enviadas, mas conversas em andamento continuam respondendo.
Arquivar/desarquivar campanha
Alterna o estado de arquivamento da campanha. Campanhas arquivadas não aparecem na listagem padrão.
Listar dívidas da campanha
Retorna a lista paginada de dívidas vinculadas à campanha, incluindo status de contato e pagamento de cada uma.