Envoyer des événements à votre propre système avec des webhooks

Un webhook permet à IDup d'appeler une de vos adresses web au moment où quelque chose se passe, par exemple lorsqu'une facture est payée. Chaque livraison est signée et répétée si votre système ne répond pas.

Ajouter un point de terminaison

1. Ouvrir le Webhooks onglet et appuyez sur Ajouter un point de terminaison.
2. Entrez un Nom et le URL. Elle doit être publiquement accessible. Les adresses à l'intérieur d'un réseau privé sont refusées pour des raisons de sécurité.
3. Cochez le Événements vous voulez.
4. Optionnel : choisissez un Clé API. Le point de terminaison ne reçoit alors que les événements que cette clé peut lire.
5. Presse Enregistrer. IDup affiche Votre secret de signature une fois. Conservez-le en sécurité.

Événements

• Facture créée, Facture payée, Paiement reçu
• Nouveau client, Nouveau contact, Nouveau prospect, Nouveau ticket
• Devis accepté — un devis qu'un client a accepté

Chaque livraison comporte trois en-têtes : le nom de l'événement, un numéro de livraison et la signature. Une nouvelle tentative conserve le même numéro de livraison, afin que votre système puisse reconnaître les doublons.

Vérifier la signature

Votre système doit calculer un HMAC-SHA256 sur le temps et le corps brut avec votre secret, le comparer avec la signature, et refuser un temps plus ancien que 5 minutes. Appuyez sur Vérifier la signature et exemples pour le code prêt à l'emploi.

Tester, suspendre et renouveler

• Envoyer un test envoie un événement test et affiche le code HTTP et le temps qu'il a pris.
• Pause arrête les livraisons ; Activer les redémarre.
• Secret de roulement crée un nouveau secret. L'ancien cesse de fonctionner immédiatement.
• Supprimer supprime le point de terminaison. Son journal est conservé.

Réessais et le journal

Votre adresse doit répondre avec un code 2xx dans les 5 secondes. Les redirections ne sont pas suivies. En cas d'échec, IDup réessaie après 1 minute, 5 minutes, 30 minutes, 2 heures et 12 heures. Après le sixième essai, la livraison est marquée Abandonné.

Le journal montre chaque tentative avec l'événement, le point de terminaison, la tentative, le code HTTP, la durée et le début de la réponse. Le statut est En attente, Livré, Échec ou Abandonné. Utilisez Renvoyer pour renvoyer une livraison.