Enviar Notificações do Microsoft Teams do Autonomous AI Database na Infraestrutura Dedicada do Exadata

Você pode configurar o Microsoft Teams para enviar mensagens, alertas ou saída de uma consulta do Autonomous AI Database na Infraestrutura Dedicada do Exadata para um canal do Microsoft Teams usando o pacote DBMS_CLOUD_NOTIFICATION.

Preparar-se para Enviar Notificações do Microsoft Teams do Autonomous AI Database

Comece configurando um bot no seu aplicativo do Microsoft Teams. Em seguida, crie uma credencial para usar com os procedimentos DBMS_CLOUD_NOTIFICATION para enviar notificações do Microsoft Teams do Autonomous AI Database.

Para configurar as notificações do Microsoft Teams:

  1. Crie seu aplicativo do Microsoft Teams e adicione um bot nele. Consulte Portal do Desenvolvedor para Equipes para obter informações sobre como configurar um aplicativo.

  2. Na seção Gerenciamento de Bots, certifique-se de que o bot tenha uma chave secreta, o escopo definido como Equipe e a permissão para enviar notificações.

  3. Publique o aplicativo em sua organização para disponibilizá-lo às pessoas em sua organização.

  4. Depois que o administrador de TI aprovar o aplicativo da central de administração, instale-o na seção Aplicativos do Teams.

  5. Solicite as permissões Files.ReadWrite.All e ChannelSettings.Read.All ao aplicativo para API de Gráfico no Portal do Azure usando as seguintes instruções:

    1. Faça log-in no Portal do Azure, navegue até o Azure Active Directory usando o painel esquerdo e selecione a opção Aplicativo.

    2. A página Aplicativo exibe os aplicativos que você possui junto com os bots adicionados a esses aplicativos. Clique no bot para exibir seus detalhes.

    3. Copie o id do diretório/tenant da página de visão geral do bot para uso posterior.

    4. Em seguida, vá para Permissões de API no painel esquerdo. Em Permissões de API, clique em Adicionar permissão, selecione Gráfico Microsoft e, em seguida, Permissão de aplicativo.

    5. Procure as permissões Files.ReadWrite.All e ChannelSettings.Read.All e adicione-as.

  6. Faça com que o administrador de TI aprove as permissões solicitadas acima no portal do Azure seguindo as etapas abaixo:

    1. Faça log-in no Portal do Azure, navegue até o Azure Active Directory usando o painel esquerdo e selecione a opção Aplicativo.

    2. Selecione Todos os aplicativos na página Aplicativo.

    3. Pesquise o aplicativo/bot por seu nome, vá para permissões de API e conceda o consentimento do ADMIN para as permissões solicitadas: Files.ReadWrite.All e ChannelSettings.Read.All.

    Dica: Depois que seu aplicativo for aprovado pelo Administrador de TI, você poderá fornecer o id do bot e a chave secreta a outros usuários para instalar o aplicativo dentro do Teams na organização.

  7. Depois que o aplicativo for aprovado pelo administrador de TI e as permissões solicitadas acima forem concedidas, você poderá usar o ID do bot do aplicativo e a chave secreta será usada para criar o objeto de credencial e gerar um token de bot.

  8. Para enviar um resultado de consulta a um canal do Microsoft Teams, obtenha o team id e o tenant id.

    Dica: O team id está localizado no link da equipe entre /team/ e /conversations. O tenant id fica após "tenantId=" no final do link da equipe. Esse link é encontrado clicando nos três pontos ao lado do nome da equipe e selecionando Obter link para a equipe.

    Por exemplo:

    https://teams.microsoft.com/l/team/teamID/conversations?groupId=groupid%tenantId=tenantid

  9. Obtenha o channelID.

    Dica: channelID está localizado no link do canal entre /team/ e o nome do canal. Esse link é encontrado clicando nos três pontos ao lado do nome do canal e selecionando Obter link para o canal.

    Por exemplo:

    https://teams.microsoft.com/l/channel/channelID/channel_name?groupId=groupid&tenantId=tenantid

  10. No Exadata Cloud@Customer, configure as definições do Proxy HTTP em seu ambiente para permitir que o banco de dados acesse o Microsoft Teams. Consulte Usando a Console para Provisionar o Exadata Database Service on Cloud@Customer para obter informações sobre como configurar as definições do Proxy HTTP ao criar uma Infraestrutura do Exadata Cloud@Customer.

    Observação: A configuração de rede, incluindo o Proxy HTTP, só poderá ser editada até que a Infraestrutura do Exadata esteja no estado Requer Ativação. Uma vez ativado, você não pode editar essas configurações.

    Para configurar um Proxy HTTP para uma Infraestrutura do Exadata já provisionada, submeta uma Solicitação de Serviço (SR) no My Oracle Support. Consulte Criar uma Solicitação de Serviço no My Oracle Support para obter detalhes.

  11. Crie um objeto de credencial para acessar o aplicativo Microsoft Teams no Autonomous AI Database.

    Dica: Se você não puder usar o procedimento CREATE_CREDENTIAL com sucesso, consulte o usuário ADMIN para conceder acesso de execução em pacotes DBMS_CLOUD.

    O nome de usuário da credencial é bot_id e a senha é a chave do bot.

    Por exemplo:

    BEGIN
    DBMS_CLOUD.CREATE_CREDENTIAL(credential_name => 'TEAMS_CRED',
        username        => 'bot_id',
        password        => 'bot_secret');
END;
/

    Consulte Procedimento CREATE_CREDENTIAL para obter mais informações.

Enviar Mensagens para um Canal do Microsoft Teams

Depois de criar o objeto de credencial do Microsoft Teams conforme descrito em Preparar para Enviar Notificações do Microsoft Teams do Autonomous AI Database, você poderá usar o procedimento DBMS_CLOUD_NOTIFICATION.SEND_MESSAGE para enviar uma mensagem a um canal do Microsoft Teams.

Exemplo:

BEGIN
     DBMS_CLOUD_NOTIFICATION.SEND_MESSAGE(
        provider        => 'msteams',
        credential_name => 'TEAMS_CRED',
        message         => 'text from new teams api',
        params          => json_object('channel' value 'channelID'));
END;
/

Use o parâmetro params para especificar o canal.

canal: especifica o ID do Canal obtido na Etapa 10 em Preparar para Enviar Notificações do Microsoft Teams do Autonomous AI Database.

Consulte Procedimento SEND_MESSAGE para obter mais informações.

Enviar Resultados da Consulta para um Canal do Microsoft Teams

Depois de criar o objeto de credencial do Microsoft Teams conforme descrito em Preparar para Enviar Notificações do Microsoft Teams do Autonomous AI Database, você pode usar o procedimento DBMS_CLOUD_NOTIFICATION.SEND_DATA para enviar a saída de uma consulta para um canal do Microsoft Teams.

Exemplo:

BEGIN
     DBMS_CLOUD_NOTIFICATION.SEND_DATA(provider => 'msteams',
        credential_name => 'TEAMS_CRED',
        query           => 'SELECT tablespace_name FROM dba_tablespaces',
        params          => json_object('tenant'value '5b743bc******c0286',
                                       'team'value '0ae401*********5d2bd',
                                       'channel'value '19%3a94be023*****%40thread.tacv2',
                                       'title'value 'today',
                                       'type'value 'csv'));
END;
/

Use o parâmetro params para especificar o tenant, a equipe, o canal, o título e o tipo de dados nos valores string.

Observação: O tamanho máximo do arquivo suportado ao usar DBMS_CLOUD_NOTIFICATION.SEND_DATA para o Microsoft Teams é de 4 MB.

Tópicos Relacionados