Une intégration est une adresse (URL de webhook) à laquelle un autre système peut envoyer une requête. frego en fait une tâche dans le projet. C'est pratique par exemple pour les signalements de bugs depuis ton site, un formulaire client ou les erreurs venant de Sentry.
Nouvelle intégration
- Dans le projet, ouvre Intégrations dans le menu.
- Clique sur Ajouter une intégration et donne-lui un nom.
- Choisis le Type : Générique ou Sentry.
- Configure les tâches à créer : titre, priorité, tag et colonne de destination.
- Copie l'URL du webhook et colle-la dans l'autre système.
Tu peux avoir plusieurs intégrations dans un même projet, chacune avec ses propres réglages et sa propre adresse. Quand tu n'as pas besoin de l'une d'elles, désactive-la avec l'interrupteur.
Intégration générique
L'autre système envoie une requête POST avec un corps JSON à l'adresse. Seul le champ description est obligatoire. Il peut aussi envoyer, en option, title, priority (high, medium ou low) et tag, qui remplaceront tes réglages par défaut. Il peut également joindre une image, qui sera ajoutée à la tâche en pièce jointe.
Le champ description peut contenir du simple texte. Il peut aussi contenir du HTML basique : paragraphes, listes, liens et images. Tout le reste, y compris les scripts, sera supprimé de la description par frego.
Sentry
Pour le type Sentry, frego t'affiche directement dans l'intégration la marche à suivre pour la connecter à Sentry. À partir de l'erreur, il remplit automatiquement le titre, la description et la priorité de la tâche. Si la même erreur réapparaît, aucune nouvelle tâche n'est créée.
Qui est au courant
Quand une intégration crée une tâche, tous les membres du projet reçoivent une notification.
FREE ou PRO
Les intégrations sont configurées par le propriétaire du projet et font partie de PRO. Quand PRO se termine, les intégrations déjà en place continuent de créer des tâches. Mais tu ne peux plus en ajouter de nouvelles ni modifier les existantes.
AttentionL'adresse de l'intégration fonctionne comme un mot de passe. Si elle tombe entre de mauvaises mains, clique sur Régénérer le token. L'ancienne adresse cessera de fonctionner et tu devras configurer la nouvelle dans l'autre système.