Publiq

Relay SMTP

Envie e-mails via SMTP AUTH sem expor o provedor por trás do Publiq — mesmo pipeline de envio e observabilidade do endpoint HTTP.

Se o seu sistema já fala SMTP (um ERP legado, uma ferramenta que só sabe enviar por smtplib/nodemailer, um script antigo), você não precisa migrar para a API HTTP para usar o Publiq. O relay SMTP é um ingress que aceita conexões SMTP autenticadas e injeta cada mensagem no mesmo pipeline de envio usado por emails.send — fila, renderização, entrega e todos os eventos de observabilidade (sent, delivered, opened, clicked, bounced). O Publiq nunca expõe qual provedor de entrega está por trás: para o seu cliente SMTP, só existe smtp.publiq.digital.

Não é um relay aberto. Toda conexão precisa autenticar com AUTH — não existe envio anônimo.

Portas: 587 (STARTTLS) ou 465 (TLS implícito)

O relay escuta em duas portas, ambas cifradas:

  • 587 — envio com STARTTLS. A conexão começa em texto claro e faz upgrade para TLS antes do AUTH. É a porta padrão da maioria das bibliotecas SMTP modernas.
  • 465 — TLS implícito. A conexão já nasce cifrada (TLS desde o handshake inicial), sem upgrade. Prefira esta porta se seu cliente/biblioteca suporta TLS implícito diretamente.

Use a que for mais simples de configurar no seu cliente — o comportamento de envio é idêntico nas duas.

A autenticação (AUTH) só é aceita depois que o canal está cifrado (STARTTLS ou TLS implícito). Não há fallback em texto claro — tentar autenticar antes do TLS é rejeitado.

Autenticação

O relay aceita AUTH PLAIN ou AUTH LOGIN. O usuário pode ser qualquer valor (não é verificado) — quem autentica de verdade é a senha, que precisa ser uma API Key do Publiq com escopo send-only. Isso é o mesmo padrão usado por relays SMTP como SendGrid e Mailgun, então se você já integrou com algum deles a configuração vai parecer familiar.

Exemplo de configuração de um cliente SMTP genérico:

Host:     smtp.publiq.digital   (verifique o host exato no seu painel — smtp.publiq.digital é ilustrativo)
Porta:    587 (STARTTLS) ou 465 (TLS implícito)
Usuário:  qualquer valor (ex.: "publiq")
Senha:    postly_sk_... (sua API Key com escopo send-only)

O remetente (from) e os destinatários (to) são lidos diretamente dos comandos MAIL FROM / RCPT TO do protocolo SMTP — não dos cabeçalhos MIME. Assunto, corpo (texto/HTML) e anexos vêm normalmente do corpo da mensagem.

Duas restrições importantes:

  • Tamanho máximo da mensagem: 25 MB. Mensagens maiores são rejeitadas antes de entrar no pipeline.
  • A API Key precisa do escopo send-only. Chaves com escopo full ou read-only são rejeitadas com erro de autenticação (SMTP 535) — o relay não aceita nenhum outro escopo.

Veja também

Relay SMTP — Publiq Docs