Avisar convites no Rocket.Chat

Antes de começarCopiar link

Você precisa de acesso de administração ao Rocket.Chat para criar o usuário bot e gerar o token. A configuração fica em Integrações e é visível só para quem é proprietário ou administração do espaço.

Criar o usuário botCopiar link

No Rocket.Chat, crie (ou use) um usuário que enviará as mensagens. Anote o ID do usuário: é o valor de _id mostrado na administração do usuário, ou o campo X-User-Id nas chamadas da API. Esse é o ID do usuário bot que você informa no Prisma Times.

Gerar o token de acesso pessoalCopiar link

1. Entre no Rocket.Chat com o usuário bot.
2. Abra Preferências da conta e procure Tokens de acesso pessoal.
3. Gere um token e copie o valor. Ele só aparece uma vez.
4. Confirme que a conta tem a permissão create-personal-access-tokens. A geração do token costuma exigir autenticação em dois fatores ligada.

O token dá acesso à conta do bot. Trate como segredo: o Prisma Times guarda o token cifrado e nunca o mostra de volta na tela.

Permissões necessáriasCopiar link

Para buscar a pessoa pelo e-mail e abrir a conversa, o bot precisa de:

• create-personal-access-tokens para gerar o próprio token.
• view-d-room para ver as conversas diretas e listar usuários.
• view-full-other-user-info para ler os dados do usuário na busca por e-mail.

O Prisma Times procura a pessoa por e-mail. Em servidores Rocket.Chat 8.4 ou mais novos, a busca usa users.info com o e-mail. Em versões anteriores (6.x a 8.x), o servidor não aceita esse parâmetro e a busca cai em users.list por emails.address, que exige as mesmas permissões acima. Por isso mantenha view-d-room e view-full-other-user-info ligadas.

Não é preciso permissão de impersonação: a mensagem sai em nome do próprio bot, sem alias nem avatar.

Conectar no Prisma TimesCopiar link

Em Integrações, abra Rocket.Chat e informe:

• URL do servidor: por exemplo https://chat.suaempresa.com.br. Precisa ser HTTPS fora de um servidor local de teste.
• ID do usuário bot: o _id do usuário criado acima.
• Token de acesso pessoal: o token gerado.

Clique em Salvar conexão e depois em Testar conexão. O teste confirma que a URL e o token funcionam. Se aparecer falha, confira a URL, o token e as permissões do bot.

O que é enviadoCopiar link

Quando você convida alguém cujo e-mail existe no Rocket.Chat, a pessoa recebe uma mensagem direta do bot com o nome de quem convidou, o nome da organização, o link do convite e a validade. Se o e-mail não existir no chat, nada é enviado e o registro mostra Pulado.

O chat é um canal a mais: o e-mail do convite continua sendo enviado sempre. Nenhum conteúdo de avaliação, evidência ou nota vai para o chat.

Desligar ou removerCopiar link

Use o interruptor Avisar convites pelo chat para pausar os avisos sem perder a conexão. Para remover a conexão e o token salvos, abra Editar conexão e clique em Remover conexão.