formbasedocs
Aller à l'applicationAppli

Intégrations

Linear

Transformez les soumissions en tickets Linear automatiquement. Chaque soumission crée un ticket dans l’équipe de votre choix, avec un titre, une description et un projet personnalisés.


Ce que vous obtenez

  • Un ticket Linear par soumission, attribué à l’utilisateur connecté
  • Titre et description construits depuis un éditeur de modèle — tapez @ pour insérer la valeur de n’importe quel champ du formulaire

  • La description prend en charge le markdown (gras, listes, titres, blocs de code, citations, liens)
  • Projet par défaut optionnel appliqué à chaque ticket
  • Remplissage rétrospectif des soumissions existantes à la demande (~1 ticket par seconde)
  • Bouton de test qui crée un vrai ticket avec le préfixe [Test] pour vérifier avant la mise en production

Connecter Linear

  1. 1

    Ouvrez Paramètres du formulaire → Intégrations → Linear

    Appuyez sur Connecter un compte Linear, ou choisissez un compte déjà connecté par l’espace de travail. Une fenêtre contextuelle vous guide à travers le consentement OAuth. Portées demandées : read, write, issues:create.

  2. 2

    Choisissez une équipe

    Les tickets arriveront dans le backlog de cette équipe. Chaque intégration cible une seule équipe — ajoutez une autre intégration pour router vers une deuxième équipe.

  3. 3

    Définissez les valeurs par défaut (optionnel)

    Choisissez un projet. Il s’applique à chaque ticket et se réinitialise quand vous changez d’équipe.

  4. 4

    Composez le titre et la description

    Utilisez les éditeurs de modèle. Tapez @ pour insérer les valeurs des champs du formulaire ou des métadonnées de soumission comme PDF Link. Le titre s’affiche en texte brut (255 caractères max) ; la description s’affiche en markdown.

  5. 5

    Soumissions abandonnées (optionnel)

    Choisissez une fenêtre d’inactivité et écrivez un titre et une description séparés pour les brouillons que personne n’a terminés. Laissez sur Désactivé pour ignorer. Nécessite Pro ou Business.

  6. 6

    Finaliser

    Envoyer un test crée un vrai ticket avec le préfixe [Test] dans l’équipe choisie — archivez-le ou supprimez-le ensuite. Puis appuyez sur Créer l’intégration et chaque soumission crée un ticket Linear.

Remplissage rétrospectif des soumissions existantes

Lors de la première connexion, vous pouvez exporter les soumissions existantes sous forme de tickets Linear. Le remplissage s’exécute en arrière-plan à ~1 ticket par seconde pour rester dans les limites de débit de Linear. La progression est enregistrée toutes les 10 soumissions.

Événements de réponses abandonnées

Lorsqu’un répondant commence votre formulaire mais ne le termine pas, formbase peut créer un ticket séparé pour les données partielles. Réglez Envoyer l’événement d’abandon après sur 12 heures, 1 jour, 3 jours ou 1 semaine, puis renseignez le titre et la description du ticket abandonné — aucun des deux ne peut être vide. Les tickets abandonnés reçoivent l’étiquette partial-submission.

Un balayage horaire recherche les brouillons inactifs, si bien que le ticket apparaît au premier balayage suivant le passage de la fenêtre. Seuls les brouillons d’un lien de partage sont balayés, et Champs obligatoires le restreint davantage : le ticket n’est créé que si au moins un des champs choisis a été rempli.

Fonctionnalité Pro

La livraison des réponses abandonnées nécessite un plan Pro ou Business. L’intégration Linear de base est disponible sur tous les plans. Voir plans et tarifs.

Renouvellement du jeton

Les jetons d’accès Linear se renouvellent automatiquement avant chaque envoi lorsqu’ils approchent de leur expiration. Si le renouvellement échoue (jeton révoqué, application désinstallée), formbase marque l’intégration en erreur et vous recevez un e-mail de notification d’échec. Reconnectez-vous depuis la page Intégrations de l’espace de travail pour rétablir la connexion.

Supprimer l’intégration

  • Depuis formbase — Paramètres du formulaire → Intégrations → Linear → Supprimer. Les nouvelles soumissions arrêtent immédiatement de créer des tickets.

  • Depuis Linear — Révoquez l’autorisation OAuth depuis vos paramètres utilisateur. Le prochain envoi échoue et les identifiants sont marqués comme expirés.

Limites et comportement

  • Un ticket par soumission — pas de mode commentaire sur un ticket existant
  • Le titre est en texte brut, tronqué avec des points de suspension au-delà de 255 caractères ; la description est en markdown uniquement

  • Un titre vide revient à New submission to <form name>

  • Les réponses de type téléchargement de fichier s’affichent comme le nom du fichier suivi de son lien de téléchargement, si bien que le fichier reste accessible depuis le ticket

  • Un champ groupe répétable inséré avec @ affiche chaque entrée jointe par “ · “

FAQ

Trois portées OAuth Linear : read (lister les équipes, projets et labels), write (mettre à jour les métadonnées des tickets) et issues:create (créer des tickets). La connexion utilise actor=user, donc les tickets vous sont attribués, pas à un bot.

Oui. Ouvrez la fiche de détail de l’intégration et modifiez l’un ou l’autre champ. Changer d’équipe réinitialise le projet car les projets sont spécifiques à chaque équipe.

Oui. Autorisez différents comptes Linear pour ajouter plusieurs identifiants. Chaque intégration de formulaire choisit lequel utiliser.

Oui. Les connexions Linear sont liées à l’espace de travail. N’importe quel membre peut utiliser n’importe quel compte Linear connecté lors de la configuration d’une intégration.

L’intégration se met automatiquement en pause et un e-mail est envoyé à la personne qui l’a configurée. Un jeton révoqué, une permission perdue ou une équipe supprimée n’attendent pas cinq échecs — l’intégration s’arrête immédiatement. Dans tous les cas, corrigez la cause et appuyez sur Reprendre.

Prochaines étapes