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

# Configurando a Integração com o Slack

> Configure a integração com o Slack para receber as conversas do AirysChat nos canais do Slack

Configurar a integração do AirysChat com o Slack envolve 5 etapas.

1. Crie um aplicativo Slack no portal do desenvolvedor.
2. Adicione as permissões necessárias para o aplicativo Slack.
3. Configure o AirysChat com o `Client ID` e o `Client Secret` obtidos do aplicativo Slack.
4. Abra a interface do AirysChat, vá para integrações, Slack e clique em conectar.
5. Voila! Você deve estar recebendo as novas conversas no canal #customer-conversations no Slack.

## Registrar um aplicativo Slack

Para usar a Integração com o Slack, você precisa criar um aplicativo Slack no portal do desenvolvedor. Você pode encontrar mais detalhes sobre a criação de aplicativos Slack no [Portal de desenvolvedores do Slack](https://api.slack.com/).

Depois de registrar seu aplicativo Slack, você terá que obter o `Client Id` e o `Client Secret`. Esses valores estarão disponíveis nas configurações do aplicativo e serão necessários ao configurar as variáveis de ambiente do AirysChat.

## Configurar o aplicativo Slack

1. Crie um aplicativo Slack e adicione-o ao seu espaço de trabalho de desenvolvimento.
2. Obtenha o `Client Id` e o `Client Secret` para o aplicativo e configure-o nas suas [variáveis de ambiente](/self-hosted/configuration/environment-variables) do AirysChat.
3. Vá para a seção `OAuth & permissions` na aba `features`.
4. Nas URLs de redirecionamento, adicione a URL base de instalação do AirysChat.
5. Na seção de escopos, configure os escopos fornecidos para escopos de token de bot:

* `channels:history`
* `channels:join`
* `channels:manage`
* `channels:read`
* `chat:write`
* `chat:write.customize`
* `commands`
* `files:read`
* `files:write`
* `groups:history`
* `groups:write`
* `im:history`
* `im:write`
* `links:read`
* `links:write`
* `mpim:history`
* `mpim:write`
* `users:read`
* `users:read.email`

7. Na seção de token de acesso do usuário, assine: `files:read`, `files:write`, `remote_files:share`
8. Vá para a seção `Events Subscriptions` na aba `Features`.
9. Habilite os eventos e configure a url de solicitação fornecida `{AirysChat installation url}/api/v1/integrations/webhooks`
10. Inscreva-se nos seguintes eventos de bot: `link_shared`, `message.channels`, `message.groups`, `message.im`, `message.mpim`.
11. Adicione a URL de instalação como `domain` na seção `App unfurl domains section` para exibir metainformações sobre a conversa quando a URL da conversa for compartilhada.
12. Conecte a integração do Slack no aplicativo AirysChat e seja produtivo.

## Configurar as variáveis de ambiente no AirysChat

Obtenha o `Client ID` e o `Client Secret` do aplicativo e configure-os nas [variáveis de ambiente](/self-hosted/configuration/environment-variables) do seu AirysChat. Esses valores estarão disponíveis em `Settings` > `Basic Information`.

```bash theme={null}
SLACK_CLIENT_ID=
SLACK_CLIENT_SECRET=
```

Reinicie o servidor do AirysChat.

<Note>
  O Slack só aparecerá na seção de integrações depois que você configurar esses valores e reiniciar o servidor.
</Note>

## Conectar o AirysChat ao seu espaço de trabalho do Slack

Siga este [guia](https://www.airyschat.com/hc/user-guide/articles/1677774874-how-to-answer-conversations-from-slack) para concluir a integração com o Slack.

## Testando sua configuração

1. Crie uma nova conversa.
2. Certifique-se de estar recebendo as mensagens do AirysChat no canal conectado do Slack.
3. Adicione uma mensagem a esse tópico e certifique-se de que ela está voltando para o AirysChat.
4. Adicione `note:` ou `private:` na frente da mensagem do Slack para ver se ela está saindo como notas privadas.
5. Se o e-mail do seu membro do Slack corresponder ao e-mail dele no AirysChat, as mensagens serão associadas à conta de usuário dele no AirysChat.