Enviar Notificações do Microsoft Teams pelo Autonomous Database

Descreve como configurar o Microsoft Teams para que você possa enviar mensagens, alertas ou saída de uma consulta do Autonomous Database para um Canal do Microsoft Teams. Também descreve os procedimentos usados para enviar notificações do Microsoft Teams.

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

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

Para configurar 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 Bot, certifique-se de que o bot tenha uma chave secreta, um escopo definido como Equipe e uma 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 no centro de administração, instale-o na seção Aplicativos do Teams.
  5. Solicite as permissões Files.ReadWrite.All e ChannelSettings.Read.All para o aplicativo da API Graph 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 do aplicativo.
    5. Procure as permissões Files.ReadWrite.All e ChannelSettings.Read.All e adicione-as.
  6. Faça com que seu administrador de TI aprove as permissões solicitadas acima do 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 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 para que outros usuários instalem o aplicativo nas Equipes da 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 e a chave secreta do aplicativo para criar o objeto de credencial e gerar um token de bot.
  8. Para enviar um resultado de consulta para 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 está localizado depois de "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. Crie um objeto de credencial para acessar o aplicativo Microsoft Teams no Autonomous 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 nos 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 CREATE_CREDENTIAL Procedimento 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 Database, você pode 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.

Consulte SEND_MESSAGE Procedimento 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 Database, você pode usar o procedimento DBMS_CLOUD_NOTIFICATION.SEND_DATA para enviar a saída de uma consulta a um canal do Microsoft Teams.

Por 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 de arquivo suportado ao usar DBMS_CLOUD_NOTIFICATION.SEND_DATA para o Microsoft Teams é de 4 MB.

Consulte SEND_DATA Procedimento para obter mais informações.