Recevoir les notifications Pyxaura dans Slack, Zapier ou vos propres outils

Le guide Webhooks couvre la mise en place technique (signature,
retries, format de payload). Celui-ci se concentre sur les intégrations pratiques les plus
demandées : relayer les événements Pyxaura vers Slack ou vers un outil no-code comme Zapier/Make.

Les événements disponibles

Un endpoint webhook peut s'abonner à tout ou partie de ces événements :

Catégorie	Événements
Espace	space.deleted, space.reindexed
Sources	source.connected, source.auth_failed
Synchronisation	sync.started, sync.completed, sync.failed
Documents	document.indexed, document.failed
Rapports	report.ready, report.failed
Quotas	quota.warning, quota.exceeded
Divers	usage.recorded, export.ready

Pour une intégration Slack, les événements les plus utiles au quotidien sont généralement
sync.failed, document.failed, quota.warning et quota.exceeded — les signaux qui demandent
une action, plutôt que tous les événements de succès.

Option 1 — Relayer vers Slack via Zapier ou Make

La façon la plus rapide de recevoir des alertes Pyxaura dans un canal Slack sans écrire de code :

1. Créez un Zap (ou scénario Make) avec le déclencheur Webhooks by Zapier → Catch Hook. Zapier vous fournit une URL unique.
2. Dans Pyxaura, créez un endpoint webhook (Paramètres → Webhooks) avec cette URL, et sélectionnez les événements pertinents (ex. sync.failed, quota.exceeded).
3. Ajoutez une action Slack → Send Channel Message, en composant le message à partir des champs du payload reçu (ex. {{event}}, {{data.source_name}}, {{data.error_message}}).
4. Testez avec un événement réel (ex. mettez volontairement un connecteur en erreur) pour vérifier le format du message avant de l'activer en production.

Même principe pour Make (Integromat) avec un module Webhooks → Custom webhook en
déclencheur.

Option 2 — Endpoint Slack natif (sans Zapier)

Slack propose des Incoming Webhooks natifs. Si vous préférez éviter un intermédiaire
payant/tiers :

1. Créez une Incoming Webhook Slack pour le canal cible (App Slack → Incoming Webhooks) — vous obtenez une URL https://hooks.slack.com/services/....
2. Slack attend un payload {"text": "..."}, différent du format natif de Pyxaura. Il faut donc un petit relais (ex. une fonction serverless légère, ou un webhook custom Zapier/Make comme à l'option 1) qui transforme le payload Pyxaura en message Slack — Pyxaura n'envoie pas directement au format Slack, pour rester générique vis-à-vis de tous les récepteurs possibles.

Vérifier l'authenticité des événements reçus

Quel que soit le récepteur, vérifiez la signature du payload (voir le
guide Webhooks) avant de traiter l'événement dans tout relais que vous
développez vous-même — cela évite qu'un tiers déclenche de fausses alertes en devinant votre URL
d'endpoint.

Suivre la fiabilité de vos endpoints

Chaque tentative de livraison échouée est automatiquement retentée (jusqu'à 5 fois, avec un délai
croissant). Consultez l'historique des livraisons de votre endpoint (Paramètres → Webhooks →
Historique) pour repérer un endpoint en échec persistant (ex. Zap désactivé côté Zapier) avant
de perdre silencieusement des notifications.