Melhores práticas para utilizar notificações do feed de atividades do Microsoft Teams

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

• Criar notificações de chamada a ação
• Pedir respostas a notificações
• Criar notificações sobre eventos externos

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

Quando implementar notificações do feed de atividades, tenha em atenção os seguintes pontos:

• As notificações de alerta redirecionam os utilizadores para o feed de atividades e não para a aplicação. Para ver outra atividade, os utilizadores têm de selecionar a notificação associada no feed de atividades.
• Os utilizadores só podem gerir as definições de notificação depois de a aplicação selecionada enviar uma notificação.
• O ícone de cada notificação está incluído no manifesto da aplicação. O Microsoft Graph não suporta a personalização do ícone.
• As notificações de prioridade não são suportadas.

Melhorar a experiência de notificação

O Microsoft Teams apresenta notificações em formatos de feed de atividades e alertas. Os utilizadores recebem notificações de várias origens em chats, canais, reuniões ou outras aplicações. Para melhorar a experiência do utilizador, aplique as seguintes recomendações:

• Localize o conteúdo num alerta de notificação ou feed. A localização só acontece se o conteúdo da aplicação estiver localizado.
• Forneça os títulos e descrições adequados para os Seus Tipos de Atividade. Utilize títulos curtos, como @menção e Anúncios. Evite títulos longos, como Atividade mencionada pelo utilizador e Atividade pós-criação.
• As notificações devem transmitir informações importantes relevantes para o utilizador. Por exemplo, o Diego atribuiu-lhe um pedido de venda é uma mensagem relevante; Joni deixou a equipa de vendas .
• Evite enviar notificações promocionais por natureza, como Experimentar a nova funcionalidade na aplicação Ciclismo.
• Evite notificações duplicadas de mensagens de bot e notificações do feed de atividades. Para obter mais informações, veja Escolher notificações do feed de atividades ou mensagens do bot framework.
• Utilize a secção de pré-visualização de texto em notificações. Forneça informações para ajudar o utilizador a determinar a importância da notificação e a tomar medidas, se necessário.
• Não adicione um período no final do título da notificação para ser consistente com todas as outras definições de notificação no Teams.
• Tornar a relação entre a notificação e o respetivo conteúdo clara para o utilizador. Por exemplo, quando um utilizador recebe uma notificação para aprovar uma licença, a notificação deve redirecioná-la para a secção correspondente da aplicação. Se a notificação diz respeito à remoção ou eliminação de entidades, como utilizadores e tarefas, direcione o destinatário para o conteúdo e indique a ação necessária.
• Certifique-se de que a experiência de alimentação é autónoma. Por exemplo, quaisquer pop-ups e modais têm de permanecer na aplicação.
• Verifique se a aplicação não envia mais de 20 notificações por minuto, por utilizador. As notificações serão limitadas automaticamente se a contagem exceder 20.
• Certifique-se de que o tempo de carregamento da sua aplicação não afeta negativamente a experiência dos utilizadores quando alternam entre notificações no feed.
• Informe o utilizador 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 aplica-se a todas as notificações. Não é específico das notificações enviadas através da API de notificações do feed de atividades.

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

Pode utilizar notificações do feed de atividades ou mensagens do bot framework, mas não utilize ambos os tipos de notificação. As secções seguintes descrevem os tipos de notificação e quando utilizar cada um.

Notificações de feed de atividades

As notificações do feed de atividades são apresentadas no feed de atividades do Teams e podem incluir ligações para várias localizações. Estas notificações:

• Permitir que o utilizador tome medidas ou faça a triagem da notificação.
• Levar o utilizador a um separador num chat ou canal, numa aplicação pessoal ou numa mensagem de chat ou canal.

A API de notificações do feed de atividades permite que os utilizadores configurem notificações para cada tipo de notificação a partir das definições de notificação.

Se utilizar notificações do feed de atividades, tenha em atenção que a sua aplicação pode enviar notificações duplas se enviar notificações de bot para chats ou canais e também para o feed de atividades. Envie apenas notificações duplas se o seu cenário o exigir.

Utilize 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 apenas de aplicações. Nas chamadas delegadas, o remetente da notificação aparece como o utilizador que iniciou a notificação e, nas chamadas apenas de aplicação, o remetente aparece como a aplicação.

Pode atualizar uma notificação do feed de atividades existente em vez de criar uma nova notificação com o parâmetro chainId .

Mensagens do Bot Framework

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

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

Conteúdo relacionado

• Criar notificações do feed de atividades para o Microsoft Teams
• Visão geral da API do Microsoft Teams