Geral

As notificações são muito úteis para se manter atualizado em relação a determinados eventos. Por exemplo, pode configurar uma notificação por e-mail ou Slack para ser enviada sempre que um segredo for visualizado. A notificação inclui a ID e a descrição do segredo e também alguns detalhes do visualizador, como o endereço IP.

Tipos de notificações

Pode configurar as notificações para serem entregues através de:

Email
Slack
Webhook (HTTP POST)

Tipos de eventos

Pode configurar notificações para os seguintes eventos:

Segredo criado
Segredo visualizado
Segredo expirado

Notificações por correio eletrónico

As notificações por correio eletrónico podem ser configuradas em Notificações > Correio eletrónico. De momento, não é possível ter vários destinatários para as mensagens de correio eletrónico.

A secção Estado da página mostra quando foi enviado o último e-mail de notificação.

Notificações do Slack

As notificações do Slack podem ser configuradas em Notificações > Slack.

As notificações do Slack usam os webhooks de entrada do Slack. Você pode ler mais sobre o recurso na documentação do Slack.

A secção Estado da página mostra quando a última notificação foi enviada e se foi bem-sucedida.

Notificações Webhook

As notificações Webhook podem ser configuradas em Notificações > Webhook.

As notificações de webhook podem ser utilizadas para enviar notificações a qualquer aplicação com API HTTP de entrada.

O seguinte payload JSON será enviado como um pedido POST quando o webhook for executado. O Content-Type do pedido é definido como application/json.

{
  event_type:"um de secret_created, secret_viewed, secret_expired",
  secret_id:"o ID do segredo",
  created_at:"carimbo de data/hora em que o segredo foi criado",
  description (descrição):"descrição do segredo, se definido",
  viewed_at:"data e hora em que o segredo foi visualizado, se visualizado",
  viewed_by_ip:"Endereço IP do visualizado, se visualizado",
  viewed_by_user_agent:"Agente de utilizador HTTP do visualizador, se visualizado",
  expires_at:"data e hora em que o segredo expira, se definido",
  expired:"um booleano que indica se o segredo expirou"
}

A secção Estado da página mostra quando a última notificação foi enviada e se foi bem sucedida.