Enviar eventos para o seu próprio sistema com webhooks

Um webhook permite que o IDup chame um endereço web seu no momento em que algo acontece, por exemplo, quando uma fatura é paga. Cada entrega é assinada e repetida se o seu sistema não responder.

Adicionar um endpoint

1. Abrir o Webhooks aba e pressione Adicionar endpoint.
2. Insira um Nome e o URL. Deve ser publicamente acessível. Endereços dentro de uma rede privada são recusados por razões de segurança.
3. Marque o Eventos você quer.
4. Opcional: escolha um Chave de API. O endpoint então recebe apenas eventos que esta chave pode ler.
5. Imprensa Salvar. O IDup mostra Seu segredo de assinatura uma vez. Armazene-o com segurança.

Eventos

• Fatura criada, Fatura paga, Pagamento recebido
• Novo cliente, Novo contato, Novo lead, Novo ticket
• Oferta aceita — um orçamento que um cliente aceitou

Cada entrega carrega três cabeçalhos: o nome do evento, um número de entrega e a assinatura. Uma nova tentativa mantém o mesmo número de entrega, para que seu sistema possa reconhecer duplicatas.

Verificar a assinatura

Seu sistema deve calcular um HMAC-SHA256 sobre o tempo e o corpo bruto com seu segredo, compará-lo com a assinatura e recusar um tempo superior a 5 minutos. Pressione Verificar assinatura e exemplos para código pronto.

Testar, pausar e renovar

• Enviar teste envia um evento de teste e mostra o código HTTP e o tempo que levou.
• Pausar interrompe as entregas; Ativar os inicia novamente.
• Segredo do rolo cria um novo segredo. O antigo para de funcionar imediatamente.
• Excluir remove o endpoint. Seu log é mantido.

Tentativas e o log

Seu endereço deve responder com um código 2xx em até 5 segundos. Redirecionamentos não são seguidos. Se falhar, o IDup tenta novamente após 1 minuto, 5 minutos, 30 minutos, 2 horas e 12 horas. Após a sexta tentativa, a entrega é marcada Desistiu.

O log mostra cada tentativa com evento, endpoint, tentativa, código HTTP, duração e o início da resposta. O status é Aguardando, Entregue, Falhou ou Desistiu. Use Reenviar para enviar uma entrega novamente.