Visão geral
Depois de configurar a integração com o Feishu Bitable, cada relatório de compartilhamento que você gerar na extensão BugCapturer será gravado automaticamente na Bitable indicada como uma nova linha completa de registro: descrição, tipo, 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:- Zero criação manual de tabelas: 14 colunas padrão são criadas automaticamente ao salvar a integração (colunas existentes com o mesmo nome são reutilizadas)
- Várias tabelas: é possível adicionar até 3 integrações, cada uma apontando para uma tabela diferente — ideal para manter separadas uma «tabela de acompanhamento de bugs» e uma «tabela de solicitações de produto»
- Verificação ao salvar: antes de salvar, o servidor executa a verificação completa de quatro etapas «validar credenciais → confirmar acesso de escrita → criar colunas → gravar um registro de teste»
- Falhas visíveis: gravações com falha são repetidas automaticamente e registradas no log de entregas; após 20 falhas consecutivas a integração é pausada automaticamente e você recebe um e-mail
Preparação: criar um app do Feishu
O Feishu Bitable se conecta por meio de um app personalizado de empresa (App ID + App Secret), em quatro etapas:1. Criar o app personalizado
Abra a plataforma aberta do Feishu → Console do desenvolvedor → Criar app personalizado, e preencha o nome e a descrição (por ex., «BugCapturer Ledger Sync»).2. Ativar as permissões do Bitable
Acesse o seu app → Permissões → pesquise e ative:bitable:app(ver, comentar, editar e gerenciar o Bitable)
- Se a sua tabela estiver em um wiki, ative também
wiki:wiki:readonly(ver o wiki)
3. Publicar o app
Acesse Gerenciamento de versões e publicação → Criar versão → Enviar para publicação. Apps personalizados normalmente são aprovados diretamente pelo administrador do espaço.4. Adicionar o app como colaborador da tabela
Abra a sua Bitable → «...» no canto superior direito → Mais → Adicionar app de documento → pesquise o seu app e adicione-o como colaborador com permissão de edição. > Sem esta etapa, o app não conseguirá gravar na tabela por falta de permissão de colaborador — é o descuido de configuração mais comum.Configurar no BugCapturer
- Nome: por ex., «Tabela de acompanhamento de bugs»
- App ID: começa com
cli_
- App Secret: copie na página de credenciais e informações básicas do app
- URL da Bitable: cole o link completo da barra de endereços do navegador (com o parâmetro
table=; links de wiki também são aceitos e resolvidos automaticamente)
Quais colunas são gravadas
As seguintes colunas padrão são criadas automaticamente no primeiro salvamento (colunas existentes com o mesmo nome são reutilizadas; os tipos das suas colunas nunca são alterados):| Coluna | Conteúdo |
|---|---|
| Descrição | Descrição do problema reportado |
| Tipo | Bug / Função / Sugestão / Elogio |
| 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 detalhe completo está no link de compartilhamento) |
| Captura | Link da captura (clique para abrir em resolução total) |
| 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 Feishu das últimas 20 gravações
- Pausar / Retomar: pause quando não quiser sincronizar temporariamente e retome quando quiser
- Proteção contra falhas consecutivas: após 20 gravações com falha consecutivas (por ex., secret renovado, app removido dos colaboradores), a integração é pausada automaticamente e você é avisado por e-mail; depois de corrigir, clique em «Testar» para verificar e retomar