Para administradores
← Todos os tópicos

Microsoft 365: conectar caixas de e-mail

A conexão com a conta da caixa de e-mail (cliente da organização) e, além disso, um registro para caixas compartilhadas – e o que configurar no Microsoft Entra, passo a passo.

Para ler os e-mails no Microsoft 365 e criar rascunhos neles, o assistente precisa de acesso pelo Microsoft Graph. Para isso, a organização registra um aplicativo no próprio Microsoft Entra ID; o draften não tem um aplicativo comum ao qual você só daria consentimento. Isso vale tanto para o nosso serviço quanto para a instalação no seu próprio servidor.

Tudo aqui vale só para contas corporativas e de estudante do Microsoft 365. As contas pessoais outlook.com, hotmail.com e live.com não podem ser conectadas de forma alguma – veja Provedores compatíveis e limitações.

O que você quer e o que configurar

O que você querO que configurar
Os membros entram com a conta Microsoft e cada um tem a própria caixa de e-mailcliente da organização – isso basta
Além disso, caixas compartilhadas (info@, vendas@), ou o acesso às caixas de e-mail configurado de forma central, sem os proprietários delastambém o registro da organização
Você não quer a entrada com conta Microsoftas pessoas entram com a senha do convite, e os e-mails são conectados pelo registro da organização (ou por IMAP)

Dois aplicativos diferentes

O cliente da organização e o registro da organização são dois aplicativos separados no Entra. Cada um faz uma coisa diferente, e um não substitui o outro:

Cliente da organizaçãoRegistro da organização
O que faza entrada dos membros com o botão Entrar com a Microsoft e o botão Conectar o Outlook na própria caixa de e-mailo acesso do assistente às caixas de e-mail sem que os proprietários delas entrem
Onde fica no draftenOrganização → Entrada e acesso aos e-mails → cartão Entrada com conta e conexão de caixas de e-mailOrganização → Entrada e acesso aos e-mails → cartão Registros para caixas compartilhadas e gestão central
Quem o configura no drafteno proprietário da organizaçãoo proprietário ou um administrador da organização
Permissões no Entradelegadas (Delegated)de aplicativo (Application)
Quem entra na caixa de e-mailo proprietário de cada caixa de e-mail, uma vezninguém
Quais caixas de e-mail alcançasó as que as próprias pessoas conectamas caixas do diretório (dá para restringir)
Caixas compartilhadasnão – elas não têm login própriosim
Quando alguém sai da empresadepois que a conta da pessoa é bloqueada, a caixa se desconectanada muda

São dois aplicativos de propósito. O consentimento para o cliente dá direitos só às caixas de e-mail que as próprias pessoas conectam – nunca aos e-mails de toda a organização. O registro da organização, ao contrário, alcança todas as caixas, e por isso o draften o usa só para o acesso às caixas de e-mail, nunca para a entrada. Não os junte em um só.

Cada caixa de e-mail usa um dos dois acessos. Você pode ter os dois aplicativos ao mesmo tempo: por exemplo, o cliente para a entrada e as caixas de e-mail próprias das pessoas, e o registro para a caixa compartilhada info@.

Nunca dê a nenhum dos dois aplicativos a permissão Mail.Send. O draften não envia nada e, sem essa permissão, nem consegue – e é exatamente essa a ideia.

Cliente da organização: entrada e Conectar o Outlook

O cliente tem permissões delegadas: o aplicativo só pode fazer o que a pessoa conectada pode, e só na caixa de e-mail dela. Você o cria uma vez; depois, os proprietários das caixas de e-mail se conectam sozinhos e não precisam mais do administrador do Entra.

No Microsoft Entra

Você trabalha no Microsoft Entra admin center, https://entra.microsoft.com, conectado com uma conta de administrador do seu diretório do Microsoft 365.

  1. No draften, abra primeiro Organização → Entrada e acesso aos e-mails, o cartão Entrada com conta e conexão de caixas de e-mail. Ele mostra duas redirect URIs exatamente para o endereço do seu draften – terminam em /auth/callback e /mailboxes/connect/callback. Copie-as de lá; elas precisam coincidir caractere por caractere.
  2. Abra a lista de registros de aplicativos: no menu à esquerda, Entra ID → App registrations (na versão mais antiga do menu, Identity → Applications → App registrations). Direto: https://entra.microsoft.com/#view/Microsoft_AAD_RegisteredApps/ApplicationsListBlade
  3. No alto, clique em + New registration e preencha:
    • Name – por exemplo draften – login,
    • Supported account types – Accounts in this organizational directory only (… only - Single tenant),
    • Redirect URI – na lista suspensa Select a platform, escolha Web e, ao lado, cole o primeiro endereço do cartão (termina em /auth/callback).

    Clique em Register. Abre-se a página do novo aplicativo.

  4. Na página Overview, copie o Application (client) ID e o Directory (tenant) ID (ícone de copiar ao lado do valor).
  5. No menu do aplicativo à esquerda, abra Authentication. Na plataforma Web, na parte Redirect URIs, clique em Add URI, cole o segundo endereço do cartão (termina em /mailboxes/connect/callback) e, embaixo, clique em Save.
  6. Certificates & secrets → aba Client secrets → + New client secret. Em Description, por exemplo draften; em Expires, escolha a validade (no máximo 24 meses) e clique em Add. Na tabela, copie na hora o valor da coluna Value – ele só aparece agora; o Secret ID o draften não precisa. Anote também a data da coluna Expires.
  7. API permissions → + Add a permission → Microsoft Graph → Delegated permissions. Digite na busca, um por um, e marque openid, profile, email, offline_access, User.Read, Mail.ReadWrite e MailboxSettings.ReadWrite e, embaixo, clique em Add permissions. User.Read costuma já estar na lista desde a criação. Sem offline_access a conexão não se mantém – o draften não receberia um token de atualização.
  8. Na mesma página, clique em Grant admin consent for … e confirme com Yes. Todas as linhas precisam ter a marca verde na coluna Status. Se a sua organização proíbe que os usuários consintam com aplicativos, sem este passo a conexão terminaria com a mensagem de que o consentimento foi recusado.

No draften

  1. O proprietário da organização abre Organização → Entrada e acesso aos e-mails e, no cartão Entrada com conta e conexão de caixas de e-mail, preenche em Registro no Entra para “Entrar com a Microsoft” e “Conectar o Outlook” os valores Application (client) ID (passo 4) e Client secret (passo 6) e clica em Salvar.
  2. A entrada com conta Microsoft ele ativa na mesma página, no cartão Como os membros entram: em ID do diretório Microsoft (Entra), coloca o Directory (tenant) ID. Assim que a organização tiver o cliente e o ID do diretório, os membros entram com a conta Microsoft e as senhas deles deixam de funcionar – veja Como os membros entram.
  3. O proprietário da caixa de e-mail abre a página da caixa e, no cartão Acesso aos e-mails, na linha Conectar com a conta da caixa de e-mail:, clica em Conectar o Outlook. Ele entra com a conta dessa caixa de e-mail – o draften recusa outra conta – e permite o acesso. Só o proprietário da caixa vê o botão, e só quando a organização tem o cliente; sem ele, o cartão mostra no lugar do botão que a conexão com a conta vai ser possível quando o proprietário da organização adicionar o cliente.
  4. Depois, Testar a conexão.

Quando a caixa de e-mail se desconecta

Registro da organização: acesso sem entrar

O registro tem permissões de aplicativo: o assistente tem acesso à caixa de e-mail sem que ninguém precise entrar. Ele serve para caixas compartilhadas e para organizações que querem gerenciar o acesso às caixas de e-mail de forma central. Não tem relação com a entrada no draften.

Você precisa de uma conta com o perfil administrador global ou administrador de funções com privilégios – só eles dão consentimento para permissões de aplicativo do Microsoft Graph. O registro em si também pode ser criado por um administrador de aplicativos.

No Microsoft Entra

Você trabalha no Microsoft Entra admin center, https://entra.microsoft.com.

  1. Abra a lista de registros de aplicativos: no menu à esquerda, Entra ID → App registrations (na versão mais antiga do menu, Identity → Applications → App registrations). Direto: https://entra.microsoft.com/#view/Microsoft_AAD_RegisteredApps/ApplicationsListBlade
  2. No alto, clique em + New registration e preencha:
    • Name – por exemplo draften – e-mails,
    • Supported account types – Accounts in this organizational directory only (… only - Single tenant),
    • Redirect URI – deixe vazio.

    Clique em Register. Abre-se a página do novo aplicativo.

  3. Na página Overview, copie o Application (client) ID e o Directory (tenant) ID (ícone de copiar ao lado do valor).
  4. No menu do aplicativo à esquerda, Certificates & secrets → aba Client secrets → + New client secret. Em Description, por exemplo draften; em Expires, escolha a validade (no máximo 24 meses) e clique em Add. Na tabela, copie na hora o valor da coluna Value – ele só aparece agora; o Secret ID o draften não precisa. Anote também a data da coluna Expires.
  5. API permissions → + Add a permission → Microsoft Graph → Application permissions (não Delegated). Digite na busca e marque Mail.ReadWrite e MailboxSettings.ReadWrite e, embaixo, clique em Add permissions. MailboxSettings.ReadWrite serve só para a cor da categoria no Outlook; sem ela, a categoria é adicionada sem cor. Se quiser, adicione User.Read.All – com ela o draften verifica os aliases da caixa de e-mail; sem ela, o teste de conexão avisa, nos aliases, que não consegue verificá-los.
  6. Na mesma página, clique em Grant admin consent for … e confirme com Yes. Todas as linhas precisam ter a marca verde na coluna Status.

No draften

  1. Abra Organização → Entrada e acesso aos e-mails, o cartão Registros para caixas compartilhadas e gestão central. Os registros são gerenciados pelo proprietário ou por um administrador da organização.
  2. Sistema: Microsoft 365 (Entra). Preencha Nome, Directory (tenant) ID, Application (client) ID, Client secret (o valor do passo 4, não o ID dele) e O segredo expira. Clique em Adicionar registro. O segredo é guardado criptografado e nunca mais é exibido.
  3. Um registro sozinho não conecta nada. Na página de cada caixa de e-mail, no cartão Acesso aos e-mails, escolha este registro em Registro da organização, clique em Aplicar e depois em Testar a conexão. A escolha só aparece para quem é ao mesmo tempo proprietário da caixa de e-mail e proprietário ou administrador da organização (o proprietário da organização é proprietário de todas as caixas). O procedimento completo, com capturas de tela, está no guia Adicionar e conectar uma caixa de e-mail.

Com a caixa de e-mail automática ativada (Como os membros entram), uma nova caixa de e-mail é vinculada sozinha ao registro quando há exatamente um ativo para o Microsoft 365.

Restringir a caixas de e-mail escolhidas (opcional)

A permissão de aplicativo alcança todas as caixas de e-mail do diretório; quem faz a guarda é o draften (um membro não consegue adicionar uma caixa de e-mail; o assistente não envia nem apaga nada). Quem quiser também uma barreira técnica restringe o aplicativo a um grupo de segurança com a política ApplicationAccessPolicy no Exchange Online. Você precisa do PowerShell e da função de administrador do Exchange (ou de administrador global).

Passo 1 – módulo do Exchange Online. Instale-o uma vez: abra o PowerShell como administrador do computador e digite:

Install-Module ExchangeOnlineManagement

Passo 2 – grupo e política. Entre no Exchange Online, crie um grupo de segurança com as caixas de e-mail que o draften pode acessar e uma política que restrinja o aplicativo só a esse grupo. No lugar de <Application (client) ID>, coloque o ID do registro do passo 3 acima; no lugar dos endereços, as suas caixas de e-mail:

Connect-ExchangeOnline -UserPrincipalName admin@<tenant>.onmicrosoft.com
New-DistributionGroup -Name "draften - caixas permitidas" -Alias draften-caixas -Type Security -Members caixa@firma.cz
New-ApplicationAccessPolicy -AppId <Application (client) ID> -PolicyScopeGroupId draften-caixas@firma.cz -AccessRight RestrictAccess -Description "draften: só caixas permitidas"

Passo 3 – verificação. Para uma caixa de e-mail do grupo, o comando deve mostrar AccessCheckResult : Granted; para uma caixa fora do grupo, Denied:

Test-ApplicationAccessPolicy -Identity caixa@firma.cz -AppId <Application (client) ID>

Uma caixa de e-mail adicional você coloca depois no grupo pelo Exchange admin center (https://admin.exchange.microsoft.com → Recipients → Groups) ou com o comando Add-DistributionGroupMember -Identity draften-caixas@firma.cz -Member outra@firma.cz. Uma caixa fora do grupo falha no teste de conexão com o erro 403 (AppOnly AccessPolicy). A política costuma entrar em vigor em até uma hora; já vimos levar quatro horas. Como alternativa mais nova, a Microsoft oferece o RBAC for Applications no Exchange Online; esse ainda não descrevemos aqui.

Troca do segredo

O segredo tem validade limitada, e o draften não manda nenhum aviso sobre o fim dela – a data no cartão fica amarela 30 dias antes de expirar e, depois, vermelha. Coloque um lembrete na sua agenda. Antes que ele expire:

  1. No Entra, abra App registrations → o seu registro (por exemplo draften – e-mails) → Certificates & secrets → + New client secret e copie o novo Value (como no passo 4 acima).
  2. No draften, em Organização → Entrada e acesso aos e-mails, escolha Novo segredo no registro e informe o novo valor e a nova data.
  3. Apague o segredo antigo no Entra com o ícone de lixeira na linha dele.

Se o segredo expirar antes, as caixas de e-mail se desconectam (invalid_client) e os assistentes as pulam. Depois de trocar o segredo, execute Testar a conexão nas caixas de e-mail – um teste bem-sucedido reativa a caixa.

Erros do teste de conexão

O teste verifica três etapas: Acesso, Token e permissão e Leitura da Caixa de Entrada. Cada uma recebe uma marca de confirmação ou um X com o motivo:

Na mensagemO que significaO que fazer
AADSTS7000215, AADSTS7000222, invalid_clientclient secret errado ou expiradocriar um novo segredo e salvá-lo no draften
AADSTS700016, AADSTS90002, unauthorized_clientApplication ID ou Directory ID erradocopiar de novo os dois IDs em Overview
AADSTS65001, AADSTS650057, consent_requiredfalta o consentimento do administradorGrant admin consent no aplicativo
token sem Mail.ReadWritea permissão falta ou não foi consentidaadicionar a permissão e dar o consentimento
invalid_grant, AADSTS50173, AADSTS700082, AADSTS70008a conexão com a conta expirou ou foi revogadaReconectar o Outlook
HTTP 403 AppOnly AccessPolicya caixa de e-mail não está no grupo da política de acessoadicioná-la ao grupo e esperar
HTTP 404essa caixa de e-mail não existeconferir o endereço; a caixa precisa ter Exchange Online
HTTP 401outro diretório, ou falta permissãoconferir o Directory ID e as permissões

Outros erros estão em Solução de problemas.

Versão em texto