Integrações
Trama no GRUPIM
Vincule um servidor GRUPIM a um quadro do Trama. As atualizações de tarefas vão para um canal; slash commands e chaves de tarefa funcionam no sentido contrário. Cada membro vincula a própria conta, então tudo o que faz pelo chat é feito em nome dele.
Nesta página
Conectar um servidor
Um único bot atende todos os workspaces, então o servidor é vinculado com um código de uso único gerado dentro dele: a prova de que quem faz a conexão administra o servidor. É preciso ser admin do workspace no Trama e ter alguém com a permissão Gerenciar Servidor no GRUPIM.
Convide o bot
No Trama, abra Configurações do workspaceIntegraçõesGRUPIM e escolha Convidar bot. Adicionar o bot a um servidor exige Gerenciar Servidor.Gere um código
No servidor, alguém com Gerenciar Servidor (ou Administrador) executa/trama connect, de preferência no canal que vai receber as atualizações. O bot responde em privado com um código comoABCD-EFGH-JKLM: de uso único, válido por 10 minutos.Verifique o código
De volta ao Trama, cole o código e escolha Verificar código. Aparecem o servidor, quem pediu o código e os canais do servidor, com o canal onde o comando foi executado já selecionado.Escolha o canal e o quadro
Escolha para onde vão as atualizações e com qual quadro o servidor trabalha, depois Conectar GRUPIM.
Vincular sua conta
Os comandos que leem ou alteram tarefas rodam como um usuário do Trama, então cada membro vincula a sua conta do GRUPIM uma vez:
- Execute
/trama linkno servidor. O bot responde em privado com um link que vale por 10 minutos. - Abra o link logado no Trama. Confira se o nome de usuário do GRUPIM é o seu e escolha Vincular conta.
Admins do workspace também podem vincular membros manualmente, ou associar de uma vez os nomes de usuário do GRUPIM e do Trama, no cartão do GRUPIM em Configurações do workspaceIntegrações.
Comandos
| Comando | O que faz |
|---|---|
| /trama connectGerenciar Servidor | Um código para vincular este servidor a um workspace do Trama. |
| /trama linkQualquer pessoa | Um link privado para conectar a sua conta do GRUPIM ao Trama. |
| /boardQualquer pessoa | Um resumo do quadro vinculado: cartões abertos e atrasados por coluna. |
| /task createVinculado, pode editar o quadro | Cria uma tarefa a partir de um name, com body e column opcionais (pelo nome; se não informada, a coluna A fazer do quadro). |
| /task showVinculado, pode ver o quadro | Mostra uma tarefa pela key. |
| /task moveVinculado, pode editar o quadro | Move uma tarefa (key) para uma column, pelo nome. |
| /task from-threadVinculado, pode editar o quadro | Dentro de uma thread: cria uma tarefa cuja descrição traz as mensagens recentes da thread (até 30). O título é o nome da thread, a menos que você informe outro. |
| /assignVinculado, pode editar o quadro | Atribui uma tarefa (key) a um user mencionado, que precisa estar vinculado e já estar no quadro. |
Chaves de tarefa no chat
Digite uma chave como ACME-42 em uma mensagem e o bot responde com uma prévia: título, coluna, responsáveis e prazo, nunca a descrição, já que o canal pode ter pessoas que não veem o quadro. Até três chaves por mensagem.
- Só mensagens de membros vinculados que veem o quadro recebem prévia.
- Mensagens que já têm um link para a tarefa, e mensagens de bots, são ignoradas.
Atualizações no canal
Quando um cartão do quadro vinculado é criado, movido, comentado, atribuído ou arquivado, o bot publica uma atualização no canal. Escolha quais desses eventos publicar em Publicar quando uma tarefa for, no cartão do GRUPIM; sem nenhum escolhido, nada é publicado e os comandos continuam funcionando.
- O que os membros fazem pelo bot não volta para o canal: criar uma tarefa com
/task createnão publica uma atualização de criação. - Cartões movidos por um pull request (veja GitHub e GitLab) publicam uma atualização de movimentação, como qualquer outra.
- Ao desconectar, o webhook do bot é removido do canal.
Permissões
- O bot age como o usuário do Trama vinculado: as tarefas são criadas por ele, comentários e movimentações mostram o nome dele, e as notificações vêm dele.
- Criar, mover, atribuir e
/task from-threadexigem permissão de edição no quadro vinculado./task showe as prévias exigem poder ver o quadro./boardfunciona antes de qualquer pessoa se vincular. /assignsó atribui pessoas que já estão no quadro; ele nunca adiciona ninguém ao quadro.
Como testar
Um roteiro por todas as partes da integração, para uma configuração nova ou depois de uma mudança.
Conectar
Um admin do workspace convida o bot; alguém que gerencia o servidor executa/trama connect; o admin cola o código, escolhe o canal e o quadro e conecta. Um membro sem Gerenciar Servidor recebe uma recusa de/trama connect.Vincular
Execute/trama link, abra o link logado no Trama como membro do workspace e confirme. O membro aparece como vinculado no cartão do GRUPIM. Se quiser, vincule um segundo membro manualmente, ou associe os nomes de usuário.Criar
Como membro vinculado, use/task create. O cartão aparece no quadro vinculado, criado por esse membro (não por quem instalou o bot), e o canal não recebe uma atualização de criação para ele.Prévia
Como membro vinculado, digite a nova chave (PREFIX-N) no canal: uma prévia, sem a descrição. Um membro não vinculado que digitar a chave não recebe nada.Mostrar, mover, resumo, atribuir
Execute/task show,/task movee/boardcom essa chave, depois/assignpara um membro vinculado.Sem vínculo
Um membro não vinculado que executa/task createrecebe a orientação de executar/trama linkantes;/assignpara um membro não vinculado falha com uma mensagem clara.Atualizações vindas do Trama
Arraste o cartão para outra coluna no Trama: o canal recebe a atualização de que ele foi movido para a nova coluna. Comente no cartão e depois arquive-o: uma atualização para cada, se esses eventos estiverem ativados.A partir de uma thread
Dentro de uma thread,/task from-threadcria um cartão cuja descrição traz as mensagens recentes da thread.Desconectar
Desconecte no Trama. O webhook some do canal, e os comandos do servidor respondem “Guild not connected”.