Microsoft Teams
Como conectar o OpsScript ao Microsoft Teams para receber notificações de chamados e automatizar comunicações
A integração com o Microsoft Teams permite que sua equipe receba notificações de chamados e atualizações operacionais diretamente nos canais do Teams. Organizações que utilizam o ecossistema Microsoft podem centralizar a comunicação sem abandonar a ferramenta de colaboração principal.
Para configurar esta integração, você precisa ter permissão de administrador no OpsScript e permissão para autorizar aplicativos no Microsoft Teams.
Pré-requisitos
Antes de iniciar a configuração, verifique se você atende aos seguintes requisitos:
- Permissão para autorizar aplicativos (admin consent) no Microsoft 365 / Microsoft Teams
- Cargo de Administrador ou Proprietário no OpsScript
- Equipe (Team) e canais de destino já criados no Teams
A integração utiliza autorização OAuth (admin consent) e o aplicativo dedicado do OpsScript para o Teams. Depois de autorizado, o aplicativo é adicionado às equipes e canais nos quais você deseja receber notificações.
Configurando a integração
Acesse as integrações
Clique em Integrações no menu lateral do OpsScript. Você verá o catálogo de provedores disponíveis.
Selecione o provedor Microsoft Teams
No catálogo de integrações, localize o card do Microsoft Teams.
Inicie a conexão
Clique no botão Conectar para iniciar o fluxo de autorização. Você será direcionado para autorizar o aplicativo do OpsScript no Microsoft Teams.
Autorize o aplicativo
Conceda o consentimento de administrador para o aplicativo do OpsScript no painel do Microsoft Teams / Microsoft 365.
Configure os canais de destino
Após a conexão, adicione o aplicativo às equipes e canais desejados e configure os gatilhos e as preferências de notificação.
Funcionalidades após a conexão
Com a integração ativa, você tem acesso às seguintes funcionalidades:
Notificações em canais
Configure quais eventos geram notificações e em quais canais do Teams elas devem aparecer. As notificações são enviadas como mensagens formatadas, com informações resumidas do chamado.
Broadcasting de mensagens
Quando ativado, atualizações e comentários adicionados a chamados vinculados são automaticamente replicados no canal do Teams correspondente, permitindo que a equipe acompanhe a evolução sem acessar o OpsScript.
Vinculação de usuários
Associe usuários do OpsScript aos seus perfis no Microsoft Teams. Essa vinculação permite menções diretas nas notificações, garantindo que o responsável seja alertado imediatamente.
Se sua organização utiliza o Microsoft 365, aproveite os canais privados do Teams para direcionar notificações sensíveis apenas aos membros autorizados do projeto — e os canais compartilhados (shared channels) para acompanhar chamados junto a pessoas de fora da organização, como clientes e parceiros.
Configurando gatilhos
Os gatilhos automatizam o envio de mensagens com base em eventos específicos da plataforma.
Selecione o tipo de evento
Escolha o evento que deve disparar a mensagem, como criação de chamado, comentário em chamado, atribuição, mudança de status, mudança de prioridade ou chamado concluído.
A notificação de chamado concluído é enviada quando o chamado passa para um status do tipo "concluído" — seja pela conclusão manual do chamado, pela edição do status para um status de conclusão ou pela ação de concluir em massa. Ela chega como uma resposta na thread do chamado, por isso configure também um gatilho de criação de chamado no mesmo canal.
Defina o canal de destino
Selecione o canal do Teams onde a mensagem será enviada quando o evento ocorrer. Canais padrão, privados e compartilhados (shared channels) são suportados — canais compartilhados aparecem na seleção com o selo Compartilhado e exigem um passo extra de configuração no Teams (veja Canais compartilhados abaixo).
Configure o template de mensagem
Personalize o conteúdo da notificação utilizando os campos do chamado, como título, prioridade, responsável e descrição.
Teste o gatilho
Utilize a função de teste do próprio gatilho para enviar uma mensagem de exemplo ao canal selecionado e verificar se a configuração está correta.
Gatilhos mal configurados podem gerar um volume excessivo de notificações. Selecione apenas os eventos relevantes para cada canal e evite duplicar gatilhos com o mesmo escopo.
Canais compartilhados
Canais compartilhados (shared channels) permitem acompanhar chamados junto a pessoas de fora da sua organização — os membros externos do canal recebem as notificações e podem responder nas threads normalmente.
Diferente dos canais padrão e privados, o aplicativo não é herdado do time: além de o app OpsScript estar instalado no time que hospeda o canal, um proprietário do canal precisa adicioná-lo ao canal compartilhado.
Confirme o app no time
Verifique se o aplicativo OpsScript está instalado no time que hospeda o canal compartilhado (o time em que o canal foi criado).
Adicione o app ao canal
No Teams, abra o canal compartilhado, clique em ⋯ Mais opções → Gerenciar canal → aba Aplicativos → Adicionar um aplicativo e selecione OpsScript. Esse passo precisa ser feito por um proprietário do canal.
Teste o gatilho
Após configurar o gatilho no OpsScript, use a função de teste do gatilho para confirmar que a mensagem chega ao canal.
Sem adicionar o app ao canal compartilhado, os envios falham — o erro fica registrado no log de mensagens do gatilho, com a orientação de configuração.
Em canais compartilhados, as respostas na thread levam até 2 minutos para aparecer como comentário no chamado (nos demais canais é imediato). Imagens coladas diretamente na mensagem não são importadas nesses canais — envie como arquivo anexo.
Canais compartilhados hospedados por outra organização (compartilhados para dentro dos seus times) não são suportados e não aparecem na seleção de canais.
Desconectando a integração
Para remover a integração com o Microsoft Teams:
- Acesse Integrações no menu lateral e abra o card do Microsoft Teams
- Clique em Desconectar
- Confirme a ação na caixa de diálogo
Ao desconectar a integração, os gatilhos vinculados deixam de enviar mensagens. Recomenda-se também remover o aplicativo do OpsScript diretamente no painel do Microsoft Teams para evitar referências órfãs.