De Loops a Postal, con los mismos bloques

En Dominios, Postal muestra pocos registros para que quien se encarga del DNS los copie, y los comprueba sola durante hasta 72 horas. El dominio puede seguir verificado en Loops al mismo tiempo.

• Por los nombres, los registros de Postal no chocan con los de Loops. Copia los valores de la pantalla de tu Loops y comprueba si algún nombre es igual antes de publicar.
• Postal avisa por el webhook domain.updated cuando el dominio pasa a verified. Consulta Dominios y DNS.
• Crea una clave de API (empieza con ps_). Para sistemas que solo envían, usa una clave solo de envío, restringida al dominio.

En Loops, la llamada indica solo a quién enviar y qué correo transaccional usar: el remitente, el asunto y el cuerpo quedan en el correo registrado allí. En Postal el diseño es parecido, con la plantilla en lugar del correo transaccional, pero la llamada es otra.

POST https://app.loops.so/api/v1/transactional
Authorization: Bearer <clave de 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" }
  }
}

• En Loops, quien canceló su suscripción sigue recibiendo los correos transaccionales. En Postal es igual: solo la lista de supresión bloquea un envío por la API.
• ¿Prefieres un SDK? Los de Postal (Node.js, PHP y Laravel) usan esta misma API. Consulta SDKs y CLI y la referencia de correos.

Por SMTP, Loops no recibe un correo común: el cuerpo del mensaje es un JSON con el transactionalId, la dirección del destinatario y los datos del modelo (en el ejemplo de Laravel de la documentación, la dirección de Mail::to() no se usa en la entrega). El SMTP de Postal entrega el mensaje tal como llega, con asunto, HTML y los destinatarios del propio correo.

{
  "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

• En Laravel, esto significa cambiar la vista de texto que armaba el JSON por una vista con el HTML del correo, y pasar el asunto en el Envelope. La dirección de Mail::to() pasa a valer.
• En Postal, la autenticación (AUTH PLAIN o AUTH LOGIN) viene siempre después del TLS. El SMTP no tiene etiquetas ni programación.
• Los envíos por SMTP siguen las mismas reglas de la API (dominio verificado, cuotas y supresión) y aparecen en Correos y Registros. Consulta la guía de SMTP.

Los eventos cumplen el mismo papel en ambos: cuentan a la plataforma lo que pasó en tu producto e inician los flujos. En Postal, un solo POST /events también registra o actualiza a la persona antes de iniciar las automatizaciones.

POST https://app.loops.so/api/v1/events/send
Authorization: Bearer <clave de 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" }
}

• Un evento sin contact queda registrado, pero no inicia automatizaciones. Con un correo nuevo, Postal crea el contacto, avisa al webhook contact.created e inicia las automatizaciones de contacto creado.
• Una dirección de la lista de supresión nunca se convierte en contacto: la respuesta es 422 email_suppressed.
• Los SDK de Node.js y PHP (events.send) y la CLI (postal events send) envían eventos. Consulta la referencia de eventos.

Los flujos no pasan solos. La buena noticia es que los bloques son casi los mismos, así que la conversión es de nombres: abre cada workflow de Loops y arma el equivalente en Automatizaciones.

• Cada contacto entra una vez de forma predeterminada (reentry: "once"). Para que entre con cada disparador, usa every_time.
• Las campañas y los segmentos guardados (saved segments) también se rehacen: las campañas en Campañas y los segmentos como segmentos dinámicos. Las campañas ya enviadas no se importan.
• Las importaciones no inician automatizaciones, a menos que actives esa opción. Revisa quién entraría antes de activarla. Consulta Automatizaciones.

Postal no convierte correos de otra plataforma. Pega el HTML en el editor o envíalo por POST /templates. Lo que cambia es la forma de escribir las variables.

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

{
  "name": "Código de acceso",
  "alias": "codigo-de-acesso",
  "subject": "Tu código de acceso",
  "html": "<p>Para entrar, <a href=\"{{{loginUrl}}}\">haz clic aquí</a>.</p>",
  "variables": [{ "key": "loginUrl" }]
}

• Los nombres de las variables admiten letras, números y _, hasta 50 caracteres. Declara en variables las que tienen valor predeterminado.
• La plantilla guarda también el remitente y el asunto predeterminado (from, subject), que valen cuando el envío no manda los suyos.
• Consulta la referencia de plantillas; el plan define cuántas plantillas tiene el equipo.

La verificación de la firma es la misma en ambos: las documentaciones describen los encabezados webhook-id, webhook-timestamp y webhook-signature y un HMAC-SHA256, en Base64, de id.timestamp.corpo, con el secreto whsec_…. Tu código de verificación debería seguir sirviendo, solo con el secreto del nuevo endpoint. Lo que cambia son los nombres y el cuerpo de los eventos.

• Crea el endpoint en Webhooks (panel o POST /webhooks), elige los eventos y guarda el signing_secret. Consulta la verificación de la firma.
• Quita el webhook de Loops solo después de cambiar todo el tráfico: los correos que aún salen por allí siguen generando eventos.

En la Audiencia de Loops, abre el menú ••• en la esquina del cuadro de filtros y elige Download. Para exportar solo un grupo, aplica los filtros antes. El CSV tiene una columna por propiedad de contacto, las predeterminadas y las tuyas. En Postal, la importación está en Audiencia, Importar CSV.

• Subscribed es lo inverso de Dado de baja. Crea una columna Dado de baja con sim donde Subscribed sea falso y não donde sea verdadero. O descarga dos archivos, filtrando por Subscribed, e importa el de los dados de baja con sim en todas las filas.
• Suprimidos: la documentación de Loops solo describe la consulta de una dirección por vez (GET /v1/contacts/suppression?email=). Para separar los suprimidos de los dados de baja por elección, consulta cada dirección del archivo de los dados de baja (el límite es de 10 solicitudes por segundo) y pon los suprimidos en la lista de supresión con POST /suppressions/batch/add, 100 por solicitud, antes de importar contactos.
• Listas: Loops no documenta si el CSV trae la pertenencia a listas. Si no la trae, exporta una lista por archivo. Las listas pasan a ser temas (públicos o privados, como allá): importa cada archivo marcando el tema en Suscribir a los temas. Ese campo suscribe a todos los contactos del archivo.
• Propiedades: los tipos son los mismos (texto, número, sí/no y fecha). Source, User Group y Notes pasan a ser propiedades que creas antes, porque la importación no crea propiedades nuevas. Las fechas en formato 2026-10-28 funcionan.
• Límite del plan: en Loops, los dados de baja no cuentan en el plan. En Postal, los contactos dados de baja ocupan un lugar en el límite de contactos (en Gratis son 1.000; en Profesional, 5.000; en Escala, 50.000). Las direcciones en la lista de supresión no ocupan. Consulta Precios.
• Deja desactivada la opción Disparar automatizaciones. Los contactos que ya existen se actualizan por el correo, las celdas vacías no borran valores, y cada archivo puede tener hasta 20 MB.
• Antes de enviar, pasa la lista por la Verificación de correos.

Cambia un flujo a la vez, con Loops todavía activo. Empieza por las direcciones de prueba y por ti mismo, compara entregas y rebotes en los primeros días y solo entonces pasa el resto.