Notificações do Microsoft Teams

O FyneDesk pode publicar notificações de tickets diretamente no Microsoft Teams. Quando um ticket é criado, atribuído, respondido ou tem o status ou a prioridade alterados, um cartão aparece no canal do Teams que você escolher — com o número do ticket, título, detalhes principais e um botão Ver no FyneDesk que abre o ticket. Incluído nos planos Pro e Business.

O que você vai precisar

• Um administrador do Microsoft Teams que possa carregar aplicativos personalizados. Até o FyneDesk ser listado na loja de aplicativos do Teams, o aplicativo é instalado via Carregar um aplicativo personalizado, o que a política de administrador do Teams da sua organização precisa permitir.
• Um Administrador do FyneDesk para vincular o canal e ativar o recurso. A integração fica desligada para a sua organização até que um Administrador a ative.

Etapa 1 — Baixe o pacote do aplicativo do FyneDesk para o Teams

O aplicativo vem como um pequeno arquivo .zip (um manifesto mais ícones). Um Administrador do FyneDesk o baixa de dentro do FyneDesk: acesse Configurações → Conexões → Microsoft Teams e clique em Baixar pacote do aplicativo do Teams (.zip).

Etapa 2 — Instale-o no Teams

No Microsoft Teams, acesse Aplicativos → Gerenciar seus aplicativos → Carregar um aplicativo → Carregar um aplicativo personalizado e escolha o .zip que você recebeu.

Etapa 3 — Adicione o bot a um canal

Durante a instalação, escolha Adicionar a uma equipe e selecione o canal que deve receber as notificações. (Você também pode adicioná-lo a uma equipe depois, pelas opções do aplicativo.)

Etapa 4 — O bot publica um código de uso único

Logo após entrar, o bot publica um código de vinculação de uso único nesse canal. Ele se parece com XXXX-XXXX e permanece válido por 7 dias. É com esse código que o FyneDesk verifica se a vinculação é legítima — somente quem consegue ver seu canal pode usá-lo.

Etapa 5 — Vincule o canal no FyneDesk

Um Administrador do FyneDesk acessa Configurações → Conexões → Microsoft Teams, cola o código e clica em Vincular canal. O canal agora aparece em Conversas vinculadas.

Etapa 6 — Ative a chave principal

Na mesma página, ligue a chave principal. As notificações para a sua organização ficam desligadas até que um Administrador ative isso — nada é publicado no Teams antes disso.

Etapa 7 — Escolha seu roteamento

Para cada tipo de evento — Novo ticket, Ticket atribuído, Nova resposta, Status alterado e Prioridade alterada — escolha o canal que deve receber o cartão, ou Nenhum canal para ficar em silêncio nesse evento.

Etapa 8 — Teste

Crie um ticket de teste no FyneDesk. O cartão deve chegar ao canal escolhido em segundos, com um botão Ver no FyneDesk que abre o ticket.

Opcional — mensagens diretas pessoais para responsáveis

O agente a quem um ticket é atribuído pode receber uma mensagem pessoal (1:1) do bot em vez de — ou além de — a publicação no canal:

• O agente instala o mesmo aplicativo no Teams pessoalmente (Adicionar para mim).
• O FyneDesk faz a correspondência pelo e-mail corporativo — o e-mail na conta do Teams precisa ser o mesmo do e-mail de login do FyneDesk.
• Marque Enviar mensagem direta ao responsável em um evento, e um cartão pessoal vai para quem o ticket estiver atribuído.

Adicionando mais canais

Adicione o bot a outro canal no Teams. Uma vez que sua organização esteja vinculada, novos canais no mesmo locatário da Microsoft se conectam automaticamente e simplesmente aparecem na sua lista de Conversas vinculadas — o bot só publica um novo código se um for realmente necessário.

Desativando

• Para um canal: remova o bot do canal no Teams. O FyneDesk percebe e para de rotear para lá automaticamente.
• Para tudo: a chave principal em Configurações → Conexões → Microsoft Teams silencia todas as notificações do Teams instantaneamente, sem desinstalar nada.

Perguntas frequentes

Por que um código em vez de "Entrar com a Microsoft"?

O código comprova que a pessoa que está vinculando realmente controla tanto o canal do Teams quanto o espaço de trabalho do FyneDesk. Como o bot o publica dentro do seu canal, somente quem consegue ler esse canal pode concluir a vinculação — isso impede que qualquer outra pessoa reivindique o Teams da sua empresa.

O que o bot consegue ver?

Nada das suas conversas. Ele apenas publica cartões. Ele sabe os canais a que foi explicitamente adicionado e, no caso de instalações pessoais, o nome e o e-mail corporativo do usuário (usado unicamente para a correspondência de responsável).

Quais idiomas?

Os cartões seguem a configuração de idioma de e-mail da sua organização (Configurações → E-mail): English, Deutsch, Español, Português.

Quanto custa?

As notificações do Microsoft Teams estão incluídas nos planos Pro e Business — sem taxa extra de complemento.

E quanto à configuração com webhook + Power Automate?

Esse caminho ainda funciona — veja Enviar notificações do FyneDesk para o Microsoft Teams (webhooks). Mas, para notificações em canais, este bot nativo é o caminho mais simples: não há fluxo a construir, e os cartões são formatados e localizados para você.

Em breve

Os cartões de violação de SLA e de prazo estão chegando em breve. Criar e atualizar tickets de dentro do Teams é um recurso separado do plano Business atualmente em desenvolvimento.

Solução de problemas