> 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/user-manual/configure/notification-channels.md).

# Canais de notificação

Os **canais de notificação** enviam alertas por meio 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 de forma independente em dois tipos de notificações:

* **Risk Engine** — Alertas acionados pelas regras do Risk Engine que você mapeou.
* **Eventos de monitoramento** — Alterações de risco detectadas nos endereços que você monitora. Para ver os detalhes da configuração, consulte [Monitoramento](https://docs.compliance.phalcon.blocksec.com/pt-br/user-manual/monitoring/monitor.md#setting-up-notifications).

<figure><img src="https://506894602-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FBzD66AI0kygFWXLyKlwt%2Fuploads%2Fgit-blob-6d7fae62e4694ef5b599e4502323bdb275966102%2Fnotification-channel-monitor-events.png?alt=media" alt="Notification channel detail page with Monitor Events enabled"><figcaption></figcaption></figure>

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

O **canal de notificação do Telegram** oferece três modos de entrega de alertas: **chat individual**, **chat em grupo** e **canal**.

* **Modo de chat individual**: os alertas são enviados diretamente ao bot.
* **Modo de grupo/canal**: o bot envia mensagens de alerta para um grupo ou canal do Telegram pré-configurado.

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

### **Modo de chat individual do Telegram**

* **Etapa 1**: Pesquise **@PhalconComplianceBot** (<https://t.me/PhalconComplianceBot>) no Telegram e abra um chat com o bot.
* **Etapa 2**: Envie o comando `/getchatid` no chat com o bot para obter seu "ID de usuário".
* **Etapa 3**: Crie um canal de notificação do Telegram no Phalcon e selecione o tipo de chat "Usuário".
* **Etapa 4**: Cole seu "ID de usuário" no campo indicado para concluir a criação do canal.

Quando um Risk Engine associado a este canal é acionado, o bot envia automaticamente uma mensagem de alerta estruturada para este chat, conforme mostrado no exemplo abaixo.

### **Modo de chat em grupo do Telegram**

* **Etapa 1**: Adicione @PhalconComplianceBot ao grupo do Telegram em que deseja receber alertas.
* **Etapa 2**: Envie o comando `/getchatid` no chat em grupo para obter o "ID do chat em grupo".
* **Etapa 3**: Crie um canal de notificação do Telegram no Phalcon e selecione o tipo de chat "Grupo".
* **Etapa 4**: Cole o "ID do grupo" no campo indicado para concluir a criação do canal.

### **Modo de canal do Telegram**

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

## E-mail

* **Etapa 1**: Crie um canal de notificação por e-mail e informe o endereço de e-mail em que deseja receber alertas.
* **Etapa 2**: Insira o código de verificação para concluir a criação.

Quando um Risk Engine associado a este canal de notificação por e-mail é acionado, o endereço de e-mail pré-configurado recebe uma mensagem de alerta estruturada, conforme mostrado no exemplo abaixo.

<br>

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

* **Etapa 1**: Adicione o bot ao seu grupo do Lark.
* **Etapa 2**: Selecione "Bot personalizado" como tipo e configure o bot.
* **Etapa 3**: Crie uma notificação do Lark no Phalcon.
* **Etapa 4**: Informe a URL do Webhook e a chave de assinatura.

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

Quando um Risk Engine associado a este canal de notificação do Lark é acionado, uma mensagem de alerta aparece no seu grupo do Lark, conforme mostrado no exemplo abaixo.

<br>

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

O **canal de Webhook** permite receber mensagens de alerta do Phalcon diretamente no seu próprio servidor ou aplicativo. Pense nele como a criação de um bridge cross-chain seguro entre o Phalcon e o seu sistema — sempre que o seu monitoramento é acionado, o Phalcon envia automaticamente esses alertas para o seu servidor por meio desse bridge cross-chain.

* **Etapa 1**: Crie um canal de Webhook no Phalcon.
* **Etapa 2**: Informe a URL do seu servidor Webhook.

> Se o seu servidor usa autenticação básica, forneça as credenciais necessárias.

Para ver os formatos detalhados das mensagens do Webhook e as especificações técnicas, consulte o documento a seguir:

[Formato do Webhook](https://docs.compliance.phalcon.blocksec.com/pt-br/user-manual/configure/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 do Slack no Phalcon.
* **Etapa 2**: Clique no botão `Connect Slack` para acessar a página de autenticação.
* **Etapa 3**: Configure o canal em que deseja receber alertas e conceda autorização.

Quando um Risk Engine associado a este canal do Slack é acionado, você recebe uma mensagem de alerta no Slack, conforme mostrado no exemplo abaixo.

## Discord

* **Etapa 1**: No canal do Discord em que deseja receber alertas, clique em `Editar canal`.
* **Etapa 2**: Crie um Webhook na página `Integrações`.
* **Etapa 3**: Crie um canal do Discord no Phalcon.
* **Etapa 4**: Cole a URL do seu Webhook e conclua a criação do canal.

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

Quando um Risk Engine associado a este canal do Discord é acionado, o canal recebe uma mensagem de alerta, conforme mostrado no exemplo abaixo.

## PagerDuty

Há duas formas de configurar um canal de notificação do PagerDuty: **Token** ou **autenticação por e-mail**.

**Autenticação por Token**

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

<br>

**Autenticação por e-mail**

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