WEBHOOKS

Introduction
Configuration
Contenu du message JSON


Introduction

INESCRM vous permet d’utiliser les webhooks afin d’envoyer des notifications aux applications externes que vous utilisez dès qu’une action se produit sur des éléments en base de données.
Les profils administrateurs peuvent configurer les actions (Créer, Modifier, Supprimer) sur certaines entités (Société, Contact, Affaires, etc). Quand l’opération s’exécute, un message au format JSON est envoyé à l’URL définie.

Configuration

Pour activer les webhooks, veuillez tout d’abord vous diriger vers le panneau de configuration avec un utilisateur ayant un profil administrateurs.
Depuis l’Administration > Intégration et Compléments > Webhooks, visualisez l’ensemble des wehbooks paramétrés. Ajoutez un webhook en cliquant sur le bouton AJOUTER et modifier un webhook en cliquant sur la ligne

Depuis le paramétrage d’un webhook, vous retrouverez ces champs :
Nom du webhook
URL : Renseignez l’URL de redirection de votre application externe
Activation : Activez ou désactivez le webhook
Sélectionnez l’entité : Vous pouvez configurer des webhooks sur les sociétés, contacts, affaires, contrats, devis
Sélectionnez l’action(s) : 3 actions sont possibles, créer, modifier et supprimer
Sélectionnez les champs de modification : Vous pouvez définir une sélection de champs sur l’action modifier. Alors le webhook se déclenchera uniquement à la modification de l’un des champs sélectionnés
Paramètres : Ajoutez un paramètre de sécurité

Contenu JSON

Pour les actions créer, modifier et supprimer, le JSON contient :

"Entity": l’entité (société, contact, affaire, etc)
"Id": l’identifiant de l’entité
"Operation": l’action sélectionnée
"DateNotification": la date de l’opération

Pour les champs sélectionnés de l’action modifier, le JSON contient :

"Entity": l’entité (société, contact, affaire, etc)
"Id": l’identifiant de l’entité
"Operation": l’action sélectionnée
"DateNotification": la date de l’opération
"Name": le nom du champ modifié
"OldValue": l’ancienne valeur
"NewValue": la nouvelle valeur
"DateChange": date de l’opération sur ce champ