MyQ X Server

Configuração do Microsoft Exchange Online

Primeiro, configure o Microsoft Exchange Online no Microsoft Azure e, em seguida, configure-o no MyQ.


Pré-requisito: SMTP AUTH

O MyQ X envia e-mails usando SMTP com OAuth (XOAUTH2). Esse método requer que o SMTP AUTH esteja habilitado no Exchange Online.

Se o SMTP AUTH estiver desativado no nível do locatário ou da caixa de correio, o SMTP baseado em OAuth não funcionará e o MyQ X não poderá enviar e-mails.


Configuração do Microsoft Exchange Online no Microsoft Azure

  1. Faça login no portal do Microsoft Azure e acesse “Registros de aplicativos”.

    MS Azure - App registrations
  2. Crie um novo registro:

    image-20260528-084335.png
  3. Crie um aplicativo do Azure:

    1. Nome – O nome deste aplicativo (pode ser alterado posteriormente). Por exemplo, MS Exchange Online. É importante usar o mesmo nome utilizado no MyQ, na seção “Conexões”.

    2. Tipos de conta compatíveis — Quem pode usar este aplicativo ou acessar esta API? Selecione a opção “Apenas contas neste diretório organizacional (somente {nome do locatário} — locatário único)”. Aplicativos multilocatários também podem ser usados, se necessário, dependendo do público-alvo do aplicativo (qual conta será usada para autorização no MyQ).

    3. URI de redirecionamento (opcional) — A resposta de autenticação é retornada a esta URL após a autenticação bem-sucedida do usuário. Selecione a opção “Cliente público/nativo (celular e desktop)” no menu suspenso e preencha https://login.microsoftonline.com/common/oauth2/nativeclient como URI de redirecionamento.

    4. Clique em “Registrar”.

      image-20260528-084432.png
  4. A página de visão geral do novo aplicativo é aberta. Copie o ID do cliente e o ID do diretório (locatário), pois eles são necessários para a conexão com o MyQ.

    image-20260528-084532.png
  5. No menu à esquerda, clique em “Autenticação”. Em “Configurações avançadas”, na seção “Permitir fluxos de clientes públicos”, selecione “Sim” ao lado de “Ativar os seguintes fluxos para dispositivos móveis e computadores” e, em seguida, clique em “Salvar” na parte superior.

    image-20260528-084603.png
  6. No menu à esquerda, clique em “Permissões de API” e adicione as permissões adicionais necessárias para o funcionamento correto:

    1. Microsoft Graph: offline_access — Permite que o aplicativo visualize e atualize os dados aos quais você concedeu acesso, mesmo quando você não estiver usando o aplicativo no momento. Isso não concede ao aplicativo nenhuma permissão adicional.

    2. Microsoft Graph: User.Read – Efetuar login e ler o perfil do usuário.

    3. Microsoft Graph: IMAP.AccessAsUser.All – Permite que o aplicativo leia, atualize, crie e exclua e-mails da sua caixa de correio. Não inclui permissão para enviar e-mails.

    4. Microsoft Graph: SMTP.Send – Permite que o aplicativo envie e-mails em seu nome a partir da sua caixa de correio.

image-20250317-152928.png

Configuração do Microsoft Exchange Online no MyQ

  1. Faça login na interface de administração web do MyQ e acesse MyQ, Configurações, Conexões.

  2. Clique em +Adicionar e selecione Microsoft Exchange Online na lista.

  3. Na janela pop-up, preencha os campos obrigatórios:

    image-20250317-121002.png
    1. Título – Adicione o nome que você escolheu durante o registro do aplicativo no MS Azure; por exemplo, MS Exchange Online.

    2. ID do diretório (locatário) — O ID do diretório que você copiou durante a configuração do MS Azure.

    3. ID do aplicativo (cliente) — O ID do aplicativo que você copiou durante a configuração do MS Azure.

  4. Clique em OK.

  5. Após configurar a conexão no MyQ, você será solicitado a confirmar um código pelo site da Microsoft (https://microsoft.com/devicelogin). O código que você precisa confirmar é exibido na janela pop-up, logo abaixo do link para o site da Microsoft. Há um tempo limite para a confirmação do código (geralmente é de 15 minutos).

A funcionalidade de e-mail não funcionará até que a confirmação seja concluída com sucesso.

Essa confirmação deve ser feita com a conta da Microsoft proprietária da caixa de e-mail (endereço de e-mail) usada para se conectar ao Exchange (e-mail do remetente no MyQ, em Configurações, na guia Rede).

Por exemplo, se você usar o e-mail do remetente “print@somedomain.com”, precisará realizar a autenticação no site da Microsoft como esse usuário durante esta etapa.

O Microsoft Exchange Online agora está conectado ao MyQ e está pronto para ser usado na guia “Configurações de rede” como servidor SMTP de saída e, na guia “Configurações de trabalhos”, em “Trabalhos por e-mail”, como servidor POP3 ou IMAP.

Configurações adicionais

Enviar digitalização como o usuário conectado

Se o MyQ estiver configurado para enviar digitalizações como o usuário conectado em MyQ, Configurações, Digitalização e OCR - Configurações padrão de um e-mail com digitalização - Remetente, a caixa de correio com autenticação no MyQ deve ter permissão “Enviar como” para todos os usuários.

  1. Faça login no Centro de Administração do Exchange.

  2. Vá para “Caixas de correio” e selecione todos os usuários.

  3. Clique em “Delegação de caixa de correio”.

  4. Selecione a caixa de correio que passou pela autenticação no MyQ quando o conector do MS Exchange Online foi criado (você pode encontrá-la no MyQ, em Configurações, Conexões).

  5. Escolha a permissão “Enviar como”.

    Choosing the send as permission
  6. Clique em “Salvar”.

A caixa de correio selecionada para e-mails de saída agora recebeu os direitos para enviar documentos digitalizados em nome do usuário que os digitalizou.

Se você optar por enviar e-mails como remetente padrão, essa alteração não será necessária.