API de agregação SMTP
Conecte suas próprias contas de envio SMTP à plataforma e envie e-mails por uma única API HTTP. A plataforma alterna o envio entre suas contas, tenta novamente com a próxima conta quando uma falha e oferece modelos, contatos, campanhas, uma lista de cancelamento de inscrição e callbacks de Webhook. O plano gratuito vem ativado por padrão; os planos pagos são cobrados do saldo da sua conta.
Como funciona
A plataforma não oferece serviço de envio nem IPs de envio. Os e-mails saem pelas contas que você conecta; a plataforma escolhe a conta, faz novas tentativas, mantém os registros e envia os callbacks.
- Conecte contas de envio: Adicione uma conta SMTP no console: host, porta, criptografia, usuário e senha (ou senha de app). Você pode testar a conexão e enviar um e-mail de teste antes. As senhas são armazenadas criptografadas.
- Crie uma chave de API: Gere uma chave que começa com smk_ e envie-a no cabeçalho Authorization: Bearer. Você pode criar várias chaves e revogar cada uma separadamente.
- Chame a API de envio: A conta é escolhida pela prioridade que você define e pelo volume que ela já enviou hoje. Em caso de falha de autenticação, falha de conexão ou erro temporário, a próxima conta é tentada, com no máximo 3 tentativas.
- Confira o resultado: O registro de envio mostra o status de cada e-mail, a conta usada e o erro, se houver. Quando o servidor de destino aceita um e-mail, ele é marcado como entregue, e o evento pode ser enviado ao seu Webhook.
Recursos
- Rotação de contas e nova tentativa: As contas são escolhidas pela prioridade e pelo volume do dia, e cada conta pode ter seu próprio limite diário. Falhas da conta e erros temporários são tentados novamente em outra conta; erros que nenhuma conta resolve, como um endereço inexistente ou conteúdo rejeitado, não são tentados de novo. Você também pode fixar um envio em uma conta específica.
- Pausa e recuperação automáticas: Uma conta que falha 3 vezes seguidas é pausada, e você é notificado. Depois, a plataforma testa a conexão dela em intervalos que crescem de 30 minutos a 12 horas e só a devolve à rotação quando um teste passa. Contas pausadas por você nunca são reativadas automaticamente.
- Modelos e variáveis: Corpo em HTML e em texto simples, com substituição de {{variable}}. Cada salvamento registra uma versão, e você pode ver o histórico de versões. A API pode enviar pelo código do modelo.
- Contatos e campanhas: Importe contatos de CSV (até 10 MB por arquivo) e organize-os em grupos. As campanhas enviam para grupos ou para uma lista, podem ser agendadas, pausadas e canceladas e ignoram automaticamente endereços com inscrição cancelada ou com devolução.
- Rastreamento de aberturas e cliques, cancelamento de inscrição com um clique: E-mails HTML de campanhas podem ativar o rastreamento de aberturas e cliques, e {{unsubscribe_url}} no corpo é substituído pelo link de cancelamento de inscrição de cada destinatário. Todo e-mail de campanha leva um cabeçalho de cancelamento de inscrição com um clique.
- Lista de cancelamentos de inscrição e devoluções: Endereços que tiveram devolução ou reclamação não recebem mais nenhum e-mail, nem mesmo e-mails transacionais. Endereços que clicaram para cancelar a inscrição ou foram adicionados manualmente são ignorados apenas em campanhas e envios em lote, não em e-mails transacionais como códigos de verificação e redefinições de senha.
- Callbacks de eventos via Webhook: Eventos como entregue, aberto, clicado, devolvido, reclamação e inscrição cancelada são enviados à sua URL com assinatura HMAC-SHA256. Também podem ir direto para bots de grupo do Slack, Discord, Feishu, DingTalk e WeCom.
- Verificação de domínio de envio: Verifica os registros SPF, DKIM e DMARC de um domínio de envio e informa uma pontuação e os registros DNS a adicionar.
Integração
Uma API HTTP com corpo de requisição em JSON e autenticação por chave de API. No console, você também pode escrever um e-mail avulso ou criar uma campanha sem código.
- POST /api/v1/smtp/send: Envia um e-mail. Aceita CC e CCO, anexos, imagens embutidas, alternativa em texto simples, cabeçalhos personalizados e envio agendado, com um Idempotency-Key para evitar duplicidade.
- POST /api/v1/smtp/send/batch: Envia um e-mail para cada um de vários destinatários em uma só chamada; o limite de destinatários depende do plano.
- POST /api/v1/smtp/send/template: Envia pelo código do modelo e preenche as variáveis do modelo.
- GET /api/v1/smtp/status/{message_id}: Consulta o status de entrega de um e-mail.
- GET /api/v1/smtp/quota: Consulta a cota restante de hoje e deste mês.
- POST /api/v1/smtp/inbound: Informa uma devolução ou reclamação; o endereço é adicionado à lista de cancelamento de inscrição.
Limites
- Até 20 requisições por segundo por chave de API e 60 por segundo por conta.
- Até 20 anexos por e-mail, com 15 MB no total após a decodificação.
- Envios agendados precisam estar pelo menos 30 segundos no futuro, com até 500 na fila por conta.
- Só a API HTTP está disponível; não há acesso pelo protocolo SMTP.
Regras de planos e cotas
- O plano gratuito vem ativado por padrão, sem assinatura, e se renova sozinho quando vence.
- A cota diária é zerada à meia-noite no fuso horário da sua conta; a cota mensal é zerada no dia 1 de cada mês.
- Os planos pagos são cobrados mensal ou anualmente do saldo da sua conta e podem ser renovados no console antes do vencimento. Eles não são renovados automaticamente.
- Quando um plano pago vence, você volta às cotas e aos recursos do plano gratuito. Contas conectadas, modelos e contatos não são excluídos.
- A troca de plano vale na hora. O tempo não usado do plano antigo é creditado pelo preço original; o crédito que passar do preço do novo plano prolonga sua vigência em vez de ser reembolsado. O uso deste mês passa para o novo plano.
- Os e-mails saem pelas contas que você conecta, então a chegada à caixa de entrada depende da reputação dessas contas e do seu domínio de envio. A plataforma não promete uma taxa de entrega.
Planos e preços
| Planos | Mensal | Anual | E-mails por dia | E-mails por mês | Contas de envio | Destinatários por envio em lote | Modelos de e-mail | Contatos | Campanhas por mês | Verificações de domínio de envio | Endpoints de Webhook |
|---|---|---|---|---|---|---|---|---|---|---|---|
| Grátis | Grátis | Grátis | 500 | 10,000 | 2 | 100 | 20 | 1,000 | Não incluído | 1 | Não incluído |
| Básico | $1.00/mês | $10.00/ano | 5,000 | 100,000 | 5 | 1,000 | 100 | 20,000 | 50 | 5 | 3 |
| Profissional | $5.00/mês | $50.00/ano | 50,000 | 1,000,000 | 20 | 10,000 | 1,000 | 200,000 | 500 | 20 | 20 |
| Empresarial | $20.00/mês | $200.00/ano | 200,000 | 5,000,000 | 100 | 50,000 | 9,999 | 2,000,000 | 9,999 | 100 | 100 |
Os preços estão em USD e são o preço padrão exibido a visitantes sem login. Pontos podem cobrir parte do valor; vale o valor mostrado na página do pedido. As cotas contam e-mails enviados, e envios em lote e campanhas contam um e-mail por destinatário.
Perguntas frequentes
O que a API de agregação SMTP faz?
Ela permite conectar uma ou mais contas de envio SMTP suas e enviar e-mails por uma única API HTTP. A plataforma alterna entre as contas, tenta novamente em outra conta quando uma falha e oferece modelos, contatos, campanhas, uma lista de cancelamento de inscrição e callbacks de Webhook. A plataforma em si não oferece serviço de envio.
Do que eu preciso?
De pelo menos uma conta de envio em que você consiga fazer login por SMTP: o SMTP de um provedor de e-mail, um e-mail empresarial ou seu próprio servidor de e-mail servem. Você precisa do host, da porta, do usuário e da senha (ou senha de app). Para campanhas, configure antes SPF, DKIM e DMARC no seu domínio de envio.
Quais são os limites do plano gratuito?
Volume de envio, contas de envio, modelos e contatos estão na tabela de planos. O plano gratuito não inclui campanhas nem webhooks; todos os outros endpoints de envio funcionam. Ele não exige assinatura e continua disponível.
Vocês garantem a entrega na caixa de entrada?
Não. Os e-mails saem pelas contas que você conecta, e o lado receptor decide entre caixa de entrada e spam com base na reputação da conta e do domínio de envio e no conteúdo. A plataforma pode verificar os registros SPF, DKIM e DMARC do seu domínio e ignora automaticamente endereços que tiveram devolução ou reclamação.
Posso me conectar à plataforma diretamente por SMTP?
Não. Só estão disponíveis a API HTTP e a escrita de e-mails e criação de campanhas no console. A plataforma se conecta às contas SMTP que você adiciona para enviar e-mails; ela não oferece relay SMTP.
O que acontece se uma conta continuar falhando?
Uma conta que falha 3 vezes seguidas é pausada, e você é notificado, enquanto suas outras contas continuam enviando. Depois, a plataforma testa a conexão dessa conta regularmente e só a devolve à rotação quando um teste passa. Alterar os dados de conexão dela ou reativá-la você mesmo também a restaura na hora.
Como as cotas são contadas e o que acontece quando acabam?
As cotas contam e-mails enviados, e envios em lote e campanhas contam um e-mail por destinatário. A cota diária é zerada à meia-noite, e a mensal, no dia 1 de cada mês. Quando uma cota se esgota, a API de envio recusa novas requisições; aguarde a cota ser zerada ou faça upgrade, o que vale na hora.
Posso usar a partir de um cliente de IA?
Sim. Depois de conectar sua conta em um cliente de IA compatível com MCP, você pode consultar planos e uso, ler registros de envio, enviar para 1 a 10 destinatários e gerenciar contatos, modelos, webhooks e domínios de envio. Renovar exige um código de uso único.
Páginas relacionadas: Roteamento de entrada e API de envio para seu domínio · E-mail empresarial com seu próprio domínio · Verificação por SMS · API de e-mail SMTP · Usar a API de agregação SMTP
Carregando…