Crie já

API de Envio de E-mail: Gmail, Outlook e IMAP de Contas do Usuário (2026)

Índice
Índice 8 seções
Fundações
01O que é isso?
02Casos de uso
Provedores
03Gmail, Outlook, IMAP
04Como Enviar (Passo a Passo)Guia
Integração
05Endpoint de API Unificado
06Todos os Endpoints da API
07Autenticação e Segurança
Referência
08Erros Comuns
09PERGUNTAS FREQUENTES
API de E-mail da Conta do Usuário

API de Envio de E-mail: Enviar de Usuário Gmail, Outlook e IMAP Contas

A maioria das APIs de e-mail envia de um domínio compartilhado que você possui. A API de envio de e-mail da Unipile é diferente: ela envia das contas Gmail, Outlook e IMAP dos seus usuários, com OAuth2 completo, sem armazenamento de credenciais e um único endpoint unificado para cada provedor. Quando seu SaaS precisa enviar e-mails programaticamente em nome de pessoas reais, esta é a integração que faz funcionar.

Conexão OAuth2, sem armazenamento de senha
Um endpoint unificado, todos os provedores
Suporta Gmail, Outlook e IMAP
Infraestrutura compatível com SOC 2
GmailGmail
PerspectivasPerspectivas
IMAPIMAP
Começar a construir Exibir documentos
api de e-mail - contas de usuário
Enviado de contas vinculadas
Gmail
sarah@acme.com (Gmail)
Dando seguimento à nossa conversa
Enviado
Perspectivas
mark@corp.io (Outlook)
Seu resumo de integração
Enviado
IMAP
lisa@startup.co (IMAP)
Bem-vindo à plataforma
Enviado
POST /api/v1/emails
"id_da_conta": "acc_gmail_xyz",
"para": [{ "identificador": "sarah@acme.com" }],
"assunto": "Em seguimento..."
200 OK - email na fila
O que é uma API de Envio de E-mail por Conta de Usuário?

Uma API de Envio de E-mail que Atua em Nome dos seus Usuários

A maioria das buscas por "API de envio de e-mail" leva a provedores transacionais. Este não é o caso. A Unipile é uma API de e-mail de conta de usuário: ela se conecta às contas reais de Gmail ou Outlook dos seus usuários e envia em nome deles, com a identidade e a capacidade de entrega deles.

Principais casos de uso

Por que Desenvolvedores Criam em uma API de Email de Contas de Usuário

Quando seu produto precisa enviar e-mails programaticamente de pessoas reais (não de um endereço noreply@), estes são os cenários que impulsionam a adoção.

CRM e Automação de Vendas

Envie e-mails de acompanhamento da conta Gmail ou Outlook de cada representante de vendas. Taxas de resposta mais altas, identidade autêntica do remetente, sem necessidade de aquecimento de domínio. Os prospects veem um nome real, não um alias genérico.

Plataformas de Atendimento ao Cliente

Permita que os agentes de suporte respondam diretamente de sua própria caixa de entrada. Os clientes veem o nome e o endereço de e-mail de uma pessoa real, não um alias de suporte@. Gera confiança, aumenta a velocidade de resolução.

ATS e Ferramentas de Recrutamento

Alcance candidatos com e-mails personalizados da conta real do recrutador. Sem domínio frio, sem risco de filtro de spam, sem período de aquecimento. O e-mail chega à caixa de entrada como uma mensagem pessoal, porque é uma.

Provedores compatíveis

Enviar E-mail do Gmail, Outlook e IMAP: Uma API

A API de envio de e-mail da Unipile abstrai completamente a camada de provedor. Seja a conta do seu usuário Gmail, Outlook, Microsoft 365, Exchange Online ou qualquer caixa de correio compatível com IMAP, a chamada da API é idêntica. Você escreve a integração uma vez e todos os provedores simplesmente funcionam.

Gmail
Google Workspace incluído
Autenticação OAuth2, sem senha necessária
Escopo: gmail.enviar: pegada mínima de permissão
Até 500 e-mails/dia por conta pessoal, limites mais altos para Workspace
Excelente entregabilidade: infraestrutura do Google, reputação do usuário
OAuth2 pronto
Guia de integração da API do Gmail
Perspectivas
Cobre Microsoft 365 e Exchange Online
OAuth2 via Plataforma de Identidade da Microsoft
Permissão Mail.Send: delegado ou em nível de aplicativo
Funciona para contas pessoais do Outlook, Microsoft 365 e Exchange Online
Até 10.000 destinatários/dia para contas M365
OAuth2 pronto
Guia da API Microsoft Graph
IMAP
Fallback universal para qualquer provedor
Suporta IMAP/SMTP com credenciais ou OAuth2, onde disponível
Funciona com Yahoo, Zoho, Fastmail, servidores de e-mail corporativos personalizados
Mesmo endpoint da API Unipile, sem trabalho extra de integração
Ideal para usuários B2B com domínios personalizados e e-mail corporativo
Universal
Guia de integração da API IMAP
Guia Passo a Passo

Como Enviar E-mail Via API: Integração Passo a Passo

Do link de conta ao envio do seu primeiro e-mail programaticamente, aqui está o fluxo completo. Este guia cobre Gmail e Outlook; os passos para IMAP são idênticos, apenas o tipo de conta difere.

1
Obtenha sua chave de API Unipile

Cadastre-se no painel da Unipile. Cada espaço de trabalho recebe uma chave de API. Todas as requisições são autenticadas com a X-API-KEY header. Nenhuma configuração de OAuth do seu lado: A Unipile cuida da autenticação do provedor para você.

enrolar
# Verifique sua chave de API enrolar -X GET https://api.unipile.com/api/v1/accounts \ -H "X-API-KEY: {SUA_CHAVE_DE_API}"
2
Vincular uma conta de usuário (Gmail, Outlook ou IMAP)

Gerar um link de autenticação hospedado via API. O usuário clica nele e passa pela tela de consentimento padrão do OAuth2 para seu provedor. A Unipile armazena os tokens de forma segura e retorna um account_id. Você nunca toca em credenciais.

enrolar JavaScript Python
# Gerar um link de autenticação hospedado para o Gmail enrolar -X POST https://api.unipile.com/api/v1/hosted/accounts/link \ -H "X-API-KEY: {SUA_CHAVE_DE_API}" -H "Content-Type: application/json" -d '{"type":"GOOGLE","api_url":"https://api.unipile.com","expiresOn":"2026-12-31T00:00:00.000Z"}'
// Gerar link de autenticação - Node.js const res = await fetch('https://api.unipile.com/api/v1/hosted/accounts/link', { method: 'POST', cabeçalhos: { 'X-API-KEY': '{SUA_CHAVE_DE_API}', 'Content-Type': 'application/json'}, body: JSON.stringify({ type: 'Google', api_url: 'https://api.unipile.com', expiraEm: '2026-12-31T00:00:00.000Z'}) });const { url } = await res.json();
# Gerar link de autenticação - Python import requisições res = requisições.post( 'https://api.unipile.com/api/v1/hosted/accounts/link', cabeçalhos={'X-API-KEY': '{SUA_CHAVE_DE_API}'}, json={ 'tipo': 'Google', 'url_da_api': 'https://api.unipile.com', 'expiraEm': '2026-12-31T00:00:00.000Z') url = res.json()['url']
Para o Outlook, use "tipo":"MICROSOFT". Para IMAP, use "tipo":"IMAP". O mesmo fluxo hospedado lida com todos os três provedores.
3
Recupere o account_id do retorno de chamada do webhook

Após o usuário completar o OAuth2, o Unipile dispara um webhook para seu endpoint com o account_id. Armazene-a em seu banco de dados: é a chave que você usará em todas as chamadas de API de envio de e-mail para esse usuário.

Payload JSON
// Exemplo de payload de webhook (evento account.linked){ "evento": "conta.vinculada", "id_da_conta": "acc_gmail_Abc123XYZ", "provedor": "GOOGLE", "e-mail": "sarah@acme.com"}
4
Enviar e-mail da conta vinculada

POST para /api/v1/emails com o account_id. O e-mail é enviado da caixa de entrada real do Gmail ou Outlook do usuário, da mesma forma que se ele mesmo tivesse pressionado enviar. O endpoint é idêntico, independentemente de a conta vinculada ser Gmail, Outlook ou IMAP.

enrolar JavaScript Python
# Enviar e-mail de uma conta do Gmail vinculada enrolar -X POST https://api.unipile.com/api/v1/emails \ -H "X-API-KEY: {SUA_CHAVE_DE_API}" -H "Content-Type: application/json" -d '{ "account_id": "{ID_DA_CONTA}", "para": [{"nome_exibicao": "John Doe", "identificador": "john@example.com"}], "assunto": "Acompanhamento da nossa conversa", "corpo"<p>Olá John,</p><p>Só queria acompanhar...</p>" }'
// Enviar e-mail - Node.js const res = await fetch('https://api.unipile.com/api/v1/emails', { method: 'POST', cabeçalhos: { 'X-API-KEY': '{SUA_CHAVE_DE_API}', 'Content-Type': 'application/json'}, body: JSON.stringify({ account_id: '{ID_DA_CONTA}', para: [{ nome_exibicao: 'João da Silva', identificador: 'john@example.com' }], assunto: 'Dando seguimento à nossa conversa', corpo: '<p>Olá John,</p><p>Só queria acompanhar...</p>'}) });const data = await res.json();
# Enviar e-mail - Python import requisições res = requisições.post( 'https://api.unipile.com/api/v1/emails', cabeçalhos={'X-API-KEY': '{SUA_CHAVE_DE_API}'}, json={ 'id_da_conta': '{ID_DA_CONTA}', 'a': [{ 'Nome de exibição': 'João da Silva', 'identificador': 'john@example.com' }], 'assunto': 'Dando seguimento à nossa conversa', 'corpo': '<p>Olá John,</p><p>Só queria acompanhar...</p>') print(res.json())
A resposta inclui um ID de mensagem e um status de entrega. Você também pode adicionar "cópia carbono", "Cco", "responder_a"e "anexos" para o mesmo payload.

Pronto para enviar e-mails do Gmail, Outlook e IMAP?

Sua chave de API está aguardando. Comece a desenvolver em menos de 10 minutos.

Comece a construir agora Exibir documentos
Endpoint de API Unificado

Um Ponto de Extremidade Unificado para Enviar E-mails em Todos os Provedores

A maior dificuldade em integrações com múltiplos provedores é manter caminhos de código separados para cada serviço de e-mail. O Unipile elimina isso. Seja a conta vinculada Gmail, Outlook ou IMAP, você sempre chama o mesmo endpoint com a mesma carga útil. A camada de abstração cuida dos protocolos específicos do provedor, atualizações de token e diferenças de limite de taxa nos bastidores.

POST /api/v1/emails - idêntico para todos os provedores Unificado
POST https://api.unipile.com/api/v1/emails X-API-KEY: {SUA_API_KEY}{ "id_da_conta": "{ID_DA_CONTA}", "para": [{ "nome_exibido": "João da Silva", "identificador": "john@example.com"}], "assunto": "Atualização do seu projeto", "corpo": "<p>Ol\u00e1 John...<\/p>"}// Funciona para Gmail, Outlook e IMAP // account_id informa ao Unipile qual conta usar
GmailGmail
+
PerspectivasPerspectivas
+
IMAPIMAP
/api/v1/emails
Explore a API unificada de e-mail multi-provedor
Escreva uma vez, suporte qualquer provedor

Caminhos de código separados para Gmail vs. Outlook. Uma integração cobre todos os três provedores hoje e quaisquer adições futuras que o Unipile adicionar.

Atualização de token tratada automaticamente

Tokens de acesso OAuth2 expiram. Unipile os atualiza de forma transparente. Seu código nunca lida com o ciclo de vida do token; apenas chame a API e envie.

Escalonar para milhares de contas vinculadas

Cada usuário vincula sua própria conta. Você gerencia um ID de conta por usuário; a Unipile cuida do resto. Sem malabarismos com SDKs por provedor.

Formato de resposta consistente

A API retorna a mesma estrutura JSON independentemente do provedor. Analise um esquema, crie um manipulador de erros e lance mais rápido.

Precisa enviar e-mails em nome dos seus usuários em escala? Leia o guia completo sobre como enviar e-mails em nome dos seus usuários, incluindo o modelo de conformidade e consentimento que a Unipile usa para manter tudo auditável.

Referência da API

Todos os Endpoints da API de Envio de E-mail, Organizados

Todos os endpoints disponíveis para conectar contas, enviar e responder, gerenciar sua caixa de entrada e ouvir eventos no Gmail, Outlook e IMAP com uma única integração.

Explorar todos os pontos de extremidade
Gmail Perspectivas IMAP
Enviar e ResponderEnviar
Configuração da ContaConta
Gerenciar emailsGerenciar
Webhooks

Enviar e Responder

4 endpoints disponíveis

GmailGmail
PerspectivasPerspectivas
IMAPIMAP
Enviar um e-mail
Responder a um e-mail
Encaminhar um e-mail
Enviar com Anexos

Configuração da Conta

3 endpoints disponíveis

GmailGmail
PerspectivasPerspectivas
IMAPIMAP
Auth Hospedada: fluxo OAuth white-label
Use sua própria tela de OAuth
Conectar com credenciais (SMTP)

Gerenciar emails

5 endpoints disponíveis

GmailGmail
PerspectivasPerspectivas
IMAPIMAP
Lista de e-mails
Obter E-mail
Excluir e-mail
Mover e-mail
Listar pastas

Webhooks

2 eventos disponíveis

GmailGmail
PerspectivasPerspectivas
IMAPIMAP
Novo e-mail recebido
Rastreamento de aberturas e cliques
Referência da API do Explore
Guia da API de e-mail
Quer o guia completo de integração da API de e-mail?

Abrange fluxos de autenticação, configuração de webhook, leitura e envio de e-mails, anexos e comparação completa de provedores, tudo o que você precisa para criar uma integração de API de envio de e-mails pronta para produção.

Leia o Guia da API de E-mail
Autenticação e Segurança

Autenticação e Segurança para Sua Integração de API de Envio de Email

Lidar com credenciais de e-mail do usuário é uma das partes de maior risco em qualquer integração SaaS. A arquitetura da Unipile foi projetada para que você nunca armazene ou transmita tokens OAuth2 diretamente; a superfície de risco permanece mínima e a conformidade continua gerenciável.

OAuth2: nenhum armazenamento de credenciais do seu lado

O Unipile gera o URL de consentimento OAuth2, coleta o código de autorização e armazena os tokens de acesso e de atualização em seu próprio cofre criptografado. Seu backend nunca vê um account_id. Sem token bruto, sem senha, sem desvio de credenciais.

Atualização automática de token

Tokens do Gmail OAuth2 expiram após 1 hora. Tokens da Microsoft expiram após 1 hora (acesso) ou 90 dias (refresh). O Unipile os atualiza automaticamente antes do vencimento. Suas chamadas de API de envio de e-mail nunca falham devido a um token expirado.

Escopos OAuth2 mínimos

Para uma integração apenas de envio, a Unipile solicita apenas os escopos necessários: gmail.enviar para Gmail e Mail.Send para o Outlook. Isso segue o princípio do privilégio mínimo e reduz a superfície de ataque para os dados dos seus usuários.

Verificação de assinatura de webhook

Todo webhook que o Unipile envia para o seu endpoint inclui um cabeçalho de assinatura que você pode verificar contra o seu segredo de webhook. Isso garante que os payloads de eventos não possam ser forjados por terceiros que tentam acionar ações no seu sistema.

SOC 2 Tipo II

A infraestrutura da Unipile é certificada SOC 2 Tipo II. Os controles auditados abrangem gerenciamento de acesso, criptografia em repouso e em trânsito, resposta a incidentes e disponibilidade. Isso facilita a aprovação em revisões de segurança de fornecedores quando seus clientes SaaS perguntam como você lida com as credenciais de e-mail deles.

Aprenda sobre a API de e-mail seguro
CASA Nível 2

Unipile é avaliada como CASA Nível 2, o padrão de segurança exigido pelo Google para aplicativos que acessam escopos sensíveis da API do Gmail. A avaliação é realizada por um laboratório autorizado e abrange o manuseio de dados, controles de acesso e práticas de desenvolvimento seguro. Necessário para manter o acesso de produção aos escopos de envio do Gmail.

Capacidades da API

Cobertura Total de Recursos da API de E-mail em Todos os Provedores

Uma integração te dá acesso a todas as principais operações de e-mail em provedores Gmail, Outlook e IMAP. O mesmo endpoint, a mesma estrutura de payload, o mesmo formato de resposta, independentemente da conta que seu usuário conectou.

Recurso Gmail Outlook / M365 IMAP / SMTP
Enviando
Enviar e-mail da conta do usuário ✓ ✓ ✓
Enviar com anexos ✓ ✓ ✓
Responder na thread existente ✓ ✓ ✓
Destinatários CC e CCO ✓ ✓ ✓
Conteúdo do corpo HTML ✓ ✓ ✓
Imagens inline (incorporação de CID) ✓ ✓ ✓
Limite diário de envio (aprox.) ~500 por dia ~10.000 / dia Dependente de servidor
Ler e Sincronizar
Listar e ler e-mails ✓ ✓ ✓
Visualização de Tópicos / Conversa ✓ ✓ ✓
Webhooks em tempo real (novo e-mail, lido, enviado) ✓ ✓ ✓
Sincronização incremental de delta ✓ ✓ ✓
Gerenciamento de rótulos e pastas ✓Rótulos ✓Pastas ✓Pastas
Autenticação e Segurança
OAuth2 (sem armazenamento de senha) ✓ ✓ Senha do aplicativo
Atualização automática de token ✓ ✓ ✓
SOC 2 Tipo II / CASA Nível 2 ✓ ✓ ✓
Erros Comuns

Erros Comuns ao Integrar uma API de Envio de E-mail

A maioria dos problemas que os desenvolvedores encontram ao integrar uma API de envio de e-mail para contas de usuário se enquadra em um pequeno conjunto de categorias. Aqui estão as que valem a pena conhecer antes de começar a construir.

01
Ignorando limites de taxa do provedor

Contas pessoais do Gmail são limitadas a aproximadamente 500 e-mails por dia. As contas do Outlook têm limites mais altos, mas ainda podem sofrer estrangulamento (throttling) sob condições de pico. Exceder esses limites resulta em erros 429 ou suspensão temporária da conta pelo provedor.

Correção:Rastreie contagens de envio por conta vinculada, implemente backoff exponencial em respostas 429 e distribua envios em massa em janelas de tempo em vez de enviá-los como um único lote.
02
Não lidando com revogação de token

Os usuários podem revogar o acesso a qualquer momento nas configurações de suas contas Google ou Microsoft. Quando isso acontece, o Unipile retornará um erro na próxima chamada de API para essa conta. Se o seu aplicativo não lidar com isso de forma adequada, isso resultará em falhas silenciosas na entrega de e-mails.

Correção:Ouça o conta.desconectada evento de webhook e solicitar que o usuário reflac seu conta.
03
Envio sem consentimento explícito do usuário

Mesmo com um token OAuth2 válido, enviar e-mails da conta de um usuário sem o conhecimento dele viola as políticas de uso do Google e da Microsoft e as leis de spam da maioria das jurisdições. A tela de consentimento do OAuth2 deve explicar claramente o que seu aplicativo fará.

Correção:Use linguagem clara na sua tela de consentimento OAuth e nas descrições no aplicativo. Documente o que aciona um envio automatizado e dê aos usuários o controle para desativá-lo.
04
Armazenando tokens OAuth2 brutos em seu banco de dados

Se você mesmo armazenar tokens de acesso e eles forem expostos em uma violação de dados, um invasor terá acesso total a todas as contas de e-mail vinculadas. Este é um risco crítico de segurança e conformidade, especialmente sob o GDPR.

Correção:Use o fluxo de autenticação hospedado da Unipile. Armazene apenas o account_id; A Unipile guarda os tokens em seu cofre certificado SOC 2. Seu banco de dados nunca toca em um token OAuth2 bruto.
05
Tratando SMTP e uma API REST de envio de e-mail como intercambiáveis

O SMTP requer acesso direto ao servidor, gerenciamento de credenciais, configuração TLS e tratamento de rejeições. Uma API REST para envio de e-mail abstrai tudo isso. Combinar ambas as abordagens no mesmo código adiciona complexidade sem benefício.

Correção:Para o envio de contas de usuário, utilize exclusivamente a API REST. O SMTP só é relevante se você estiver operando sua própria infraestrutura de e-mail ou tiver um provedor que não suporte OAuth2.

Perguntas frequentes

Tudo o que você precisa saber sobre a API de envio de e-mail.

Uma API de envio de e-mail é uma interface REST que permite que seu aplicativo envie e-mails programaticamente sem abrir um cliente de e-mail. A API de envio de e-mail da Unipile especificamente envia de contas de propriedade do usuário (Gmail, Outlook, IMAP), o que significa que o e-mail chega do endereço real do usuário em vez de um domínio genérico noreply@ que você controla.
Com o Unipile, você gera um link de autenticação hospedado para o provedor do tipo GOOGLE. O usuário se autentica através da tela de consentimento OAuth2 padrão do Google. Uma vez vinculado, você recebe um account_id via webhook. Você então faz um POST para /api/v1/emails com esse account_id e sua carga útil da mensagem. O e-mail é enviado do endereço de e-mail real deles. Nenhuma configuração de chave de API do Gmail é necessária do seu lado.
Sim. O Unipile suporta o envio de e-mails programaticamente a partir de contas Outlook, incluindo Outlook pessoal, Microsoft 365 e Exchange Online, tudo através do mesmo endpoint de API. Você vincula a conta usando o tipo de provedor MICROSOFT. A autenticação utiliza OAuth2 com o Mail.Send permissão delegada. Unipile lida com a atualização do token automaticamente.
Para uma integração somente de envio, o escopo mínimo necessário é https://www.googleapis.com/auth/gmail.send. Isso permite enviar e-mails, mas não concede acesso para ler, modificar ou excluir mensagens. Ao usar o Unipile, você não configura esse escopo; o fluxo de autenticação hospedado cuida disso. Para um caso de uso de API de envio de e-mail puro, gmail.enviar é suficiente.
Estes são mercados diferentes para problemas diferentes. APIs transacionais enviam de um domínio que você possui e controla. Unipile não está nesse mercado. Unipile conecta-se aos e-mails reais do Gmail ou Outlook dos seus usuários e envia em nome deles, com a identidade deles, para casos de uso em que o endereço do remetente importa: sequências de CRM, respostas de suporte, prospecção.
Os limites de taxa se aplicam no nível do provedor, não no nível do Unipile. Contas pessoais do Gmail permitem aproximadamente 500 e-mails por dia. Contas do Outlook e Microsoft 365 têm limites mais altos, mas podem ser estranguladas sob picos intensos. Melhor prática: monitore o volume de envio por conta vinculada em seu próprio banco de dados, implemente backoff exponencial ao receber respostas 429 e distribua envios em massa em janelas de tempo. O Unipile retorna o código de erro do provedor para que você possa distinguir um erro de limite de taxa de uma falha de autenticação.
Sim: é exatamente isso que a Unipile oferece. Uma POST /api/v1/emails o provedor é determinado pela account_id na carga útil; você não precisa especificá-lo. Escreva sua lógica de envio uma vez e ela funcionará independentemente do provedor de e-mail que seu usuário conectou.
Unipile utiliza exclusivamente OAuth2; nenhuma senha é armazenada. Os usuários passam pela tela de consentimento padrão do provedor e podem revogar o acesso a qualquer momento nas configurações de suas contas Google ou Microsoft. O Unipile possui certificação SOC 2 Tipo II, o que significa que os controles de segurança, incluindo gerenciamento de acesso, criptografia e resposta a incidentes, são auditados independentemente. Os tokens OAuth2 são armazenados em um cofre criptografado e nunca são expostos ao seu aplicativo.

Ainda tem dúvidas? Nossa equipe está aqui para ajudar.

Comece a construir hoje mesmo
Sua API de envio de e-mails, pronta em minutos

Conecte sua primeira conta Gmail, Outlook ou IMAP e envie seu primeiro e-mail programaticamente em menos de 30 minutos. Sem armazenamento de credenciais, sem configuração de OAuth2 do seu lado, sem SDK por provedor. Um account_id, um endpoint REST, todos os provedores.

Iniciar teste grátis Leia a documentação do desenvolvedor
Certificação SOC 2 Tipo II
Não é necessário cartão de crédito
Suporta Gmail, Outlook e IMAP
pt_BRBR
en_USEN fr_FRFR es_ESES de_DEDE it_ITIT nl_NLNL pl_PLPL tr_TRTR pt_BRBR