> ## Documentation Index
> Fetch the complete documentation index at: https://zeropath.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Integração com Slack

> Receba notificações de scan em tempo real e alertas de vulnerabilidades nos canais do seu Slack

<h2 id="overview">
  Visão Geral
</h2>

O ZeroPath se integra ao Slack para enviar notificações de conclusão de scan e alertas de vulnerabilidades aos canais da sua equipe. Configure quais eventos disparam notificações e defina limites de pontuação para controlar o ruído.

<h2 id="setup">
  Configuração
</h2>

1. Navegue até **Settings → Integrations** no painel do ZeroPath.
2. Clique em **"Connect Slack"**.
3. Autorize o ZeroPath na tela de consentimento do Slack.
4. Selecione os canais nos quais deseja receber notificações.

O bot do ZeroPath entra automaticamente nos canais públicos que você selecionar. Para canais privados, você precisará convidar o bot do ZeroPath manualmente.

<h2 id="notification-types">
  Tipos de Notificação
</h2>

Cada grupo de notificações pode ser configurado com estes gatilhos de notificação:

| Notificação                              | Padrão | Descrição                                                   |
| ---------------------------------------- | ------ | ----------------------------------------------------------- |
| **Full scan complete**                   | On     | Notifica quando um scan completo ou agendado termina        |
| **PR scan complete**                     | Off    | Notifica quando um scan de pull request termina             |
| **Only new vulnerabilities (full scan)** | Off    | Notifica apenas se o scan encontrou novas descobertas       |
| **Only new vulnerabilities (PR scan)**   | Off    | Notifica apenas se o scan de PR encontrou novas descobertas |

<h3 id="score-threshold">
  Limite de Pontuação
</h3>

Defina um **limite de pontuação de vulnerabilidade** (0–100) para filtrar as notificações. Apenas descobertas com pontuação igual ou superior ao limite são incluídas na mensagem de notificação. Isso evita que ruído de baixa severidade inunde seus canais.

<h2 id="channel-configuration">
  Configuração de Canais
</h2>

Você pode criar **vários grupos de notificações**, cada um direcionado a canais diferentes do Slack com configurações diferentes. Por exemplo:

* **#security-critical** — Apenas scans completos, limite 80 (apenas descobertas Critical/High)
* **#dev-notifications** — Todos os scans, limite 0 (todas as descobertas)
* **#pr-reviews** — Apenas scans de PR, apenas novas vulnerabilidades

<h3 id="managing-notification-groups">
  Gerenciando Grupos de Notificações
</h3>

Selecione a integração **Slack** na barra lateral em **Settings → Integrations** para gerenciar os grupos de notificações diretamente no painel de detalhes:

* **Criar um grupo** — Clique em **"New Notification Group"**, configure os canais, os limites e os tipos de notificação e salve.
* **Editar um grupo** — Selecione um grupo existente para modificar suas configurações diretamente no painel.
* **Excluir um grupo** — Remova um grupo de notificações e todas as suas associações a canais.
* **Adicionar canais** — Selecione na lista de canais públicos e privados do seu workspace. Você pode pesquisar canais pelo nome para encontrar rapidamente o que precisa. Os canais são listados em ordem alfabética.
* **Remover canais** — O bot do ZeroPath sai automaticamente dos canais removidos.

Ao editar um grupo de notificações, o ZeroPath valida se os canais salvos anteriormente ainda existem. Se algum canal tiver sido arquivado, excluído ou o bot tiver sido removido dele, você verá um aviso e esses canais serão automaticamente removidos da seleção. Você pode então salvar o grupo para persistir a lista de canais atualizada.

<h2 id="troubleshooting">
  Solução de Problemas
</h2>

**Não recebo notificações**

* Verifique se o grupo de notificações está configurado para o tipo de scan correto.
* Verifique se o limite de pontuação não está filtrando todas as descobertas.
* Para canais privados, certifique-se de que o bot do ZeroPath foi convidado.

**"Slack integration not found"**

* Reconecte a integração em Settings → Integrations.