Pour une meilleure intégration entre Moduleo et votre application, Kipaware met à votre disposition des webhooks.
Un webhook est une notification de serveur à serveur qui permet d'informer votre système informatique qu'une ressource quelconque est mise à jour.
Une fois configuré, un webhook est utilisé pour envoyer une notification d'événement à votre service.
Une fois l'URL de votre site de réception configurée, Moduleo publiera l'événement sous forme de JSON sur l'URL de votre webhook.
Par exemple, si un contact est modifié, une notification est envoyée à l'URL spécifiée.
Les webhooks sont configurés via les requêtes "Webhook" de l'API.
Vous trouverez la liste des événements webhook disponibles ici.
L'objet de retour est composé de 3 éléments : 'TypeEvenement', 'CleSecurite' et 'Data'.
'TypeEvenement' correspond au type d'évènement. Il sera de type 'ListenableEvents'.
'CleSecurite' correspond à la clé de sécurité que vous nous aurez fournie à la configuration.
'Data' contiendra l'ensemble de l'élement correspondant à l'évènement.
Par exemple pour un contact, 'Data' contiendra un ApiContact, ainsi que tout les sous éléments le composant, comme ci-dessous :
{{
"ApiContact": {
"IdContact": 1382,
"Nom": "DURANT",
"TypeContact": 1,
"TypeDonneurOrdre": 9,
"Qualifications": [
11,
14,
15,
23,
25
]
},
"ApiPersonne": {
"Id": 1382,
"Civilite": 3,
"Prenom": "Jean",
"AutresPrenoms": "Lucien",
"NomJeuneFille": "",
"NomUsage": "DURANT",
"DateNaissance": null,
"IdCommuneNaissance": null,
"Sexe": 1
},
"ApiAdresse": [],
"ApiTelephone": [
{
"IdTelephone": 2052,
"Numero": "06.89.29.28.18",
"Lieu": "Mobile"
},
{
"IdTelephone": 3390,
"Numero": "06.78.24.43.57",
"Lieu": "Mobile Bureau"
}
],
"ApiEmail": [
{
"IdEmail": 1937,
"Adresse": "jean.durant@kipaware.fr",
"Lieu": "Bureau"
},
{
"IdEmail": 2060,
"Adresse": "jean.durant@gmail.com",
"Lieu": "Personnel"
}
],
"ApiQualification": [
{
"IdQualification": 11,
"Libelle": "Partenariat",
"Actif": true,
"DateCreation": "2010-09-07T07:42:30Z",
"DateDerniereModification": "2017-10-30T09:54:27Z"
},
{
"IdQualification": 14,
"Libelle": "Demande Additionnelle",
"Actif": true,
"DateCreation": "2016-02-22T16:19:23Z",
"DateDerniereModification": "2017-11-10T08:21:44Z"
},
{
"IdQualification": 15,
"Libelle": "Demande Partenaire",
"Actif": true,
"DateCreation": "2016-05-17T12:36:49Z",
"DateDerniereModification": "2017-10-30T09:49:02Z"
},
{
"IdQualification": 23,
"Libelle": "Doivent envoyer un courrier",
"Actif": true,
"DateCreation": "2018-03-02T09:03:41Z",
"DateDerniereModification": null
},
{
"IdQualification": 25,
"Libelle": "Heureux",
"Actif": true,
"DateCreation": "2021-04-02T08:21:30Z",
"DateDerniereModification": null
}
]
}}