Un webhook est une URL à laquelle Agendize enverra les informations au format JSON quand un rendez-vous sera planifié ou annulé. Vous pouvez vous en servir pour avertir quelqu'un quand un rendez-vous est pris, ou synchroniser le rendez-vous avec votre système de gestion de calendrier interne, par exemple.


Pour activer un webhook, allez sur votre "Console" (1), cliquez sur "Paramètres" (2) et "Calendrier Sync" (3).



Dans le champ "URL de notification" (4), insérez l'URL de votre webhook.


Pour les tests, vous pouvez utiliser ce site Internet : requestb.in.

Vous recevrez une information JSON quand un nouveau rendez-vous est pris ou annulé :



La structure JSON est :


{

   "action":{string},

   "client":{

      "email":{string}, 

      "firstname":{string}, 

      "id":{string}, 

      "lastname":{string}, 

      "phone":{string}

   },

   "company":{

      "id":{string}, 

      "name":{string}

   },

   "event":{

      "end-date":{datetime},

      "id":{string},

      "start-date":{datetime}

   },

   "service":{

      "duration":{integer},

      "id":{string},

      "name":{string}, 

      "price":{integer}

   },

   "source":{string}, 

   "staff":{

      "email":{string}, 

      "firstname":{string}, 

      "lastname":{string}

   }

}



Parameter name

Value

Description

action

string

Action: “new”, “cancel”.

client

object

Détails client : identifiant, email, prénom, nom, téléphone

company

object

Informations sur l'entreprise : identifiant, nom

event

object

Données de l'événement : Identifiant du rendez-vous, dates de début et fin (formatées selon le RFC 3339) 

service

object

Informations sur le service : identifiant, nom, prix, durée

source

string

D'où provient l'action : "widget" ou "console"

staff

object

Informations sur l'équipier : prénom, nom, courriel