AyudaIntegracionesConfigurar el correo del negocio: SMTP, Resend y Gmail
    Integraciones

    Configurar el correo del negocio: SMTP, Resend y Gmail

    Configurá el proveedor de correo del negocio, verificá el remitente, entendé el fallback y diagnosticá límites de envío.

    Qué resuelve

    El correo del tenant permite que los mensajes salgan desde una cuenta del propio comercio o desde el proveedor de plataforma, según la configuración. La elección importa porque afecta identidad del remitente, entregabilidad, límites y quién controla las credenciales.

    Proveedores disponibles

    Structura contempla estos modos de proveedor en la capa de correo:

    • Platform: cuenta global de Structura/fallback.
    • Resend: cuenta Resend propia del tenant.
    • SMTP: servidor SMTP propio mediante host, puerto, usuario y contraseña.
    • Gmail OAuth: conexión autorizada de Gmail sin guardar una contraseña SMTP del usuario.

    SMTP: datos que necesitás

    Antes de abrir la configuración pedile al proveedor de correo:

    • SMTP Host — servidor SMTP del proveedor.
    • SMTP Port — normalmente 587 para STARTTLS o 465 para TLS directo, según proveedor.
    • SMTP User — usuario/cuenta autorizada para enviar.
    • SMTP Password — contraseña o app password, si el proveedor la requiere.
    • From — dirección que aparecerá como remitente y que debe estar autorizada por el proveedor.
    • Reply-To — opcional; dirección donde querés recibir respuestas.

    Structura usa TLS directo cuando el puerto configurado es 465; para el puerto 587 utiliza la conexión SMTP correspondiente al transporte configurado.

    Configurar SMTP paso a paso

    :::steps

    1. Abrí Configuración → Email.
    2. Elegí SMTP como proveedor.
    3. Completá host, puerto, usuario y contraseña.
    4. Definí el remitente From con una dirección que tu proveedor permita utilizar.
    5. Si querés recibir respuestas en otra casilla, configurá Reply-To.
    6. Guardá.
    7. Enviá un correo de prueba a una dirección que controles. :::endsteps

    Cómo verificar que realmente funciona

    No alcanza con que la configuración se guarde. Comprobá que el mensaje llegue, que el remitente sea el esperado, que Reply-To apunte a la casilla correcta y que el proveedor no lo bloquee por autenticación.

    Resend

    Con Resend necesitás una API key y un remitente/dominio autorizado por Resend. Guardá la API key como secreto. No la pegues en scripts del storefront ni la compartas por WhatsApp.

    Gmail OAuth

    Gmail OAuth no funciona como “usuario + contraseña SMTP” dentro de Structura. La conexión usa autorización OAuth y un refresh token para obtener access tokens cuando hay que enviar.

    Para esta modalidad, el administrador debe completar el flujo de conexión de Google y conceder el permiso solicitado. Si la conexión se revoca, el correo deja de poder autenticarse hasta volver a autorizarlo.

    Fallback

    La configuración contempla fallback a la cuenta de plataforma. Una falla del proveedor propio puede terminar enviando por el canal de plataforma si el fallback está habilitado.

    Límites y consumo

    El sistema registra consumo diario y mensual y puede aplicar soft/hard limits. Cuando se alcanza un hard limit, puede utilizarse saldo de pack de email si está disponible; de lo contrario el envío puede bloquearse.

    Errores frecuentes

    • Authentication failed: usuario/contraseña, app password o permisos.
    • Connection timeout: host/puerto, firewall o proveedor.
    • From rejected: remitente/dominio no autorizado.
    • Llega a spam: revisar SPF, DKIM y DMARC con el proveedor.

    Seguridad

    Las credenciales SMTP y API keys son secretos. Si una credencial fue expuesta, rotala.

    Seguí desde acá

    Otras guías que completan esta tarea.