Recevoir les modifications Amply en temps réel avec les webhooks

Amply peut envoyer une requête HTTP POST à une URL de votre choix lorsqu’un contenu change dans votre projet : création d’un événement, publication d’un article ou modification d’un lieu. Utilisez les webhooks pour synchroniser vos outils externes ou déclencher des automatisations.

Événements disponibles

Événement	Description
`event.created`	Une séance ou un événement a été ajouté à l’agenda
`event.updated`	Un événement existant a été modifié
`event.deleted`	Un événement a été supprimé
`article.published`	Un article du blog a été publié
`article.updated`	Un article a été modifié
`place.created`	Un lieu a été ajouté à la carte
`place.updated`	Un lieu a été modifié

Configurer un webhook

Ouvrir les webhooks

Ouvrez Paramètres → Intégrations → Webhooks.

Ajouter un webhook

Cliquez sur Ajouter un webhook pour ouvrir le formulaire.

Renseigner l’URL de destination

Collez l’URL à laquelle Amply doit envoyer les notifications. Il peut s’agir de votre serveur ou d’un outil d’automatisation comme Zapier, Make ou n8n.

Choisir les événements

Sélectionnez les événements qui doivent déclencher une notification. Vous pouvez choisir un ou plusieurs types d’événements.

Enregistrer

Enregistrez votre webhook. Amply commence immédiatement à envoyer les notifications correspondant aux événements sélectionnés.

Contenu d’une notification

Chaque webhook transmet un corps JSON par HTTP POST. Il contient le type d’événement, un horodatage, l’identifiant du projet et les détails du contenu concerné.

{
  "event": "event.created",
  "timestamp": "2024-06-15T09:30:00Z",
  "project_id": "proj_abc123",
  "data": {
    "id": "evt_xyz789",
    "title": "Yoga au sommet",
    "start_time": "2024-06-15T09:30:00Z",
    "end_time": "2024-06-15T10:15:00Z",
    "category": "Sport"
  }
}

Vérifier les signatures des webhooks

Chaque requête envoyée par Amply contient un en-tête X-Amply-Signature. Il contient la signature HMAC-SHA256 du corps brut de la requête, calculée avec le secret de votre webhook. Vérifiez cette signature sur votre serveur avant de traiter la notification pour confirmer son origine et l’intégrité de son contenu. Retrouvez le secret dans Paramètres → Intégrations → Webhooks, à côté du point de terminaison configuré.

Les webhooks nécessitent l’offre Pro. Changez d’offre pour accéder à cette fonctionnalité.

Vous pouvez utiliser les webhooks sans serveur personnalisé avec Zapier, Make ou n8n. Par exemple, publiez un message dans Slack à chaque nouvel événement ou ajoutez les nouveaux articles à une feuille Google Sheets.

Premiers pas

Modules

Publication

Personnalisation

Statistiques et automatisations

Événements disponibles

Configurer un webhook

Contenu d’une notification

Vérifier les signatures des webhooks

​Événements disponibles

​Configurer un webhook

​Contenu d’une notification

​Vérifier les signatures des webhooks

Événements disponibles

Configurer un webhook

Contenu d’une notification

Vérifier les signatures des webhooks