> ## Documentation Index
> Fetch the complete documentation index at: https://docs.boble.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Présentation des webhooks

> Soyez notifié à l'instant où l'accès d'un acheteur à l'une de vos promotions change — et déclenchez l'action de votre choix depuis n'importe quel outil.

Un webhook est une notification que Boble envoie à votre propre serveur dès qu'un événement important survient sur l'une de vos promotions : une nouvelle vente, une résiliation, un renouvellement en échec, un abonnement arrivé à terme.

Au lieu d'interroger Boble ou de rafraîchir un dashboard, vous nous indiquez une URL par promotion, et nous y envoyons un petit message JSON au moment précis où ça se passe.

## Ce que vous pouvez en faire

Quelques exemples de ce que des créateurs branchent par-dessus les webhooks Boble :

<Columns cols={2}>
  <Card title="Notifier votre équipe à chaque vente" icon="bell">
    Un nouvel acheteur rejoint votre `Pro membership` → un message automatique tombe dans votre canal Discord ou Slack avec son nom et la promotion concernée.
  </Card>

  <Card title="Synchroniser les acheteurs avec votre outil email" icon="envelope">
    Un nouvel acheteur → automatiquement ajouté à votre liste Mailchimp, Brevo ou ConvertKit, taggé avec la promotion qu'il vient d'acheter.
  </Card>

  <Card title="Révoquer des accès dans des outils externes" icon="lock">
    Un abonnement est annulé → l'acheteur perd automatiquement son rôle VIP sur votre Discord ou son accès Notion.
  </Card>

  <Card title="Pousser chaque vente dans une feuille" icon="table">
    Chaque vente atterrit comme une nouvelle ligne dans votre Google Sheets ou Airtable, pour votre compta et votre reporting.
  </Card>
</Columns>

## Comment ça marche en trois étapes

<Steps>
  <Step title="Vous configurez une URL par promotion">
    Depuis votre dashboard créateur, vous associez une URL HTTPS à une promotion. C'est là que Boble enverra tous les événements de cette promotion.
  </Step>

  <Step title="Boble vous notifie en temps réel">
    Chaque changement d'accès sur la promotion déclenche un événement. Les mêmes événements partent que le changement vienne d'un checkout Stripe, d'un renouvellement Stripe, d'un échec de prélèvement ou d'une action manuelle de votre côté.
  </Step>

  <Step title="Votre service réagit">
    Votre serveur (ou votre endpoint Zapier / Make / n8n) reçoit l'événement et fait ce que vous voulez : notifier, synchroniser, révoquer, logguer.
  </Step>
</Steps>

## Les événements que vous recevez

| Événement                       | Quand il se déclenche                                                               |
| ------------------------------- | ----------------------------------------------------------------------------------- |
| `user_promotion.access_granted` | Un acheteur vient d'obtenir l'accès à l'une de vos promotions.                      |
| `user_promotion.canceled`       | L'accès d'un acheteur a été annulé.                                                 |
| `user_promotion.expired`        | Un abonnement est arrivé à terme sans être renouvelé.                               |
| `user_promotion.suspended`      | Un prélèvement récurrent a échoué et l'accès est suspendu.                          |
| `webhook.test`                  | Un événement de test que vous avez déclenché manuellement pour valider votre setup. |

Chaque événement transporte l'acheteur, la promotion, les dates et le nouveau statut. Le payload complet de chaque événement — avec un exemple réel — est documenté dans [Types d'événements](/fr/webhooks/event-types).

## Bon à savoir

<Info>
  La livraison est en **best-effort**. Si votre endpoint est down ou si votre service répond une erreur, Boble **ne réessaie pas** automatiquement. L'échec est logué et vous pouvez le rejouer depuis votre dashboard quand vous voulez.
</Info>

<Note>
  Votre URL doit être en `https://` et résoudre vers un hôte public. Les adresses locales et celles des réseaux privés sont refusées.
</Note>

## Pour aller plus loin

<Columns cols={2}>
  <Card title="Types d'événements" icon="list" href="/fr/webhooks/event-types">
    Le catalogue complet des événements, ce que chacun veut dire et un payload réel pour chacun.
  </Card>

  <Card title="Structure du payload" icon="braces" href="/fr/webhooks/payload-structure">
    À quoi ressemble chaque livraison de webhook Boble.
  </Card>
</Columns>