Práticas recomendadas para usar as notificações do feed de atividades do Microsoft Teams

Este artigo aborda as práticas recomendadas para usar as notificações do feed de atividades do Microsoft Teams no Microsoft Graph. Estas práticas recomendadas se aplicam a:

  • Criando notificações de chamada para ação
  • Solicitar respostas às notificações
  • Criar notificações sobre eventos externos

A imagem a seguir mostra um exemplo de uma notificação do feed de atividades no Teams:

Captura de tela de um aplicativo do Teams mostrando o modo de exibição de notificação do feed de atividades.

Ao implementar notificações do feed de atividades, lembre-se dos seguintes pontos:

  • As notificações do sistema redirecionam os usuários para o feed de atividades, não para o aplicativo. Para ver outra atividade, os usuários devem selecionar a notificação associada no feed de atividades.
  • Os usuários podem gerenciar as configurações de notificação somente depois que o aplicativo selecionado enviar uma notificação.
  • O ícone de cada notificação está incluído no manifesto do aplicativo. O Microsoft Graph não dá suporte à personalização do ícone.
  • Não há suporte para notificações prioritárias.

Aprimorar a experiência de notificação

O Microsoft Teams exibe notificações nos formatos de feed de atividades e brinde. Os usuários recebem notificações de várias fontes em chats, canais, reuniões ou outros aplicativos. Para aprimorar a experiência do usuário, aplique as seguintes recomendações:

  • Localizar o conteúdo em uma notificação do sistema ou feed. A localização acontece somente se o conteúdo do aplicativo for localizado.
  • Forneça títulos e descrições apropriados para seus Tipos de Atividade. Use títulos curtos, como @menção e Anúncios. Evite títulos longos, como Atividade mencionada pelo usuário e Atividade de criação de postagem.
  • As notificações devem transmitir informações importantes que sejam relevantes para o usuário. Por exemplo, Diego atribuiu um ticket de vendas a você é uma mensagem relevante; Joni deixou a equipe de vendas não.
  • Evite enviar notificações de natureza promocional, como Experimente o novo recurso no aplicativo Ciclismo.
  • Evite notificações duplicadas de mensagens de bot e notificações do feed de atividades. Para obter mais informações, consulte escolher notificações do feed de atividades ou mensagens da estrutura de bot.
  • Use a seção de visualização de texto nas notificações. Forneça informações para ajudar o usuário a determinar a importância da notificação e tomar medidas, se necessário.
  • Não adicione um ponto no final do título da notificação, para ser consistente com todas as outras configurações de notificação no Teams.
  • Deixe clara para o usuário a relação entre a notificação e seu conteúdo. Por exemplo, quando um usuário recebe uma notificação para aprovar uma licença, a notificação deve redirecioná-lo para a seção correspondente do aplicativo. Se a notificação se referir à remoção ou exclusão de entidades, como usuários e tarefas, direcione o destinatário para o conteúdo e indique a ação necessária.
  • Verifique se a experiência do feed é independente. Por exemplo, quaisquer pop-ups e modais devem permanecer no aplicativo.
  • Verifique se o aplicativo não envia mais de 20 notificações por minuto, por usuário. As notificações serão limitadas automaticamente se a contagem exceder 20.
  • Verifique se o tempo de carregamento do seu aplicativo não afeta negativamente a experiência dos usuários quando eles alternam entre notificações no feed.
  • Informe o usuário sobre o período de armazenamento de notificações no feed de atividades. No Microsoft Teams, o período de armazenamento é de 30 dias.

    Observação

    O limite de armazenamento de 30 dias se aplica a todas as notificações. Não é específico para notificações enviadas por meio da API de notificações do feed de atividades.

Escolher notificações do feed de atividades ou mensagens da estrutura de bot

Você pode usar notificações do feed de atividades ou mensagens da estrutura de bot, mas não use os dois tipos de notificação. As seções a seguir descrevem os tipos de notificação e quando usar cada um.

Notificações de feed de atividades

As notificações do feed de atividades aparecem no feed de atividades do Teams e podem incluir links para vários locais. Essas notificações:

  • Permita que o usuário execute uma ação ou faça a triagem da notificação.
  • Leve o usuário para uma guia em um chat ou canal, um aplicativo pessoal ou uma mensagem de chat ou canal.

A API de notificações do feed de atividades permite que os usuários configurem notificações para cada tipo de notificação nas configurações de notificação.

Se você usar notificações do feed de atividades, lembre-se de que seu aplicativo pode enviar notificações duplas, se ele enviar notificações de bot para chats ou canais e também para o feed de atividades. Só envie notificações duplas se o cenário exigir.

Use notificações delegadas para criar uma melhor experiência de notificação. A API de notificação do feed de atividades pode enviar chamadas delegadas ou somente de aplicativo. Em chamadas delegadas, o remetente da notificação aparece como o usuário que iniciou a notificação e, em chamadas somente de aplicativo, o remetente aparece como o aplicativo.

Você pode atualizar uma notificação de feed de atividades existente em vez de criar uma nova notificação usando o parâmetro chainId .

Mensagens da estrutura de bot

As mensagens do bot são entregues como mensagens de chat ou de canal. Se o usuário ativar as notificações de chat ou canal, as notificações acionadas serão enviadas como mensagens de chat ou de canal. Para enviar mensagens de bot, @menção o nome do usuário para que a notificação apareça no feed de atividades.

É útil que o alerta seja consumido como uma mensagem de chat ou canal; Por exemplo, uma mensagem que é consumida por todos os membros do canal.

Conteúdo relacionado

  • Last updated on