Resumen
Tras configurar la integración con Lark 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: descripción, 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:- Puesta en marcha sin fricción: el método recomendado es el disparador Webhook — no hace falta crear una aplicación de Lark ni obtener la aprobación del administrador, y la configuración se completa en unos minutos
- Varias tablas: se pueden añadir hasta 3 integraciones, cada una apuntando a una tabla distinta — perfecto para gestionar por separado una «tabla de seguimiento de bugs» y una «tabla de solicitudes de producto»
- Verificación al guardar: al guardar, el servidor envía una solicitud de prueba a la dirección del Webhook y la conectividad queda confirmada al momento
- Fallos visibles: las escrituras fallidas se reintentan automáticamente y puedes consultarlas en el registro de entregas; tras 20 fallos consecutivos la integración se pausa automáticamente y recibes un correo
- Método A: Disparador Webhook de automatización (recomendado) — sin necesidad de crear una aplicación de Lark: crea un flujo con disparador Webhook en «Automatización» de tu Bitable, pega la dirección y listo; la configuración se completa en unos minutos
- Método B: API de aplicación personalizada de empresa — crea automáticamente 13 columnas estándar al guardar y evita la asignación de campos; ideal para equipos que necesitan una estructura de columnas uniforme
Preparación: crear un flujo de Webhook en Lark
Abre tu Bitable y haz clic en «Automatización» en la esquina superior derecha → «Nuevo flujo»:Configurar en BugCapturer
- Nombre: p. ej., «Tabla de seguimiento de bugs»
- Dirección del Webhook: pega la dirección que copiaste en el paso anterior
- Bearer Token (opcional): rellénalo solo si activaste la verificación de Token en Lark
Completa la asignación de campos
Vuelve a la página de edición del flujo en Lark:Qué campos se escriben en la tabla
| Columna | Contenido |
|---|---|
| Descripción | Descripción del problema reportado |
| 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 contenido no viene incluido; abre el enlace para compartir para verlo completo) |
| Captura | Enlace de captura (haz clic para abrirlo directamente) |
| 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 Lark de las últimas 20 escrituras
- Pausar / Reanudar: pausa cuando no quieras sincronizar temporalmente y reanuda cuando quieras
- Protección ante fallos consecutivos: si la escritura falla 20 veces consecutivas (p. ej., la dirección del Webhook dejó de ser válida o el flujo fue desactivado), la integración se pausa automáticamente y te avisamos por correo; tras corregirlo, pulsa «Probar» para verificar y reanudar
Preguntas frecuentes
¿El guardado falla con «verificación de la dirección del Webhook»? Comprueba que la dirección se copió completa (incluidohttps://) y que no se colaron espacios ni saltos de línea. BugCapturer solo admite direcciones https públicas.
¿Se guardó correctamente pero no hay datos en la tabla? Confirma que el flujo de Lark está guardado y activado; si la «Configuración de salida» no tiene asignados los campos, la solicitud recibida tampoco escribirá en la tabla. Puedes pulsar «Probar» en la tarjeta de integración para generar de nuevo un registro de prueba.
¿Se escribe el propio archivo de captura en la tabla? Por ahora se escribe un enlace de captura; haz clic para ver la imagen a resolución completa.
¿Están seguros mis datos? La escritura de la integración solo se activa cuando compartes activamente; este flujo de datos está divulgado en la política de privacidad.
Más documentación: las guías paso a paso están en la documentación oficial — Método A · Disparador Webhook de automatización / Método B · API de aplicación personalizada de empresa.