Intégration Lark Bitable : synchronisez automatiquement vos rapports de bug

Aperçu

Après avoir configuré l'intégration Lark Bitable, chaque rapport de partage généré dans l'extension BugCapturer est automatiquement ajouté à la Bitable que vous avez spécifiée sous la forme d'une nouvelle ligne complète : description, page, environnement, résumé des diagnostics, lien de capture, lien de partage — sans déranger personne dans le groupe, et votre équipe peut filtrer et consulter les entrées à tout moment. Fonctionnalités clés :
  • Mise en route sans friction : la méthode recommandée par déclencheur Webhook ne nécessite ni application Lark ni approbation d'administrateur — configuration en quelques minutes
  • Plusieurs tables : jusqu'à 3 intégrations possibles, chacune pointant vers une table différente — idéal pour séparer « Table de suivi des bugs » et « Table des demandes produit »
  • Vérification à l'enregistrement : à l'enregistrement, le serveur envoie une requête de test à l'URL Webhook — la connectivité est confirmée immédiatement
  • Échecs visibles : les écritures échouées sont retentées automatiquement et consignées dans le journal de livraison ; après 20 échecs consécutifs, l'intégration est mise en pause automatiquement et vous recevez un e-mail
Depuis la v1.3.2, Lark Bitable prend en charge deux méthodes de connexion :
  • Méthode A : Déclencheur Webhook d'automatisation (recommandée) — aucune application Lark requise. Créez un flux déclenché par Webhook dans l'automatisation de votre Bitable et collez l'URL — prêt en quelques minutes
  • Méthode B : Application personnalisée (API) — 13 colonnes standard sont créées automatiquement à l'enregistrement, sans mappage de champs ; idéal pour les équipes qui ont besoin d'une structure de colonnes unifiée
Pour une comparaison détaillée des deux méthodes et des guides pas à pas, consultez la documentation officielle · vue d'ensemble des intégrations.

Préparation : créer un flux Webhook dans Lark

Ouvrez votre Bitable et cliquez en haut à droite sur « Automatisation » → « Nouveau flux » :
  • Comme déclencheur, sélectionnez « À la réception d'une requête Webhook » (affiché « Déclencheur Webhook » dans certaines versions)
  • Le système génère automatiquement une URL Webhook unique — copiez-la pour la suite
  • Il est conseillé d'activer « Valider le token » pour éviter les requêtes falsifiées, et de noter le Bearer Token généré
  • Aucune application Lark à créer, aucune approbation d'administrateur requise — la préparation s'arrête là.

    Configurer dans BugCapturer

  • Ouvrez app.bugcapturer.com/settings/integrations et connectez-vous
  • Dans la liste des plateformes à gauche, sélectionnez « Lark Bitable » → cliquez sur « Ajouter une intégration » → choisissez « Déclencheur Webhook d'automatisation » (recommandé)
  • Renseignez :
    • Nom : par ex. « Table de suivi des bugs »
    • URL Webhook : collez l'URL copiée à l'étape précédente
    • Bearer Token (facultatif) : nécessaire uniquement si vous avez activé la validation du token côté Lark
  • Cliquez sur « Vérifier et enregistrer » — à l'enregistrement, BugCapturer envoie une requête de test à cette URL
  • Terminer le mappage des champs

    Retournez dans l'éditeur de flux de Lark :
  • Dans les « Paramètres de sortie », sélectionnez « Définir via l'envoi d'une requête »
  • Lark détecte automatiquement la requête de test qu'il vient de recevoir et liste tous les champs
  • Mappez un à un les champs souhaités vers les colonnes de la table, puis enregistrez et activez le flux
  • Une fois terminé, cliquez sur « Tester » sur la carte dans l'interface d'intégration BugCapturer — un nouvel enregistrement apparaît immédiatement dans votre table, et l'intégration est en place.

    Quels champs sont écrits dans la table

    Colonne Contenu
    Description Description du problème signalé
    URL de la page Adresse de la page concernée (paramètres sensibles masqués)
    Titre de la page Titre de la page
    Navigateur / OS / Résolution Informations d'environnement
    Erreurs console / Erreurs réseau Nombre d'entrées de diagnostic (texte intégral non inclus — cliquez sur le lien de partage pour voir le contenu complet)
    Capture Lien de capture (un clic ouvre l'image directement)
    Lien de partage Page de partage BugCapturer (annotations complètes, enregistrement d'écran, détails des diagnostics)
    Soumis le / Expire le / Synchronisé le Horodatages
    Si vous préférez vous passer du mappage manuel et laisser le serveur créer automatiquement les colonnes standard ci-dessus, optez plutôt pour la Méthode B · Application personnalisée (API). Le processus global est toutefois plus complexe — à essayer selon votre cas. Vous pouvez librement ajouter ou supprimer vos propres colonnes dans la table (par ex. « Responsable », « Priorité », « Statut ») — l'intégration n'est pas affectée.

    Utilisation quotidienne

    Une fois configurée, aucune action supplémentaire n'est requise : cliquez sur « Partager » dans l'extension → une nouvelle ligne apparaît automatiquement dans la table. Le panneau de succès affiche « Synchronisé automatiquement avec N tables ».
    • Test d'écriture : chaque carte d'intégration de la page de paramètres comporte un bouton « Tester » pour vérifier l'écriture à tout moment
    • Journal de livraison : consultez le statut, la cause de l'échec et l'ID d'enregistrement Lark des 20 dernières écritures
    • Pause / Reprise : mettez en pause quand vous ne souhaitez pas synchroniser temporairement, reprenez à tout moment
    • Protection contre les échecs consécutifs : après 20 échecs d'écriture consécutifs (par ex. URL Webhook invalide ou flux désactivé), l'intégration se met en pause automatiquement et vous êtes notifié par e-mail ; après correction, cliquez sur « Tester » pour vérifier et reprendre

    FAQ

    L'enregistrement échoue avec « validation de l'URL Webhook » ? Vérifiez que l'URL a été copiée dans son intégralité (avec https://), sans espaces ni retours à la ligne parasites. BugCapturer ne prend en charge que les URL https publiques. Enregistrement réussi mais aucune donnée dans la table ? Assurez-vous que le flux Lark est enregistré et activé ; si aucun mappage de champs n'est configuré dans les « Paramètres de sortie », les requêtes reçues n'écriront rien dans la table. Cliquez sur « Tester » sur la carte de l'intégration pour déclencher un nouvel enregistrement de test. Le fichier de capture est-il écrit lui-même dans la table ? Actuellement, c'est un lien de capture qui est écrit — un clic suffit pour voir l'image en pleine résolution. Mes données sont-elles en sécurité ? Les écritures de l'intégration ne se déclenchent que lorsque vous partagez activement ; ce flux de données est détaillé dans la politique de confidentialité. Plus de documentation : les guides pas à pas se trouvent dans la documentation officielle — Méthode A · Déclencheur Webhook d'automatisation / Méthode B · Application personnalisée (API).