Webhook Avenant

Peopulse prend en charge les Webhooks pour envoyer des notifications en temps réel lorsqu’un événement relatif à une mission se produit.

Pour les avenants existe le webhook suivant :

• AMENDMENT_CREATED : déclenché lors de l’envoi de la demande d’avenant par l’EU (renouvellement ou changement).

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=4&
event=AMENDMENT_CREATED&
agencyPeopulseId=RHXNETT0F000001&
sitePeopulseId=FULLY1000000001&
amendmentNumber=1&
customerPeopulseId=RHIO_WORKFULLY_1

Détails de paramètres :

• id : identifiant unique de l’entité avenant
• sitePeopulseId : identifiant du site client dans Peopulse
• agencyPeopulseId : identifiant de l’agence émettrice dans Peopulse
• event : type d’événement déclencheur
• amendmentNumber : numéro de l’avenant (certaines missions peuvent avoir plusieurs avenants)
• customerPeopulseId : Identifiant client