Envoyer des soumissions vers Slack via un webhook
Ajoutez un point de terminaison du webhook dans l’onglet Livraison d’un formulaire, choisissez le format Message Slack et collez une adresse de webhook entrant dont vous êtes propriétaire. C’est un format de charge utile, pas une intégration native de Slack.
Cet article a été traduit automatiquement. Lire l'original en anglais
FormFlow peut publier un court message dans Slack chaque fois qu’un formulaire reçoit une soumission. Il le fait via un point de terminaison du webhook, le mécanisme même qui transmet les soumissions vers n’importe quelle URL qui vous appartient. Ce n’est pas une intégration native de Slack : aucune application Slack à installer, aucune connexion avec Slack, aucun sélecteur de canal. Vous donnez à FormFlow une adresse de webhook entrant, et FormFlow lui envoie un message au format Slack. Ce tutoriel explique la configuration et dit sans détour ce que le message contient et ne contient pas.
Ce qu’il vous faut d’abord
Un formulaire de votre équipe que vous pouvez modifier.
Une adresse de webhook entrant qui vous appartient : l’URL du webhook entrant de votre espace de travail Slack, ou l’adresse de tout point de terminaison à vous qui accepte le format de message de Slack. Créez-la dans Slack en suivant la documentation de Slack ; cet article ne couvre pas ce côté.
Une adresse https. FormFlow refuse le http simple pour les points de terminaison du webhook.
Ajoutez le point de terminaison
Ouvrez le formulaire et allez dans son onglet « Livraison ».
Repérez « Points de terminaison du webhook » et choisissez « Ajouter un point de terminaison ».
Dans le champ « Envoyer comme », choisissez « Message Slack ». La valeur par défaut est « FormFlow JSON (signé) » : ce changement est donc toute la différence entre un point de terminaison Slack et un webhook ordinaire.
Le champ d’URL s’intitule désormais « URL du webhook entrant ». Collez-y votre adresse. Le champ est masqué pendant la saisie, et vous pouvez l’afficher pour vérifier ce que vous avez collé.
Laissez « Livrer » activé. Il l’est par défaut ; désactivez-le pour arrêter la livraison vers ce point de terminaison.
Enregistrez le formulaire.
Le texte d’aide sous « Envoyer comme » indique que l’adresse est stockée chiffrée et n’est jamais renvoyée par e-mail. La ligne repliée du point de terminaison nomme le format au lieu d’afficher l’adresse, de sorte que l’URL ne traîne pas en clair sur la page.
Envoyez un test
Chaque ligne de point de terminaison a une action « Envoyer le test ». Elle publie une seule ligne, « FormFlow test — submissions from this form will arrive here. », à l’adresse de la ligne. En cas de succès, vous voyez « Test livré » ; en cas d’échec, vous voyez « La livraison du test a échoué », avec le texte d’erreur du récepteur lui-même, tronqué à 300 caractères.
Deux conditions s’appliquent. Enregistrez d’abord le formulaire : un point de terminaison jamais enregistré ne peut pas être testé, et l’action vous le dit. Et chaque personne peut envoyer 20 livraisons de test par heure, échecs compris. Un test est un bouton, pas un verrou ; le point de terminaison livre que vous l’ayez actionné ou non.
Ce qui arrive dans le canal
Le message est une sonnette, pas le registre. Il contient :
Une première ligne en gras : « New submission — » suivie du nom du formulaire.
Jusqu’à cinq réponses, une par ligne, chacune sous forme d’une étiquette en gras et d’une valeur. Une valeur est tronquée à 200 caractères.
Une ligne indiquant combien de champs supplémentaires il y a, lorsque le formulaire en compte plus de cinq.
Un lien « View submission » vers la soumission dans votre tableau de bord.
Les espaces à l’intérieur d’une valeur sont réduits, de sorte qu’une valeur ne tient jamais que sur une ligne. Les caractères &, < et > sont échappés pour que Slack ne lise pas le texte d’un expéditeur comme du balisage, et un astérisque dans une valeur est remplacé par un caractère d’apparence voisine pour qu’un expéditeur ne puisse pas falsifier une étiquette en gras. Le message est en texte brut uniquement ; il n’utilise pas Block Kit de Slack.
Limites à connaître
À sens unique. FormFlow envoie ; rien dans Slack ne revient vers FormFlow.
Cinq réponses au maximum, de 200 caractères chacune. Pour la soumission complète, utilisez le lien ou la boîte de réception des soumissions.
Slack ignore la signature. Tous les formats de webhook sont signés, mais Slack écarte l’en-tête de signature : il n’y a donc aucun secret de signature à copier pour un point de terminaison Slack.
Les soumissions que FormFlow classe comme spam ne sont pas transmises. Seules les soumissions acceptées qui ne sont pas du spam atteignent un point de terminaison du webhook.
Les nouvelles tentatives, le backoff et la désactivation sont communs à tous les formats de webhook. Un récepteur qui échoue en continu peut voir son point de terminaison désactivé ; vérifiez donc la ligne si les messages cessent d’arriver.
L’adresse est un identifiant. Quiconque détient l’URL d’un webhook entrant de Slack peut publier dans ce canal. Traitez-la comme un mot de passe et remplacez-la dans Slack si elle fuite.
Ce que cela ne décide pas
Cela ne choisit pas votre canal et ne gère pas Slack à votre place : l’adresse que vous collez fixe où atterrissent les messages, et cela se configure dans Slack. Cela ne fait pas de Slack votre boîte de réception ; lire, rechercher et exporter les soumissions reste dans FormFlow. Et cela ne fait pas du message Slack une copie des données. Si vous avez besoin que chaque champ soit livré sous forme de données structurées, ajoutez un second point de terminaison avec le format FormFlow JSON par défaut.