Aprenda Mokapen.

Slack

Ligue o workspace Slack para receber avisos do Mokapen e criar tasks sem sair do Slack. Não sincroniza canais, mensagens nem ficheiros: publica os eventos que escolhe e abre uma task quando alguém usa o comando ou o atalho.

Panorâmica: Integrações.

Requisitos

• Permissão para instalar uma app no workspace Slack. Se o administrador Slack bloquear apps externas, a autorização para aí: tem de ser aprovada no portal Slack, não no Mokapen.
• Plano Mokapen Medium.
• Utilizadores Mokapen com o mesmo email da conta Slack, se quiser que a atribuição da task volte à pessoa certa.

Ligar e escolher os avisos

Menu de utilizador → Integrações → Slack e autorize o workspace. Depois, na página:

• Canal — onde o Mokapen publica. Sem canal a notificação de teste não sai.
• Task atribuída / novo encargo — uma mensagem quando uma task é atribuída.
• Novo comentário na task — uma mensagem quando chega um comentário.
• Enviar notificação de teste — verifica o canal antes de deixar os eventos ligados. O texto de teste diz que a integração funciona.

Os utilizadores Slack são emparelhados com os utilizadores Mokapen por email. Se uma pessoa no Slack tiver um email diferente, corrija a linha no mapa de utilizadores: caso contrário o comando cria a task, mas o encargo não volta a ela.

Criar uma task a partir do Slack

No canal escreve-se o comando slash com o slug da app e o título, na forma indicada na página (/slug O título). Em alternativa usa-se o atalho na mensagem. A página Mokapen mostra o URL a colar na app Slack como Request URL de Slash Commands e Interactivity, e o URL das Event Subscriptions (…/slack/events). Esses dois endereços vão na configuração da app Slack: sem eles, o comando no canal não chega ao Mokapen mesmo que o OAuth esteja ligado.

O comando cria uma task. Não atualiza uma oportunidade, não fecha um ticket, não responde ao cliente. Se o título estiver vazio, não há nada a criar.

Quando o canal silencia

• O evento não está ligado, ou o canal é outro do que está a ver.
• A task foi atribuída a um utilizador que o Slack não tem no mapa: o evento pode sair na mesma, mas a pessoa não é reconhecida na mensagem.
• A app Slack foi revogada pelos administradores do workspace. No Mokapen desligue e autorize de novo, depois de a app ter sido readmitida.