Introdução ao Publiq
O Publiq é a API de e-mail com observabilidade nativa: envie e-mails transacionais e de marketing e acompanhe entrega, aberturas e cliques em tempo real, com SDKs para Node e Python.
O Publiq é uma plataforma de envio de e-mails feita para desenvolvedores. Com uma única API REST (e SDKs oficiais para Node.js e Python), você envia e-mails transacionais — como confirmações, recuperação de senha e recibos — e campanhas de marketing, sempre com métricas de entrega, abertura e clique em tempo real.
A diferença do Publiq é a observabilidade nativa: cada e-mail é rastreável do pedido até a caixa de entrada, com eventos de queued, sent, delivered, opened, clicked e bounced disponíveis por webhooks e no painel. Você para de adivinhar por que um e-mail não chegou.
Para quem é
- Times de produto que precisam de e-mails transacionais confiáveis (signup, reset de senha, recibos)
- Times de growth/marketing que enviam broadcasts segmentados e newsletters
- Qualquer app que queira automações acionadas por eventos (ex.: onboarding em 3 e-mails)
Conceitos principais
- Emails — o envio em si, transacional, via SDK ou API.
- Templates — corpos versionados com variáveis
{{ }}, referenciados portemplateKey. - Eventos & Automações — dispare eventos que acionam fluxos automáticos.
- Contatos — pessoas e seus atributos, usados como variáveis padrão.
- Webhooks — receba eventos de entrega em tempo real (veja Webhooks).
- Domínios — verifique seu domínio (SPF/DKIM) para entregar de verdade (veja Domínios).
Transacional vs. marketing
E-mails transacionais são 1-para-1, disparados por uma ação do usuário (confirmar conta, redefinir senha) e usam o endpoint de Emails. E-mails de marketing são 1-para-muitos (broadcasts, newsletters) enviados a listas/segmentos. O Publiq cobre os dois com a mesma infraestrutura de entrega e observabilidade — mas trata supressão e descadastro de forma adequada a cada caso.
Pronto para começar? Siga a Instalação e depois o Quickstart para enviar seu primeiro e-mail em menos de 5 minutos.