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ê quer | O que configurar |
|---|---|
| Os membros entram com a conta Microsoft e cada um tem a própria caixa de e-mail | cliente 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 delas | também o registro da organização |
| Você não quer a entrada com conta Microsoft | as 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ção | Registro da organização | |
|---|---|---|
| O que faz | a entrada dos membros com o botão Entrar com a Microsoft e o botão Conectar o Outlook na própria caixa de e-mail | o acesso do assistente às caixas de e-mail sem que os proprietários delas entrem |
| Onde fica no draften | Organização → Entrada e acesso aos e-mails → cartão Entrada com conta e conexão de caixas de e-mail | Organização → Entrada e acesso aos e-mails → cartão Registros para caixas compartilhadas e gestão central |
| Quem o configura no draften | o proprietário da organização | o proprietário ou um administrador da organização |
| Permissões no Entra | delegadas (Delegated) | de aplicativo (Application) |
| Quem entra na caixa de e-mail | o proprietário de cada caixa de e-mail, uma vez | ninguém |
| Quais caixas de e-mail alcança | só as que as próprias pessoas conectam | as caixas do diretório (dá para restringir) |
| Caixas compartilhadas | não – elas não têm login próprio | sim |
| Quando alguém sai da empresa | depois que a conta da pessoa é bloqueada, a caixa se desconecta | nada 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.
- 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/callbacke/mailboxes/connect/callback. Copie-as de lá; elas precisam coincidir caractere por caractere. - 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
- 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.
- Name – por exemplo
- Na página Overview, copie o Application (client) ID e o Directory (tenant) ID (ícone de copiar ao lado do valor).
- 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. - 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. - 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.ReadWriteeMailboxSettings.ReadWritee, embaixo, clique em Add permissions.User.Readcostuma já estar na lista desde a criação. Semoffline_accessa conexão não se mantém – o draften não receberia um token de atualização. - 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
- 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.
- 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.
- 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.
- Depois, Testar a conexão.
Quando a caixa de e-mail se desconecta
- O segredo do cliente expirou – no Entra, abra App registrations → o registro do cliente (por exemplo
draften – login) → Certificates & secrets → + New client secret e copie o Value. Salve-o no cartão Entrada com conta e conexão de caixas de e-mail e clique em Reconectar o Outlook nas caixas de e-mail. - A pessoa saiu ou a conta dela foi bloqueada – a Microsoft deixa de emitir tokens e o draften desconecta a caixa de e-mail. Uma caixa sem login próprio você conecta pelo registro da organização (abaixo).
- “O provedor não emitiu um token de atualização” – falta ao cliente a permissão
offline_access(passo 7). - “Entrou uma conta diferente do endereço da caixa de e-mail” – ao conectar, entre com a conta exatamente dessa caixa de e-mail; quem tem várias contas Microsoft no navegador escolhe a certa.
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.
- 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
- 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.
- Name – por exemplo
- Na página Overview, copie o Application (client) ID e o Directory (tenant) ID (ícone de copiar ao lado do valor).
- 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. - API permissions → + Add a permission → Microsoft Graph → Application permissions (não Delegated). Digite na busca e marque
Mail.ReadWriteeMailboxSettings.ReadWritee, embaixo, clique em Add permissions.MailboxSettings.ReadWriteserve só para a cor da categoria no Outlook; sem ela, a categoria é adicionada sem cor. Se quiser, adicioneUser.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. - 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
- 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.
- 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.
- 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:
- 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). - 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.
- 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 mensagem | O que significa | O que fazer |
|---|---|---|
AADSTS7000215, AADSTS7000222, invalid_client | client secret errado ou expirado | criar um novo segredo e salvá-lo no draften |
AADSTS700016, AADSTS90002, unauthorized_client | Application ID ou Directory ID errado | copiar de novo os dois IDs em Overview |
AADSTS65001, AADSTS650057, consent_required | falta o consentimento do administrador | Grant admin consent no aplicativo |
token sem Mail.ReadWrite | a permissão falta ou não foi consentida | adicionar a permissão e dar o consentimento |
invalid_grant, AADSTS50173, AADSTS700082, AADSTS70008 | a conexão com a conta expirou ou foi revogada | Reconectar o Outlook |
HTTP 403 AppOnly AccessPolicy | a caixa de e-mail não está no grupo da política de acesso | adicioná-la ao grupo e esperar |
| HTTP 404 | essa caixa de e-mail não existe | conferir o endereço; a caixa precisa ter Exchange Online |
| HTTP 401 | outro diretório, ou falta permissão | conferir o Directory ID e as permissões |
Outros erros estão em Solução de problemas.