# 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 :\
\&#xNAN;**"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.