---
url: https://docs-standcast.usefachada.dev/pt-BR/admin/slack.md
---
# Slack

O Standcast publica o consolidado de cada time num canal do Slack. Cada instalação conecta um workspace do Slack.

## Conectar

Só um admin da organização pode conectar ou reconectar o Slack: um admin da organização no GitHub, ou o dono da conta, numa conta pessoal. O Standcast confere o papel com o GitHub quando a conexão começa e de novo quando o Slack devolve o admin. Os outros membros veem a conexão na página de setup só para leitura.

Na página de setup, clique em **Conectar Slack** e aprove o app. A etapa do Slack passa a mostrar "Conectado a" e o nome do workspace.

Para conectar de novo, por exemplo depois que o app foi removido do Slack ou para levar os consolidados para outro workspace, clique em **Reconectar Slack** na página de setup. O fluxo de aprovação é o mesmo e substitui a conexão anterior.

## Permissões do bot

| Escopo | Para quê |
| --- | --- |
| `chat:write` | Publicar o consolidado e as dailies atrasadas na thread dele |
| `chat:write.public` | Publicar em canais públicos sem ser convidado |
| `channels:read` | Transformar o nome de um `#canal` público no id dele |
| `groups:read` | Transformar o nome de um `#canal` privado no id dele, nos canais privados para os quais o bot foi convidado |
| `users:read` | Buscar usuários do Slack |
| `users:read.email` | Achar o usuário de uma pessoa no Slack pelo e-mail, para mencioná-la |
| `im:write` | Enviar mensagens diretas: lembretes, impedimentos encaminhados e impedimentos sugeridos |

O Standcast não lê mensagens.

## Canais

Defina o canal no `standcast.yml`, em `chat.channel`:

* `"#daily-backend"`: o nome do canal. Use aspas.
* `C0123456789`: o id do canal. No Slack, abra os detalhes do canal; o id fica no fim.

**Canais públicos** funcionam direto: o bot publica sem ser convidado.

**Canais privados** precisam do bot como membro. No canal, rode `/invite` e escolha o app do Standcast, ou adicione o app nos detalhes do canal, em **Integrações**. Até lá, o consolidado falha com `channel_not_found`.

Canais arquivados não são encontrados.

## Como as pessoas são mencionadas

O consolidado menciona cada pessoa pelo usuário dela no Slack quando o Standcast o conhece, e mostra `@` seguido do login do GitHub, em texto, quando não conhece. A pessoa é ligada ao usuário do Slack quando entra (com `standcast login` ou na página de setup), se o Slack já estiver conectado e o `standcast.yml` tiver uma versão válida:

1. Se o `standcast.yml` tiver `members.<login>.slack`, esse id é usado.
2. Senão, o Standcast busca o usuário do Slack pelo e-mail principal verificado da conta da pessoa no GitHub.

Se nada disso funcionar, o consolidado sai mesmo assim, com `@login`. Para resolver, veja [Meu nome aparece como @login](/pt-BR/troubleshooting#meu-nome-aparece-como-login).

## Erros de entrega

Quando uma publicação falha, a página de setup a lista em "Últimas entregas com falha", com o time, a data e o erro no formato `código: mensagem`. O Standcast tenta cada mensagem até 3 vezes no total. Um consolidado só é tentado de novo dentro de 120 minutos depois do `digest_at`.

| Código do erro | Significado | Como resolver |
| --- | --- | --- |
| `channel_not_found` | O canal não existe, está arquivado, ou é privado e o bot não está nele. | Confira o `chat.channel`. Num canal privado, convide o bot. |
| `not_in_channel` | O bot não é membro do canal. | Convide o bot para o canal. |
| `is_archived` | O canal está arquivado. | Desarquive o canal ou escolha outro. |
| `invalid_auth`, `token_revoked`, `account_inactive` | O token do Slack não funciona mais, em geral porque o app foi removido do workspace. | Um admin clica em **Reconectar Slack**. |
| `missing_scope` | Falta ao token uma permissão de que o Standcast precisa. | Um admin clica em **Reconectar Slack** e aprova todas as permissões. |
| `ratelimited` | O Slack pediu para o Standcast ir mais devagar. | Nada a fazer; a entrega é tentada de novo. |
| `no_chat_connection` | O Slack não está conectado nesta instalação. | Um admin clica em **Conectar Slack** na página de setup. |
| `no_chat_identity` | Um lembrete ou impedimento encaminhado não pôde ser enviado porque a pessoa, ou o gestor para quem ele caiu, não tem usuário no Slack. A página de setup mostra o login. | Peça à pessoa para rodar `standcast login` depois que o Slack foi conectado, ou adicione `members.<login>.slack` no `standcast.yml`. |
| `no_route_target` | Um impedimento foi reportado, mas não havia nenhum destinatário, por exemplo porque o autor é o único gestor do time. | Adicione outro gestor ao time. |
| `unsupported_provider` | O time usa `chat.provider: google-chat`, que vem em breve. | Use `slack`. |
| `worker_died` | O worker parou três vezes durante o envio. | Fale com o suporte se repetir. |
| `internal_error` | Erro inesperado. A mensagem traz os detalhes. | Fale com o suporte se repetir. |

Depois que você resolve a causa, o consolidado do dia seguinte sai normalmente. Um consolidado que já usou as 3 tentativas não é enviado de novo naquele dia.