Faça um alerta do Sentry chegar à pessoa certa.

Prepare um canal para sinais que pedem ação

Antes de conectar, escolha um canal interno acompanhado por quem pode investigar o erro ou a métrica. Defina quando alguém deve reagir e qual link leva ao detalhe no Sentry. Alertas sem filtro e sem responsável podem apenas aumentar o ruído. A conexão atual não publica em mensagens diretas nem em canais compartilhados entre organizações.

A pessoa que cria a conexão precisa poder gerenciar integrações no Joii e publicar no canal selecionado. Uma conexão tem um destino fixo. Se equipes diferentes precisam receber sinais distintos, configure regras e conexões separadas em vez de copiar tudo para todos os canais.

Configure Sentry e Joii em sequência

1. No Sentry, abra Settings → Developer Settings ou a área atual de integrações personalizadas e crie uma Internal Integration. Os nomes de menu podem variar com a versão.
2. Copie o Client Secret dessa integração. Ele autentica os webhooks. Não use o Auth Token da API; esse token serve a outra finalidade.
3. No Joii, abra Configurações → Integrações → Aplicativos e alertas, escolha Sentry, dê um nome à conexão, escolha o canal e informe o Client Secret.
4. Depois de salvar, copie a URL secreta mostrada pelo Joii. Ela aparece nesse momento ou após uma rotação; trate-a como credencial.
5. Volte à integração no Sentry, preencha Webhook URL com a URL copiada e habilite Alert Rule Action.
6. Numa regra de alerta de issue ou métrica, selecione a ação da integração interna e dispare um teste, se disponível na sua versão.

Se o Sentry pedir a URL antes de liberar o Client Secret, salve a integração inicialmente sem a ação de alertas, obtenha o segredo e volte para completar a configuração. A referência oficial da integração personalizada identifica os campos de URL e a opção de uso em regras de alerta.

Confira o teste dos dois lados

Um teste iniciado na tela do Joii verifica seu próprio fluxo de fila e publicação. Ele não prova que o Sentry tem a URL correta ou que está assinando os envios com o segredo esperado. Para validar de ponta a ponta, envie o teste ou um alerta real pela regra no Sentry; confira a resposta no provedor, a mensagem Sentry · App no canal e o histórico da conexão no Joii.

Uma resposta HTTP 202 indica que o evento foi aceito para processamento, não que a publicação já terminou. O histórico mostra entregas aceitas na fila, concluídas, falhas ou descartadas. Requisições recusadas antes da admissão, como assinatura inválida, não aparecem como mensagens entregues.

A mensagem contém um resumo legível, com a informação útil do alerta e um link para o Sentry; o Joii não armazena o payload bruto como mensagem nem copia o stack trace inteiro para o canal.

Se o alerta não aparecer

Para outros códigos e limites, consulte o guia da API de entrada. Ele explica o fluxo de entrega, mas usa o provedor genérico; não envie o JSON do exemplo diretamente à conexão Sentry.

Mantenha a conexão sob controle

O Sentry assina o corpo do webhook com o Client Secret, e o Joii confere a assinatura antes de aceitar o evento. Não coloque o segredo nem a URL em documentação pública. Para trocar o Client Secret, crie uma nova conexão e revogue a anterior; para trocar apenas a URL no Joii, gere uma nova e atualize o Sentry imediatamente.

Pausar bloqueia novos eventos e invalida entregas pendentes dessa geração; reativar não despeja um acúmulo antigo. Revogar encerra a conexão. A integração recebe alertas e publica resumos: ela não abre issues, altera estados nem executa ações bidirecionais no Sentry. A visão geral de integrações descreve os demais destinos e provedores.

Perguntas frequentes