# Notificações

> Receba alertas e relatórios por e-mail, webhook, Slack ou Microsoft Teams, teste cada canal e acompanhe as entregas.

URL: https://docs.proteside.com/pt-BR/docs/guide/settings/notifications

Em **Configurações → Notificações** você cadastra **canais**: os destinos para onde o Proteside avisa quando algo
acontece no checkout. Cada canal tem um tipo, um escopo, uma severidade mínima e uma lista de eventos.

Toda loja já nasce com o canal **E-mail (padrão)**, que envia para o e-mail de quem criou a loja, com severidade
mínima **Alto ou superior**.

*Imagem: Canais cadastrados e o histórico das últimas entregas.*

## Quem pode alterar
Todos os papéis veem os canais e o histórico. Só **proprietários** e **administradores** criam, editam, ativam,
desativam, testam e excluem canais. Os demais papéis veem o aviso "Somente proprietários e administradores podem
alterar canais."

## Tipos de canal
| Tipo        | Para quê                                                    | O que recebe                                 |
| ----------- | ----------------------------------------------------------- | -------------------------------------------- |
| **E-mail**  | Avisar pessoas. Até 5 destinatários.                        | Novos alertas, relatórios prontos e testes.  |
| **Webhook** | Integrar com o seu sistema (SIEM, chamados, automações).    | Todos os eventos marcados, em JSON assinado. |
| **Slack**   | Postar em um canal do Slack via Incoming Webhook.           | Todos os eventos marcados.                   |
| **Teams**   | Postar em um canal do Microsoft Teams via Incoming Webhook. | Todos os eventos marcados.                   |

> **Combine e-mail com Slack, Teams ou webhook**
>
> Canais de e-mail recebem **Novo alerta**, **Relatório pronto** e testes. Para receber também os avisos de
> **Integridade de script alterada**, **Header de segurança alterado** e **SDK silencioso**, crie um canal de Slack,
> Teams ou webhook.

As mensagens de Slack e Teams têm textos fixos em inglês. Os e-mails de canais criados nesta tela saem em português.

## Adicionar um canal
### Abra o formulário
Clique em **Adicionar canal** (1).

### Escolha tipo e escopo
*Imagem: Janela Adicionar canal, tipo Webhook.*

Escolha o tipo (1): **E-mail**, **Webhook**, **Slack** ou **Teams**. Depois, o **Escopo** (2):

* **Esta loja:** recebe só os eventos da loja selecionada.
* **Organização:** recebe os eventos de **todas** as lojas da organização.

Tipo e escopo não podem ser alterados depois. Para mudar, crie outro canal.

### Informe o destino
Dê um **Nome** ao canal (até 80 caracteres) e:

* **E-mail:** adicione até 5 destinatários, um de cada vez, com **Adicionar** ou Enter.
* **Webhook, Slack, Teams:** cole a **URL** (3). Ela precisa começar com `https://`. Para Slack e Teams, use a URL do
  Incoming Webhook criada no próprio Slack ou Teams.

### Configure o webhook
Só para o tipo **Webhook** (4):

* **Formato:** **JSON (assinado)** para o seu sistema, ou **Slack (blocks)** e **Teams (Adaptive Card)**.
* **Segredo de assinatura:** um valor aleatório de 16 a 128 caracteres. Com ele, cada entrega traz o header
  `X-Proteside-Signature`, e o seu sistema consegue confirmar que a mensagem veio do Proteside. Guarde o segredo: ele
  não é exibido de novo.

### Escolha severidade e eventos
Escolha a **Severidade mínima** (5) e os **Eventos** (6). Veja as seções abaixo.

### Salve
Mantenha **Canal ativo** ligado e clique em **Salvar alterações**. Em seguida, use **Testar conexão** no card do canal.

> **Sem segredo, o webhook não é assinado**
>
> O segredo é opcional no painel. Se o campo ficar vazio, as entregas saem sem assinatura e o card mostra
> "sem assinatura". Qualquer pessoa que descubra a URL poderia enviar mensagens falsas ao seu sistema. Sempre preencha o
> segredo em webhooks JSON e verifique a assinatura no recebimento, como mostra
> [Verificar a assinatura](https://docs.proteside.com/pt-BR/docs/api/webhooks#verificar-a-assinatura).

Canais de **Organização** valem para todas as lojas e devem ser geridos por administradores da organização.

## Severidade mínima
A **Severidade mínima** filtra os eventos de alerta pela gravidade: **Apenas crítico**, **Alto ou superior**,
**Médio ou superior**, **Baixo ou superior** ou **Todos**. Canais novos começam em **Alto ou superior**.

> **Use Médio ou superior em pelo menos um canal**
>
> A severidade considera o tipo de dado e o destino; o motivo aparece no alerta. Avisos como **SDK silencioso** (o SDK
> parou de enviar dados da loja), **Header de segurança alterado** e violações de CSP têm severidade média ou baixa.
> Para saber quando a proteção parou de rodar, configure pelo menos um canal de Slack, Teams ou webhook com
> **Médio ou superior**.

**Script detectado**, **Política aplicada** e **Relatório pronto** não têm severidade e passam por qualquer filtro.

## Eventos
Com **Todos os eventos** marcado, o canal recebe tudo. Desmarque para escolher:

| Evento                                                   | Quando chega                                                                                                                                      |
| -------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Novo alerta** (`alert.created`)                        | Um alerta é aberto.                                                                                                                               |
| **Alerta resolvido** (`alert.resolved`)                  | Só quando um alerta de SDK silencioso se resolve sozinho porque o SDK voltou a enviar dados. Resolver um alerta manualmente não gera notificação. |
| **Script detectado** (`script.detected`)                 | Um script novo apareceu no checkout e aguarda revisão em [Scripts](https://docs.proteside.com/pt-BR/docs/guide/scripts).                                                               |
| **Integridade de script alterada** (`integrity.changed`) | O conteúdo de um script autorizado mudou.                                                                                                         |
| **Header de segurança alterado** (`header.changed`)      | Um header de segurança da página de pagamento mudou.                                                                                              |
| **SDK silencioso** (`sdk.silent`)                        | Uma loja com tráfego parou de enviar dados do SDK.                                                                                                |
| **Política aplicada** (`policy.applied`)                 | Uma política de aprovação decidiu um script.                                                                                                      |
| **Relatório pronto** (`report.ready`)                    | O relatório PCI DSS semanal ficou pronto.                                                                                                         |

> **Nota**
>
> Para acompanhar autorizações e bloqueios de scripts, use a [Auditoria](https://docs.proteside.com/pt-BR/docs/guide/settings/audit-log).

## Ativar, editar e excluir
* A chave no canto do card (2) ativa ou desativa o canal sem apagá-lo. Canais desativados não recebem nada.
* O resumo do card mostra a severidade mínima e os eventos escolhidos (3), além do formato e se há assinatura.
* **Editar** abre o formulário. Para manter o segredo de assinatura atual, deixe o campo em branco.
* O ícone de lixeira exclui o canal depois de uma confirmação.

## Testar um canal
Clique em **Testar conexão** (4) no card do canal. O Proteside envia na hora um evento de teste, que aparece no
histórico de entregas. Se falhar, a mensagem de erro mostra o código HTTP da resposta, por exemplo `http_404` (a URL não
existe).

O teste é enviado mesmo com o canal desativado e ignora os filtros de severidade e de eventos. Ele tem uma única
tentativa, sem repetição.

## Histórico de entregas
O card **Histórico de entregas** (5) lista as últimas 50 entregas da loja e dos canais da organização: quando, canal,
evento, status (**Enviado**, **Falhou** ou **Pendente**), tentativas com o código HTTP e o erro, quando houver. As
entregas ficam guardadas por 90 dias.

Quando uma entrega para webhook, Slack ou Teams falha, o Proteside tenta de novo algumas vezes, com intervalos
crescentes. Depois da última falha, a entrega fica como **Falhou** e não é reenviada; o canal continua ativo.

Detalhes do formato das mensagens, da assinatura e das retentativas estão em [Webhooks](https://docs.proteside.com/pt-BR/docs/api/webhooks).

## Próximos passos
- [Webhooks](https://docs.proteside.com/pt-BR/docs/api/webhooks): Formato do payload, verificação da assinatura e retentativas.
- [Alertas](https://docs.proteside.com/pt-BR/docs/guide/alerts): O que cada alerta significa e como tratá-lo.
