Do Loops para a Postal, com os mesmos blocos

Em Domínios, a Postal mostra poucos registros para quem cuida do DNS copiar e confere sozinha por até 72 horas. O domínio pode continuar verificado no Loops ao mesmo tempo.

• Pelos nomes, os registros da Postal não colidem com os do Loops. Copie os valores da tela do seu Loops e confira se algum nome é igual antes de publicar.
• A Postal avisa pelo webhook domain.updated quando o domínio vira verified. Veja Domínios e DNS.
• Crie uma chave de API (ela começa com ps_). Para sistemas que só enviam, use uma chave só de envio, restrita ao domínio.

No Loops, a chamada diz só para quem enviar e qual e-mail transacional usar: o remetente, o assunto e o corpo ficam no e-mail cadastrado lá. Na Postal o desenho é parecido, com o template no lugar do e-mail transacional, mas a chamada é outra.

POST https://app.loops.so/api/v1/transactional
Authorization: Bearer <chave do Loops>
Idempotency-Key: pedido-10482-saiu
Content-Type: application/json

{
  "email": "[email protected]",
  "transactionalId": "clomzp89u635xl30px7wrl0ri",
  "dataVariables": { "nome": "Ana", "pedido": "10482" }
}

POST https://api.postal.so/emails
Authorization: Bearer ps_sua_chave
Idempotency-Key: pedido-10482-saiu
Content-Type: application/json

{
  "from": "Aurora Cosméticos <[email protected]>",
  "to": "[email protected]",
  "template": {
    "id": "pedido-enviado",
    "variables": { "nome": "Ana", "pedido": "10482" }
  }
}

• No Loops, quem se descadastrou continua recebendo os e-mails transacionais. Na Postal é igual: só a lista de supressão bloqueia um envio pela API.
• Prefere um SDK? Os da Postal (Node.js, PHP e Laravel) usam esta mesma API. Veja SDKs e CLI e a referência de e-mails.

Por SMTP, o Loops não recebe um e-mail comum: o corpo da mensagem é um JSON com o transactionalId, o endereço do destinatário e os dados do modelo (no exemplo do Laravel da documentação, o endereço de Mail::to() não é usado na entrega). O SMTP da Postal entrega a mensagem como ela chega, com assunto, HTML e os destinatários do próprio e-mail.

{
  "transactionalId": "clomzp89u635xl30px7wrl0ri",
  "email": "[email protected]",
  "dataVariables": { "loginUrl": "https://exemplo.com.br/entrar?code=482913" }
}

- MAIL_HOST=smtp.loops.so- MAIL_PORT=587- MAIL_USERNAME=loops- MAIL_PASSWORD=<chave de API do Loops>- MAIL_ENCRYPTION=tls+ MAIL_SCHEME=smtps+ MAIL_HOST=smtp.postal.so+ MAIL_PORT=465+ MAIL_USERNAME=postal+ MAIL_PASSWORD=ps_sua_chave

• No Laravel, isso quer dizer trocar a visão em texto que montava o JSON por uma visão com o HTML do e-mail, e passar o assunto no Envelope. O endereço de Mail::to() passa a valer.
• Na Postal, a autenticação (AUTH PLAIN ou AUTH LOGIN) vem sempre depois do TLS. O SMTP não tem tags nem agendamento.
• Os envios por SMTP seguem as mesmas regras da API (domínio verificado, cotas e supressão) e aparecem em E-mails e Logs. Veja o guia de SMTP.

Os eventos têm o mesmo papel nos dois: contam à plataforma o que aconteceu no seu produto e iniciam os fluxos. Na Postal, um só POST /events também cadastra ou atualiza a pessoa antes de iniciar as automações.

POST https://app.loops.so/api/v1/events/send
Authorization: Bearer <chave do Loops>
Idempotency-Key: pedido-10482-pago
Content-Type: application/json

{
  "email": "[email protected]",
  "eventName": "pedido_pago",
  "eventProperties": { "total": 289.9 },
  "plano": "pro"
}

POST https://api.postal.so/events
Authorization: Bearer ps_sua_chave
Idempotency-Key: pedido-10482-pago
Content-Type: application/json

{
  "name": "pedido_pago",
  "contact": { "email": "[email protected]" },
  "properties": { "total": 289.9 },
  "contact_properties": { "plano": "pro" }
}

• Um evento sem contact fica registrado, mas não inicia automações. Com um e-mail novo, a Postal cria o contato, avisa o webhook contact.created e inicia as automações de contato criado.
• Um endereço da lista de supressão nunca vira contato: a resposta é 422 email_suppressed.
• Os SDKs de Node.js e PHP (events.send) e a CLI (postal events send) enviam eventos. Veja a referência de eventos.

Os fluxos não passam sozinhos. A boa notícia é que os blocos são quase os mesmos, então a conversão é de nome: abra cada workflow do Loops e monte o equivalente em Automações.

• Cada contato entra uma vez por padrão (reentry: "once"). Para entrar a cada gatilho, use every_time.
• Campanhas e segmentos salvos (saved segments) também são refeitos: campanhas em Campanhas e os segmentos como segmentos dinâmicos. Campanhas já enviadas não são importadas.
• Importações não iniciam automações, a menos que você ligue essa opção. Revise quem entraria antes de ativar. Veja Automações.

A Postal não converte e-mails de outra plataforma. Cole o HTML no editor ou envie por POST /templates. O que muda é a forma de escrever as variáveis.

POST https://api.postal.so/templates
Authorization: Bearer ps_sua_chave
Content-Type: application/json

{
  "name": "Código de acesso",
  "alias": "codigo-de-acesso",
  "subject": "Seu código de acesso",
  "html": "<p>Para entrar, <a href=\"{{{loginUrl}}}\">clique aqui</a>.</p>",
  "variables": [{ "key": "loginUrl" }]
}

• Os nomes das variáveis aceitam letras, números e _, até 50 caracteres. Declare em variables as que têm valor padrão.
• O template guarda também o remetente e o assunto padrão (from, subject), que valem quando o envio não manda os seus.
• Veja a referência de templates; o plano define quantos templates o time tem.

A verificação da assinatura é a mesma nos dois: as documentações descrevem os cabeçalhos webhook-id, webhook-timestamp e webhook-signature e um HMAC-SHA256, em Base64, de id.timestamp.corpo, com o segredo whsec_…. O seu código de verificação deve continuar servindo, só com o segredo do endpoint novo. O que muda são os nomes e o corpo dos eventos.

• Crie o endpoint em Webhooks (painel ou POST /webhooks), escolha os eventos e guarde o signing_secret. Veja a verificação da assinatura.
• Tire o webhook do Loops só depois de virar todo o tráfego: os e-mails que ainda saem por lá continuam gerando eventos.

Na Audiência do Loops, abra o menu ••• no canto da caixa de filtros e escolha Download. Para exportar só um grupo, aplique os filtros antes. O CSV tem uma coluna por propriedade de contato, as padrão e as suas. Na Postal, a importação fica em Audiência, Importar CSV.

• Subscribed é o inverso de Descadastrado. Crie uma coluna Descadastrado com sim onde Subscribed for falso e não onde for verdadeiro. Ou baixe dois arquivos, filtrando por Subscribed, e importe o dos descadastrados com sim em todas as linhas.
• Suprimidos: a documentação do Loops só descreve a consulta de um endereço por vez (GET /v1/contacts/suppression?email=). Para separar os suprimidos dos descadastrados por escolha, consulte cada endereço do arquivo dos descadastrados (o limite é de 10 requisições por segundo) e ponha os suprimidos na lista de supressão com POST /suppressions/batch/add, 100 por requisição, antes de importar contatos.
• Listas: o Loops não documenta se o CSV traz a participação em listas. Se não trouxer, exporte uma lista por arquivo. As listas viram tópicos (públicos ou privados, como lá): importe cada arquivo marcando o tópico em Inscrever nos tópicos. Esse campo inscreve todos os contatos do arquivo.
• Propriedades: os tipos são os mesmos (texto, número, sim/não e data). Source, User Group e Notes viram propriedades que você cria antes, porque a importação não cria propriedades novas. Datas no formato 2026-10-28 funcionam.
• Limite do plano: no Loops, descadastrados não contam no plano. Na Postal, contatos descadastrados ocupam um lugar no limite de contatos (no Grátis são 1.000; no Profissional, 5.000; no Escala, 50.000). Endereços na lista de supressão não ocupam. Veja Preços.
• Deixe desligada a opção Disparar automações. Contatos que já existem são atualizados pelo e-mail, células vazias não apagam valores, e cada arquivo pode ter até 20 MB.
• Antes de enviar, passe a lista pela Validação de e-mails.

Vire um fluxo de cada vez, com o Loops ainda ligado. Comece pelos endereços de teste e por você mesmo, compare entregas e bounces nos primeiros dias e só então passe o resto.