Webhooks des plugins

Transmettez des événements extérieurs à un plugin activé dans votre organisation, et ce que l'endpoint vérifie avant que le plugin ne les voie.

Veyra Docs TeamMis à jour le 1 min de lectureVersion 2 · Historique

Un plugin qui déclare la capacité webhook reçoit les événements extérieurs à l'adresse :

HTTP
POST https://intelligence-api.veyra.so/api/plugins/{pluginId}/webhooks/{endpointKey}

endpointKey désigne l'un des endpoints que le plugin déclare dans son manifeste. La page de réglages du plugin affiche ses adresses.

Ce que Veyra vérifie d'abord

Vérification En cas d'échec
Le plugin existe. 404
Le plugin est prêt (activé et démarré). 400 avec son statut actuel
Le plugin déclare la capacité webhook et cet endpoint. 400 ou 404

Le plugin vérifie ensuite la requête à sa manière (par exemple une signature du service émetteur) et décide de ce qu'il en fait. Sa documentation décrit la charge utile attendue.

Authentification

La façon dont un webhook de plugin est authentifié dépend du plugin. Préférez les plugins qui vérifient une signature de l'émetteur ; l'adresse de l'endpoint seule ne doit pas être considérée comme un secret.

Voir Plugins dans la référence de l'API.

EntrantsPluginsWebhooks