Enviar notificações de feed de atividades para usuários no Microsoft Teams
O feed de atividades do Microsoft Teams permite que os usuários triagem itens que exigem atenção notificando-os de alterações. Você pode usar as APIs de notificação do feed de atividades no Microsoft Graph para estender essa funcionalidade aos seus aplicativos. Isso permite que seus aplicativos forneçam experiências mais avançadas e envolvam melhor os usuários, ajudando a mantê-los atualizados com alterações nas ferramentas e fluxos de trabalho que eles usam.
Usar casos de notificações de feed de atividades
- Notícias: ajuda os usuários a se manterem atualizados com as informações mais recentes, como novas atribuições ou novas postagens.
- Colaboração: quando você compartilha um arquivo ou @ menção um usuário em um comentário, os usuários podem ver uma visualização de texto na faixa de notificação.
- Lembretes: uma notificação para informar sobre um evento ou uma tarefa. Por exemplo, você tem uma data de vencimento do treinamento hoje, e o aplicativo envia uma notificação de lembrete para ajudá-lo a se lembrar da tarefa ou evento.
- Alertas: Notificações, que exigem atenção urgente ou imediata. Por exemplo, a data de vencimento de um treinamento passou ou um administrador enviou uma solicitação para corrigir um bug com a maior prioridade.
Vantagens das notificações do feed de atividades
- A notificação do feed de atividades é uma integração nativa do Teams que leva o usuário perfeitamente ao aplicativo Tab, trazendo um envolvimento adicional do usuário da Atividade para seu aplicativo.
- A notificação do feed de atividades vem com uma notificação do sistema operacional na área de trabalho e nos clientes móveis do Teams, para que a atenção do usuário seja captada do pop-up e do som do sistema.
- O conteúdo da notificação é altamente personalizável, permitindo que os usuários visualizem o resumo dos eventos notificados.
- Você pode vincular profundamente seu aplicativo a uma notificação para que, quando um usuário seleciona a notificação, ele aumenta o envolvimento do aplicativo de usuário.
- Você pode enviar notificação do feed de atividades para vários destinatários. Por exemplo, enviar uma notificação pessoal ou enviar notificações em lote para um grupo de usuários.
- A localização do manifesto do aplicativo (anteriormente chamada de manifesto de aplicativo do Teams) dá suporte ao texto modelo em notificações do feed de atividades.
Entender os conceitos básicos das notificações do feed de atividades
No Microsoft Teams, as notificações do feed de atividades consistem em vários bits de informações exibidos juntos, conforme mostrado na seguinte imagem:
Os componentes incluem:
| Contador | Descrição |
|---|---|
| 1 | Avatar: mostra quem iniciou a atividade. |
| 2 | Tipo de atividade ou ícone de aplicativo: o tipo de atividade ou ícone de aplicativo retrata o tipo de atividade. Para notificações de aplicativo, o ícone de linha é substituído por um ícone de aplicativo. |
| 3 | Título: Ator + motivo: Ator: nome do usuário ou aplicativo que iniciou a atividade. Motivo: descreve a atividade. |
| 4 | Carimbo de data/hora: mostra quando a atividade aconteceu. |
| 5 | Visualização de texto: mostra uma linha truncada desde o início da notificação. |
| 6 | Local: mostra onde a atividade aconteceu no Teams. |
O exemplo a seguir mostra que os componentes juntos fornecem os detalhes sobre uma notificação.
Tipos de cartões de notificação do feed de atividades
As variantes a seguir mostram os tipos de cartões de notificação do feed de atividades que você pode exibir. O logotipo do aplicativo substitui o avatar do usuário por notificações geradas pelo aplicativo:
| Contador | Descrição |
|---|---|
| 1 | Teams personalizado |
| 2 | Windows |
| 3 | Mac |
Requisitos para usar as APIs de notificação do feed de atividades
As APIs do feed de atividades funcionam com um aplicativo do Teams. A seguir estão os requisitos para o envio de notificações de feed de atividades:
- O manifesto do aplicativo deve ter a ID do aplicativo Azure AD adicionada à seção WebApplicationInfo. Para obter mais informações, consulte esquema de manifesto do aplicativo.
- Os tipos de atividade devem ser declarados na seção atividades. Para obter mais informações, consulte esquema de manifesto do aplicativo.
- O aplicativo Teams deve ser instalado para o destinatário, pessoalmente ou em uma equipe ou chat do qual eles fazem parte.
Permissões
Use permissões delegadas ou de aplicativo para enviar notificações do feed de atividades. Quando você usa permissões de aplicativo, recomendamos usar o RSC (consentimento específico do recurso), pois a TeamsActivity.Send.User permissão é consentida pelo usuário para enviar notificações de atividade. Verifique se você declara permissões RSC no arquivo de manifesto do aplicativo.
Atualização do manifesto do aplicativo
Esta seção descreve as atualizações que precisam ser adicionadas ao manifesto do aplicativo. Verifique se você usa a versão 1.7 do manifesto do aplicativo ou posterior.
"$schema": "https://developer.microsoft.com/json-schemas/teams/v1.7/MicrosoftTeams.schema.json",
"manifestVersion": "1.7",
Atualização webApplicationInfo
"webApplicationInfo":
{
"id": "a3111f15-658e-457c-9689-fd20fe907330",
"resource": "https://contosoapp.com"
}
| Parâmetro | Tipo | Descrição |
|---|---|---|
id |
string | Azure AD ID do aplicativo (ID do cliente). |
resource |
string | Recurso associado ao aplicativo Azure AD. Também conhecida como URL de resposta ou redirecionamento no Portal do Microsoft Azure. |
Observação
Você pode receber um erro se vários aplicativos do Teams no mesmo escopo (equipe, chat ou usuário) estiverem usando o mesmo aplicativo Azure AD. Verifique se você está usando aplicativos Azure AD exclusivos.
Atualização de atividades
"activities":
{
"activityTypes": [
{
"type": "taskCreated",
"description": "Task Created Activity",
"templateText": "{actor} created task {taskId} for you"
},
{
"type": "approvalRequired",
"description": "Deployment requires your approval",
"templateText": "{actor} created a new deployment {deploymentId}"
}
]
}
| Parâmetro | Tipo | Descrição |
|---|---|---|
| type | string | Tipo de atividade. Isso precisa ser exclusivo em um manifesto de aplicativo específico. |
| description | string | Descrição curta legível pelo homem. Isso está visível no cliente do Microsoft Teams. |
| templateText | string | Texto do modelo para a notificação de atividade. Você pode declarar seus parâmetros encapsulando parâmetros em {}. |
Observação
A actor propriedade é um parâmetro especial que sempre leva o nome do chamador. Em chamadas delegadas, actor é o nome do usuário. Em chamadas somente de aplicativo, ele usa o nome do aplicativo Teams.
Atualização de autorização
"authorization":
{
"permissions": {
"resourceSpecific": [
{
"type": "Application",
"name": "TeamsActivity.Send.User"
},
{
"type": "Application",
"name": "TeamsActivity.Send.Group"
},
{
"type": "Application",
"name": "TeamsActivity.Send.Chat"
}
]
}
}
| Parâmetro | Tipo | Descrição |
|---|---|---|
| type | string | O tipo da permissão RSC. |
| nome | string | O nome da permissão RSC. Para obter mais informações, consulte permissões RSC com suporte. |
Instalar o aplicativo Teams
Os aplicativos do Teams devem ser instalados em uma equipe, chat ou para um usuário no escopo pessoal para que os usuários recebam notificações do feed de atividades. Para obter detalhes, confira Métodos de distribuição de aplicativos do Teams. Para fins de desenvolvimento, preferimos sideload. Após o desenvolvimento, você pode escolher o método de distribuição correto com base em se deseja distribuir para um locatário ou para todos os locatários.
Você também pode usar APIs de instalação de aplicativo do Teams para gerenciar instalações de aplicativo do Teams.
Enviar notificações de feed de atividades aos usuários
Como um aplicativo do Teams pode ser instalado para um usuário, em uma equipe ou em um chat, ele também pode enviar notificações nos três contextos a seguir:
- Enviar notificação ao usuário em um chat
- Enviar notificação ao usuário em uma equipe
- Enviar notificação ao usuário
Além disso, você pode enviar notificações em massa para até 100 usuários por vez:
Para encontrar detalhes sobre os tópicos com suporte para cada cenário, consulte as APIs específicas. Há suporte para tópicos baseados em texto personalizados para todos os cenários.
Você pode usar a notificação do feed de atividades nos seguintes cenários:
- Notifique os indivíduos sobre o conteúdo personalizado que requer sua atenção.
- Mostrar conteúdo avançado no aplicativo Tab ou na URL.
- Dá suporte a interações complexas do usuário.
- Envie notificações delegadas do usuário que iniciou a notificação.
- Coloque o modelo no manifesto do aplicativo.
- O Teams manipula a localização para notificações.
Observação
O ícone de atividade é baseado no contexto em que a solicitação é feita. Se a solicitação for feita com permissões delegadas, a foto do usuário será exibida como o avatar, enquanto o ícone do aplicativo teams será exibido como o ícone de atividade. Em um contexto somente aplicativo, o ícone do aplicativo teams é usado como o avatar e o ícone de atividade é omitido.
Personalizar as notificações
Os usuários do Microsoft Teams podem personalizar as notificações que veem no feed ou como uma faixa. As notificações geradas por meio de APIs de feed de atividades também podem ser personalizadas. Os usuários podem escolher como são notificados por meio de configurações no Microsoft Teams. Os aplicativos do Teams aparecem na lista para o usuário escolher, conforme mostrado na captura de tela a seguir.
Os usuários podem selecionar Editar ao lado de um aplicativo e personalizar as notificações. O manifesto do aplicativo exibe o description campo.
Exemplos
Para obter exemplos sobre como enviar uma notificação do feed de atividades, consulte enviar exemplos de notificação do feed de atividades.
Guias passo a passo
Siga o guia passo a passo para enviar notificações do feed de atividades no Teams.