Abonnement
Un service externe peut s’abonner à un évènement, de sorte à recevoir une requête HTTP contenant des données à chaque fois que l'évènement est déclenché.
Pour cela il suffit d’appeler le endpoint EPT_WebhookSubscribe ( https://api.weavy.divalto.com/v1/EntryPoints/{{projectCode}}/process/?c=EPT_WebhookSubscribe )
avec un Bearer token de connexion valide dans la partie headers et un body composé de
{
"event": "myEvent",
"hookUrl": "callbackExternalUrl"
}
event : Evènement auquel l’on souhaite s’abonner.
hookUrl : URL externe vers laquelle on va envoyer une réponse à chaque fois que le trigger sera déclenché.
Le endpoint va renvoyer des données qui serviront éventuellement à se désabonner par la suite :
{
"result": {
"codeWebhookSubscription": "mySubscriptionCode"
}
}
Désabonnement
Pour se désabonner, le principe est le même en appelant le endpoint EPT_WebhookUnsubscribe avec les paramètres suivant :
{
"codeWebhookSubscription": "mySubscriptionCode"
}
PerformList
Il existe également un troisième endpoint lié aux abonnements webhook, EPT_WebhookPerformList, qui est utilisé par un service distant pour récupérer des échantillons de données de test tel qu’ils seront envoyés par le hook, permettant ainsi de tester à la demande les données renvoyées sans avoir à déclencher l'évènement manuellement.
{
"event": "myEvent"
}
Liste des évènements WebHook standards
NewCustomer
Déclenché lors de la création d’un client coté weavy.Structure des données envoyées par un exemple :
{ "result": { "codecustomer": "1143-00004", "name": "Divalto", "address1": "11, rue Icare", "address2": "", "address3": "", "postalCode": "67960", "city": "Entzheim", "phoneNumber": "0388645060", "faxNumber": "", "mobilePhoneNumber": "", "email": "contact@divalto.com", "country": "FR", "province": "", "codeBaseCulture": "", "civility": "", "type": "Customer", "branchOfficeName": "", "userName": "Claude TENARDIER", "url": "https://weavy.divalto.com/page/customer/11430000000004" } }NewProspect
Déclenché lors de la création d’un prospect coté weavy.Structure des données envoyées par un exemple :
{ "result": { "codecustomer": "1143-00004", "name": "Divalto", "address1": "11, rue Icare", "address2": "", "address3": "", "postalCode": "67960", "city": "Entzheim", "phoneNumber": "0388645060", "faxNumber": "", "mobilePhoneNumber": "", "email": "contact@divalto.com", "country": "FR", "province": "", "codeBaseCulture": "", "civility": "", "type": "Customer", "branchOfficeName": "", "userName": "Claude TENARDIER", "url": "https://weavy.divalto.com/page/customer/11430000000004" } }NewSuspect
Déclenché lors de la création d’un suspect coté weavy.Structure des données envoyées par un exemple :
{ "result": { "codecustomer": "1143-00004", "name": "Divalto", "address1": "11, rue Icare", "address2": "", "address3": "", "postalCode": "67960", "city": "Entzheim", "phoneNumber": "0388645060", "faxNumber": "", "mobilePhoneNumber": "", "email": "contact@divalto.com", "country": "FR", "province": "", "codeBaseCulture": "", "civility": "", "type": "Customer", "branchOfficeName": "", "userName": "Claude TENARDIER", "url": "https://weavy.divalto.com/page/customer/11430000000004" } }NewSubcontractor
Déclenché lors de la création d’un sous-traitant coté weavy.Structure des données envoyées par un exemple :
{ "result": { "codecustomer": "1143-00004", "name": "Divalto", "address1": "11, rue Icare", "address2": "", "address3": "", "postalCode": "67960", "city": "Entzheim", "phoneNumber": "0388645060", "faxNumber": "", "mobilePhoneNumber": "", "email": "contact@divalto.com", "country": "FR", "province": "", "codeBaseCulture": "", "civility": "", "type": "Customer", "branchOfficeName": "", "userName": "Claude TENARDIER", "url": "https://weavy.divalto.com/page/customer/11430000000004" } }NewDeal
Déclenché lors de la création d’une affaire coté weavy.
Structure des données envoyées par un exemple :{ "result": { "codedeal": "6730000000002", "customerName": "A1C1", "label": "Vitrine de Noel 2023", "type": "Deal type 1", "dealNumber": "", "status": "Drafting", "creationDate": "2023-09-22 12:05:40", "url": "https://weavy.divalto.com/page/deal/6730000000002" } }NewOpportunity
Déclenché lors de la création d’une opportunité coté weavy.
Structure des données envoyées par un exemple :{ "result": { "codedeal": "2010000000014", "customerName": "A L'ATELIER DE DIJON", "label": "Ma nouvelle opportunité", "type": "Appel d'offres", "dealNumber": "", "status": "Active", "creationDate": "2023-10-31 00:00:00", "url": "https://weavy.divalto.com/page/project/2010000000014" } }