Configurar seu canal de e-mail para OAuth com o Microsoft Office 365

Este documento mostra como configurar um canal de e-mail da Contact Center AI Platform (CCAI) para oferecer suporte ao OAuth da Microsoft.

Pré-requisitos

  1. Uma conta do Azure com uma assinatura ativa. A conta precisa ter acesso de gerenciamento do Microsoft Entra, então ela precisa ser configurada como um dos seguintes papéis:

    • Administrador de aplicativos
    • Desenvolvedor de aplicativos
    • Administrador de aplicativos do Cloud

  2. Um locatário do Microsoft Entra. Consulte o guia de início rápido da Microsoft para instruções sobre como criar um locatário.

Verificar se a conta de e-mail permite IMAP e SMTP

A plataforma CCAI usa IMAP e SMTP para enviar e receber e-mails da Microsoft. Como uma conta da Microsoft pode ser conectada a diferentes programas, é importante garantir que o IMAP ou SMTP não esteja bloqueado por outros programas secundários. As etapas a seguir mostram alguns lugares comuns para verificar na Microsoft.

  1. Acesse Usuários > Ativos no painel de navegação à esquerda.

  2. Selecione um usuário para verificar.

  3. Clique em E-mail. Se você vir a mensagem "Este usuário não tem uma licença do Exchange Online", será necessário conceder a ele uma licença adequada para usar o Exchange. Sem uma licença adequada, a plataforma CCAI não poderá enviar ou receber e-mails para essa conta de usuário.

  4. Depois de adicionar uma licença adequada, selecione Gerenciar apps de e-mail na guia E-mail. Verifique se o IMAP e o SMTP autenticado estão marcados.

  5. Clique em Salvar.

  6. Acesse Caixas de correio no painel de navegação à esquerda.

  7. Selecione a conta de usuário que você quer verificar.

  8. Na guia Geral, selecione Gerenciar configurações de apps de e-mail. Verifique se a opção IMAP está ativada.

Registrar um aplicativo

  1. Faça login no centro de administração do Microsoft Entra. Se você tiver vários locatários, use o filtro Diretórios + assinaturas para mudar para o locatário correto.

  2. Acesse Identidade > Aplicativos > Registros de aplicativos > Novo registro.

  3. Insira um nome de exibição identificável. Vários registros de apps podem compartilhar o mesmo nome. O ID do cliente é o que o programa usa para identificar o app. No entanto, como os usuários do programa podem ver o nome que você criou, isso pode acelerar o registro, a ele um nome exclusivo.

  4. Especifique o tipo de conta que pode usar o aplicativo ou o público de login. Vários tipos de conta são aceitos:

    1. Contas somente neste diretório organizacional: selecione essa opção se você estiver criando um aplicativo para uso exclusivo de usuários (ou convidados) em um único locatário. Isso às vezes é chamado de aplicativo de linha de negócios (LOB).

    2. Contas em qualquer diretório organizacional: selecione essa opção se você quiser que os usuários em qualquer locatário possam usar esse aplicativo. Essa opção é preferível para configurações de vários locatários.

    3. Contas em qualquer diretório organizacional e contas pessoais da Microsoft accounts: selecione essa opção se quiser que os usuários em qualquer locatário possam usar esse aplicativo, bem como usuários que têm contas pessoais da Microsoft.

    4. Contas pessoais da Microsoft: selecione essa opção se quiser criar um aplicativo apenas para usuários que têm contas pessoais da Microsoft. Inclui contas da Microsoft, Skype, Xbox, Live e Hotmail.

  5. Em URI de redirecionamento, selecione Web e insira https://{tenant}.ccaiplatform.com/v1/email_accounts/oauth_callback. Substitua {tenant}` pelo nome do locatário da plataforma CCAI.

  6. Clique em Registrar para concluir o registro inicial do app.

  7. Após a conclusão do registro, a tela Visão geral será exibida. Anote as informações a seguir, que serão necessárias para concluir o processo na plataforma CCAI:

    • ID do aplicativo (cliente)
    • ID do diretório (locatário)

Ativar o aplicativo

  1. Faça login no centro de administração do Microsoft Entra.

  2. Acesse Identidade > Aplicativos > Aplicativos empresariais e selecione o app.

  3. Acesse Propriedades.

  4. Ative a opção Visível para os usuários? para Sim.

Adicionar credenciais do aplicativo

Crie uma chave secreta do cliente para uso na plataforma CCAI.

  1. Faça login no centro de administração do Microsoft Entra.

  2. Acesse Identidade > Aplicativos > Registros de aplicativos e selecione o app.

  3. Acesse Certificados e chaves secretas > Chaves secretas do cliente > Nova chave secreta do cliente. Isso vai abrir um painel para você nomear a chave secreta.

  4. Adicione uma descrição para a chave secreta do cliente.

  5. Selecione uma data de validade para a chave secreta ou especifique um período personalizado. A vida útil da chave secreta do cliente é limitada a dois anos (24 meses) ou menos. No entanto, a Microsoft recomenda definir um valor de validade de menos de 12 meses.

  6. Clique em Adicionar. Anote o valor da chave secreta. Você vai precisar dele para concluir o processo na plataforma CCAI.

Adicionar permissões de API

A API Graph permite que os tokens de acesso funcionem com o IMAP, necessário para a operação do canal de e-mail da plataforma CCAI.

  1. Faça login no centro de administração do Microsoft Entra.

  2. Acesse Identidade > Aplicativos > Registros de aplicativos e selecione o app.

  3. Selecione Permissões de API > Adicionar uma permissão.

  4. Selecione Microsoft Graph.

  5. Selecione Permissões delegadas. Use a barra de pesquisa Selecionar permissões para realizar as seguintes pesquisas e marcar as caixas ao lado dos resultados adequados:

    • IMAP: marque IMAP.AccessAsUser.All
    • offline: Cochez offline_access
    • openid: marque openid
    • smtp: SMTP.Send

  6. Clique em Add permissions.

Adicionar credenciais à plataforma CCAI

Depois que a configuração da Microsoft for concluída, use as informações do processo de configuração para concluir a conexão entre os dois programas na plataforma CCAI. Acesse Configurações > Gerenciamento de contas de e-mail > SO de e-mail e insira as seguintes informações:

Tipo de acesso: deixe em branco.

URL de autorização: https://login.microsoftonline.com/{tenant_id}/oauth2/v2.0/authorize. {tenant_id} é o ID do diretório (locatário) do app da Microsoft.

URL do token: https://login.microsoftonline.com/{tenant_id}/oauth2/v2.0/token. {tenant_id} é o ID do diretório (locatário) do app da Microsoft.

ID do cliente: o ID do aplicativo (cliente) do app da Microsoft.

Chave secreta do cliente: o valor da chave secreta do cliente do app da Microsoft.

Escopo: insira os seguintes valores. Eles não precisam ser separados por vírgulas, mas precisam estar presentes.

  • openid email offline_access
  • https://outlook.office.com/IMAP.AccessAsUser.All
  • https://outlook.office.com/SMTP.Send

Estado: deixe em branco.

Tipo de acesso: deixe em branco.

Tipo de concessão: código de autorização

Desmarque "Incluir o tipo de concessão como parte da URL de autorização e da URL do token".

Marque "Incluir a URL de redirecionamento como parte da URL de autorização e da URL do token".

Clique em Salvar.