Webhooks - Solução de Créditos
Os webhooks de créditos permitem que você receba notificações automáticas sempre que houver movimentações na carteira de créditos do cliente.
Com isso, é possível integrar sua loja a outras ferramentas e automatizar comunicações, como avisos via WhatsApp ou e-mail.
Neste artigo, você vai entender:
- Quais eventos estão disponíveis
- Como os webhooks funcionam
- Exemplos de uso na prática
O que são webhooks
Webhooks são notificações enviadas automaticamente quando um evento acontece.
Na prática:
- Um evento ocorre (ex: crédito liberado)
- A plataforma envia uma requisição HTTP para uma URL configurada
- Seu sistema recebe essa informação e pode executar uma ação
Isso permite automatizar processos sem intervenção manual.
Webhooks disponíveis para créditos
Veja os principais eventos que você pode utilizar:
| Webhook | Descrição | Exemplo de uso |
| credit-activated | Disparado quando um crédito fica disponível para uso, com uma data de ativação diferente da data de depósito. | Permite ao vendedor enviar uma notificação ao comprador quando um crédito se torna disponível para uso, mesmo se a data de ativação for posterior à data de depósito. |
| credit-deposited | Disparado quando um crédito é depositado, independentemente da data de ativação. | Útil para informar o comprador sobre a entrada de um novo crédito, permitindo ações imediatas ou notificações ao comprador sobre a disponibilidade de crédito. |
| credit-expiring | Disparado em 7, 3 e 1 dia antes do crédito expirar. | Permite que o vendedor notifique o comprador sobre a iminente expiração do crédito, facilitando ações para utilização antes do vencimento. |
Como funciona na prática
- Você configura uma URL para receber os webhooks
- A plataforma envia notificações sempre que um evento ocorre
- Seu sistema recebe os dados (em formato JSON)
- A partir disso, você pode:
- Disparar mensagens automáticas
- Atualizar sistemas internos
- Criar fluxos de relacionamento com clientes
Exemplo: enviar um WhatsApp quando um crédito estiver prestes a expirar.
