Slack

O Bordio para Slack coloca o trabalho onde a conversa já acontece: notificações pessoais por mensagem direta, prévias detalhadas dos links do Bordio e tarefas que você cria e atualiza a partir de uma mensagem.

O que você ganha

Notificações — uma mensagem direta quando uma tarefa é atribuída a você, uma reunião muda, alguém comenta e assim por diante. Você escolhe quais.
Prévias de links — cole um link do Bordio e ele vira um cartão com status, responsáveis e datas.
Ações na tarefa — conclua uma tarefa, mude o status ou o responsável direto no cartão.
Criação de tarefas — /bordio add, ou transforme qualquer mensagem do Slack em tarefa.
Sincronização de tópicos — as respostas no tópico abaixo de uma prévia viram comentários da tarefa, e vice-versa.

Configuração em três passos

A configuração acontece em três níveis, e cada um libera uma parte diferente da integração.

1. Instalar o aplicativo (uma vez, por um administrador)

Alguém com permissão para gerenciar a organização instala o Bordio no espaço de trabalho do Slack.

No Bordio, abra Configurações da organização → Integrações.
No cartão do Slack, clique em Add to Slack.
O Slack pergunta em qual espaço instalar e mostra as permissões que o Bordio pede. Confirme: você volta ao Bordio e o cartão mostra o espaço do Slack conectado.

Um espaço de trabalho do Slack pertence a exatamente uma organização do Bordio. Se o espaço que você escolheu já está conectado em outro lugar, desconecte lá primeiro. O contrário é permitido: uma organização do Bordio pode ter vários espaços do Slack conectados.

2. Conectar sua conta (cada pessoa, por si)

Instalar o aplicativo não diz ao Bordio qual usuário do Slack é você. Enquanto você não conectar sua própria conta, nenhuma mensagem direta é enviada e as ações do Slack não funcionam.

No Slack, execute:

/bordio connect

Clique no botão da resposta, entre no Bordio como de costume — login único e autenticação em duas etapas valem normalmente — e aprove a conexão. O Bordio confirma no Slack e a aba do navegador leva você de volta ao aplicativo.

Também dá para começar por uma prévia: cole um link do Bordio em um canal e, se você ainda não estiver conectado, o bot manda um botão de conexão por mensagem direta.

3. Adicionar o Bordio aos canais onde você trabalha

Os dois primeiros passos já entregam a maior parte da integração: dá para criar tarefas de qualquer lugar do Slack e os links do Bordio viram cartões em qualquer conversa. Duas coisas, porém, exigem que o aplicativo seja membro do canal: publicar em um canal privado e ler as respostas de um tópico.

No canal, execute:

/invite @Bordio

Ou abra a aba Integrations do canal e adicione o aplicativo por lá. O Bordio publica uma confirmação curta e, a partir daí, tudo funciona nesse canal.

O que você ganha depende de onde você está:

Onde você está	A tarefa é criada	Prévias de links	Cartão do `/bordio add`	Respostas do tópico viram comentários
Canal público, aplicativo não adicionado	Sim	Sim	Sim	Não
Canal privado, aplicativo não adicionado	Sim	Sim	Não — o Bordio explica o motivo	Não
Qualquer canal, aplicativo adicionado	Sim	Sim	Sim	Sim
Mensagem direta ou em grupo	Sim	Sim	Não, e não tem como resolver	Não

Desta tabela vale guardar quatro coisas.

As prévias de links não precisam do aplicativo no canal. O Bordio registra os próprios endereços no Slack, e o Slack expande links para eles em todo o espaço de trabalho. É a única parte que funciona sem nenhuma configuração por canal.

As respostas em um tópico precisam. O Slack repassa mensagens apenas das conversas às quais um aplicativo pertence, então num canal sem o Bordio o cartão pode estar bem ali enquanto as respostas abaixo dele não chegam a lugar nenhum. Nada avisa: a resposta simplesmente continua sendo uma mensagem do Slack.

Um canal privado se esconde por completo dos aplicativos. Enquanto o Bordio não for convidado, ele não consegue publicar ali: a tarefa do /bordio add é criada mesmo assim, e o Bordio avisa — naquele canal e só para você — que o cartão não tinha para onde ir.

Mensagens diretas e em grupo ficam fora de alcance. O Slack não permite adicionar um aplicativo à conversa de outra pessoa, então cartões do /bordio add não aparecem lá e as respostas não são sincronizadas. Os links continuam sendo expandidos e a tarefa é criada normalmente.

Permissões que o Bordio pede

Permissão	Para quê
Enviar mensagens, inclusive em canais públicos	Notificações pessoais e respostas aos seus comandos
Abrir mensagens diretas	Entregar essas notificações a você
Ler e escrever prévias de links	Expandir os links do Bordio em cartões
Comandos de barra	`/bordio add`, `connect`, `disconnect`, `status`
Ler mensagens em canais públicos e privados	Sincronizar como comentários as respostas do tópico abaixo de uma prévia
Ler informações básicas do perfil	Mostrar qual conta do Slack está conectada e nomear quem é mencionado nos tópicos

O Bordio não pede acesso às suas mensagens diretas nem às de grupo, então os tópicos de lá não são sincronizados.

O Bordio age apenas sobre as respostas em tópicos abaixo dos próprios cartões. Todo o resto do canal é ignorado: nada é guardado e nada chega às suas tarefas. E num canal onde o aplicativo não foi adicionado, o Bordio nem fica sabendo das mensagens.

Comandos de barra

Comando	O que faz
`/bordio connect`	Conecta sua conta do Slack à sua conta do Bordio
`/bordio status`	Mostra se sua conta está conectada e com qual
`/bordio disconnect`	Desconecta sua conta e interrompe as mensagens pessoais
`/bordio add <texto>`	Abre um formulário para criar uma tarefa, com o título já preenchido

Como desconectar

Sua própria conta. Execute /bordio disconnect no Slack, ou abra Configurações do perfil → Integrações → Aplicativos com acesso ao Bordio no Bordio e revogue a conexão do Slack. As duas fazem a mesma coisa: as mensagens pessoais param e as ações do Slack deixam de funcionar até você conectar de novo. Nada das suas tarefas ou comentários é removido.

A integração inteira. Em Configurações da organização → Integrações, desconecte o espaço do Slack. Prévias, notificações e comandos param para todo mundo naquele espaço. A integração pode ser conectada de novo depois.

Remover o aplicativo do Bordio pelo lado do Slack tem o mesmo efeito: o Bordio percebe, marca a integração como sem acesso e oferece reconectar.

A seguir

Notificações — escolher o que chega até você
Tarefas no Slack — prévias, ações, criar tarefas, tópicos
Solução de problemas — quando algo não aparece