Pular para o conteúdo
D-APITestar grátis

saas de cobrança

WhatsApp para software de cobrança: uma régua com Pix, ligação e SMS no mesmo lugar

Coloque WhatsApp no seu software de cobrança e monte a régua inteira num fornecedor só: lembrete com botão Pix e boleto, ligação de URA que captura a tecla do devedor e SMS para quem não está no WhatsApp.

SaaS testa 14 dias com o time técnico ajudando na integração.

conexões na D-API
1.875
de uptime garantido em contrato
99,9%
datacenters no Brasil
4
por ligação de WhatsApp na API não-oficial
R$ 0
  • Pix com um toque

    POST /api/v1/interactive/send/pix envia a chave com botão de cópia, valor e identificação da fatura.

  • Ligação que vira dado

    A URA toca o áudio do credor e cada tecla pressionada chega como evento call.dtmf no seu backend.

  • Três canais, um padrão de webhook

    WhatsApp, voz e SMS na mesma conta, com a mesma API key e envelope de eventos parecido. A régua vive inteira no seu código.

Um software de cobrança é medido por uma coisa: quanto do valor em aberto volta para o credor. Isso depende de chegar ao devedor no canal certo, na hora certa, com o caminho para pagar a um toque de distância. O WhatsApp para software de cobrança cobre a maior parte desse caminho, e a D-API soma a ele os dois canais que a régua precisa para quem não responde mensagem: ligação com menu por tecla e SMS.

Esta página mostra como uma plataforma de cobrança, gestão de recebíveis ou ERP com módulo financeiro monta a régua inteira com a D-API, do lembrete antes do vencimento até a ligação para a fatura atrasada.

O credor cobra pelo próprio número

Devedor ignora número desconhecido. Por isso cada cliente do seu software, seja uma escola, um condomínio, uma clínica ou uma empresa de serviços, conecta o próprio WhatsApp numa conexão isolada criada pelo seu backend. A cobrança sai de quem o devedor reconhece, e a resposta dele volta para o seu sistema com o sessionId do credor.

O custo acompanha o modelo do seu negócio. Na API não-oficial, a cobrança da D-API é por conexão ativa, sem tarifa por mensagem. A régua de um credor com dez mil faturas no mês custa o mesmo que a de um com cem, e o preço de cada conexão cai conforme a sua base de credores cresce.

Lembrete com Pix e boleto na conversa

O lembrete que funciona é o que já traz o meio de pagamento. Antes do vencimento, o seu software envia a mensagem com o botão Pix, que coloca a chave do credor na conversa com botão de cópia e valor:

POST /api/v1/interactive/send/pix
{
  "sessionId": "credor-904-escola",
  "to": "5585966665555",
  "content": "Olá, Carlos. A mensalidade de novembro, de R$ 640,00, vence na sexta. Toque para copiar a chave Pix.",
  "footer": "Financeiro Escola Horizonte",
  "pixKey": "[email protected]",
  "pixAmount": 640,
  "pixMessage": "Mensalidade nov"
}

Para quem prefere boleto, POST /api/v1/messages/send/document envia o PDF na sequência, com fileName e caption. Os status message.delivered e message.read chegam por webhook e mostram ao credor quem recebeu e quem leu o lembrete, o que ajuda a decidir o próximo passo da régua.

A baixa continua onde sempre esteve. O endpoint envia a cobrança, e a confirmação vem do banco ou do provedor de pagamento integrado ao seu software. Quando a baixa chega, o seu sistema manda o recibo na mesma conversa e tira o devedor da régua.

Conversa de negociação

Parte dos devedores responde ao lembrete pedindo prazo ou parcelamento. A mensagem chega no webhook messages.received, e o seu sistema decide se responde com uma proposta automática ou se abre um atendimento para o time do credor. Uma lista interativa com as opções de parcelamento devolve a escolha com o identificador que você definiu, pronta para gerar o acordo.

Ligação de URA para a fatura atrasada

Quando o lembrete não teve resposta, a régua sobe para voz. A URA da D-API faz ligações telefônicas com um áudio gravado pelo credor ou com um fluxo interativo montado no builder do painel. Para uma fatura vencida, o fluxo pode tocar “sua fatura está em aberto, pressione 1 para receber a chave Pix no WhatsApp ou 2 para receber a segunda via por SMS”, com blocos de WhatsApp e SMS dentro do próprio fluxo.

Para a carteira inteira de atrasados, POST /api/v1/voice/bulk recebe a lista de destinos em recipients, cada um com phone e variables, e aceita scheduledAt para começar a discagem no horário que o credor escolheu. O campo maxAttempts define quantas vezes tentar quem não atendeu. As variáveis entram no contexto do fluxo e podem ir, por exemplo, numa chamada HTTP para o seu backend gerar a segunda via certa. O disparo de voz em massa detalha os dois modos.

O resultado volta por webhook, e é aqui que a ligação vira dado de cobrança. O call.answered diz quem atendeu, cada tecla gera um call.dtmf e o call.ended traz answered, talkSeconds e o código de causa. O seu software grava “atendeu e pediu Pix” ou “não atendeu após duas tentativas” na ficha da fatura. Os campos de cada evento estão na documentação da D-API, e a página sobre webhooks de URA mostra como tratá-los.

SMS para quem está fora do WhatsApp

Alguns devedores não têm WhatsApp no número cadastrado. Para eles, POST /api/v1/sms/send envia o aviso com a linha digitável ou o link de pagamento, e POST /api/v1/sms/bulk manda o mesmo texto para uma lista. A API de SMS usa a mesma API key, não depende de conexão e notifica o status final por webhook: sms.delivered, sms.undelivered, sms.failed ou sms.expired. Um errorCode como INVALID_NUMBER ou LANDLINE é sinal para o seu software marcar o cadastro para revisão.

Cobrança pela API Oficial

Alguns credores exigem a API Oficial da Meta. A conexão nasce pelo Embedded Signup hospedado pela D-API, e o envio continua pela mesma rota. A regra que muda é a da Meta: fora da janela de 24 horas, o lembrete sai como template aprovado. Avisos de fatura costumam se encaixar na categoria de utilidade, e a tarifa de cada categoria é cobrada pela Meta na conta do próprio credor. O artigo sobre cobrança das mensagens de serviço explica quando a conversa não gera tarifa. Para templates com pagamento, a rota de envio aceita botões payment_request e order_details, com o valor em reais.

Cuidados de uma régua de cobrança

Cobrança tem regras de proteção ao consumidor, e o seu software ajuda o credor a cumpri-las. Mensagem com o essencial (valor, vencimento, como pagar), sem expor a dívida a terceiros e sem mandar cobrança em grupo. Horário de envio e de ligação configurável pelo credor. Registro de cada contato feito, com canal e resultado, para responder a qualquer contestação. E uma forma clara de o devedor dizer que já pagou, que chega no webhook e pausa a régua até a conferência.

Por onde começar

Comece pelo lembrete com Pix, que é o passo de maior volume. Depois conecte a baixa do provedor de pagamento para tirar o devedor da régua automaticamente. Com isso redondo, acrescente a URA para os atrasados e o SMS para quem não tem WhatsApp. A modelagem de conexões por credor e o modelo de cobrança estão na página de API de WhatsApp para SaaS.

Time D-API. Atualizado em .

Perguntas frequentes

A D-API confirma o pagamento do Pix?

Não. O endpoint de Pix envia a chave com botão de cópia e valor opcional. A baixa da fatura vem do banco ou do provedor de pagamento que o seu software já usa.

Posso disparar a ligação de cobrança em horário agendado?

Sim. POST /api/v1/voice/bulk aceita scheduledAt em ISO 8601. Com data futura, a campanha fica agendada e a discagem começa no horário.

Cada credor usa o próprio número de WhatsApp?

Sim. Cada cliente do seu software conecta o próprio número numa conexão isolada, e o devedor recebe a cobrança de quem ele reconhece.

Na API Oficial, como fica o lembrete de vencimento?

Fora da janela de 24 horas, ele sai como template aprovado. Lembrete de fatura costuma se encaixar na categoria de utilidade, e a tarifa da Meta é cobrada na conta Meta do credor.

O SMS recebe resposta do devedor?

Não. O SMS da D-API é só de envio, com status de entrega por webhook. Para conversa de mão dupla, o canal é o WhatsApp.

A gente também é SaaS

SaaS liberado pelo time testa 14 dias grátis, com um grupo de onboarding em que o time técnico da D-API acompanha a integração no seu produto.

Continue por aqui

Liberar seu teste grátis

Responda rapidinho e o time libera seu teste pelo WhatsApp, com o time técnico ajudando na integração.

Seus dados são usados só pra liberar o teste. Sem spam.