Suporte
Como conectar sua conta
Como criar um token
- No Sentry, abra User settings → Personal Tokens (em servidores auto-hospedados: as configurações equivalentes de tokens de autenticação) e crie um novo token.
-
Escolha os escopos. Para navegar em modo somente leitura:
org:read,project:read,event:read. Para fazer a triagem pelo app, adicioneevent:write(resolver, arquivar, atribuir) emember:read(para escolher responsáveis). - Copie o token e cole-o na tela de conexão do Tracebell. Os escopos não podem ser alterados depois da criação: se você escolheu escopos de menos, crie um novo token.
Servidores auto-hospedados
Escolha “Auto-hospedado” na tela de conexão e digite o URL do seu servidor. O app usa os mesmos caminhos de API do sentry.io. Seu servidor precisa estar acessível a partir do seu iPhone (diretamente ou por VPN) via HTTPS.
Problemas comuns
- “O token foi rejeitado” logo depois de colar: verifique se o token não foi cortado e se não há espaços a mais; os tokens são longos. Em servidores auto-hospedados, confirme também que o URL não tem nenhum caminho depois do nome do host.
- Botões em cinza (resolver/atribuir): falta ao seu
token o escopo
event:writeoumember:read. Crie um novo token com esses escopos. - Tudo funcionava e parou de repente: o token provavelmente foi revogado ou sua participação na organização mudou. Reconecte com um token novo.
- As listas ficam lentas ou param de atualizar: o Sentry aplica limites de taxa por endpoint. O app reduz o ritmo automaticamente e retoma quando o limite é redefinido.
Notificações push
No plano gratuito, os dispositivos registrados recebem um resumo diário de issues novas (por volta das 22:00 UTC), e todo dispositivo registrado recebe um resumo semanal. O Tracebell Advanced troca o resumo diário pela entrega em tempo real de cada evento (criação, regressão, resolução), com seus filtros. A configuração é a mesma nos dois casos:
- No Tracebell, abra Perfil → Notificações, toque em Ativar notificações e permita as notificações.
- Toque em Configurar notificações push. No Sentry, abra Settings → Developer Settings → Custom Integrations e crie uma Internal Integration: defina Issue & Event como Read (o Sentry exige isso para assinar webhooks de issues), deixe todas as outras permissões em “No Access”, ative Alert Rule Action e assine os eventos issue no webhook.
- Copie o Client Secret da integração, cole-o no app e toque em Registrar este dispositivo. O app mostra então o seu URL pessoal do webhook.
- Cole esse URL no campo Webhook URL da integração no Sentry e salve. Se quiser, adicione “Send a notification via Tracebell” às suas regras de alerta.
- De volta ao app, envie uma notificação de teste. Com o Advanced, escolha quais tipos de evento notificam você em tempo real e, se quiser, limite-os a Projetos selecionados (até 50) e a um Nível mínimo (Info, Warning, Error ou Fatal).
Criar uma Internal Integration normalmente exige a função Admin, Manager ou Owner na organização. Se você é Member, peça a um Owner para configurá-la ou use o app sem push.
Nota de privacidade: o relay nunca guarda seu token do Sentry e não armazena títulos de issues; eles só passam por ele a caminho do serviço de push da Apple, para entregar a notificação. Veja a política de privacidade.
Como os filtros funcionam
- Eles valem para o push em tempo real e para o início automático de Atividades ao Vivo. O resumo diário (plano gratuito) e o resumo semanal continuam contando toda issue nova, e as issues que você acompanha na Tela Bloqueada não são filtradas.
- Alertas de métricas são filtrados apenas por projeto. Quando o Sentry não informa o projeto ou o nível de um evento, ele é entregue em vez de descartado.
Atividade ao Vivo (Advanced)
Abra uma issue não resolvida e toque em Acompanhar na Tela Bloqueada. A Atividade ao Vivo mostra a fase, os eventos, os usuários e os alertas da issue, além de quando ela foi vista pela última vez, na Tela Bloqueada e na Dynamic Island. Ela termina quando a issue é resolvida ou arquivada, e você pode parar de acompanhar a qualquer momento.
- As atualizações em segundo plano chegam pelo relay de push, então exigem notificações configuradas (acima) para a organização da issue. Elas chegam quando o Sentry envia um webhook da issue, não em intervalos fixos; adicionar “Send a notification via Tracebell” a uma regra de alerta de issues as torna mais frequentes. Sem notificações, a Atividade ao Vivo só é atualizada enquanto o Tracebell está aberto e mostra “Abra o Tracebell para atualizar” depois de 30 minutos.
- Reinício: a Atividade ao Vivo de uma issue acompanhada pode recomeçar quando a issue regride ou um alerta dispara.
- Depois de forçar o encerramento: se você deslizar o Tracebell para fora no Seletor de Apps, ou se o Modo Pouca Energia estiver ativado ou a Atualização em 2º Plano estiver desativada para o Tracebell, o iOS pode não deixar o app iniciar Atividades ao Vivo nem enviar o token de atualização delas ao relay em segundo plano. Uma Atividade ao Vivo iniciada nessa situação mostra “Abra o Tracebell para atualizar” depois de 30 minutos, mesmo com as notificações configuradas. Abra o Tracebell e as atualizações são retomadas.
- Iniciar automaticamente (Perfil → Notificações, desativado por padrão): uma issue que regride nos projetos que você acompanha, no seu nível mínimo ou acima dele, pode iniciar uma Atividade ao Vivo sozinha, mas só enquanto nenhuma Atividade ao Vivo do Tracebell estiver em andamento.
- Limites: até 3 Atividades ao Vivo ficam ativas ao mesmo tempo; acompanhar uma quarta encerra a que foi atualizada há mais tempo. O iOS decide com que frequência um app pode iniciar Atividades ao Vivo em segundo plano, e o relay envia no máximo 4 inícios por hora, então um início pode ser pulado. O iOS encerra toda Atividade ao Vivo depois de 8 horas.
- Não aparece nada? Verifique se as Atividades ao Vivo estão ativadas para o Tracebell no app Ajustes do iOS, depois use Enviar Atividade ao Vivo de teste em Perfil → Notificações e bloqueie seu iPhone: uma Atividade ao Vivo de teste aparece em cerca de 10 segundos.
- No modo de demonstração, você pode acompanhar uma issue de exemplo; ela mostra atualizações de exemplo enquanto o app está aberto.
Ícones do app (Advanced)
Abra Perfil → Aparência → Ícone do app e escolha Papel, Mono, Sinal, Âmbar ou Menta; Clássico está sempre disponível. O iOS confirma cada alteração com um breve alerta. Sem o Advanced, e no modo de demonstração, tocar em um ícone mostra uma pré-visualização, e o ícone da Tela de Início continua o mesmo. Se o Advanced terminar, o ícone que você escolheu continua até você voltar para Clássico.
Compras
- Planos: o Tracebell Advanced está disponível no plano Mensal (¥500 / $2.99), no plano Anual (¥4,000 / $24.99, 14 dias de teste grátis) ou como compra única vitalícia (¥9,700 / $99.99). As gorjetas no app apoiam o desenvolvimento e não desbloqueiam nada.
- Restaurar: Perfil → Plano → Restaurar compras (use a mesma Conta Apple).
- Cancelar: as assinaturas são gerenciadas nos ajustes da sua conta da App Store, não no app.
- Reembolsos são tratados pela Apple em reportaproblem.apple.com.
Pedidos de recursos e bugs
Escreva para [email protected] contando o que você esperava e o que aconteceu. Capturas de tela ajudam, mas, por favor, desfoque antes qualquer informação sensível.