Coroid possui bots de plataforma para Slack, Discord, Telegram e SMS. Configure-os nesta seção: Configurações → Conexões → Canais.
O que cada um faz atualmente:
| Plataforma | Mensagens viram solicitações | Recebe atualizações |
|---|---|---|
| Slack | Sim, por meio de uma automação de eventos | Atualizações de tarefas, por meio de um webhook de entrada |
| Telegram | Sim, por meio de uma automação de eventos | Não |
| Discord | Não | Não |
| SMS | Não | Não |
Você pode salvar um bot do Discord ou SMS, mas nada o utiliza hoje. A mesma página também tem pontes de canal, que ainda não funcionam. Veja Pontes de canal.
Bots da plataforma
O bot é a identidade que Coroid usa na plataforma. Instale-o uma vez por workspace ou servidor e conceda a ele acesso aos canais que deve ler. Slack e Telegram precisam do seu bot para que a automação de eventos possa ler mensagens.
Se um bot do Slack for removido de um canal, Coroid deixará de ler esse canal, e nada indica isso. Se as mensagens do Slack pararem de virar solicitações, verifique se o bot ainda está no canal.
Apenas proprietários e administradores podem adicionar, alterar ou remover um bot. Cada plataforma envia seus eventos para um URL de webhook no gateway API, que Coroid exibe para cada bot. Coroid rejeita uma entrega que não esteja assinada com o segredo do bot.
Iniciando o trabalho a partir de um canal
Uma mensagem do Slack ou Telegram pode virar uma solicitação de trabalho. Mensagens do Discord e SMS não podem.
Uma mensagem vira uma solicitação por meio de uma automação de eventos. Isso é útil para as solicitações do tipo "alguém pode simplesmente consertar…" que, de outra forma, nunca seriam registradas como trabalho.
Uma mensagem correspondente vai para a Qualificação como uma solicitação. A Qualificação a analisa, procura por duplicatas e decide o que ela deve se tornar. Nada é criado até que seja aprovada. Veja Formas de iniciar o trabalho.
Coroid não vincula contas do Slack ou Telegram a contas do Coroid, portanto qualquer pessoa que possa postar em um chat correspondente pode registrar uma solicitação. Por esse motivo, o trabalho a partir de um chat nunca começa sozinho. Uma tarefa qualificada é criada e aguarda que alguém a inicie, e um plano aguarda aprovação.
Veja Gatilhos e destinos.
Slack
- Configure o bot do Slack nesta seção: Bots da plataforma. Ele precisa do token do bot e do segredo de assinatura do app do Slack.
- No seu app do Slack, envie mensagens de canal e menções do app para a URL do webhook
que o Coroid exibe:
https://api.coroid.ai/api/v1/webhooks/slack/events. - Convide o bot para cada canal que ele deve ler.
- Ative o Slack em Controle de Qualidade → Padrão da organização → Antes do início do trabalho → De onde vêm as solicitações. Apenas proprietários e administradores podem ativar uma fonte, e somente depois que o bot estiver conectado.
Ativar o Slack adiciona uma automação que converte mensagens correspondentes em solicitações. Ela está listada em Factory → Automações, onde você pode alterar seu filtro. Desativar o Slack pausa a automação e mantém seu filtro.
O filtro da automação define quais mensagens contam. Ele começa correspondendo
às mensagens que contêm esta menção: @coroid. Um filtro também pode limitar a
automação a um canal ou a mensagens enviadas por bots, como alertas.
O Coroid executa no máximo 10 automações do Slack por minuto em um canal.
Telegram
- Adicione o bot do Telegram nesta seção: Bots da plataforma. O Coroid registra seu webhook no Telegram e o protege com um segredo de webhook. Se você deixar o segredo em branco, o Coroid gera um.
- Adicione o bot ao grupo ou torne-o administrador do canal.
- Ative o Telegram em Controle de Qualidade → Padrão da organização → Antes do início do trabalho → De onde vêm as solicitações. Sua automação está listada em Factory → Automações, onde você pode alterar seu filtro.
- No chat, inicie cada solicitação com este comando:
/coroid.
O modo de privacidade do Telegram, ativado por padrão, permite que o bot veja comandos, mas não mensagens comuns. Um filtro também pode limitar a automação a um chat pelo seu ID de chat. O bot ignora mensagens diretas, a menos que o filtro as permita.
Qualquer pessoa pode adicionar seu bot a outro grupo e registrar solicitações de lá. Para
evitar isso, limite a automação ao seu chat ou impeça o bot de entrar em grupos
com este comando do BotFather: /setjoingroups.
O Coroid aceita no máximo 10 mensagens correspondentes por minuto de um chat. Se a automação for limitada a um projeto, suas solicitações irão para esse projeto.
Pontes de canal
Uma ponte conecta um canal a uma sessão com o assistente de chat.
Conversar com o assistente por meio de uma ponte não está disponível. Uma ponte não encaminha mensagens ao assistente, portanto não pode iniciar ou orientar o trabalho.
Atualizações em um canal
O Slack é a única plataforma de chat que recebe atualizações. O Coroid publica em um canal do Slack quando uma tarefa é concluída, falha ou é escalada, bem como quando tenta novamente ou desiste de resolver um conflito de mesclagem. As mensagens passam por um webhook de entrada do Slack conectado à sua organização, e não pelo bot do Slack. Ainda não há tela de configurações para vincular o webhook.
Discord, Telegram e SMS não recebem atualizações. Todo o restante chega ao portal. Veja Notificações.