Comment créer et utiliser un Webhook

Connectez-vous à votre compte AgencyHandy.

2. Accéder aux paramètres Webhooks

Depuis le Tableau de bord, allez dans : "Intégrations" → "Gestion des Webhooks"

3. Authentification

Cliquez sur le bouton "Gestion" pour authentifier le jeton de sécurité.

4. Créer un nouveau Webhook

Cliquez sur "Créer un nouveau Webhook" pour démarrer la configuration.

5. Saisir l’URL de point de terminaison

Renseignez l’URL du système externe qui recevra les données envoyées par le webhook.

6. Sélectionner le format des données

Choisissez le format **JSON** comme Content-Type.

7. Choisir les événements déclencheurs

Sélectionnez les événements d’AgencyHandy qui déclencheront l’envoi automatique des données. Événements disponibles :

• Service : Création, mise à jour, suppression

• Commande : Création, mise à jour, suppression

• Tâche : Création, assignation, achèvement, mise à jour

• Facture : Changement de statut

• Client/Utilisateur : Ajout d’un client, suppression

• Proposition : Envoyée, reçue, acceptée, rejetée

• Ticket : Créé, assigné, changement de statut

• Paiement : Reçu, échec

• Pack de services : Création, mise à jour, suppression

8. Activer le Webhook

Activez le bouton radio pour indiquer que le webhook est actif. Les données seront envoyées automatiquement à chaque fois qu’un événement sélectionné se produit.

9. Sauvegarder la configuration

Vérifiez bien tous les paramètres du webhook, puis cliquez sur "Enregistrer" pour activer définitivement l’intégration.

10. Prévisualiser les données envoyées

Cliquez sur le webhook que vous venez de créer pour consulter :

• Les données envoyées pour chaque événement

• L’historique des envois

• Les requêtes/réponses

• L’option de renvoyer (re-deliver) les données manuellement au besoin

---

📌 Notes Importantes

• Tests : Avant de passer en production, testez l’envoi des données vers votre endpoint pour vérifier le bon fonctionnement.

• Sécurité : L’URL de votre endpoint doit être sécurisée (HTTPS) afin de protéger les données transmises.

• Suivi : Surveillez régulièrement l’activité de vos webhooks pour détecter d’éventuels échecs ou erreurs.

• Mises à jour : Révisez périodiquement la configuration des webhooks pour l’adapter à l’évolution de vos besoins et outils externes.