Resumen
Tras configurar la integración con Feishu Bitable, cada informe que generes en la extensión BugCapturer se escribirá automáticamente en la Bitable que hayas indicado como una nueva fila completa de registro: descripción, tipo, página, entorno, resumen de diagnóstico, enlace de captura, enlace para compartir — sin molestar a nadie del grupo, y tu equipo puede filtrar y revisar las entradas en cualquier momento. Características clave:- Cero creación manual de tablas: se crean automáticamente 14 columnas estándar al guardar la integración (las columnas existentes con el mismo nombre se reutilizan)
- Varias tablas: se pueden añadir hasta 3 integraciones, cada una apuntando a una tabla distinta — perfecto para mantener separadas una «tabla de seguimiento de bugs» y una «tabla de solicitudes de producto»
- Verificación al guardar: antes de guardar, el servidor ejecuta la comprobación completa de cuatro pasos «verificar credenciales → confirmar acceso de escritura → crear columnas → escribir un registro de prueba»
- Fallos visibles: las escrituras fallidas se reintentan automáticamente y quedan en el registro de entregas; tras 20 fallos consecutivos la integración se pausa automáticamente y recibes un correo
Preparación: crear una aplicación de Feishu
Feishu Bitable se conecta mediante una aplicación personalizada de empresa (App ID + App Secret), en cuatro pasos:1. Crear la aplicación personalizada
Abre la plataforma abierta de Feishu → Consola de desarrollador → Crear aplicación personalizada, e introduce el nombre y la descripción (p. ej., «BugCapturer Ledger Sync»).2. Activar los permisos de Bitable
Entra en tu aplicación → Permisos → busca y activa:bitable:app(ver, comentar, editar y gestionar Bitable)
- Si tu tabla está en un wiki, también
wiki:wiki:readonly(ver el wiki)
3. Publicar la aplicación
Entra en Gestión de versiones y publicación → Crear versión → Enviar a publicación. Las aplicaciones personalizadas normalmente las aprueba directamente el administrador del espacio.4. Añadir la aplicación como colaboradora de la tabla
Abre tu Bitable → «...» en la esquina superior derecha → Más → Añadir aplicación de documento → busca tu aplicación y añádela como colaboradora con permiso de edición. > Sin este paso, la aplicación no podrá escribir en la tabla por falta de permiso de colaboradora — es el descuido de configuración más habitual.Configurar en BugCapturer
- Nombre: p. ej., «Tabla de seguimiento de bugs»
- App ID: empieza por
cli_
- App Secret: cópialo desde la página de credenciales e información básica de la aplicación
- URL de Bitable: pega el enlace completo de la barra de direcciones del navegador (con el parámetro
table=; los enlaces de wiki también se admiten y se resuelven automáticamente)
Qué columnas se escriben
Las siguientes columnas estándar se crean automáticamente al guardar por primera vez (las columnas existentes con el mismo nombre se reutilizan; tus tipos de columna nunca se modifican):| Columna | Contenido |
|---|---|
| Descripción | Descripción del problema reportado |
| Tipo | Bug / Función / Sugerencia / Elogio |
| URL de la página | Dirección de la página donde ocurrió el problema (parámetros sensibles ocultos) |
| Título de la página | Título de la página |
| Navegador / SO / Resolución | Información del entorno |
| Errores de consola / Errores de red | Recuento de entradas de diagnóstico (el detalle completo está en el enlace para compartir) |
| Captura | Enlace de captura (haz clic para abrir a resolución completa) |
| Enlace para compartir | Página de compartición de BugCapturer (anotaciones completas, grabación de pantalla, detalles de diagnóstico) |
| Enviado el / Caduca el / Sincronizado el | Marcas de tiempo |
Uso diario
Una vez configurada, no se necesita ninguna acción adicional: pulsa «Compartir» en la extensión → se añade automáticamente una nueva fila a la tabla. El panel de éxito muestra «Sincronizado automáticamente con N tablas».- Prueba de escritura: cada tarjeta de integración de la página de ajustes tiene un botón «Probar» para verificar la escritura en cualquier momento
- Registro de entregas: consulta el estado, el motivo del fallo y el ID de registro de Feishu de las últimas 20 escrituras
- Pausar / Reanudar: pausa cuando no quieras sincronizar temporalmente y reanuda cuando quieras
- Protección ante fallos consecutivos: tras 20 escrituras fallidas consecutivas (p. ej., secret renovado, aplicación retirada de colaboradoras), la integración se pausa automáticamente y te avisamos por correo; tras corregirlo, pulsa «Probar» para verificar y reanudar