Tovanix
Tovanix

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.

  1. 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.
  2. 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.
  3. 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.
  4. 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

PlanosMensalAnualE-mails por diaE-mails por mêsContas de envioDestinatários por envio em loteModelos de e-mailContatosCampanhas por mêsVerificações de domínio de envioEndpoints de Webhook
GrátisGrátisGrátis50010,0002100201,000Não incluído1Não incluído
Básico$1.00/mês$10.00/ano5,000100,00051,00010020,0005053
Profissional$5.00/mês$50.00/ano50,0001,000,0002010,0001,000200,0005002020
Empresarial$20.00/mês$200.00/ano200,0005,000,00010050,0009,9992,000,0009,999100100

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…