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.

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.