Passer au contenu principal
Les webhooks intégrés notifient votre serveur lorsqu’une activité survient pour n’importe quel utilisateur final de votre projet partenaire. Chaque charge utile identifie l’utilisateur final concerné afin que vous puissiez la router vers le bon client.

Créer un abonnement

Les endpoints de webhook doivent utiliser HTTPS et être accessibles publiquement.
Omettez events, ou transmettez un tableau vide, pour recevoir tous les événements reconnus survenant pour vos utilisateurs finaux intégrés.
Les événements utiles pour une intégration de publication embarquée sont notamment :

Vérifier la signature

Social media studio signe le corps brut exact de la requête HTTP avec HMAC-SHA256. Lisez le corps en texte ou en octets et vérifiez-le avant d’analyser le JSON.
La signature peut être envoyée sous forme de condensé hexadécimal ou avec un préfixe v1= ; le SDK accepte les deux formes.

Structure de la charge utile

Les requêtes de livraison incluent également :

Comportement de livraison

  • Renvoyez une réponse 2xx dès que l’événement est accepté de manière durable.
  • Traitez les événements de façon asynchrone lorsque le travail peut prendre plus de quelques secondes.
  • Dédoublonnez les livraisons à l’aide du id de la charge utile ou de X-Webhook-Delivery-Id.
  • Les réponses non 2xx, les échecs réseau et les expirations sont relancés avec un délai exponentiel.
  • Les abonnements qui échouent de façon répétée sont désactivés automatiquement.
La livraison des webhooks est au moins une fois ; vos gestionnaires doivent donc être idempotents.