Visão geral
Depois de configurar a integração com o Lark Bitable, cada relatório que você gerar na extensão BugCapturer será gravado automaticamente na Bitable indicada como uma nova linha completa: descrição, página, ambiente, resumo do diagnóstico, link da captura, link de compartilhamento — sem incomodar ninguém no grupo, e a sua equipe pode filtrar e revisar as entradas a qualquer momento. Recursos principais:- Integração sem barreiras: o método recomendado é o gatilho Webhook — não é preciso criar um app do Lark nem obter aprovação do administrador, e a configuração fica pronta em poucos minutos
- Várias tabelas: é possível adicionar até 3 integrações, cada uma apontando para uma tabela diferente — ideal para gerenciar separadamente uma «tabela de acompanhamento de bugs» e uma «tabela de solicitações de produto»
- Verificação ao salvar: ao salvar, o servidor envia uma requisição de teste ao endereço do Webhook e a conectividade é confirmada na hora
- Falhas visíveis: gravações com falha são repetidas automaticamente e ficam registradas no log de entregas; após 20 falhas consecutivas a integração é pausada automaticamente e você recebe um e-mail
- Método A: Gatilho Webhook de automação (recomendado) — sem criar um app do Lark: crie um fluxo com gatilho Webhook em «Automação» da sua Bitable, cole o endereço e pronto; a configuração fica pronta em poucos minutos
- Método B: API de app personalizado de empresa — cria automaticamente 13 colunas padrão ao salvar e dispensa o mapeamento de campos; ideal para equipes que precisam de uma estrutura de colunas uniforme
Preparação: criar um fluxo de Webhook no Lark
Abra a sua Bitable e clique em «Automação» no canto superior direito → «Novo fluxo»:Configurar no BugCapturer
- Nome: por ex., «Tabela de acompanhamento de bugs»
- Endereço do Webhook: cole o endereço copiado na etapa anterior
- Bearer Token (opcional): preencha apenas se você ativou a verificação de Token no Lark
Conclua o mapeamento de campos
Volte à página de edição do fluxo no Lark:Quais campos são gravados na tabela
| Coluna | Conteúdo |
|---|---|
| Descrição | Descrição do problema reportado |
| URL da página | Endereço da página onde ocorreu o problema (parâmetros sensíveis ocultos) |
| Título da página | Título da página |
| Navegador / SO / Resolução | Informações do ambiente |
| Erros de console / Erros de rede | Contagem de entradas de diagnóstico (o conteúdo não vem incluído; abra o link de compartilhamento para ver o detalhe completo) |
| Captura | Link da captura (clique para abrir diretamente) |
| Link de compartilhamento | Página de compartilhamento do BugCapturer (anotações completas, gravação de tela, detalhes do diagnóstico) |
| Enviado em / Expira em / Sincronizado em | Carimbos de data/hora |
Uso diário
Depois de configurada, nenhuma ação adicional é necessária: clique em «Compartilhar» na extensão → uma nova linha aparece automaticamente na tabela. O painel de sucesso mostra «Sincronizado automaticamente com N tabelas».- Teste de gravação: cada cartão de integração na página de configurações tem um botão «Testar» para verificar a gravação a qualquer momento
- Log de entregas: consulte o status, o motivo da falha e o ID de registro do Lark das últimas 20 gravações
- Pausar / Retomar: pause quando não quiser sincronizar temporariamente e retome quando quiser
- Proteção contra falhas consecutivas: se a gravação falhar 20 vezes consecutivas (por ex., o endereço do Webhook deixou de ser válido ou o fluxo foi desativado), a integração é pausada automaticamente e você é avisado por e-mail; depois de corrigir, clique em «Testar» para verificar e retomar
Perguntas frequentes
O salvamento falha com «verificação do endereço do Webhook»? Confira se o endereço foi copiado por completo (incluindohttps://) e se não entrou espaço ou quebra de linha. O BugCapturer só aceita endereços https públicos.
O salvamento foi concluído, mas não há dados na tabela? Confirme que o fluxo do Lark está salvo e ativado; se a «Configuração de saída» não tiver o mapeamento de campos configurado, a requisição recebida também não gravará na tabela. Você pode clicar em «Testar» no cartão de integração para gerar um novo registro de teste.
O que é gravado na tabela é o arquivo da captura em si? Por enquanto, é gravado um link da captura — clique para ver a imagem em resolução total.
Meus dados estão seguros? A gravação da integração é acionada apenas quando você compartilha ativamente; esse fluxo de dados está divulgado na política de privacidade.
Mais documentação: os guias passo a passo estão na documentação oficial — Método A · Gatilho Webhook de automação / Método B · API de app personalizado de empresa.