Adicionar o aplicativo ao chat

Namespace: microsoft.graph

Instale um teamsApp para o chatespecificado.

Observações:

  • Se o chat estiver associado a uma instância do onlineMeeting, então, efetivamente, o teamsApp será instalado na reunião.

Essa API está disponível nas seguintes implantações nacionais de nuvem.

Serviço global Governo dos EUA L4 GOVERNO DOS EUA L5 (DOD) China operada pela 21Vianet

Permissões

Escolha a permissão ou as permissões marcadas como menos privilegiadas para essa API. Use uma permissão ou permissões privilegiadas mais altas somente se o aplicativo exigir. Para obter detalhes sobre permissões delegadas e de aplicativo, consulte Tipos de permissão. Para saber mais sobre essas permissões, consulte a referência de permissões.

Tipo de permissão Permissões menos privilegiadas Permissões privilegiadas mais altas
Delegado (conta corporativa ou de estudante) TeamsAppInstallation.ReadWriteSelfForChat TeamsAppInstallation.ManageSelectedForChat, TeamsAppInstallation.ReadWriteAndConsentForChat, TeamsAppInstallation.ReadWriteAndConsentSelfForChat, TeamsAppInstallation.ReadWriteForChat
Delegado (conta pessoal da Microsoft) Sem suporte. Sem suporte.
Application TeamsAppInstallation.ReadWriteSelfForChat.All Chat.Manage.Chat, TeamsAppInstallation.ManageSelectedForChat.All, TeamsAppInstallation.ReadWriteAndConsentForChat.All, TeamsAppInstallation.ReadWriteAndConsentSelfForChat.All, TeamsAppInstallation.ReadWriteForChat.All

Observação

Essas permissões TeamsAppInstallation.ReadWriteSelfForChat, TeamsAppInstallation.ReadWriteForChat, TeamsAppInstallation.ReadWriteSelfForChat.All e TeamsAppInstallation.ReadWriteForChat.All não podem ser usadas para instalar aplicativos que exigem consentimento para permissões específicas do recurso.

Solicitação HTTP

POST /chats/{chat-id}/installedApps

Cabeçalhos de solicitação

Cabeçalho Valor
Autorização {token} de portador. Obrigatório. Saiba mais sobre autenticação e autorização.
Content-Type application/json. Obrigatório.

Corpo da solicitação

O corpo da solicitação deve incluir a ID do aplicativo de catálogo gerada. Para obter mais informações, consulte propriedades teamsApp. A tabela a seguir lista outros parâmetros que podem ser usados com o corpo da solicitação.

Parâmetro Tipo Descrição
consentedPermissionSet teamsAppPermissionSet Conjunto de permissões específicas de recursos que estão sendo consentidas.

Nota: As permissões consentidas durante a instalação devem corresponder às permissões específicas do recurso definidas no teamsAppDefinition do aplicativo. Para obter o aplicativo e as permissões específicas do recurso delegadas, consulte Exemplo 7. Se apenas as permissões delegadas específicas do recurso forem especificadas no teamsAppDefinition, as permissões poderão ser omitidas no corpo da solicitação.

Resposta

Se tiver êxito, este método retornará um código de resposta 201 Created.

Exemplos

Exemplo 1: Instalar aplicativo em um chat

Solicitação

O exemplo a seguir mostra uma solicitação.

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

{
   "teamsApp@odata.bind":"https://graph.microsoft.com/v1.0/appCatalogs/teamsApps/12345678-9abc-def0-123456789a"
}

Resposta

O exemplo a seguir mostra a resposta.

HTTP/1.1 201 Created

Para obter a lista de permissões específicas do recurso exigidas pelo aplicativo, obtenha o aplicativo do appCatalog, conforme mostrado no Exemplo 7.

Solicitação

O exemplo a seguir mostra uma solicitação.

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

{
  "teamsApp@odata.bind" : "https://graph.microsoft.com/v1.0/appCatalogs/teamsApps/2b524e28-95ce-4c9b-9773-4a5bd6ec1770",
    "consentedPermissionSet": {
        "resourceSpecificPermissions": [
        {
          "permissionValue": "OnlineMeeting.ReadBasic.Chat",
          "permissionType": "Delegated"
        },
        {
          "permissionValue": "OnlineMeetingIncomingAudio.Detect.Chat",
          "permissionType": "Delegated"
        },
        {
          "permissionValue": "ChatMember.Read.Chat",
          "permissionType": "Application"
        },
        {
          "permissionValue": "ChatMessage.Read.Chat",
          "permissionType": "Application"
        }]
      }
}

Resposta

O exemplo a seguir mostra a resposta.

HTTP/1.1 201 Created