Webhooks et événements dans RaiseNow Hub

Cet article explique comment les organisations avec un contrat RaiseNow Growth peuvent créer, gérer et surveiller des webhooks dans RaiseNow Hub. Les webhooks permettent des notifications en temps réel pour des événements clés et aident les organisations à intégrer efficacement les données RaiseNow dans leurs propres systèmes.

Que sont les webhooks et les événements ?

Un webhook est un message automatisé envoyé par RaiseNow Hub à une URL définie lorsqu’un événement spécifique se produit.

Un événement est une action ou une modification dans le système, par exemple :

• Un nouveau don
• Un paiement réussi
• Un abonnement mis à jour
• Des modifications des données de donateur ou d’organisation

Au lieu d’interroger régulièrement le système (polling), votre système reçoit les informations dès que l’événement se produit.

Accéder aux webhooks

1. Accédez à Paramètres dans RaiseNow Hub.
2. Sélectionnez Webhooks.

Cette section contient toutes les options pour créer, gérer et surveiller les webhooks et les événements.

Créer et gérer des webhooks

Vous pouvez créer de nouveaux webhooks pour vous abonner aux événements importants pour votre organisation, notamment :

• Transactions et paiements
• Abonnements
• Données des donateurs
• Modifications liées à l’organisation

Chaque webhook envoie les données d’événement à l’URL que vous définissez.

Pour obtenir une liste complète et à jour des événements pris en charge, consultez notre Developer Documentation.

Rechercher et filtrer des webhooks

Pour gérer plus facilement des configurations complexes, vous pouvez rechercher et filtrer les webhooks existants.

Filtres disponibles :

• UUID
• URL du webhook
• Alias du webhook
• Nom de l’événement

Cela vous permet de trouver rapidement des configurations spécifiques et de garder une structure claire.

Consulter l'historique des événements

RaiseNow Hub conserve l'historique de livraison des événements pendant six mois.

Vous pouvez utiliser cet historique pour :

• Vérifier si les événements ont été livrés avec succès
• Contrôler le statut des événements
• Résoudre les problèmes de livraison

Vous pouvez rechercher et filtrer les événements par :

• Horodatage
• Nom de l’abonnement à l’événement
• URL du webhook
• Alias du webhook
• Statut de livraison
• UUID

Renvoyer des événements webhook échoués

Si l’envoi d’un événement webhook échoue, vous pouvez le renvoyer directement depuis RaiseNow Hub sans retraitement manuel en dehors de la plateforme.

Comment renvoyer un événement

1. Allez dans Paramètres → Webhooks
2. Ouvrez la section Réponses et recherchez la réponse échouée
3. Cliquez sur Envoyer dans la vue détaillée de la réponse

Ce que vous pouvez attendre

• Un indicateur de chargement confirme que l’événement est mis en file d’attente pour un nouvel envoi
• Un message de succès ou d’erreur s’affiche une fois l’action terminée
• La tentative de renvoi est enregistrée et visible dans le tableau Responses pour une traçabilité complète

Limitation du débit

Pour éviter les abus, les renvois sont limités à 5 par minute. Lorsque cette limite est atteinte, le bouton Envoyer est désactivé et un message explicatif est affiché.