Conectar contas do Gmail usando o OAuth 2.0

Siga as etapas neste artigo para configurar a sincronização no servidor para enviar e receber emails em aplicativos de envolvimento de clientes (como Dynamics 365 Sales, Dynamics 365 Customer Service, Dynamics 365 Marketing, Dynamics 365 Field Service e Dynamics 365 Project Service Automation) de contas do Gmail usando o OAuth 2.0 como o mecanismo de autorização.

Observação

O perfil do servidor de Gmail OAuth funciona para até 100 usuários. Crie vários perfis do OAuth (etapas 1 a 4) se quiser associar o mesmo perfil a vários usuários.

Etapa 1. Habilitar IMAP ou POP no Gmail

Observação

Essas etapas devem ser realizadas pelo administrador do sistema.

Para IMAP, siga as etapas em Verificar o Gmail por meio de outras plataformas de email.

Para POP, siga as etapas em Ler mensagens do Gmail em outros clientes de email usando POP.

Etapa 2. Criar um projeto

Observação

Essas etapas devem ser realizadas pelo administrador do sistema.

Usando uma conta do Google (pode ser a mesma que você usará para enviar e recuperar emails, ou uma outra conta), vá para o Console de Desenvolvedores do Google e crie um novo projeto.

Siga as etapas para Criar um projeto em Criar, encerrar e restaurar projetos.

Observação

Essas etapas devem ser realizadas pelo administrador do sistema.

  1. Selecione Tela de consentimento do OAuth e escolha o tipo de usuário:

    • Selecione Interno se você estiver usando um locatário administrativo do GSuite e criar o aplicativo exclusivamente para sua organização.
    • Selecione Externo se você estiver testando com uma conta autônoma do Gmail.

    Captura de tela da Tela de consentimento do OAuth.

  2. Selecione Criar.

  3. Em Nome do aplicativo, insira o nome do aplicativo. Em Domínios autorizados, insira o nome do principal domínio privado do seu ambiente (por exemplo, dynamics.com). Selecione Salvar.

    Captura de tela de inserção do nome do aplicativo e do domínio.

  4. Selecione Credenciais>Criar credenciais.

    Captura de tela do comando Criar credenciais.

  5. Selecione ID do cliente do OAuth.

  6. Selecione Configurar tela de consentimento.

  7. Digite as seguintes configurações:

    Configuração Usar
    Tipo de aplicativo aplicativo da Web
    Nome O nome do seu cliente Web
    Origens de JavaScript autorizado A URL do seu ambiente (por exemplo, https://contoso.crm.dynamics.com)
    URIs de redirecionamento autorizados A URL do seu ambiente com /_grid/cmds/dlg_gmailoauth.aspx anexado a ela (por exemplo, https://contoso.crm.dynamics.com/_grid/cmds/dlg_gmailoauth.aspx)
  8. Selecione Criar. Na tela exibida, anote o ID do cliente e o segredo do cliente. Você usará estes dados na próxima etapa.

Etapa 4. Criar um perfil do servidor de email

  1. Entre no centro de administração do Power Platform.
  2. No painel de navegação, selecione Gerenciar.
  3. No painel Gerenciar, selecione Ambientes.
  4. Na página Ambientes , selecione um ambiente.
  5. Na barra de comando, selecione Configurações.
  6. Expanda E-mail e selecione Perfis de servidor.
  7. Na barra de comando, selecione Novo perfil de servidor.

No painel Configurar perfil do servidor :

  1. Em Tipo de servidor de e-mail, selecione Gmail e insira um Nome significativo para o perfil.

  2. Para definir este perfil de servidor como padrão para novas caixas de correio, ative Definir como perfil padrão para novas caixas de correio.

  3. Para Tipo de Autenticação, selecione Gmail OAuth.

  4. Digite o ID do cliente e o Segredo do cliente da etapa 8 do procedimento anterior.

    Observação

    Os campos Locais e portas são preenchidos automaticamente.

  5. Expanda Avançado e use as dicas de ferramentas para configurar suas opções de processamento de e-mail.

  6. Quando terminar, clique em Salvar.

Etapa 5. Configurar a caixa de correio

Observação

Essas etapas devem ser realizadas pelo usuário da caixa de correio.

  1. Em um aplicativo do Dynamics 365, clique em Configurações na barra de comandos superior e selecione Configurações avançadas.

  2. No grupo Sistema , selecione Configuração de e-mail e clique em Caixas de correio.

  3. Selecione a caixa de correio para o usuário configurado nas etapas anteriores.

  4. No painel Método de sincronização , insira as seguintes configurações:

    Configuração Usar
    Perfil do servidor O perfil criado na etapa 4
    Email de entrada Sincronização no Servidor ou E-mail Router
    Email de saída Sincronização no Servidor ou E-mail Router
  5. Selecione Salvar para aplicar as alterações.

  6. Selecione Entrar no Gmail.

  7. Siga as páginas de login e autorização do Gmail.

Etapa 6. Adicionar usuários de teste

No Google Cloud Platform (Console do Desenvolvedor), adicione usuários na seção Usuários de Teste ao publicar o aplicativo. Você pode aprender mais sobre como adicionar usuários de teste na Ajuda do Console do Google Cloud Platform.

Captura de tela de adição de usuários de teste.

Etapa 7. Testar e habilitar

Observação

Essas etapas devem ser realizadas pelo usuário da caixa de correio.

Selecione Testar e habilitar a caixa de correio para testar a caixa de correio configurada na etapa 6.

Captura de tela do comando Testar e Habilitar a Caixa de Correio.