Passer au contenu principal
Procore

Configurer les Webhooks du projet

 

Objectif

Configurez la fonctionnalité Webhooks pour recevoir des notifications lorsqu'une ou plusieurs ressources d'API Procore changent dans un projet.

Contexte

La fonctionnalité Webhooks permet aux développeurs et intégrateurs tiers de spécifier une ou plusieurs ressources d'API Procore pour lesquelles ils souhaitent être notifiés lorsque des actions Créer, Mettre à jour ou Supprimer se produisent. L'interface utilisateur de configuration de la fonction Webhooks est disponible via l'outil Admin du projet dans Procore.

Les avantages de la fonction Webhooks sont notamment les suivants :

  • Suppression du besoin de logique/code d'interrogation dans les intégrations tierces pour déterminer les changements de ressources
  • Amélioration des performances en remplaçant les sondages par des mises à jour asynchrones
  • Efficacité accrue car le code ne doit fonctionner que lorsqu'une ressource change
  • Réduction du risque de dépassement des plafonds de taux API de Procore

Éléments à considérer

  • Permission d'utilisateur requise :
    • « Admin » dans l'outil Admin du projet.
  • Informations pour les développeurs :

Étapes

  1. Accédez à l'outil Admin du projet.
    Cela affiche la page « Informations générales sur le projet ».
  2. Dans le menu « Paramètres du projet » de la barre latérale, cliquez sur Webhooks.



    Cela ouvre la page de configuration « Webhooks » qui comprend un champ Extrémité de notification pour entrer l'URL de votre serveur Web et une grille de ressources pour sélectionner les ressources et les actions de modification correspondantes pour lesquelles vous souhaitez recevoir une notification.

 

  1. Dans le champ Point de terminaison de notification, entrez l'URL du point de terminaison sur votre serveur Web qui gérera les demandes POST provenant de Procore.
  2. (Facultatif) Dans le champ En-tête de permission, saisissez le jeton de permission que vous souhaitez placer dans l'en-tête d'une demande POST provenant de Procore. Bien que ce champ puisse être utilisé pour définir les informations d'en-tête de permission que vous souhaitez, il est le plus souvent utilisé pour spécifier les informations d'identification de permission en utilisant la syntaxe : <type> <credential>, où <type> est le type de permission (« Basic », « Token », « Bearer », etc.) et <credential> est la valeur du jeton. Par exemple, une entrée valide pour ce champ serait Basic c3a24b8208ac5199d083d54a1234e94b8864.
  3. Cliquez sur Enregistrer le point de terminaison. Si vous avez entré une adresse valide et bien formée dans le champ Point de terminaison de notification, une bannière verte apparaît en haut de l'écran indiquant la réussite. S'il y a des problèmes avec l'URL que vous avez entrée, une bannière d'avertissement s'affiche pour décrire le problème probable.
  4. Dans la grille de ressources, sélectionnez les actions « Créer », « Mettre à jour » et « Supprimer » pour toutes les ressources pour lesquelles vous souhaitez recevoir les notifications correspondantes. Notez que vos sélections d'actions prennent effet immédiatement au fur et à mesure que vous les effectuez, il n'est pas nécessaire de « soumettre » vos modifications.

    Remarque : Lors de la configuration des Webhooks, gardez à l'esprit que vous identifiez simplement les ressources/actions sur lesquelles vous souhaitez recevoir des notifications. Ce n'est qu'en cas de modification réelle d'une ressource que vous recevrez une notification.

Livraisons Webhooks

Un journal en cours d'exécution de Livraisons Webhooks à votre point de terminaison de notification est disponible au bas de la page Webhooks du projet. La section Livraisons permet de voir rapidement le statut des événements que Procore a envoyés (ou tenté d'envoyer) à votre serveur de notification. Les livraisons réussies et échouées sont incluses par défaut dans l'affichage. Vous pouvez utiliser la case à cocher Afficher uniquement les échecs pour filtrer l'affichage afin d'afficher uniquement les livraisons qui ont échoué.

 

deliveries.png

 

Les livraisons les plus récentes apparaissent en haut de la section Livraisons. En cliquant sur une entrée de livraison, vous obtenez des détails sur la charge utile de la demande, les en-têtes de réponse et le corps de la réponse.

 

deliveries-expand-project.png

L'affichage du registre des livraisons est paginé avec un maximum de 25 livraisons affichées à la fois. En cliquant sur « Plus de livraisons », vous verrez apparaître la prochaine série de 25 livraisons.

more-deliveries.png

Surveillance et alarmes

Nous vous recommandons vivement de mettre en place une surveillance adéquate de vos serveurs de notification afin de garantir que toute interruption ou tout autre problème lié aux performances soit identifié et que vous soyez averti en temps utile par un système d'alarme fiable. Il existe de nombreux systèmes de surveillance commerciaux qui peuvent servir à cette fin, notamment Datadog, New Relic et d'autres encore. Ces services offrent des fonctions de surveillance robustes qui vous permettent de visualiser facilement la santé de votre système grâce à des tableaux et des graphiques configurables et à des analyses en temps réel. Ces services fournissent également des alertes intégrées, afin que vous soyez rapidement averti en cas de problème.

Voir aussi

  • Pour plus d'informations sur la configuration des Webhooks au niveau de la compagnie, consultez Configurer les Webhooks de la compagnie.
  • Les configurations Webhook du projet sont prises en charge dans les modèles du projet. Pour plus d'informations, consultez Configurer un modèle de projet.
  • Pour plus d'informations, reportez-vous aux documents inclus dans votre invitation bêta.