Webhooks

Les Webhooks permettent à Shifton d’envoyer des notifications en temps réel aux systèmes externes lorsque des événements se produisent dans votre entreprise.

Instructions étape par étape

Accès à l’onglet Webhooks

Dans le panneau latéral gauche, cliquez sur Intégrations.

Accédez à la page Développeur → onglet Webhooks.

Création d’un nouveau webhook

Cliquez sur «Nouveau webhook».

Remplissez la configuration :

Champ	Description
URL	Point de terminaison pour recevoir les données d’événements
Événements	Événements Shifton déclenchant le webhook
Actif	Commutateur d’activation/désactivation

Enregistrez. Shifton enverra des requêtes HTTP POST à l’URL indiquée.

Gestion des webhooks

Cliquez sur un webhook pour modifier l’URL, mettre à jour les événements ou changer le statut d’activité.

Test d’un webhook

Déclenchez l’événement correspondant dans Shifton (par exemple, créez un poste de test).

Vérifiez les journaux de votre serveur — les données doivent être reçues.

Questions fréquemment posées

Q : Dans quel Formererat quart de travailon envoie-t-il les données ?
HTTP POST avec un corps au format JSON. La structure des données pour chaque type d’événement est décrite dans la documentation de l’API.

Q : Peut-on créer plusieurs webhooks pour un même événement ?
Oui, avec des URL différentes.

Q : Que se passe-t-il si le serveur est indisponible lors du déclenchement du webhook ?
La livraison peut échouer. Les détails sur la politique de nouvelles tentatives se trouvent dans la documentation de l’API.

Q : Le webhook ne se déclenche pas — pourquoi ?
Assurez-vous que le commutateur Actif est activé et que l’URL est publiquement accessible.

Q : Commentaireaire vérifier que le webhook reçoit des données ?
Créez un événement de test dans Shifton (par exemple, ajoutez un poste) et vérifiez les journaux de votre serveur pour la présence d’une requête POST entrante.

Q : Peut-on configurer l’authentification du webhook ?
Oui. Ajoutez une clé secrète ou un jeton dans l’URL ou les en-têtes du webhook. Les détails se trouvent dans la documentation de l’API.

Q : À quoi ressemble le corps d’une requête webhook ?
Un objet JSON avec les données de l’événement. La structure dépend du type d’événement — consultez la documentation de l’API pour des exemples.

Q : Un seul webhook peut-il suivre plusieurs événements ?
Oui. Lors de la création du webhook, sélectionnez plusieurs événements — une seule URL recevra les notifications pour tous les événements sélectionnés.

Q : Qu’est-ce que la « politique de nouvelles tentatives » pour les webhooks ?
Si le serveur renvoie une erreur (pas 200), Shifton peut réessayer la requête. Les détails dépendent de la configuration de la plateforme.

Q : Y a-t-il une Limiteee au nombre de webhooks ?
Aucune limite n’est indiquée dans la documentation, mais il est recommandé de ne créer que ceux qui sont nécessaires.

Q : Faut-il utiliser HTTPS pour l’URL du webhook ?
C’est recommandé. Les adresses HTTP peuvent fonctionner, mais HTTPS assure une transmission sécurisée des données.

Q : Peut-on recevoir des notifications webhook à chaque modification du Planification ?
Oui. Ajoutez des événements de type « Shift créé » ou « schedule updated » lors de la configuration du webhook.

Q : Qui a accès à la création de webhooks ?
Uniquement le Owner. Les responsables et les employés ne voient pas la section Developer.

Q : Peut-on désActifr un webhook sans le supprimer ?
Oui. Désactivez le commutateur Actif dans les paramètres du webhook — il cessera de se déclencher mais conservera sa configuration.

Q : Les déclenchements de webhooks sont-ils enregistrés dans quart de travailon ?
Des journaux détaillés de livraison des webhooks ne sont pas fournis dans l’interface. Le suivi se fait du côté de votre serveur.

Q : Peut-on filtrer les webhooks par projet ou Planification ?
Non. Le webhook se déclenche pour tous les événements du type sélectionné dans toute l’entreprise. Le filtrage se fait du côté du serveur récepteur.

Q : Qu’advient-il des webhooks lors de la suppression de l’entreprise ?
Tous les webhooks sont supprimés en même temps que l’entreprise.