Webhooks

Les webhooks sont une méthode largement utilisée pour permettre à plusieurs applications d’interagir les unes avec les autres, en utilisant des requêtes HTTP POST pour se transmettre des rappels. Pour plus d’informations, consultez la page de Wikipedia sur les webhooks. Les webhooks sont couramment utilisés pour envoyer des notifications par e-mail ou par SMS, publier des messages sur les réseaux sociaux, écrire automatiquement du contenu dans une feuille de calcul et mettre à jour les bases de données d’entreprise.

Dans ArcGIS Survey123, il est désormais possible de configurer et d’activer les webhooks lorsqu’une réponse à une enquête est envoyée. Par exemple, après un envoi réussi d’informations à une couche d’entités, l’appel du webhook peut déclencher une autre action, notamment l’envoi d’un e-mail de notification, l’ajout du contenu de l’enquête à une feuille de calcul et l’envoi d’une alerte.

Outre le fournisseur de webhooks attitré de votre lieu de travail, divers services de processus tiers sont disponibles, parmi lesquels Microsoft Power Automate, Integromat, Zapier et tray.io. Tous ces services peuvent servir à incorporer Survey123 comme déclencheur pour un processus automatisé. Ainsi, Microsoft Power Automate et Integromat ont chacun un connecteur Survey123 intégré, ce qui vous permet d’incorporer Survey123 à votre processus de webhook simplement, et sans avoir besoin de configurer le webhook dans le site Web Survey123 ou de saisir une payload URL.

Attention :

Lorsque vous créez ou modifiez un webhook pour une enquête, cette dernière doit être mise à jour dans l’application de terrain Survey123 pour que les modifications prennent effet.

Il existe de nombreuses façons d’utiliser Survey123 comme déclencheur dans vos processus. Les sections suivantes expliquent comment configurer un webhook pour envoyer une notification électronique quand une réponse reçue à une question contient une certaine valeur.

Configurer un webhook dans Integromat

Integromat est une plateforme d’automatisation en ligne. Connectez-vous à un compte gratuit pour commencer. Integromat possède des modèles à utiliser comme point de départ pour inclure des pièces jointes dans vos notifications électroniques, ajouter des enregistrements aux feuilles de calcul et créer des éléments de calendrier.

  1. Accédez au site https://www.integromat.com/ et connectez-vous.
  2. Cliquez sur le bouton Create a new scenario (Créer un scénario).
  3. Recherchez Survey123 et sélectionnez-le. Cliquez sur Continuer.

    Le module Survey123 est répertorié comme favori dans votre scénario.

  4. Cliquez sur l’icône du module au milieu de l’écran et sélectionnez Survey123 dans le menu.

    Ajouter un module Survey123

  5. Sélectionnez le module déclencheur Watch survey (Visionner l’enquête).

    Ce module est conçu pour exécuter le scénario à chaque fois qu’une réponse est envoyée à l’enquête.

    L’icône de scénario change de couleur, et un assistant s’affiche pour vous aider à configurer le module Survey123.

    Astuce :

    Il est également possible d’utiliser le module Create report (Créer des rapports) pour générer un rapport dans le cadre d’une réponse à l’enquête.

  6. Cliquez sur Add (Ajouter) et attribuez un nom à votre webhook.

    Ce nom doit être unique pour l’enquête pour laquelle vous configurez le webhook.

  7. Si vous utilisez ce module pour la première fois dans Integromat, configurez une connexion à votre organisation ArcGIS. Vous n’aurez à le faire qu’une fois, car Integromat enregistre vos informations pour une utilisation ultérieure. Cliquez sur Add (Ajouter) et nommez la connexion à ArcGIS.
    • Pour vous connecter à ArcGIS Online, cliquez sur Continue (Poursuivre) pour vous connecter à votre organisation ArcGIS.
    • Pour vous connecter à ArcGIS Enterprise, inscrivez Integromat auprès de votre portail. Pour plus d’informations, reportez-vous à l’article de blog Survey123 Tricks of the Trade: Integromat.
  8. Sélectionnez, à partir de votre organisation ArcGIS, une enquête à laquelle vous voulez vous connecter.

    Webhook pour votre enquête

  9. Pensez aux options à inclure dans votre webhook, et cliquez sur Save (Enregistrer).

    Il est recommandé de conserver la valeur par défaut, définie sur Yes (Oui), pour toutes les options, ce qui vous confère le plus de flexibilité lors de la personnalisation de votre webhook.

  10. Cliquez sur  OK.

    Votre webhook est créé et le module Survey123 est configuré.

  11. Cliquez sur le bouton Add another module (Ajouter un autre module) sur le côte droit du module Survey123 pour y connecter un autre module.

    Ajouter un autre module

  12. Recherchez Email (Courrier électronique) et sélectionnez le module Email (Courrier électronique).
  13. Sélectionnez l’action Send an email (Envoyer un message électronique).
  14. Si vous utilisez ce module pour la première fois dans Integromat, cliquez sur Add (Ajouter) pour configurer une connexion dans votre compte de messagerie. Sélectionnez un type de connexion et connectez-vous à votre compte.

    Vous n’aurez à le faire qu’une fois, car Integromat enregistre votre connexion en vue d’une utilisation ultérieure.

  15. Ajoutez un e-mail de réception.

    Il s’agit de l’adresse électronique à laquelle les messages seront envoyés.

  16. Cliquez dans la zone de texte « Objet ». Sélectionnez des champs de votre enquête pour construire l’objet du message électronique à l’aide du volet de paramètres du module qui apparaît.
  17. Cliquez dans la zone de texte « Contenu ». Sélectionnez des champs de votre enquête pour construire le contenu du message électronique à l’aide du volet de paramètres du module qui apparaît. Vous pouvez utiliser le format HTML pour le contenu.
  18. Cliquez sur  OK.

    Ce scénario doit envoyer le message électronique lorsqu’une réponse est apportée à une question d’une certaine façon, de sorte que vous fournirez un filtre.

  19. Cliquez sur l’icône d’outils entre les deux modules et sélectionnez Set up a filter (Configurer un filtre).

    Ajouter un filtre à votre scénario

  20. Cliquez dans la zone de texte Condition et choisissez le champ dans votre enquête à utiliser dans le filtre.

    Définir votre filtre

  21. Choisissez l’opérateur pour la condition. Dans ce cas, choisissez la valeur par défaut, Equal to (Égal à).
  22. Entrez une valeur pour la condition et cliquez sur OK.
  23. Cliquez sur Save (Enregistrer) pour enregistrer votre scénario.

    Vous pouvez également cliquer sur Run once (Exécuter une fois) pour tester votre webhook. Après avoir cliqué sur Run once (Exécuter une fois), ouvrez Survey123 et soumettez une enquête, en vérifiant que la réponse respecte les filtres appliqués. Vérifiez que le destinataire a reçu le message électronique.

  24. Utilisez le bouton bascule activer/désactiver en bas à gauche de la page pour activer votre scénario. Réglez la planification sur Immediately (Immédiatement) pour que votre scénario s’exécute chaque fois qu’une réponse à l’enquête est soumise.

Pour découvrir de nouvelles façons d’utiliser Survey123 comme déclencheur dans vos processus, consultez Integromat.

Configurer un webhook dans Microsoft Power Automate

Microsoft Power Automate (auparavant Microsoft Flow) est un service webhook fourni sur la plateforme Microsoft Office 365.

Remarque :

La procédure suivante décrit comment configurer un flux à l’aide du connecteur Survey123 intégré pour les enquêtes publiées sur ArcGIS Online. Pour utiliser Microsoft Power Automate avec des enquêtes publiées sur ArcGIS Enterprise, vous devez configurer un connecteur personnalisé. Pour plus d’informations, consultez l’article How To: Create an ArcGIS Survey123 connector for Microsoft Power Automate for use with ArcGIS Enterprise dans la base de connaissances.

  1. Ouvrez Microsoft Power Automate.
  2. Sélectionnez Create (Créer) dans le menu latéral de la page.
  3. Sélectionnez Automated cloud flow (Flux cloud automatisé) à partir des options Start from blank (Commencer à partir de zéro).

    La boîte de dialogue Build an automated cloud flow (Créer un flux cloud automatisé) apparaît.

  4. Donnez un nom à votre flux.

    Vous allez ensuite sélectionner un déclencheur.

  5. Saisissez Survey123 dans la barre de recherche. Sélectionnez When a survey response is submitted (Quand une réponse à une enquête est envoyée).

    Connecteur Survey123 dans Microsoft Power Automate

  6. Cliquez sur Create (Créer).
  7. Si vous utilisez pour la première fois ce connecteur dans Microsoft Power Automate, cliquez sur Sign In (Se connecter) pour vous connecter avec vos identifiants de connexion d’organisation ArcGIS.

    Vous n’aurez à le faire qu’une fois, car Microsoft Power Automate enregistre vos identifiants de connexion pour une utilisation ultérieure.

  8. Sélectionnez l’enquête que vous souhaitez utiliser avec votre webhook dans la liste déroulante des enquêtes.

    Vous avez maintenant terminé de configurer le déclencheur pour votre webhook. Toutefois, pour que le webhook exécute des actions avec ce déclencheur, il reste à réaliser d’autres étapes.

    Ce flux doit envoyer un message électronique lorsqu’une réponse est apportée à une question d’une certaine façon de sorte que vous fournissiez une condition.

  9. Cliquez sur le bouton New Step (Nouvelle étape), puis sélectionnez Condition en haut de la section Actions.

    Interface utilisateur de condition dans Microsoft Power Automate

  10. Cliquez sur la zone de texte la plus à gauche pour ouvrir une boîte de dialogue permettant de sélectionner une question ou une propriété à partir de l’enquête. Sélectionnez la question d’enquête que vous souhaitez utiliser pour qualifier votre enquête.
  11. La zone de texte du milieu est un menu déroulant dans lequel sélectionner la condition de déclenchement. Dans la mesure où vous attendez une réponse précise, sélectionnez is equal to (Est égal à).
  12. Dans la zone de texte la plus à droite, saisissez la valeur de la question pour laquelle envoyer une notification.

    Vous voulez que ce message électronique ne soit envoyé que si la condition est remplie.

  13. Cliquez sur Add an action (Ajouter une action) dans la zone If yes (Si oui). La zone If no (Si non) reste vide.

    De nombreux services de messagerie électronique disposent de connecteurs pouvant être utilisés dans ce flux.

  14. Pour cet exercice, sélectionnez Office 365 Outlook - Send an email (V2) (Office 365 Outlook - Envoyer un e-mail (V2)).
  15. Connectez-vous au service de messagerie électronique en saisissant vos identifiants de connexion, si ceux-ci ne sont pas déjà mémorisés.
  16. Renseignez les champs To (À), Subject (Objet) et Body (Corps) de votre courrier électronique.

    Dans la boîte de dialogue Dynamic content (Contenu dynamique) qui s’affiche lorsque vous sélectionnez une zone de texte, vous pouvez insérer le contenu de la réponse à l’enquête comme il convient.

  17. Lorsque votre e-mail est terminé, cliquez sur Save (Enregistrer).

Votre webhook est terminé, et activé par défaut. Le webhook s’exécutera à présent chaque fois qu’une réponse d’enquête envoyée satisfera les conditions données.

Configurer un webhook sur le site Web Survey123

Procédez comme suit pour configurer un webhook sur le site Web Survey123 :

  1. Sur la page My Surveys (Mes enquêtes), sélectionnez l’onglet Settings (Paramètres) dans le menu en bas à droite du volet de l’enquête.
  2. Sélectionnez la section Webhooks dans le menu de gauche.

    Cette page vous permet de configurer des webhooks, et d’accéder aux webhooks que vous avez configurés. Si vous n’avez configuré aucun webhook dans Survey123, la page est vide.

  3. Cliquez sur Add Webhook (Ajouter un webhook).

    Dans la nouvelle page qui s’ouvre, vous pouvez configurer la manière dont le webhook va interagir avec l’enquête.

    Page Add (Ajouter un webhook) sur le site Web de Survey123

  4. Attribuez un nom à votre webhook. Ce nom servira à l’identifier à l’avenir.
  5. La payload URL correspond à l’endroit où les informations de l’enquête seront envoyées. Elle doit être fournie par un service de webhook externe.
  6. L’événement déclencheur indique les actions spécifiques qui appelleront le webhook. Sélectionnez New record submitted (Nouvel enregistrement envoyé).
  7. Les données d’événement vous permettent de choisir les informations de votre enquête à inclure dans la payload : Survey info (Informations sur l’enquête), Server response (Réponse du serveur), Submitted record (Enregistrement envoyé), User info (Informations sur l’utilisateur) et Portal info (Informations sur le portail). Sélectionnez les options Survey info (Informations sur l’enquête) et Submitted record (Enregistrement envoyé).
  8. Le bouton bascule Status (Statut) détermine si ce webhook sera actif au moment de son enregistrement. Laissez-le défini sur On (Activé) (valeur par défaut).
  9. Cliquez sur Enregistrer.

Le webhook est prêt à être utilisé. Il s’exécutera chaque fois qu’une réponse à une enquête est envoyée. Les règles définies dans le fournisseur de webhooks permettent de faire en sorte qu’un message électronique soit envoyé uniquement quand certains critères sont remplis.