Peopulse prend en charge les Webhooks pour permettre des notifications en temps réel lorsqu’un événement relatif à une mission se produit.
Deux types de Webhooks sont disponibles pour les missions :
- Mission Created : déclenché lors de la création d’une mission.
- Mission Updated : déclenché lorsqu’une mission est mise à jour.
Pour recevoir ces notifications, vous devez configurer une URL de callback qui sera appelée automatiquement par Peopulse lorsqu’un de ces événements survient.
Peopulse utilise un format de payload léger pour les Webhooks. Ce payload contient uniquement les informations essentielles, notamment l’identifiant de l’entité concernée.
L’objectif est de minimiser la charge utile tout en permettant à votre système d’effectuer une requête GET vers l’API Peopulse afin de récupérer les détails complets de l’entité.
Structure des webhooks :
Header :
{
"user-agent": "Symfony HttpClient (Curl)",
"content-length": "100",
"accept": "*/*",
"accept-encoding": "gzip",
"authorization": "Bearer eyJ0eXAiOiJKU….uqqTKcUzY6hikhsG2KtyrA",
"content-type": "application/x-www-form-urlencoded",
"x-forwarded-for": "10.X.10.X",
"x-forwarded-host": "CallBack Url",
"x-forwarded-proto": "https"
}
Body :
application/x-www-form-urlencoded
id=5744&
sitePeopulseId=SUPPORT00000001&
agencyPeopulseId=RHXNETT00000005&
event=MISSION_CREATED
Détails de paramètres :
id
: identifiant unique de l’entité concernée (ex. : mission, bon de commande, etc.)sitePeopulseId
: identifiant du site client dans PeopulseagencyPeopulseId
: identifiant de l’agence émettrice dans Peopulseevent
: type d’événement déclencheur (EX :MISSION_CREATED
ouMISSION_UPDATED
)