Compartilhar via


Enviar notificações do feed de atividades aos utilizadores no Microsoft Teams

O feed de atividades do Microsoft Teams notifica os utilizadores de alterações para permitir que façam a triagem de itens que necessitam de atenção. As notificações do feed de atividades no Teams incluem as seguintes funcionalidades:

  • A integração nativa com o Teams que coloca o utilizador na aplicação Tab de forma totalmente integrada e proporciona um envolvimento adicional do utilizador a partir do painel Atividade do Teams à sua aplicação.
  • Notificações do sistema operativo em clientes móveis e de ambiente de trabalho do Teams que incluem pop-up e som.
  • Conteúdo de notificação personalizável que lhe permite mostrar mais ou menos conteúdos de pré-visualização ao utilizador.
  • Capacidade de ligar o seu separador, aplicação pessoal, mensagem de bot ou Cartão Ajustável a uma notificação para aumentar o envolvimento do utilizador com a sua aplicação.
  • Capacidade de enviar notificações do feed de atividades para vários destinatários, como notificações em lote para um grupo de utilizadores.

Pode utilizar as APIs de notificação do feed de atividades no Microsoft Graph para expandir esta funcionalidade para as suas aplicações. Desta forma, pode proporcionar experiências mais avançadas e envolver os utilizadores ao ajudá-los a manterem-se atualizados com as alterações nas ferramentas e fluxos de trabalho que utilizam.

As APIs de notificação do feed de atividades no Microsoft Graph permitem os seguintes casos de utilização:

  • Notícias – mantenha os utilizadores atualizados com as informações mais recentes, como novas atribuições ou novas publicações.
  • Colaboração – mostre aos utilizadores uma pré-visualização na faixa de notificação quando alguém partilha um ficheiro ou @ os menciona num comentário.
  • Lembretes – envie notificações aos utilizadores sobre eventos ou tarefas.
  • Alertas – envie notificações que necessitem de atenção urgente ou imediata, como uma data para conclusão anterior ou um item de trabalho de alta prioridade.

Pode utilizar notificações do feed de atividades para fazer o seguinte:

  • Notifique as pessoas sobre conteúdo personalizado que requer a sua atenção.
  • Mostrar conteúdo avançado numa aplicação de tabulação ou URL.
  • Suporte a interações complexas do utilizador.
  • Envie notificações delegadas do utilizador que iniciou uma notificação.

O Teams processa a localização das notificações.

Componentes das notificações do feed de atividades

As notificações do feed de atividades no Teams são compostas por várias informações apresentadas em conjunto, conforme mostrado na imagem seguinte.

Imagem a mostrar os componentes de uma notificação do feed de atividades, incluindo ator, motivo, carimbo de data/hora, pré-visualização e tópico.

A tabela seguinte descreve os componentes.

Componente Descrição
Avatar Mostra quem iniciou a atividade.
Ícone da aplicação ou ícone personalizado O tipo de atividade. Para notificações de aplicações, mostra a origem (ícone da aplicação) ou o tipo de notificação (ícone personalizado).
Título: Ator + razão Ator é o nome do utilizador ou da aplicação que iniciou a atividade. O motivo descreve a atividade.
Carimbo de data/hora Mostra quando a atividade ocorreu.
Pré-visualização de texto Mostra uma linha truncada desde o início da notificação.
Tópico Recurso associado ou o valor de texto do tópico do corpo do pedido.

A imagem seguinte mostra um exemplo de uma notificação do feed de atividades no Teams. Neste exemplo, um utilizador partilhou uma publicação numa aplicação.

Uma imagem de uma notificação do feed de atividades do Yammer

Tipos de cartões de notificação do feed de atividades

Os separadores seguintes mostram os tipos de cartões de notificação do feed de atividades que pode apresentar. Para notificações geradas pela aplicação, o logótipo do utilizador é substituído pelo logótipo da aplicação.

Teams personalizado

Captura de ecrã que mostra as notificações do feed de atividades num ambiente de trabalho personalizado do Teams.

Windows

Captura de ecrã que mostra as notificações do feed de atividades num Teams de ambiente de trabalho do Windows.

Mac

Captura de ecrã que mostra as notificações do feed de atividades no Teams de ambiente de trabalho do Mac.

Requisitos para utilizar as APIs de notificação do feed de atividades

As APIs do feed de atividades funcionam com uma aplicação do Teams. Seguem-se os requisitos para enviar notificações do feed de atividades:

  • O manifesto da aplicação Teams tem de ter o ID da aplicação Microsoft Entra adicionado à webApplicationInfo secção. Para obter mais informações, veja o esquema do manifesto.
  • As notificações de atividade podem ser enviadas com ou sem tipos de atividade declarados no manifesto da aplicação.
    • Por predefinição, pode utilizar as APIs de notificação de atividade sem declarar a activities secção no manifesto. O systemDefault tipo de atividade é reservado, permitindo-lhe fornecer texto de forma livre na Actor+Reason linha da notificação do feed de atividades. Para obter mais informações, veja Enviar notificações personalizáveis do feed de atividades.
    • Se quiser enviar uma notificação com modelo no modo tradicional, os tipos de atividade têm de ser declarados na secção Atividades . Para obter mais informações, veja Esquema de manifesto.
  • A aplicação Teams tem de ser instalada para o destinatário, seja pessoalmente ou numa equipa ou chat do qual faça parte. Para obter mais informações, veja Instalação de aplicações do Teams.

Permissões

Pode utilizar permissões delegadas ou de aplicação para enviar notificações de atividade. Quando utiliza permissões de aplicação, recomendamos que utilize o consentimento específico do recurso (RSC), uma vez que a TeamsActivity.Send.User permissão permite ao utilizador consentir o envio de notificações de atividade. Tem de declarar permissões RSC no seu esquema de manifesto da aplicação Teams.

Atualizações do manifesto da aplicação Teams

Esta secção descreve as alterações que precisa de fazer ao manifesto da aplicação Teams para implementar notificações do feed de atividades. Tem de utilizar a versão 1.7 do manifesto da aplicação Teams ou superior.

"$schema": "https://developer.microsoft.com/json-schemas/teams/v1.7/MicrosoftTeams.schema.json",
"manifestVersion": "1.7",

atualização webApplicationInfo

Tem de atualizar Microsoft Entra id e resource informações na propriedade do manifesto webApplicationInfo da aplicação.

"webApplicationInfo":
{
    "id": "a3111f15-658e-457c-9689-fd20fe907330",
    "resource": "https://contosoapp.com"
}
Parâmetro Tipo Descrição
id string Microsoft Entra (ID de cliente).
recurso string Recurso associado à aplicação Azure AD. Também é conhecido como URI de resposta ou redirecionamento na descrição geral do registo de aplicações centro de administração do Microsoft Entra.

Observação

Poderá obter um erro se várias aplicações do Teams no mesmo âmbito (equipa, chat ou utilizador) utilizarem a mesma aplicação Microsoft Entra. Certifique-se de que está a utilizar aplicações Microsoft Entra exclusivas.

Atualização de atividades

Tem de definir a activities propriedade no manifesto da aplicação para publicar um feed de atividades do utilizador.

"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 O tipo tem de ser exclusivo num manifesto específico.
description string Descrição breve legível por humanos. A descrição está visível no cliente do Microsoft Teams.
templateText string Texto do modelo para a notificação de atividade. Pode declarar os parâmetros ao encapsular parâmetros entre parênteses {}retos.

Observação

  • actor é um parâmetro especial que utiliza sempre o nome do autor da chamada. Em chamadas delegadas, actor é o nome do utilizador. Nas chamadas apenas de aplicação, utiliza o nome da aplicação Teams.

  • O tipo de atividade reservada systemDefault não deve ser fornecido na activities secção do manifesto. O tipo de atividade reservada pode fornecer texto de forma livre na Actor+Reason linha da notificação do feed de atividades. Para obter mais informações, veja Enviar notificações personalizáveis do feed de atividades.

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 de permissão de consentimento específico do recurso (RSC).
nome string O nome da permissão RSC. Para obter mais informações, veja Supported RSC permissions (Permissões de RSC suportadas)

Instalar a aplicação Teams

As aplicações do Teams podem ser instaladas numa equipa, num chat ou para um utilizador pessoalmente e podem ser distribuídas de várias formas. Para obter detalhes, veja Métodos de distribuição de aplicações do Teams. Normalmente, o sideload é preferido para fins de desenvolvimento. Após o desenvolvimento, pode escolher o método de distribuição certo com base no facto de pretender distribuir por um inquilino ou todos os inquilinos.

Também pode utilizar APIs de instalação de aplicações do Teams para gerir instalações de aplicações do Teams.

Enviar notificações do feed de atividades aos utilizadores

Observação

Para mostrar notificações do feed de atividades em clientes iOS e Android, a aplicação tem de ser incluída na lista de permissões. Apenas são suportadas aplicações de terceiros.

Uma vez que uma aplicação do Teams pode ser instalada para um utilizador, numa equipa ou numa conversa, as notificações podem ser enviadas em três contextos. Para obter detalhes sobre como enviar notificações em cada contexto, veja os seguintes tópicos:

Além disso, as notificações podem ser enviadas em massa para até 100 utilizadores de cada vez. Para obter detalhes, consulte o seguinte tópico:

Para obter detalhes sobre que tópicos são suportados para cada cenário, veja as APIs específicas. Os tópicos personalizados baseados em texto são suportados para todos os cenários.

Observação

O ícone de atividade baseia-se no contexto em que o pedido é feito. Se o pedido for feito com permissões delegadas, a fotografia do utilizador é apresentada como o avatar, enquanto o ícone da aplicação Teams é apresentado como o ícone de atividade. Num contexto apenas de aplicação, o ícone da aplicação Teams é utilizado como avatar e o ícone de atividade é omitido.

Ícones de atividade personalizados em notificações do feed de atividades

Pode utilizar ícones de atividade personalizados em notificações do feed de atividades para ajudar os utilizadores a identificar facilmente a origem e a intenção da notificação. Uma notificação com um ícone de atividade personalizada adiciona uma sensação exclusiva e nativa do Teams, melhorando a interação do utilizador com a sua aplicação. A captura de ecrã seguinte mostra uma notificação do feed de atividades com um ícone de atividade personalizada.

A captura de ecrã mostra as notificações do feed de atividades com ícones de atividade personalizados.

Adicionar ícones de atividade personalizados nas notificações do feed de atividades

Os passos seguintes mostram como adicionar ícones de atividade personalizados nas notificações do feed de atividades enviadas a um utilizador:

  1. Adicione os ícones de atividade personalizada no pacote de aplicações do Teams. A seguinte captura de ecrã mostra um exemplo.

    A captura de ecrã mostra um pacote de aplicações do Teams com ícones de atividade personalizados para notificações do feed de atividades.

  2. Em manifest.json, defina manifestVersion como devPreview.

  3. Em activityTypes, declare uma lista de allowedIconIds para o tipo de atividade que pretende utilizar ícones personalizados.

  4. Declare uma lista de ícones em activityIcons. Cada ícone tem de ser definido com um ID e iconFile. O exemplo seguinte mostra um fragmento de código.

    "activities": {
      "activityTypes": [
        {
          "type": "announcementPosted",
          "description": "Announcement Created Activity",
          "templateText": "Alex Wilbur posted an announcement",
          "allowedIconIds": [
            "announcementCreated"
          ]
        },
        {
         "type": "reaction",
         "description": "reaction Activity",
         "templateText": "Adele Vance reacted to your post in channel",
         "allowedIconIds" : [
            "likeReaction",
            "smileReaction"
          ]
        }
      ],
      "activityIcons": [
        {
          "id": "announcementCreated",
          "iconFile": "announcement.png"
        },
        {
          "id": "likeReaction",
          "iconFile": "likeReaction.png"
        },
        {
          "id": "smileReaction",
          "iconFile": "smileReaction.png"
        }
      ]
    }
    

    Observação

    Não pode declarar mais de 50 ícones em cada tipo de atividade.

    Para obter mais informações sobre allowedIconIds e activityIcons, veja Esquema de manifesto da aplicação de pré-visualização do programador público do Teams.

  5. Chame o ponto final beta da API de notificações e inclua o atributo iconId no payload. O valor do iconId tem de corresponder a um dos IDs de ícone nos allowedIconIds para o tipo de atividade especificado.

    POST https://graph.microsoft.com/beta/users/0000000-0000-0000-0000-000000000000/teamwork/sendactivitynotification
    
    {
      "topic": {
        "source": "text",
        "value": "Loop thread",
        "webUrl": "https://teams.microsoft.com/l/loopthread/00:000000000000000000000000000.v2"
      },
      "activityType": "announcementPosted",
      "previewText": {
        "content": "new announcement posted"
      },
      "iconId" : "announcementCreated"
    }
    

Para obter as diretrizes de estrutura do ícone de atividade personalizada, veja Diretrizes de validação da Loja Teams para ícones personalizados.

Para experimentar ícones de atividade personalizados em notificações do feed de atividades no Teams, veja Aplicação de exemplo do feed de atividades do Microsoft Graph para JavaScript ou aplicação de exemplo de feed de atividades do Microsoft Graph para C#.

Exemplos

Exemplo 1: Notificar um utilizador sobre uma tarefa criada num chat

O exemplo seguinte mostra como pode enviar uma notificação do feed de atividades para uma nova tarefa criada num chat. Neste caso, a aplicação Teams tem de ser instalada numa conversa com o ID chatId e o utilizador 569363e2-4e49-4661-87f2-16f245c5d66a também tem de fazer parte do chat.

Solicitação

POST https://graph.microsoft.com/v1.0/chats/{chatId}/sendActivityNotification
Content-Type: application/json

{
    "topic": {
        "source": "entityUrl",
        "value": "https://graph.microsoft.com/v1.0/chats/{chatId}"
    },
    "activityType": "taskCreated",
    "previewText": {
        "content": "New Task Created"
    },
    "recipient": {
        "@odata.type": "microsoft.graph.aadUserNotificationRecipient",
        "userId": "569363e2-4e49-4661-87f2-16f245c5d66a"
    },
    "templateParameters": [
        {
            "name": "taskId",
            "value": "12322"
        }
    ]
}

Resposta

HTTP/1.1 204 No Content

Exemplo 2: Notificar um utilizador sobre uma tarefa criada numa equipa

O exemplo seguinte mostra como pode enviar uma notificação de feed de atividades para uma equipa. Este exemplo notifica o proprietário da equipa sobre uma nova tarefa criada que requer a sua atenção.

Solicitação

POST https://graph.microsoft.com/v1.0/teams/{teamId}/sendActivityNotification
Content-Type: application/json

{
    "topic": {
        "source": "entityUrl",
        "value": "https://graph.microsoft.com/v1.0/teams/{teamId}"
    },
    "activityType": "taskCreated",
    "previewText": {
        "content": "New Task Created"
    },
    "recipient": {
        "@odata.type": "microsoft.graph.aadUserNotificationRecipient",
        "userId": "569363e2-4e49-4661-87f2-16f245c5d66a"
    },
    "templateParameters": [
        {
            "name": "taskId",
            "value": "12322"
        }
    ]
}

Resposta

HTTP/1.1 204 No Content

Exemplo 3: Notificar um utilizador sobre um evento através de um tópico personalizado

Como mostram os exemplos anteriores, pode ligar a diferentes aspetos da equipa ou do chat. No entanto, se quiser ligar a um aspeto que não faça parte da equipa ou o Microsoft Graph não o representar ou se quiser personalizar o nome, pode definir a origem do topictext para e transmitir um valor personalizado para o mesmo. Além disso, webUrl é necessário quando utiliza topic a origem como text.

O exemplo de notificação do Yammer mostrado anteriormente utiliza um tópico personalizado porque o Microsoft Graph não suporta os recursos do Yammer.

Observação

webUrl tem de começar com o domínio do Microsoft Teams (teams.microsoft.com, por exemplo).

Solicitação

POST https://graph.microsoft.com/v1.0/teams/{teamId}/sendActivityNotification
Content-Type: application/json

{
    "topic": {
        "source": "text",
        "value": "Deployment Approvals Channel",
        "webUrl": "https://teams.microsoft.com/l/message/19:448cfd2ac2a7490a9084a9ed14cttr78c@thread.skype/1605223780000?tenantId=c8b1bf45-3834-4ecf-971a-b4c755ee677d&groupId=d4c2a937-f097-435a-bc91-5c1683ca7245&parentMessageId=1605223771864&teamName=Approvals&channelName=Azure%20DevOps&createdTime=1605223780000"
    },
    "activityType": "approvalRequired",
    "previewText": {
        "content": "New deployment requires your approval"
    },
    "recipient": {
        "@odata.type": "microsoft.graph.aadUserNotificationRecipient",
        "userId": "569363e2-4e49-4661-87f2-16f245c5d66a"
    },
    "templateParameters": [
        {
            "name": "deploymentId",
            "value": "6788662"
        }
    ]
}

Resposta

HTTP/1.1 204 No Content

Exemplo 4: Notificar os membros da equipa sobre um evento

O exemplo seguinte mostra como pode enviar uma notificação do feed de atividades a todos os membros da equipa. Este exemplo notifica os membros da equipa sobre um novo evento.

Solicitação

POST https://graph.microsoft.com/v1.0/teams/7155e3c8-175e-4311-97ef-572edc3aa3db/sendActivityNotification
Content-Type: application/json

{
    "topic": {
        "source": "text",
        "value": "Weekly Virtual Social",
        "webUrl": "https://teams.microsoft.com/l/message/19:448cfd2ac2a7490a9084a9ed14cttr78c@thread.skype/1605223780000?tenantId=c8b1bf45-3834-4ecf-971a-b4c755ee677d&groupId=d4c2a937-f097-435a-bc91-5c1683ca7245&parentMessageId=1605223771864&teamName=Approvals&channelName=Azure%20DevOps&createdTime=1605223780000"
    },
    "previewText": {
        "content": "It will be fun!"
    },
    "activityType": "eventCreated",
    "recipient": {
        "@odata.type": "microsoft.graph.teamMembersNotificationRecipient",
        "teamId": "7155e3c8-175e-4311-97ef-572edc3aa3db"
    }
}

Resposta

HTTP/1.1 204 No Content

Exemplo 5: Notificar os membros do canal sobre um evento

O exemplo seguinte mostra como pode enviar uma notificação do feed de atividades a todos os membros do canal. Este exemplo notifica os membros do canal sobre um novo evento.

Solicitação

POST https://graph.microsoft.com/v1.0/teams/7155e3c8-175e-4311-97ef-572edc3aa3db/sendActivityNotification
Content-Type: application/json

{
    "topic": {
        "source": "text",
        "value": "Weekly Virtual Social",
        "webUrl": "https://teams.microsoft.com/l/message/19:448cfd2ac2a7490a9084a9ed14cttr78c@thread.skype/1605223780000?tenantId=c8b1bf45-3834-4ecf-971a-b4c755ee677d&groupId=d4c2a937-f097-435a-bc91-5c1683ca7245&parentMessageId=1605223771864&teamName=Approvals&channelName=Azure%20DevOps&createdTime=1605223780000"
    },
    "previewText": {
        "content": "It will be fun!"
    },
    "activityType": "eventCreated",
    "recipient": {
        "@odata.type": "microsoft.graph.channelMembersNotificationRecipient",
        "teamId": "7155e3c8-175e-4311-97ef-572edc3aa3db",
        "channelId": "19:0ea5de04de4743bcb4cd20cb99235d99@thread.tacv2"
    }
}

Resposta

HTTP/1.1 204 No Content

Exemplo 6: Notificar os membros do chat sobre um evento

O exemplo seguinte mostra como pode enviar uma notificação do feed de atividades a todos os membros do chat. Este exemplo notifica os membros do chat sobre um novo evento.

Solicitação

POST https://graph.microsoft.com/v1.0/chats/19:d65713bc498c4a428c71ef9353e6ce20@thread.v2/sendActivityNotification
Content-Type: application/json

{
    "topic": {
        "source": "text",
        "value": "Weekly Virtual Social",
        "webUrl": "https://teams.microsoft.com/l/message/19:448cfd2ac2a7490a9084a9ed14cttr78c@thread.skype/1605223780000?tenantId=c8b1bf45-3834-4ecf-971a-b4c755ee677d&groupId=d4c2a937-f097-435a-bc91-5c1683ca7245&parentMessageId=1605223771864&teamName=Approvals&channelName=Azure%20DevOps&createdTime=1605223780000"
    },
    "previewText": {
        "content": "It will be fun!"
    },
    "activityType": "eventCreated",
    "recipient": {
        "@odata.type": "microsoft.graph.chatMembersNotificationRecipient",
        "chatId": "19:d65713bc498c4a428c71ef9353e6ce20@thread.v2"
    }
}

Resposta

HTTP/1.1 204 No Content

Exemplo 7: Notificar vários utilizadores sobre pedidos de aprovação de finanças pendentes

O exemplo seguinte mostra como enviar uma notificação do feed de atividades a vários utilizadores em massa. Este exemplo notifica vários intervenientes sobre pedidos de aprovação financeira pendentes.

Solicitação

POST https://graph.microsoft.com/v1.0/teamwork/sendActivityNotificationToRecipients
Content-Type: application/json

{
    "topic": {
        "source": "entityUrl",
        "value": "https://graph.microsoft.com/v1.0/appCatalogs/teamsApps/{teamsAppId}"
    },
    "activityType": "pendingFinanceApprovalRequests",
    "previewText": {
        "content": "Internal spending team has a pending finance approval requests"
    },
    "recipients": [
        {
            "@odata.type": "microsoft.graph.aadUserNotificationRecipient",
            "userId": "569363e2-4e49-4661-87f2-16f245c5d66a"
        },
        {
            "@odata.type": "microsoft.graph.aadUserNotificationRecipient",
            "userId": "ab88234e-0874-477c-9638-d144296ed04f"
        },
        {
            "@odata.type": "microsoft.graph.aadUserNotificationRecipient",
            "userId": "01c64f53-69aa-42c7-9b7f-9f75195d6bfc"
        }
    ],
    "templateParameters": [
        {
            "name": "pendingRequestCount",
            "value": "5"
        }
    ] 
}

Resposta

HTTP/1.1 202 Accepted

Exemplo 8: enviar uma notificação a um utilizador com o tipo de atividade systemDefault

O exemplo seguinte mostra como pode enviar uma notificação de atividade para uma equipa sem tipos de atividade definidos no manifesto. Tem a flexibilidade de fornecer texto de forma livre aqui. Para obter mais informações, veja Tipos de atividade reservadas.

Este exemplo notifica o proprietário da equipa para fazer uma pequena pausa. Modifique o value no templateParameters para personalizar a notificação para vários cenários.

Solicitação

POST https://graph.microsoft.com/v1.0/teams/{teamId}/sendActivityNotification
Content-Type: application/json

{
    "topic": {
        "source": "entityUrl",
        "value": "https://graph.microsoft.com/v1.0/teams/{teamId}"
    },
    "activityType": "systemDefault",
    "previewText": {
        "content": "Take a break"
    },
    "recipient": {
        "@odata.type": "microsoft.graph.aadUserNotificationRecipient",
        "userId": "569363e2-4e49-4661-87f2-16f245c5d66a"
    },
    "templateParameters": [
        {
            "name": "systemDefaultText",
            "value": "You need to take a short break"
        }
    ]
}

Resposta

HTTP/1.1 204 No Content

Tipos de atividade reservadas

O systemDefault tipo de atividade é reservado e não pode ser utilizado no manifesto ao declarar Atividades. Pode utilizar o systemDefault tipo de atividade para:

  • Teste facilmente novos cenários e/ou experimente rapidamente as APIs de notificação do feed de atividades sem definir tipos de atividade no manifesto da aplicação.
  • Para aplicações da Loja, poupe tempo e simplifique o processo, uma vez que não precisa de ajustar constantemente os tipos de atividade no manifesto da aplicação. O systemDefault tipo de atividade está pronto para ser utilizado a partir do get-go.

Tenha em atenção que, com o systemDefault tipo de atividade, não pode:

  • Utilize as funcionalidades de localização incorporadas fornecidas pelos manifestos.
  • Dependa do envio de notificações personalizáveis com o systemDefault tipo de atividade. Os utilizadores podem desativar todas as notificações da sua aplicação com um botão de alternar nas definições de cliente do Microsoft Teams, o que pode dificultar a comunicação entre a sua aplicação e os respetivos utilizadores.

Ainda recomendamos notificações com modelos para lotes recorrentes e grandes de notificações, uma vez que necessitam de modelos de atividade no manifesto.

O systemDefault tipo de atividade reservada permanece disponível, independentemente dos tipos de atividade listados no manifesto da sua aplicação.

Personalizar a forma como as notificações o alertam

Os utilizadores do Microsoft Teams podem personalizar as notificações que veem no respetivo feed, como uma faixa, etc. As notificações geradas através de APIs de feed de atividades também podem ser personalizadas. Os utilizadores podem escolher como são notificados através das definições no Microsoft Teams. As aplicações do Teams aparecem na lista que o utilizador pode escolher, conforme mostrado na seguinte captura de ecrã.

Captura de ecrã das definições de Notificações no Teams, com a opção Personalizada realçada

Os utilizadores podem escolher Editar junto a uma aplicação e personalizar as notificações, conforme mostrado no exemplo seguinte. O description campo no manifesto da aplicação Teams é apresentado.

Captura de ecrã a mostrar notificações personalizadas para Faixa e feed para uma aplicação do Teams

Perguntas Frequentes

Quem precisa de instalar a aplicação Teams?

O utilizador de destino tem de ter a aplicação Teams que está a enviar notificações instaladas.

Um utilizador pode enviar notificações para si próprio?

Não, um utilizador não pode enviar notificações para si próprio. Neste cenário, utilize permissões de aplicação.

Uma aplicação do Teams pode controlar a forma como as notificações são apresentadas ao utilizador?

Não, apenas os utilizadores podem alterar as definições de notificação.

Instalei a minha aplicação; por que motivo não vejo as definições de notificação na conta de utilizador?

As definições são apresentadas depois de a aplicação Teams enviar a primeira notificação. Isto reduz o número de definições que os utilizadores veem.

Comecei a receber um erro 409 (conflito) ; Como posso resolve?

Conflictos erros ocorrem principalmente quando várias aplicações do Teams instaladas no mesmo âmbito (equipa, chat, utilizador, etc.) têm o mesmo Microsoft Entra appId na webApplicationInfo secção do manifesto. Quando isto acontece, obtém um erro como Found multiple applications with the same Microsoft Entra App ID 'Your Microsoft Entra AppId'.. Certifique-se de que utiliza aplicações Microsoft Entra exclusivas para aplicações exclusivas do Teams. Pode instalar a mesma aplicação do Teams em vários âmbitos (equipa + utilizador, por exemplo).