Passer au contenu principal
Les webhooks vous permettent de créer ou de configurer des intégrations qui s’abonnent aux événements en temps réel de Social media studio. Lorsqu’un événement se déclenche, nous envoyons une charge utile HTTP POST à l’URL que vous avez configurée, ce qui permet à votre application de réagir instantanément sans interrogation périodique.

Notions de base de la configuration

Vous pouvez configurer les webhooks directement depuis le tableau de bord, sous Paramètres > Webhooks, ou via notre API. Chaque webhook nécessite :
  • Une URL d’endpoint valide (HTTPS fortement recommandé).
  • Une ou plusieurs catégories d’événements auxquelles vous souhaitez vous abonner.
Votre offre détermine le nombre d’abonnements webhook actifs que vous pouvez maintenir simultanément.

Exemples de modèles de charge utile

Utilisez payloadTemplate pour personnaliser le corps JSON envoyé à votre endpoint. Les variables de modèle disponibles sont :
  • {{event}}
  • {{category}}
  • {{timestamp}}
  • {{data}}
  • {{data.any_field}} (pour les champs imbriqués propres à chaque événement)

1) Enveloppe JSON générique

2) Charge utile adaptée à Discord

3) Charge utile de style Slack Block Kit

Si une variable est absente des données de l’événement, le marqueur reste inchangé (par exemple, {{data.postId}}).

Limites et conservation des webhooks

Selon votre offre, la durée de conservation des journaux de livraison de vos webhooks et le nombre d’endpoints que vous pouvez créer varient :

Événements disponibles

Nous prenons en charge 162 événements répartis en 26 catégories. Lorsque vous vous abonnez à une catégorie, vous recevez tous les événements associés. Vous pouvez aussi vous abonner à des événements individuels pour un contrôle plus fin.

Besoin d'inspecter les charges utiles ?

Les webhooks livrent toujours des événements conformes à notre schéma officiel. Découvrez comment vérifier les signatures et consultez des exemples de charges utiles pour chaque catégorie d’événements.