✉️SMTP
Envía correos desde tu propio servidor SMTP (Gmail, Outlook, SendGrid, Mailgun, AWS SES o cualquier relay corporativo) directamente desde un flujo de Dapta. Guía paso a paso para configurar la credenc
📧 Envía correos desde tu propio servidor SMTP — tu remitente, tu dominio, tu entregabilidad.
Es el nodo indicado cuando quieres que los correos salgan desde tu propia dirección y se registren en tu infraestructura saliente — en lugar de pasar por el remitente compartido de Dapta.
📘 Qué aprenderás en este documento:
Paso 1: Añadir tu credencial SMTP
Paso 2: Añadir el nodo SMTP a un flujo
Paso 3: Configurar parámetros y ejecutar
🔐 Paso 1: Añadir tu credencial SMTP
Las credenciales se guardan a nivel de workspace, así que una vez añadidas, todos los flujos del mismo workspace pueden reutilizarlas.
Abrí el menú de usuario abajo a la izquierda (tu avatar / plan del workspace) y hacé clic en Credentials. Vas a aterrizar en /settings/oauth.
Haz clic en + sobre el bloque SMTP Server. Se abre la ventana Connect your email.
Rellena el formulario en tres secciones cortas:
Baja para revisar SECURITY y ADVANCED. Los valores por defecto son correctos para la gran mayoría de proveedores — solo necesitas cambiarlos si tu equipo de IT te dio instrucciones específicas.
Pulsa Save credential. La nueva credencial aparece bajo el bloque SMTP Server.
Referencia de campos
Identity
Name to identify this connection
✓
Etiqueta interna, p. ej. Marketing — SendGrid.
Server
Server address
✓
Host del servidor SMTP.
Server
Port
✓
587 (STARTTLS) o 465 (TLS). El puerto 25 está bloqueado.
Access
Username
✓
El mismo usuario con el que lees el correo. En SendGrid el usuario es literalmente apikey.
Access
Password
✓
Para Gmail o Microsoft 365 usa una App Password, no la contraseña de tu cuenta.
Security
Encrypted from the start (port 465)
–
Marca esta opción cuando el proveedor usa TLS implícito.
Security
Require encrypted connection (port 587)
–
Por defecto. Exige negociación STARTTLS.
Security
Send without encryption
–
Desaconsejado. Solo relays corporativos antiguos.
Security
Accept unverified certificates
–
Certificados autofirmados o con hostname distinto. Desactivado por defecto.
Security
Minimum security level
–
TLS 1.2 (por defecto) o TLS 1.3.
Advanced
Client identifier
–
EHLO/HELO personalizado. Déjalo en blanco salvo que IT te lo pida.
Proveedores comunes — ajustes rápidos
Gmail / Google Workspace
smtp.gmail.com
587
STARTTLS
Usuario = tu dirección. Contraseña = App Password. Requiere 2FA para generarla.
Microsoft 365 / Outlook
smtp.office365.com
587
STARTTLS
App Password o buzón con SMTP-AUTH activado. Microsoft está deprecando basic auth — los tenants modernos necesitarán OAuth (próxima entrega).
SendGrid
smtp.sendgrid.net
587
STARTTLS
Usuario = apikey. Contraseña = tu API key de SendGrid.
Mailgun
smtp.mailgun.org
587
STARTTLS
Credenciales SMTP por dominio desde el panel de Mailgun.
AWS SES
email-smtp.<region>.amazonaws.com
587
STARTTLS
Credenciales SMTP generadas en la consola SES (no son las IAM).
🪄 Paso 2: Añadir el nodo SMTP a un flujo
Abre Flow Studio y crea un flujo nuevo (o abre uno existente). Pulsa ⌘K / Ctrl+K o haz clic en Browse Nodes y escribe smtp.
Selecciona Send SMTP Email. El nodo aparece en el lienzo.
En el panel derecho:
Elige la credencial recién creada en el desplegable Credential.
Si olvidaste crearla, selecciona + Add new credential desde el desplegable — la ventana se abre en línea y la credencial queda autoseleccionada al guardar.
Rellena el resto de parámetros (ver referencia abajo).
Pulsa Save. Ejecuta el flujo para enviar un correo de prueba.
Variables. Cualquier campo de texto del nodo acepta referencias {{trigger.body.campo}} y otras variables de nodos anteriores — útil para personalizar el asunto o el cuerpo.
📋 Referencia de parámetros
Credential
✓
desplegable
Credencial SMTP a utilizar. A nivel de workspace.
To
✓
texto
Uno o más destinatarios separados por coma. Admite Nombre <addr@example.com>.
From
–
texto
Sobrescribe el remitente. Debe ser una dirección permitida por el servidor SMTP.
CC
–
texto
Misma sintaxis que To.
BCC
–
texto
Misma sintaxis que To. Oculto en las cabeceras del correo entregado.
Reply-To
–
texto
Una sola dirección.
Subject
✓
texto
Límite RFC: 998 caracteres.
Body format
✓
text / html
Define qué campo de cuerpo se envía.
Body
condicional
texto
Se usa cuando Body format = text. También se usa como fallback HTML si html_body está vacío.
HTML body
condicional
texto
Se usa cuando Body format = html.
Priority
–
low / normal / high
Establece el encabezado X-Priority.
Custom headers
–
lista clave/valor
Hasta 50 entradas. Los saltos de línea y los encabezados reservados se rechazan (ver abajo).
Attachments
–
URL / Base64 / Buffer
Las URL se descargan con DNS pinning y política de redirección solo-2xx.
On error
–
stop / continue
El valor por defecto en nodos nuevos es stop — fallar rápido en vez de tragarse errores de envío.
Encabezados reservados — no permitidos
Los siguientes nombres de encabezado están bloqueados porque permitirían a un flujo malicioso sobrescribir campos críticos de seguridad o romper el sobre del correo: from, sender, to, cc, bcc, reply-to, return-path, message-id, in-reply-to, references, date, content-type, content-transfer-encoding, mime-version, dkim-signature, received, authentication-results, x-original-to, delivered-to, __proto__, constructor, prototype (sin distinguir mayúsculas). Usa los parámetros dedicados para From / To / Reply-To.
💡 Casos de uso
Correos de bienvenida después de crear un contacto en el CRM.
Confirmación de leads después de que un voice agent califique a un prospecto.
Resumen diario disparado por un trigger Cron que resume la actividad del día anterior.
Alertas internas a tu equipo de operaciones cuando un flujo cae en una rama de fallback.
Notificaciones al cliente que necesitan salir desde tu propio dominio por entregabilidad y confianza de marca.
🛠 Resolución de problemas
EAUTH / fallo de autenticación
Contraseña incorrecta, o se está usando la contraseña normal donde se requiere una App Password.
Genera una App Password en tu cuenta de Google/Microsoft y pégala en la credencial.
ECONNECTION / ETIMEDOUT
Host o puerto incorrectos, firewall bloqueando SMTP saliente.
Verifica host y puerto en la tabla de proveedores. Confirma que el puerto 587/465 está abierto saliente desde el runner.
Self-signed certificate / Hostname mismatch
El certificado del servidor no es de confianza por defecto.
Reemite el certificado con una CA válida, o marca Accept unverified certificates (compromiso de seguridad).
Port 25 is not allowed
La credencial usa el puerto 25.
Cambia a 587 o 465. El puerto 25 está bloqueado al cargar la credencial.
Header value contains forbidden characters
Un \r o \n se coló en un encabezado / asunto / dirección.
Elimina los saltos de línea de la variable antes de pasarla al nodo.
Reserved header is not allowed
Añadiste un encabezado personalizado que está en la lista de denegación.
Usa el parámetro dedicado (p. ej. configura From en lugar de un encabezado From:).
El correo llega a spam
Falta SPF / DKIM / DMARC en tu dominio.
Configura los registros DNS en tu registrador. El nodo no firma nada en tu nombre.
El primer envío tarda unos segundos
Pool de conexiones en frío.
Esperado. Los envíos siguientes dentro del mismo workspace reutilizan la conexión.
🔒 Seguridad y límites
Las credenciales están cifradas en reposo con AES-256.
Las contraseñas nunca aparecen en logs, errores, métricas ni en el historial de workflow.
Las conexiones se agrupan por workspace × credencial × huella de contraseña — las credenciales no se filtran entre workspaces.
Se exige TLS 1.2+. El puerto 25 está prohibido. El tráfico saliente solo se permite a IPs públicas (guard SSRF: RFC1918, link-local, IMDS de AWS, metadata de GCP, etc. están bloqueados).
Las URLs de adjuntos se descargan con DNS pinning,
maxRedirects: 0y verificación de estado solo-2xx.Límite de body / HTML body: 10 MB UTF-8. Límite de asunto: 998 caracteres. Encabezados personalizados: máximo 50 entradas.
ℹ️ Limitaciones conocidas
OAuth (XOAUTH2) para Gmail / Microsoft 365 todavía no está soportado — usa App Passwords por ahora. El soporte de OAuth está en el roadmap.
El manejo de rebotes / DSN no se expone — una respuesta 5xx se registra pero los hard bounces no notifican automáticamente al autor del flujo.
No hay límite de envío por workspace. Ten presente el límite diario de tu proveedor (Gmail 500/día, SES sandbox 200/día, SendGrid varía).
Última actualización