Criar uma fonte de dados
Uma Fonte de Dados é um endereço de webhook com token próprio para qualquer sistema que consiga fazer um POST HTTP: CloudWatch, Grafana, um script de backup, um n8n ou até outro Zabbix por media type. Esta página mostra como criar a fonte, onde ficam a URL e o token e o que muda ao removê-la.
O que é uma fonte
O Sentrya coleta incidentes do Zabbix sozinho, pelo poller. Para tudo o que não é Zabbix existe o caminho inverso: o seu sistema envia o alerta para o Sentrya. Cada sistema que envia recebe uma fonte, e cada fonte tem um Token de autenticação exclusivo no formato whk_….
O token é a identidade da fonte. O payload que o seu sistema envia não carrega empresa nem nome da fonte: o servidor descobre os dois pelo token. É por isso que dois sistemas diferentes devem ter fontes diferentes: os incidentes chegam separados na aba Incidentes (filtro Fonte) e cada fonte pode ter seus próprios ouvintes.
Criar uma fonte
- Abra Ajustes → Fontes de Dados Na aba Perfil, entre em Ajustes e toque em Fontes de Dados. A lista mostra as fontes existentes, cada uma com a etiqueta Ativa.
- Toque em Nova Fonte No iOS, o botão é o + no canto do cabeçalho; no Android, o botão Nova Fonte aparece abaixo da lista.
- Dê um nome O único campo é Nome da fonte (até 255 caracteres). Use o nome do sistema que vai enviar, por exemplo CloudWatch Produção. Toque em Salvar.
- Copie a URL e o token Você volta para a lista e a fonte nova aparece com dois campos: URL do Webhook e Token de autenticação. Cada um tem um botão Copiar. No iOS, segurar o card abre um menu com Copiar URL, Copiar token e Remover.
- Configure o seu sistema Cole a URL como destino do POST e o token no cabeçalho
Authorization: Bearer whk_…. O corpo é o JSON descrito no bloco Contrato JSON, logo abaixo da lista.
O card da fonte
Cada fonte mostra os mesmos dados:
| Campo | Valor | Para que serve |
|---|---|---|
| URL do Webhook | https://app.flowbix.com/api/v1/alerts | Destino do POST. É a mesma URL para todas as fontes; o que muda é o token. |
| Token de autenticação | whk_ seguido de 48 caracteres hexadecimais | Vai no cabeçalho Authorization. Identifica a empresa e a fonte. |
| Contrato JSON | Dois exemplos: Abrir problema e Fechar problema | Modelo do corpo que o seu sistema deve enviar. A referência completa está em Referência do payload. |
Em resumo, toda fonte publica alertas no mesmo endpoint, autenticado pelo token dela:
Quem pode fazer o quê
| Ação | Admin | Operador | Visualizador |
|---|---|---|---|
| Ver fontes, copiar URL e token | Sim | Sim | Sim |
| Criar fonte (Nova Fonte) | Sim | Sim | Não |
| Remover fonte | Sim | Sim | Não |
Para o Visualizador, o botão Nova Fonte e o ícone de lixeira não aparecem; o servidor também recusa a mutação. Veja Papéis e permissões.
Limite por plano
O número de fontes é limitado pelo plano da empresa. Ao tentar criar além do limite, o app mostra a mensagem do servidor, limite do seu plano atingido, e a fonte não é criada. As fontes existentes continuam funcionando. Os limites de cada plano estão em Planos e limites.
Remover uma fonte
Toque no ícone de lixeira no card (ou em Remover no menu de contexto) e confirme. O efeito é imediato e não pode ser desfeito:
- O token para de funcionar. Qualquer POST com ele passa a receber
401 token inválido. Se o seu sistema ainda estiver enviando, ele vai registrar erro. - Os incidentes já recebidos permanecem no feed e no histórico. Eles não são apagados. Como a fonte não existe mais, o campo Origem deles passa a mostrar apenas o tipo genérico Webhook, sem o nome que você deu.
- Incidentes ativos dessa fonte não se resolvem mais sozinhos, porque o sistema de origem já não consegue enviar a resolução. Feche-os manualmente com Resolver ou Descartar alerta (veja Descartar alertas de webhook).
- Ouvintes que apontavam para a fonte deixam de casar com alertas novos, já que nenhum alerta novo chega por ela.
