LinkedIn
Instagram
Telegrama
Google Agenda
Participe da comunidade do SlackConectar e Sincronizar Outlook 365 Caixas de correio via API
Incorpore recursos poderosos de e-mail em seu aplicativo usando a API de E-mail do Outlook. Leia, envie, sincronize e reaja a e-mails do Outlook e do Microsoft 365 por meio de uma única interface REST suportada pelo Microsoft Graph, sem precisar gerenciar fluxos OAuth.
const response = await fetch(
https://${DSN}/api/v1/emails,
{
cabeçalhos: {
'X-API-KEY'chave de API,
'id_da_conta': outlookAccountId
}
}
);
const e-mails = await resposta.json();
// emails.items, array de mensagens do Outlook
// funciona para Outlook, Gmail e IMAP
Qual é a API de E-mail do Outlook?
O API de Email do Outlook é uma interface RESTful que fornece aos desenvolvedores acesso programático aos dados da caixa de correio do Outlook e do Microsoft 365. Construída sobre Microsoft Graph, ele permite que seu aplicativo leia, envie, organize e sincronize e-mails em qualquer conta do Outlook ou Exchange Online - usando OAuth 2.0 para autenticação segura delegada pelo usuário. Desenvolvedores integram a API de E-mail do Outlook para construir clientes de e-mail, mecanismos de sincronização de CRM, ferramentas de ATS e automação de prospecção sem expor credenciais do usuário.
Por que integrar a API de E-mail do Outlook ao seu aplicativo?
Integrar a API de Email do Outlook em seu aplicativo oferece aos seus usuários acesso direto à caixa de correio do Microsoft 365 dentro do seu produto, sem troca de abas ou cópia e cola manual. Aqui estão as quatro funcionalidades principais que as equipes mais frequentemente desbloqueiam.
API do Microsoft Outlook para sua Solução de CRM
Sincronize conversas do Outlook em pipelines de vendas e registros de clientes
Sincronizar E-mail do Outlook com Sistemas de Rastreamento de Candidatos
API do Microsoft Graph para plataformas de recrutamento e software de RH
Perspectivas
Sincronizar a API do Outlook para Ferramentas de Divulgação
Potencialize plataformas de engajamento de vendas multicanal com o Microsoft Graph
Integrar a API de Email do Outlook ao seu software de prospecção oferece às equipes de vendas uma única fonte de verdade para cada interação com prospects. As conversas permanecem sincronizadas, os acompanhamentos são disparados automaticamente e os dados de engajamento são enviados diretamente para seus painéis.
Configurando o Microsoft OAuth para a API de E-mail do Outlook
Documentação do Microsoft OAuthPor padrão, sua integração usa as credenciais OAuth da Unipile. Para obter um experiência totalmente branca de marca quando usuários finais conectam sua caixa de correio do Outlook ou Microsoft 365, registram seu próprio aplicativo em Microsoft Entra ID. Siga o 7 passos abaixo para criar o registro, configurar permissões e conectá-lo à API de E-mail do Outlook em seu espaço de trabalho Unipile.
Criar uma conta do Microsoft Entra ID
Se ainda não tiver uma, crie uma conta gratuita Microsoft Entra ID Conta (anteriormente Azure Active Directory). Este é o portal de administração onde você registra o aplicativo OAuth que alimenta sua integração com a API de E-mail do Outlook.
Registrar um novo aplicativo no portal do Azure
Faça login em portal.azure.com, abrir Microsoft Entra ID, e clique Nova inscrição.
- Nome do seu aplicativo: este nome aparece na tela de consentimento do OAuth da Microsoft exibida aos seus usuários finais.
- Tipos de conta suportados: selecione "Contas em qualquer diretório organizacional (qualquer Microsoft Entra ID, multilocatário) e contas pessoais da Microsoft" para que você possa conectar caixas de correio do Microsoft 365 corporativo e pessoal do Outlook.
Adicionar URIs de redirecionamento
Abrir a Autenticação painel e clique Adicionar URI na seção Web. Adicionar 2 URIs de redirecionamento usando seu DSN Unipile (disponível em Painel de controle da Unipile, canto superior direito):
https://{{YOUR_DSN_less_port}}/api/v1/hosted/microsoft_auth_request_callback/port{{YOUR_PORT}}
Configurar permissões do Microsoft Graph
Ir Permissões da API > Adicionar uma permissão > Microsoft Graph, então adicione o seguinte Permissões delegadas para a API de Email do Outlook:
Para os recursos do Calendário, adicione também Calendars.ReadWrite, Calendars.Read, Calendars.Read.Shared e Calendars.ReadWrite.Shared, em seguida, habilite-os nas configurações de escopos do seu Painel Unipile.
Criar um segredo do cliente
Aberto Certificados e segredos, clique Novo segredo do cliente. Dê uma descrição ao segredo e defina um prazo de vencimento 730 dias (24 meses), então clique em "Adicionar".
Conecte seu aplicativo ao Painel Unipile
Abrir a Painel de controle da Unipile e navegue para Configurações > Microsoft OAuth.
- Copie e cole o ID do Cliente (Aplicação) da página Visão Geral do Azure.
- Cole o valor secreto da página Certificates & secrets.
- Clicar Salvar.
Teste a conexão
No Painel Unipile, inicie um novo link de conta Microsoft para verificar se suas credenciais OAuth personalizadas funcionam de ponta a ponta. Você deverá ver sua Nome do aplicativo e branding dentro do prompt de consentimento da Microsoft em vez dos padrões da Unipile.
8
Torne-se um editor verificado
Recomendado para produção - remove o aviso "não verificado" na tela de consentimento
Com a verificação do editor, uma marca azul de seleção aparece no prompt de consentimento do OAuth. Sem ela, contas empresariais do Microsoft 365 podem ver um aviso de "editor não verificado" que prejudica sua conversão de cadastro.
Passo 1: participe da Microsoft Partner Network
- Cadastre-se em parceiro.microsoft.com e escolha o Microsoft AI Cloud Partner Program.
- Se você precisar de uma conta de trabalho, criar novo inquilino primeiro.
Passo 2: verifique seu domínio
Criar um arquivo chamado microsoft-identity-association.json e hospedá-lo em:
Passo 3: vincule seu ID da Conta Global de Parceiro (PGA)
- Encontre seu ID PGA via Central de Parceiros.
- No Portal do Azure, vá para Registros de aplicativos > Seu aplicativo > Branding e propriedades, insira o ID PGA e salve.
Para mais detalhes, consulte o Documentação de Verificação do Microsoft Publisher.
9
Aprovação do administrador necessária"
Quando usuários finais veem um bloco de consentimento de seu administrador do Microsoft 365
Se um usuário final vir "Aprovação do administrador necessária" ao conectar sua caixa de correio do Outlook, o consentimento necessário não foi concedido no nível do locatário. Dois caminhos para resolver:
Método 1: solicitação de consentimento do administrador dentro do Microsoft Entra
Um administrador do Microsoft 365 revisa e aprova a solicitação de consentimento de administrador pendente. Veja a Documentação da Microsoft sobre a revisão de solicitações de consentimento de administrador.
Método 2: Login OAuth como administrador com consentimento do tenant completo
- O administrador inicia o fluxo de login OAuth a partir do seu aplicativo.
- Durante a autorização da Microsoft, o administrador deve marcar "Consentimento em nome da sua organização".
- Isso concede consentimento para todos os usuários no locatário e impede o prompt para qualquer conexão futura da API de E-mail do Outlook.
Detalhes completos em Guia de solução de problemas de consentimento da Microsoft.
Aumente a Produtividade com os Recursos da API de E-mail do Outlook
Aumente a produtividade dos seus usuários aproveitando os recursos da API de E-mail do Outlook, permitindo o gerenciamento perfeito de e-mails, fluxos de trabalho automatizados e sincronização em tempo real para que eles possam se concentrar no que realmente importa.
POST /api/v1/emails { "id_da_conta": "acc_outlook_...", "para": [{"identificador": "lead@acme.com"}], "assunto": "Introdução rápida", "corpo": "Oi {{first_name}}..." }
Inbox
// Novo evento de e-mail entregue ao seu endpoint { "evento": "posta.recebida", "id_da_conta": "acc_outlook_...", "id_do_email": "em_8FdK2...", "de": "sarah@acme.com", "carimbo de data/hora": "18-05-2026T09:42:11Z" }
Comparar Outlook com Gmail e IMAP
| Recurso |
Perspectivas |
Gmail |
IMAP |
|---|---|---|---|
| Conexão de conta | |||
| Autenticação hospedada | |||
| Autenticação personalizada | |||
| OAuth | |||
| Credenciais | |||
| Enviar / Receber | |||
| Enviar / Responder Email | |||
| Lista de e-mails | |||
| Criar Rascunho de E-mail | |||
| Organize | |||
| Excluir e-mail | |||
| Mover e-mail | |||
| Listar pastas | |||
| Obter pasta | |||
| Webhooks | |||
| Novo e-mail | |||
| Rastreamento de aberturas e cliques | |||
Construa sua integração com a API de E-mail do Outlook hoje mesmo
Teste grátis incluído - não é necessário cartão de crédito. Conecte sua primeira conta do Outlook em menos de 5 minutos.
Amostras de Código da API de E-mail do Outlook: Node.js, Python e cURL
Os exemplos abaixo chamam o endpoint unificado da API de E-mail do Outlook da Unipile. Uma chave de API, uma URL base - funciona para Outlook, Gmail e IMAP sem alterar seu código. Substitua SEU_DSN e SUA_CHAVE_API com os valores do seu Painel Unipile.
// Ler e-mails de uma conta Outlook vinculada via API de E-mail Outlook da Unipile
const áxis = require('axios');
const DSN = 'api1.unipile.com:13211';
const CHAVE_API = 'SUA_CHAVE_DE_API';
const ID_ACC = 'ID_DA_CONTA_OUTLOOK'; // de POST /accounts após OAuth
async function listarEmailsDoOutlook() {
const res = await axios.obter(
https://\${DSN}/api/v1/emails,
{
cabeçalhos: {
'X-API-KEY': CHAVE_DE_API,
'id_da_conta': ID_ACC
}
}
);
console.log(res.data.items); // array de mensagens do Outlook
}
// Enviar um e-mail via API de E-mail do Outlook
async function enviarEmailOutlook() {
await axios.postagem(
https://\${DSN}/api/v1/emails,
{
account_id: ID_CONTA,
para: [{ nome_de_exibição: 'Alice', identificador: 'alice@contoso.com' }],
assunto: 'Olá da API de E-mail do Outlook',
corpo: 'Enviado via API de E-mail do Unipile Outlook.
'
},
{ cabeçalhos: { 'X-API-KEY': CHAVE_DA_API } }
);
}# Ler e enviar e-mails por meio da API de e-mail do Unipile Outlook
import solicitações
DSN = "api1.unipile.com:13211"
CHAVE_API = "SUA_CHAVE_DE_API"
ID_ACC = "ID_DA_CONTA_OUTLOOK"
CABEÇALHOS = {
"X-API-KEY": CHAVE_DE_API,
"id_da_conta": ID_CONTA,
}
#: Lista de e-mails do Outlook
def listar_e-mails():
r = pedidos.obter(
f"https://{DSN}/api/v1/emails",
cabeçalhos=CABEÇALHOS
)
r.raise_for_status()
return r.json()["itens"]
# Enviar via API de e-mail do Outlook
def enviar_email(para_addr, assunto, corpo):
r = pedidos.postagem(
f"https://{DSN}/api/v1/emails",
cabeçalhos={"X-API-KEY": API_KEY},
json={
"id_da_conta": ID_CONTA,
"para": [{"identificador": [endereço_de_destino}],
"assunto": assunto,
"corpo"corpo
}
)
r.raise_for_status()
return r.json()#: Listar e-mails da conta do Outlook vinculada
enrolar -s -X GET \
"https://api1.unipile.com:13211/api/v1/emails" \
-H "X-API-KEY: SUA_API_KEY" \
-H "id_da_conta: OUTLOOK_ACCOUNT_ID" \
| jq '.items[] | {id, subject, from, date}'
# Enviar e-mail por meio da API de e-mail do Outlook
enrolar -s -X POST \
"https://api1.unipile.com:13211/api/v1/emails" \
-H "X-API-KEY: SUA_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"account_id": "ID_DA_CONTA_OUTLOOK",
"para": [{"identificador": "alice@contoso.com"}],
"assunto": "Olá da API de E-mail do Outlook",
"corpo"Enviado via Unipile.
"
}'Microsoft Graph Nativo vs. API Unificada de Email do Outlook (Unipile)
Descubra as vantagens claras de alavancar a integração simplificada da API de E-mail do Outlook da Unipile em comparação com o desenvolvimento direto no Microsoft Graph. Use o Hosted Auth para reforçar a segurança por meio do gerenciamento aprimorado de credenciais, garantir a integração perfeita com o Outlook e outras plataformas de e-mail, e reduzir a sobrecarga da manutenção de fluxos OAuth.
| Dimensão | API nativa do Microsoft Graph | API de E-mail da Unipile Outlook |
|---|---|---|
| Escopo de integração | Outlook / Exchange Online somente | Outlook + Gmail + IMAP, mesmo código |
| Configuração do fluxo OAuth | Registro de Aplicativo do Azure + gerenciamento de token por locatário | Um link de autenticação hospedado, página OAuth de marca branca, zero código de token |
| Atualização de token | Seu código deve ser atualizado a cada 60 minutos (tempo de vida do token de acesso) | Unipile gerencia atualizações automaticamente para todas as contas vinculadas |
| Renovação de Webhook | As assinaturas expiram em 4.230 minutos, você deve renovar antes do vencimento | Unipile renova assinaturas do Graph automaticamente |
| Tratamento de limitação | Deve implementar lógica de retentativa 429 e backoff exponencial manualmente | Retentativa e gerenciamento de limite de taxa integrados |
| Tempo para o primeiro e-mail | 2-5 dias (configuração do Azure + OAuth + lógica de token + tratamento de erros) | Menos de 2 horas (siga este guia) |
| Desativação do Exchange Online | É preciso migrar do EWS para o Graph antes do prazo de outubro de 2026 | A Unipile já utiliza Graph, a migração é transparente |
| Suporte | Documentação da Microsoft + fóruns | Suporte técnico ao vivo + chamada com o fundador sob demanda |
Autenticação Hospedada em Um Link vs. Fluxo OAuth Completo
O Hosted Auth da Unipile automatiza a detecção de provedores de e-mail e cuida da autenticação. Isso reduz significativamente a complexidade da configuração inicial, acelerando os prazos de desenvolvimento e diminuindo a manutenção. Guia da API de E-mail OAuth
Atualizações e manutenção consistentes
Mantenha-se à frente com atualizações regulares e manutenção diligente. A API de E-mail Outlook Unipile é continuamente aprimorada para rastrear as mudanças do Microsoft Graph e entregar desempenho máximo, para que sua integração funcione mesmo quando a Microsoft atualiza sua API. Guia de integração com o MS Graph
Nossa equipe de suporte te guia em cada etapa da integração da API de Email do Outlook, da iniciação à pós-implementação, sem custo adicional. API de E-mail para desenvolvedores
Armadilhas Comuns ao Criar com a API de E-mail do Outlook
A API do Microsoft Outlook é poderosa, mas possui várias restrições não óbvias que podem quebrar sua integração em produção. Aqui estão os 6 armadilhas mais comuns – e como evitá-las.
Segurança e Conformidade para Integrações de API de E-mail do Outlook
Garanta a segurança dos seus dados com protocolos avançados de segurança. A API de E-mail Outlook da Unipile garante que seus e-mails e informações sensíveis permaneçam protegidos – com certificação SOC 2 Tipo II e conformidade total com o GDPR.
Perguntas frequentes
Respostas às perguntas mais comuns sobre a integração da API do Outlook Email, API do Microsoft Outlook e API do Outlook 365 com o Unipile.
graph.microsoft.com/v1.0/me/mensagens, autenticado com um token de portador OAuth 2.0 do Azure AD. Unipile encapsula isso em uma interface simples e independente de provedor que também funciona para Gmail e IMAP.Mail.ReadWrite, Mail.Send e Mail.Read permissões delegadas, (3) implementar o fluxo de código de autorização para obter um token de acesso. Com o Unipile, você pula tudo isso. Use o Hosted Auth para gerar uma página OAuth de link único para seus usuários. Veja o completo Guia da API de E-mail OAuth e o Guia OAuth do Microsoft Graph.Você também pode gostar
Recuperar e-mails com a API do Unipile
Gerenciar e recuperar e-mails de forma programática é uma habilidade essencial. Seja para fins de automação comercial, suporte ao cliente ou marketing, entender como usar uma API de e-mail para recuperar e-mails pode simplificar as operações e aumentar a eficiência. Este guia o guiará pelos fundamentos...
Como obter a API de e-mail para seu software
Explore as vantagens da integração de uma API, pois ela apresenta uma porta de entrada para desbloquear vários benefícios na incorporação perfeita de vários serviços de e-mail em seu aplicativo. O que é uma API de e-mail? Uma API (Interface de Programação de Aplicativos) de e-mail é um serviço que permite aos desenvolvedores integrar...
Verificação do Google OAuth e Credenciais da API do Gmail (2026)
Aviso sobre aplicativos não verificados da API do Gmail: o aviso "Este aplicativo não foi verificado", o limite de 100 usuários e as isenções. Antes que seu aplicativo seja aprovado na verificação de aplicativos do Google OAuth, todos os usuários que tentarem autorizá-lo verão uma tela de aviso. O Google também impõe um limite rígido de 100 usuários para aplicativos externos não verificados. Aqui está...
BR 
EN 
FR 
ES 
DE 
IT 
NL 
PL 
TR