# Linear

Ouvrez un ticket Linear à chaque soumission.

## 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.

<h2 id="what-you-get">Ce que vous obtenez</h2>

<ul>
  <li>Un ticket Linear par soumission, attribué à l’utilisateur connecté</li>
  <li>
    Titre et description construits depuis un éditeur de modèle — tapez <strong>@</strong> pour insérer la valeur de n’importe quel champ du
    formulaire
  </li>
  <li>La description prend en charge le markdown (gras, listes, titres, blocs de code, citations, liens)</li>
  <li>Projet par défaut optionnel appliqué à chaque ticket</li>
  <li>Remplissage rétrospectif des soumissions existantes à la demande (~1 ticket par seconde)</li>
  <li>
    Bouton de test qui crée un vrai ticket avec le préfixe <code>[Test]</code> pour vérifier avant la mise en production
  </li>
</ul>

<h2 id="connect">Connecter Linear</h2>

<h2 id="backfill">Remplissage rétrospectif des soumissions existantes</h2>

<p>
  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.
</p>

<h2 id="abandoned-responses">Événements de réponses abandonnées</h2>

<p>
  Lorsqu’un répondant commence votre formulaire mais ne le termine pas, Formstep peut créer un ticket séparé pour les données partielles.
  Réglez <strong>Envoyer l’événement d’abandon après</strong> 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{' '}
  <code>partial-submission</code>.
</p>

<p>
  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 <strong>Champs obligatoires</strong> le restreint davantage : le
  ticket n’est créé que si au moins un des champs choisis a été rempli.
</p>

> ℹ️ **Fonctionnalité Pro**
> <p>
>     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 <a href="/fr/subscription-billing/plans-pricing">plans et tarifs</a>.
>   </p>

<h2 id="token-refresh">Renouvellement du jeton</h2>

<p>
  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), Formstep 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.
</p>

<h2 id="removing">Supprimer l’intégration</h2>

<ul>
  <li>
    <strong>Depuis Formstep</strong> — Paramètres du formulaire → Intégrations → Linear → Supprimer. Les nouvelles soumissions arrêtent
    immédiatement de créer des tickets.
  </li>
  <li>
    <strong>Depuis Linear</strong> — Révoquez l’autorisation OAuth depuis vos paramètres utilisateur. Le prochain envoi échoue et les
    identifiants sont marqués comme expirés.
  </li>
</ul>

<h2 id="limits">Limites et comportement</h2>

<ul>
  <li>Un ticket par soumission — pas de mode commentaire sur un ticket existant</li>
  <li>
    Le titre est en texte brut, tronqué avec des points de suspension au-delà de 255 caractères ; la description est en markdown uniquement
  </li>
  <li>
    Un titre vide revient à <code>New submission to &lt;form name&gt;</code>
  </li>
  <li>
    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
  </li>
  <li>
    Un champ <a href="/fr/building-forms/repeating-groups">groupe répétable</a> inséré avec @ affiche chaque entrée jointe par " · "
  </li>
</ul>

<h2 id="faq">FAQ</h2>

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

  <p>
    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.
  </p>

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

  <p>
    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.
  </p>

  <p>
    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.
  </p>

<h2 id="next-steps">Prochaines étapes</h2>
<div class="not-prose grid gap-3 sm:grid-cols-2">
  - [GitHub Issues](/fr/integrations/github) — Transformez les soumissions en tickets GitHub
  - [Santé et surveillance](/fr/integrations/health-monitoring) — Suivez les erreurs d'intégration et l'état de renouvellement des jetons
</div>