Intégrations
GitHub Issues
Transformez automatiquement les soumissions en tickets GitHub. Chaque soumission crée un ticket dans le dépôt de votre choix, avec un titre, un corps et un jalon personnalisés.
Ce que vous obtenez
- Un ticket GitHub par soumission, attribué à l’utilisateur connecté
Titre et corps construits depuis un éditeur de modèle — tapez @ pour insérer la valeur de n’importe quel champ du formulaire
- Le corps prend en charge le markdown GitHub (gras, listes, titres, blocs de code, liens)
- Jalon par défaut optionnel appliqué à chaque ticket
Bouton de test qui crée un vrai ticket préfixé
[Test]pour vérifier avant de mettre en production
Connecter GitHub
- 1
Ouvrez Paramètres du formulaire → Intégrations → GitHub Issues
Appuyez sur Connecter un compte GitHub, ou choisissez un compte déjà connecté par l’espace de travail. Une fenêtre contextuelle vous guide à travers le consentement OAuth. Permissions demandées : repo, read:user, read:org.
- 2
Choisissez un dépôt
Le sélecteur liste les dépôts sur lesquels vous avez un accès en écriture. formbase exclut les dépôts archivés et désactivés.
- 3
Définissez les paramètres par défaut (optionnel)
Choisissez un jalon par défaut. Il s’applique à chaque ticket et se réinitialise lorsque vous changez de dépôt.
- 4
Composez le titre et le corps
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 (256 caractères max) ; le corps s'affiche en markdown GitHub.
- 5
Soumissions abandonnées (optionnel)
Choisissez une fenêtre d’inactivité et écrivez un titre et un corps séparés pour les brouillons que personne n’a terminés. Laissez sur Désactivé pour ignorer. Nécessite Pro ou Business.
- 6
Finaliser
Envoyer un test crée un vrai ticket avec le préfixe [Test] dans le dépôt choisi — fermez-le ou supprimez-le ensuite. Puis appuyez sur Créer l’intégration et chaque soumission crée un ticket GitHub.
Événements de réponses abandonnées
Lorsqu’un répondant commence votre formulaire sans le terminer, 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 le corps du
ticket abandonné — aucun des deux ne peut être vide. Les tickets abandonnés reçoivent l’étiquette partial-submission, créée à
la première utilisation.
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 GitHub Issues de base est disponible sur tous les plans. Consultez les offres et tarifs.
Jetons
Les jetons OAuth App GitHub n’expirent pas — il n’y a pas de rotation de jeton de rafraîchissement. Si vous révoquez l’autorisation depuis la page des applications OAuth autorisées de votre compte GitHub, l’envoi suivant échoue, formbase marque les identifiants comme expirés 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 → GitHub Issues → Supprimer. Les nouvelles soumissions arrêtent immédiatement de créer des tickets.
Depuis GitHub — Révoquez l’autorisation OAuth depuis la page des applications OAuth autorisées de votre compte. formbase ne révoque pas automatiquement le jeton de son côté.
Limites et comportement
- Un ticket par soumission — pas de mode commentaire sur un ticket existant
- Pas de rétro-remplissage — seules les nouvelles soumissions créent des tickets
- Le titre est en texte brut, tronqué avec des points de suspension au-delà de 256 caractères ; le corps 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
Les réponses sont insérées telles quelles dans le corps du ticket — si une réponse contient
@utilisateur, GitHub notifie cette personne, et#123crée une référence de ticket
FAQ
Trois permissions GitHub : repo (créer des tickets), read:user (identifier votre compte) et
read:org (lister les dépôts de l’organisation). Il s’agit d’une application OAuth standard — aucune installation
d’application GitHub n’est requise.
Oui. Les connexions GitHub sont liées à l’espace de travail. Tout membre de l’espace de travail peut utiliser n’importe quel compte GitHub connecté lors de la configuration d’une intégration.
Oui. Ouvrez la fiche de détails de l’intégration et modifiez l’un ou l’autre champ. Changer de dépôt réinitialise le jalon car les jalons sont spécifiques au dépôt.
La soumission suivante échoue avec une erreur “introuvable” et l’intégration affiche un statut d’erreur. Modifiez l’intégration pour choisir un autre dépôt.
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 un dépôt supprimé n’attendent pas cinq échecs — l’intégration s’arrête immédiatement. Dans tous les cas, corrigez la cause et appuyez sur Reprendre.