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

# Integração com o Slack

> Conecte a Living Security ao Slack para enviar notificações de treinamento, alertas de segurança e atualizações de Playbook ao seu workspace.

A integração com o Slack permite que a Living Security envie notificações diretamente ao seu workspace do Slack. Notifique os usuários sobre atribuições de treinamento, alerte as equipes de segurança sobre eventos de risco e mantenha os gestores informados sobre o progresso de suas equipes.

<Note>
  Para configurar o envio de Nudges e Playbooks, comece em **Configurações → Comunicações → Canais** e clique no card **Slack**. Esta página aborda a configuração do aplicativo do Slack em si.
</Note>

## Pré-requisitos

Antes de configurar a integração com o Slack, verifique se você possui:

* Permissões de administrador do workspace do Slack ou de instalação de aplicativos
* Acesso ao portal da API do Slack em [api.slack.com](https://api.slack.com)
* Privilégios de administrador na Living Security

## Criação de um aplicativo do Slack

<Steps>
  <Step title="Crie um novo aplicativo do Slack">
    1. Acesse [api.slack.com/apps](https://api.slack.com/apps)
    2. Clique em **Create New App**
    3. Selecione **From scratch**
    4. Insira um nome para o aplicativo (por exemplo, "Living Security")
    5. Selecione o seu workspace
    6. Clique em **Create App**

    <Check>
      O seu aplicativo aparece no painel da API do Slack.
    </Check>
  </Step>

  <Step title="Configure os escopos de OAuth">
    1. Na barra lateral esquerda, clique em **OAuth & Permissions**
    2. Role até **Bot Token Scopes**
    3. Adicione os seguintes escopos:

    | Escopo | Finalidade |
    | - | - |
    | `chat:write` | Enviar mensagens para canais |
    | `chat:write.public` | Enviar mensagens para canais sem ingressar neles |
    | `users:read` | Consultar informações de usuários |
    | `users:read.email` | Correlacionar usuários por endereço de e-mail |

    <Tip>
      Adicione apenas os escopos de que a sua organização precisa. Menos escopos significam mais segurança.
    </Tip>
  </Step>

  <Step title="Instale o aplicativo no seu workspace">
    1. Role até o topo de **OAuth & Permissions**
    2. Clique em **Install to Workspace**
    3. Revise as permissões e clique em **Allow**

    <Check>
      Um **Bot User OAuth Token** é exibido, começando com `xoxb-`.
    </Check>
  </Step>

  <Step title="Obtenha o signing secret">
    1. Na barra lateral esquerda, clique em **Basic Information**
    2. Role até **App Credentials**
    3. Copie o **Signing Secret**

    <Warning>
      Mantenha o seu signing secret em sigilo. Nunca o compartilhe em repositórios públicos nem em logs.
    </Warning>
  </Step>
</Steps>

## Adição de credenciais à Living Security

<Steps>
  <Step title="Acesse as Integrações de Saída">
    Acesse **Configurações → Integrações → Saída** e clique no card **Slack**.
  </Step>

  <Step title="Adicione as suas credenciais">
    Clique em **Add Credential** e insira:

    <ParamField body="botToken" type="string" required>
      O seu Bot User OAuth Token, que começa com `xoxb-`. Encontrado em **OAuth & Permissions**.
    </ParamField>

    <ParamField body="signingSecret" type="string" required>
      O Signing Secret do seu aplicativo. Encontrado em **Basic Information → App Credentials**.
    </ParamField>

    <ParamField body="appToken" type="string">
      Opcional. Necessário apenas para conexões em Socket Mode. Começa com `xapp-`.
    </ParamField>

    <ParamField body="label" type="string">
      Opcional. Um nome amigável para esta credencial (por exemplo, "Slack de produção").
    </ParamField>
  </Step>

  <Step title="Salve e verifique">
    Clique em **Salvar**. A credencial aparece na sua lista com o status **ativo**.

    <Check>
      A sua integração com o Slack está conectada e pronta para enviar notificações.
    </Check>
  </Step>
</Steps>

## Tipos de notificação

Depois de conectada, a Living Security pode enviar os seguintes tipos de notificação ao Slack:

| Notificação | Descrição |
| - | - |
| Atribuições de treinamento | Alertam os usuários quando um novo treinamento é atribuído |
| Lembretes de treinamento | Lembram os usuários de prazos próximos |
| Confirmações de conclusão | Confirmam quando um treinamento é concluído |
| Alertas de segurança | Notificam as equipes de segurança sobre eventos de risco |
| Resumos de Playbook | Enviam atualizações periódicas de desempenho do Playbook |

## Solução de problemas

<AccordionGroup>
  <Accordion title="As mensagens não aparecem nos canais">
    * Verifique se o bot foi convidado para o canal (`/invite @YourBotName`)
    * Verifique se o escopo `chat:write.public` foi adicionado para publicar em canais públicos sem ingressar neles
    * Confirme se o ID do canal está correto (use o ID do canal, não o nome)
  </Accordion>

  <Accordion title="Erro de token inválido">
    * Certifique-se de ter copiado o token completo, que começa com `xoxb-`
    * Verifique se o aplicativo ainda está instalado no seu workspace
    * Verifique se o token foi gerado novamente (é necessário atualizá-lo na Living Security)
  </Accordion>

  <Accordion title="Limitação de taxa">
    O Slack limita as solicitações de API. Se você encontrar erros de limitação de taxa:

    * Reduza a frequência das notificações
    * Consolide várias notificações em mensagens de resumo
    * Entre em contato com o suporte em casos de uso de alto volume
  </Accordion>
</AccordionGroup>

## Práticas recomendadas

<Tip>
  Crie um canal dedicado do Slack para as notificações da Living Security (por exemplo, `#security-training`) para manter os alertas organizados e reduzir o ruído nos canais gerais.
</Tip>

* Use rótulos de credencial significativos ao gerenciar vários workspaces
* Audite regularmente quais canais recebem notificações
* Configure resumos de notificações em vez de mensagens individuais para alertas de alto volume
* Revise trimestralmente as permissões do aplicativo do Slack e remova os escopos não utilizados

## Veja também

<CardGroup cols={2}>
  <Card title="Integração com e-mail" icon="envelope" href="/pt-BR/integrations/outbound/email">
    Configure o e-mail como canal de entrega.
  </Card>

  <Card title="Integração com o Teams" icon="microsoft" href="/pt-BR/integrations/outbound/teams">
    Configure o Microsoft Teams como canal de entrega.
  </Card>

  <Card title="Log de comunicações" icon="clock-rotate-left" href="/pt-BR/features/communications/log">
    Acompanhe o status e o histórico de entrega do Slack.
  </Card>

  <Card title="Como configurar uma nova integração" icon="plug" href="/pt-BR/integrations/managing/setup">
    Guia geral de configuração de integrações.
  </Card>
</CardGroup>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.