Notificações

Leva os alertas do BeryX para onde a equipa já trabalha: Slack, Microsoft Teams, email, um webhook ou, para os incidentes críticos, SMS e WhatsApp. Aqui também configuras as escalas de piquete, os tickets na ferramenta da equipa e o repositório git para as correções aprovadas.

O que podes fazer

Criar um canal com «Novo canal»: tipo (Slack, Microsoft Teams, Email, Webhook genérico ou SMS/WhatsApp), destino, severidade mínima e digest semanal. O canal SMS/WhatsApp usa a conta Twilio da tua empresa e só recebe incidentes críticos e violações de SLA, nunca o digest: cada número tem o seu horário silencioso e um teto de mensagens por hora. Com domínios de acesso restrito no workspace, só os admins criam ou alteram um canal sem equipa, que recebe os alertas de todos os datasets. Se não fores admin, escolhe para o canal uma equipa que não leia nada que tu não leias, como uma equipa tua.
Escolher o que chega a cada canal com «Âmbito»: domínios, conexões, tipos de problema e monitores automáticos. Sem nada escolhido, o canal recebe todos os alertas; a pré-visualização mostra quantos dos últimos 30 dias lá teriam chegado.
Escolher que eventos um canal recebe com «Eventos»: os alertas de qualidade e, se quiseres, as mudanças de veredito de um dataset ou de um domínio e as violações de política abertas ou resolvidas. Estas saem no fim de cada scan, só quando o estado muda, e aparecem também no sino.
Um domínio que está no âmbito de um canal só se apaga depois de o retirares de lá. Se apagares uma conexão, o «Âmbito» mostra-a como apagada: não corresponde a nada até a retirares.
Testar, desativar ou apagar cada canal a partir do seu cartão. O cartão mostra a «Última entrega» (entregue ou falhou, com o motivo) e, no webhook genérico, o «Testar» diz se o recetor aceitou a entrega assinada. Com domínios de acesso restrito, só os admins testam, desativam ou apagam um canal sem equipa, ou o de uma equipa que lê o que tu não lês.
No «Webhook genérico», guardar o secret de assinatura que aparece uma vez ao criar o canal e, se for preciso, «Rodar secret» (só admins). Contrato, assinatura e retry: Webhooks.
Definir as «Rotas por severidade» (só admins) e as «Escalas semanais por domínio»: um problema sem reconhecimento sobe à pessoa seguinte da escala, pelos canais e por email.
Marcar «O meu horário silencioso» para não receberes páginas nesse período; os canais da equipa continuam a receber tudo.
Ligar em «Tickets» o Jira, o Linear, o ServiceNow, o Azure DevOps, os GitHub Issues ou os GitLab Issues para criar tickets a partir de um issue com «Criar ticket». «Testar ligação» confirma as credenciais e mostra os destinos; o GitHub e o GitLab podem usar o token de uma integração git.
Deixar o estado dos tickets andar sozinho: o BeryX lê o estado de cada ticket (de 15 em 15 minutos, por omissão) e, quando o ticket fecha, dá o issue por resolvido; num issue de regra, o scan seguinte confirma-o ou reabre-o. No Jira, no Linear e no ServiceNow, o BeryX comenta no ticket quando o issue é resolvido, verificado, reaberto ou ignorado e, com a opção ligada pela API, fecha-o ou reabre-o. Nunca muda o título nem a descrição do ticket.
Ligar um repositório GitHub ou GitLab para as correções aprovadas seguirem como Pull Request, com revisão humana antes do merge; o BeryX nunca escreve nas fontes de dados.

Ver também

Problemas — os issues que geram alertas e tickets.
Sugestões — as correções que, aprovadas, seguem como Pull Request.

English

Notifications

Send BeryX alerts to where the team already works: Slack, Microsoft Teams, email, a webhook or, for critical incidents, SMS and WhatsApp. This is also where you set up on-call rotations, tickets in the team's tool and the git repository for approved fixes.

What you can do

Create a channel with “New channel”: type (Slack, Microsoft Teams, Email, Generic webhook or SMS/WhatsApp), destination, minimum severity and weekly digest. The SMS/WhatsApp channel uses your company’s Twilio account and only receives critical incidents and SLA breaches, never the digest: each number has its own quiet hours and a cap of messages per hour. With restricted-access domains in the workspace, only admins create or change a channel without a team, which receives the alerts of every dataset. If you are not an admin, pick a team for the channel that reads nothing you cannot read, such as one of your teams.
Choose what reaches each channel with “Scope”: domains, connections, issue types and automatic monitors. With nothing selected the channel receives every alert; the preview shows how many from the last 30 days would have reached it.
A domain in a channel's scope can only be deleted after you remove it from there. If you delete a connection, “Scope” shows it as deleted: it matches nothing until you remove it.
Test, disable or delete each channel from its card. The card shows the “Last delivery” (delivered or failed, with the reason) and, for the generic webhook, “Test” tells you whether the receiver accepted the signed delivery. With restricted-access domains, only admins test, disable or delete a channel without a team, or the channel of a team that reads what you cannot read.
For the “Generic webhook”, store the signing secret shown once when the channel is created and, if needed, “Rotate secret” (admins only). Contract, signature and retries: Webhooks.
Set the “Routes by severity” (admins only) and the “Weekly rotations by domain”: an unacknowledged issue escalates to the next person in the rotation, through the channels and by email.
Set “My quiet hours” so you are not paged during that time; the team channels still receive everything.
Connect Jira, Linear, ServiceNow, Azure DevOps, GitHub Issues or GitLab Issues under “Tickets” to create tickets from an issue with “Create ticket”. “Test connection” checks the credentials and lists the destinations; GitHub and GitLab can use the token of a git integration.
Let ticket status follow on its own: BeryX reads the status of each ticket (every 15 minutes by default) and, when the ticket is closed, marks the issue as resolved; for a rule issue, the next scan confirms it or reopens it. In Jira, Linear and ServiceNow, BeryX comments on the ticket when the issue is resolved, verified, reopened or ignored and, with the option turned on through the API, closes or reopens it. It never changes the ticket's title or description.
Connect a GitHub or GitLab repository so approved fixes go out as a Pull Request, with human review before the merge; BeryX never writes to data sources.