> For the complete documentation index, see [llms.txt](https://docs.compliance.phalcon.blocksec.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.compliance.phalcon.blocksec.com/pt-br/manual/notification-channels.md).

# Canais de Notificação

**Notification Channels** entregam alertas através de **7 canais integrados** — [Telegram](#telegram), [E-mail](#e-mail), [Lark](#lark), [Webhook](#webhook), [Slack](#slack), [Discord](#discord), e [PagerDuty](#pagerduty).

Cada canal pode se inscrever independentemente em dois tipos de notificações:

* **Risk Engines** — Alertas acionados pelos seus Risk Engines mapeados.
* **Monitor Events** — Mudanças de risco detectadas nos seus endereços monitorados. Consulte [Monitor](/pt-br/manual/monitor.md#setting-up-notifications) para detalhes de configuração.

<figure><img src="/files/CPBVRqJ8ytBAtE9l1sKD" alt="Notification channel detail page with Monitor Events enabled"><figcaption></figcaption></figure>

## Telegram <a href="#telegram" id="telegram"></a>

O **Telegram Notification Channel** oferece três modos de entrega de alertas: **User Chat**, **Group Chat**, e **Channel**.

* **User Chat Mode**: Alertas serão enviados diretamente para o bot.
* **Group/Channel Mode**: O bot envia mensagens de alerta para um grupo ou canal Telegram pré-configurado.

As etapas de configuração para cada modo estão detalhadas abaixo.

### **Telegram User Chat Mode**

* **Etapa 1**: Procure por **@BlockSecPhalcon\_bot** (<https://t.me/BlockSecPhalcon_bot>) no Telegram e abra um chat com este bot.
* **Etapa 2**: Envie o comando `/getchatid` no chat com o bot para receber seu "User ID".
* **Etapa 3**: Crie um canal de notificação Telegram no Phalcon e selecione o tipo de chat "User".
* **Etapa 4**: Cole seu "User ID" no campo especificado para concluir a criação do canal.

Quando um risk engine associado a este canal é acionado, o bot automaticamente enviará uma mensagem de alerta estruturada para este chat (como mostrado no exemplo abaixo).

### **Telegram Group Chat Mode**

* **Etapa 1**: Adicione @BlockSecPhalcon\_bot ao grupo Telegram onde deseja receber alertas.
* **Etapa 2**: Envie o comando `/getchatid` no chat do grupo para obter o "Group Chat ID".
* **Etapa 3**: Crie um canal de notificação Telegram no Phalcon e selecione o tipo de chat "Group".
* **Etapa 4**: Cole o "Group ID" no campo especificado para concluir a criação do canal.

### **Telegram Channel Mode**

* **Etapa 1**: Adicione @BlockSecPhalcon\_bot como administrador do seu canal Telegram.
* **Etapa 2**: Envie o comando `/getchannelid` no chat do canal para obter o "Channel ID".
* **Etapa 3**: Crie um canal de notificação Telegram no Phalcon e selecione o tipo de chat "Channel".
* **Etapa 4**: Cole o "Channel ID" no campo especificado para concluir a criação do canal.

## E-mail

* **Etapa 1**: Crie um canal de notificação do tipo e-mail e insira o endereço de email onde deseja receber alertas.
* **Etapa 2**: Preencha o código de verificação para concluir a criação.

Quando um risk engine associado a este canal de notificação de e-mail é acionado, o endereço de email pré-configurado receberá uma mensagem de alerta estruturada (como mostrado no exemplo abaixo).

<br>

## Lark <a href="#lark" id="lark"></a>

* **Etapa 1**: Adicione o bot ao seu grupo Lark.
* **Etapa 2**: Selecione "Custom Bot" como o tipo e configure o bot.
* **Etapa 3**: Crie uma notificação Lark no Phalcon.
* **Etapa 4**: Insira a Webhook URL e a Secret Signature.

> Para mais informações sobre como criar um bot Lark, consulte: <https://open.larksuite.com/document/client-docs/bot-v3/bot-overview>

Quando um risk engine associado a este canal de notificação Lark é acionado, uma mensagem de alerta aparecerá no seu grupo Lark (como mostrado no exemplo abaixo).

<br>

## Webhook <a href="#webhook" id="webhook"></a>

O **Webhook channel** permite que você receba as mensagens de alerta do Phalcon diretamente nos seus próprios servidores ou aplicações. Pode ser pensado como criar um bridge seguro entre o Phalcon e seu sistema—sempre que seus monitores são acionados, o Phalcon automaticamente envia esses alertas para seu servidor através deste bridge.

* **Etapa 1**: Crie um canal Webhook no Phalcon.
* **Etapa 2**: Insira sua Webhook Server URL.

> Se seu servidor usa Basic Authentication, forneça as credenciais necessárias.

Para formatos de mensagem Webhook detalhados e especificações técnicas, consulte o seguinte documento:

[Formato Webhook](/pt-br/manual/notification-channels/webhook-format.md)[<br>](https://docs.google.com/document/d/1vewc32T-jTVEaqz-W4fHtZFAf88uF4vzdJM8pWkYTVA/edit?tab=t.0#heading=h.ntu9zql97jl5)

## Slack

* **Etapa 1**: Crie um canal de notificação Slack no Phalcon.
* **Etapa 2**: Clique no botão `Connect Slack` para ir para a página de autenticação.
* **Etapa 3**: Configure o canal onde deseja receber alertas e autorize.

Quando um risk engine associado a este canal Slack é acionado, você receberá uma mensagem de alerta no seu Slack conforme mostrado no exemplo abaixo.

## Discord

* **Etapa 1**: No canal Discord onde deseja receber alertas, clique em `Edit Channel`.
* **Etapa 2**: Crie um Webhook na página `Integrations`.
* **Etapa 3**: Crie um canal Discord no Phalcon.
* **Etapa 4**: Cole sua Webhook URL e conclua a criação do canal.

> Para mais informações sobre como criar um Discord Webhook, consulte: <https://support.discord.com/hc/en-us/articles/228383668-Intro-to-Webhooks>

Quando um risk engine associado a este canal Discord é acionado, o canal receberá uma mensagem de alerta conforme mostrado no exemplo abaixo.

## PagerDuty

Existem duas maneiras de configurar o canal de notificação para PagerDuty: **Token** ou **E-mail Authentication**.

**Token Authentication**

* **Etapa 1**: Adicione uma integração `Events API V2` na sua conta PagerDuty.
* **Etapa 2**: Crie um canal PagerDuty no Phalcon e selecione o modo "Token".
* **Etapa 3**: Cole sua `Integration Key` para concluir a configuração.

<br>

**E-mail Authentication**

* **Etapa 1**: Adicione uma integração `Email` na sua conta PagerDuty.
* **Etapa 2**: Crie um canal PagerDuty no Phalcon e selecione o modo "Email".
* **Etapa 3**: Insira o endereço `Integration Email` e conclua o processo de verificação de e-mail.
