LinkedIn
Instagram
WhatsApp
Telegrama
Google Agenda
Participe da comunidade do SlackConstruindo um API de e-mail multi-provedor a integração que funciona em Gmail, Outlook e IMAP é um dos desafios mais demorados para as equipes de desenvolvimento. Cada provedor envia seu próprio fluxo OAuth, limites de taxa e modelo de dados. API de e-mail unificada simplifica tudo isso em uma única interface REST - assim, você escreve uma integração e obtém cobertura para todas as principais caixas de entrada que seus usuários utilizam.
O que você aprenderá
Guia Completo da API de E-mail
Aprenda como Gmail, Outlook e IMAP funcionam juntos sob uma única API REST unificada.
Por que desenvolvedores precisam de uma API de E-mail multi-provedor
A maioria dos produtos SaaS eventualmente precisa ler ou enviar e-mails em nome de seus usuários. O problema não é o conceito - é a execução. O Gmail usa a API do Gmail com o Google OAuth 2.0. O Outlook usa o Microsoft Graph com seu próprio ciclo de vida de tokens. Provedores baseados em IMAP se comportam de maneira ligeiramente diferente. Construir e manter três integrações separadas consome ciclos de engenharia que deveriam ser direcionados ao seu produto principal. Se você está lidando especificamente com contas IMAP, a Guia da API IMAP cobre a complexidade adicional envolvida. A API de e-mail unificada resolve isso colapsando toda a complexidade específica do provedor por trás de uma única interface - essa é a promessa central de um API de e-mail multi-provedor abordagem. Para uma referência técnica completa sobre como API de envio de e-mail chamadas pelo Gmail, Outlook e IMAP, consulte nosso guia dedicado.
O 3 provedores de e-mail coberto
Uma API unificada normaliza Gmail, Outlook e IMAP em uma interface idêntica. Seu código nunca muda quando um usuário conecta um provedor diferente.
Conecte qualquer conta Gmail ou Google Workspace via Google OAuth 2.0. Envie, leia, pesquise e sincronize e-mails em tempo real através da camada Unipile - sem necessidade de credenciais diretas da API do Gmail em seu aplicativo.
Suporta contas pessoais do Outlook, Microsoft 365 e Exchange Online sob um único provedor. O Microsoft OAuth é gerenciado pela Unipile - sua integração permanece estável em todas as configurações de tenant.
Qualquer caixa de correio acessível via IMAP - Yahoo, Fastmail, ProtonMail Bridge, servidores corporativos personalizados - torna-se instantaneamente acessível através da mesma interface de API usada para Gmail e Outlook.
Unipile vs construindo você mesmo
Quanto custa realmente fazer você mesmo um API de e-mail multi-provedor integração? Aqui está uma comparação honesta nas dimensões que importam na produção. É por isso que as equipes escolhem cada vez mais uma API de e-mail unificada como Unipile em vez de construir cada integração de provedor do zero.
Como a integração trabalha
Conectar sua primeira conta de e-mail com o Unipile leva quatro etapas. O mesmo fluxo funciona independentemente de o usuário ter Gmail, Outlook ou Conta IMAP - seu código da aplicação permanece idêntico. Esta é a força prática de uma API de e-mail unificada: escreva uma vez, cubra todos os três provedores.
Seu backend chama a API Unipile para criar uma URL de autenticação hospedada de curta duração. Redirecione o usuário para essa URL - Unipile apresenta a tela de seleção do provedor e gerencia todo o fluxo OAuth em seu nome.
// POST /api/v1/hosted/accounts/link const res = await fetch('https://api5.unipile.com:13515/api/v1/hosted/accounts/link', { method: 'POST', headers: { 'X-API-KEY': process.env.UNIPILE_API_KEY, 'Content-Type': 'application/json' }, corpo: JSON.stringify({ tipo: 'E-MAIL', filtros_fornecedores: ['Google', 'MICROSOFT', 'IMAP'], url_de_redirecionamento_de_sucesso: 'https://seufap.com/auth/success' }) }); const { url } = await res.json(); // redireciona o usuário para `url`
Após o usuário completar o OAuth, o Unipile dispara um webhook para o seu endpoint (ou anexa o ID da conta à sua URL de redirecionamento). Armazene este ID de conta - ele é sua referência permanente para essa conta vinculada, independente do provedor.
{
"evento": "conta.conectada",
"id_da_conta": "acc_01HXYZ...",
"provedor": "GOOGLE",
"e-mail": "alice@gmail.com"
}
Use o ID da conta para listar, pesquisar e recuperar e-mails. Este é o API de e-mail unificada em ação: o esquema de resposta é idêntico quer a conta seja Gmail, Outlook ou IMAP - sua lógica de análise nunca se ramifica por provedor.
// GET /api/v1/emails?account_id=acc_01HXYZ... const emails = await fetch( https://api5.unipile.com:13515/api/v1/emails?account_id=${accountId}&limite=20`, { cabeçalhos: { 'X-API-KEY': process.env.UNIPILE_API_KEY } } ).então(r => r.json()); // Mesma estrutura de resposta para Gmail, Outlook, IMAP: // { id, assunto, de, para, data, corpo, anexos }
Um único endpoint POST envia e-mail independentemente do provedor por trás da conta - este é todo o poder de um API de e-mail multi-provedor. Passe o ID da conta, destinatário, assunto e corpo - Unipile roteia através da API do Gmail, Microsoft Graph ou SMTP conforme apropriado. Este é o API de e-mail unificada em sua forma mais concreta: um terminal, três provedores, zero ramificação em seu código.
// POST /api/v1/emails/send await fetch('https://api5.unipile.com:13515/api/v1/emails/send', { method: 'POST', headers: { 'X-API-KEY': process.env.UNIPILE_API_KEY, 'Content-Type': 'application/json' }, corpo: JSON.stringify({ account_id: 'acc_01HXYZ...', para: [{ e-mail: 'bob@example.com' }], assunto: 'Olá da Unipile', corpo: 'Funciona com Gmail, Outlook e IMAP.
' }) });
Como abstração de provedor trabalha
A API de e-mail unificada fica entre seu aplicativo e os três protocolos de provedores subjacentes - traduzindo fluxos OAuth divergentes, esquemas de dados e modelos de limite de taxa em uma única interface consistente.
O Gmail utiliza o Google OAuth 2.0 com um ciclo de atualização de token específico e retorna e-mails em um modelo centrado em conversas, com rótulos. O Outlook utiliza o Microsoft Graph com um modelo de tenant OAuth diferente e retorna e-mails como objetos de mensagem individuais, com pastas. Servidores IMAP possuem seus próprios parâmetros de conexão, métodos de autenticação e conjuntos de capacidades.
Unipile's API de e-mail unificada normaliza todos os três em uma única interface REST. Seu código chama /api/v1/emails e recebe objetos de resposta com formato idêntico - independentemente de a conta subjacente ser Gmail, Outlook ou IMAP. O mesmo se aplica ao envio, manuseio de anexos, eventos de webhook e gerenciamento do ciclo de vida da conta.
Esta é a principal vantagem de engenharia do API de e-mail multi-provedor O modelo: A complexidade é absorvida na camada de infraestrutura, não no código da sua aplicação. Quando o Google altera os requisitos de escopo do OAuth ou a Microsoft atualiza a paginação da API Graph, o Unipile lida com a mudança upstream - sua integração permanece intacta.
Segurança e conformidade
Quando sua aplicação lida com e-mails em nome de usuários, a segurança não é opcional. Veja como a camada unificada de API de e-mail gerencia credenciais, dados e obrigações de conformidade.
A Unipile armazena e atualiza tokens OAuth em seu nome. Sua aplicação nunca lida com credenciais brutas - você trabalha apenas com IDs de conta opacos. Rotação de tokens, detecção de expiração e fluxos de reautenticação são gerenciados inteiramente na camada de infraestrutura.
Todos os dados em trânsito utilizam TLS 1.3. Credenciais armazenadas são criptografadas em repouso com AES-256. O conteúdo de e-mail obtido através da API unificada de e-mail é processado em memória e não é persistido além do que sua integração solicita explicitamente.
A Unipile possui certificação SOC 2 Tipo II (outubro de 2025). Auditores independentes verificaram a segurança, disponibilidade e confidencialidade da plataforma. Relatórios de auditoria estão disponíveis mediante solicitação para clientes empresariais que avaliam a API de e-mail multi-provedor para uso em produção.
Acordos de processamento de dados estão disponíveis para todos os planos. A opção de residência de dados da UE é oferecida para clientes com requisitos de localização de dados. O direito ao esquecimento é suportado via API: a exclusão de uma conta vinculada remove todos os tokens e dados cacheados associados.
Avaliação de Segurança de Aplicações do Google Cloud. Valida os controles de segurança para aplicativos que acessam dados de usuários do Google, incluindo escopos OAuth do Gmail. Aplicativos criados na Unipile herdam esta certificação.
O histórico de uptime e incidentes está publicamente disponível em status.unipile.com. Todas as alterações na API seguem uma política de versionamento com avisos de depreciação. Sem alterações disruptivas silenciosas: sua integração é protegida por um contrato estável e documentado.
Manuseio casos extremos entre provedores
Toda integração de e-mail de produção encontra casos extremos específicos do provedor. Veja como uma abordagem "faça você mesmo" se compara ao uso de uma API de e-mail unificada quando as coisas ficam complicadas.
| Cenário | Abordagem DIY | Abordagem Unipile |
|---|---|---|
| Limite de taxa do Gmail 250 unidades de cota/dia no nível gratuito |
Rastreamento manual de cotas por conta; solicitações falham silenciosamente se não forem monitoradas | Tratado automaticamente Filas integradas, nenhuma solicitação falhou para o seu aplicativo |
| Expiração do token OAuth | Implemente lógica de atualização separada por provedor; a rotação de tokens difere entre Google e Microsoft | Atualização automática Gerenciamento de tokens sem interrupção em todos os provedores |
| Conexão IMAP cai | Lógica de reconexão personalizada por configuração de servidor; timeouts variam entre implementações IMAP | Pool de conexões gerenciado Conexões persistentes mantidas pela infraestrutura Unipile |
| Limites de tamanho de anexo Gmail 25MB, Outlook 150MB, IMAP varia |
Código de ramificação por provedor; deve rastrear o limite de cada provedor e atualizar quando eles mudarem | Validação unificada Validação de tamanho independente de provedor; erros retornados em esquema consistente |
| Alterações na API do provedor | Sua responsabilidade de plantão; Google e Microsoft implementam alterações drásticas com pouco aviso | Gerenciado pela equipe da Unipile Alterações de upstream absorvidas em nível de infraestrutura; sua integração permanece estável |
Limite de taxa do Gmail
250 unidades de cota/dia no nível gratuitoRastreamento manual de cotas por conta; solicitações falham silenciosamente se não forem monitoradas
O guia do pilar cobre todos os endpoints da nossa API de e-mail unificada detalhado - fluxos de autenticação, manuseio de anexos, sincronização de pastas, filtros de pesquisa e configuração de webhooks. Tudo o que você precisa para criar uma integração de e-mail pronta para produção.
Comum casos de uso
A API de e-mail unificada é infraestrutura fundamental para uma ampla gama de categorias de produtos. Com uma API de e-mail multi-provedor, as equipes lançam recursos mais rapidamente e atendem a mais usuários - independentemente do provedor de caixa de entrada que utilizam. Aqui estão os padrões mais frequentemente criados com Unipile.
Puxe automaticamente todos os e-mails de clientes para os registros do seu CRM. Vendedores veem o histórico completo da conversa sem precisar trocar de aba ou encaminhar manualmente.
Envie sequências personalizadas de acompanhamento das caixas de entrada reais dos seus usuários - não de um domínio de envio compartilhado - através de contas Gmail e Outlook simultaneamente.
Recrutadores vinculam seu e-mail de trabalho e os logs do seu ATS em todas as conversas de candidatos automaticamente. Responda diretamente da interface do ATS, roteado através de sua conta real do Outlook ou Gmail.
Crie uma caixa de entrada compartilhada ou central de ajuda que consolide e-mails de várias contas de equipe. Encaminhe, atribua e responda — tudo através de uma única interface com suporte de uma única API.
Alimente tópicos de e-mail em um LLM para gerar rascunhos de respostas, resumos ou itens de ação. O Unipile fornece os dados normalizados do tópico; sua camada de IA faz o raciocínio.
Dispare fluxos de trabalho no-code a partir de novos e-mails de qualquer provedor. Um webhook é acionado para cada mensagem recebida - sua plataforma de automação cuida do resto sem a necessidade de polling.
Todos esses padrões funcionam no Gmail, Outlook e IMAP com zero código específico do provedor em sua aplicação. Unipile normaliza as diferenças para que a lógica do seu produto permaneça limpa e seus usuários possam conectar a caixa de entrada que preferirem. Para um guia completo de todos os endpoints, consulte o guia da API de e-mail unificada.
Perguntas frequentes perguntas
Tudo que desenvolvedores perguntam antes de integrar uma API de e-mail multi-provedor.
id, assunto, from, para, datae corpo têm a mesma estrutura independentemente do provedor. Sua lógica de análise, modelos de banco de dados e processamento downstream nunca precisam ser ramificados por tipo de provedor.
Conecte contas Gmail, Outlook e IMAP através de uma única API. Sem complicações de OAuth, sem mapeamento de esquemas, sem infraestrutura de polling para manter. Comece com um teste gratuito de 7 dias - sem necessidade de cartão de crédito.
BR 
EN 
FR 
ES 
DE 
IT 
NL 
PL 
TR