Configurar SMTP para correos del sistema

Configura SMTP desde Administración del sistema o mediante variables de entorno para enviar invitaciones, restablecimientos de contraseña y notificaciones.

​

Métodos de configuración

Teable admite dos formas de configurar el servicio de correo electrónico:

Administración del sistema (recomendado)

Configuración visual con pruebas en directo. No requiere reiniciar.

Variables de entorno

Configuración tradicional mediante el archivo .env. Requiere reiniciar el contenedor.

---

​

Opción 1: Administración del sistema (recomendado)

La forma más sencilla de configurar el correo electrónico es mediante Administración del sistema:

1. Inicia sesión como administrador (el primer usuario registrado)
2. Ve a Administración del sistema → Configuración de instancia
3. Busca la sección Configuración de Correo
4. Configura Correo de Notificación y Correo de Automatización según tus necesidades: haz clic en el botón situado a la derecha de la fila, introduce los datos SMTP en el cuadro de diálogo y guárdalos

El cuadro de configuración admite pruebas en directo: antes de guardar, introduce un correo de prueba y haz clic en Enviar para comprobar que los ajustes de SMTP funcionan.

• Correo de Notificación: se utiliza para verificar usuarios, restablecer contraseñas, enviar invitaciones y notificaciones del sistema y otros correos similares. También es lo que habilita Iniciar sesión con código por correo en la página de inicio de sesión.
• Correo de Automatización: se utiliza como servicio de correo predeterminado para las acciones Enviar correo electrónico de las Automatizaciones. Cada acción Enviar correo electrónico también puede configurar su propio servidor SMTP personalizado.

​

Fuentes de configuración y prioridad

Recomendamos configurar primero el servicio de correo en Administración del sistema → Configuración de instancia → Configuración de Correo. El orden de prioridad efectivo es:

1. Servidor de correo personalizado dentro de la acción Enviar correo electrónico: solo se aplica a esa acción concreta de la Automatización actual.
2. Administración del sistema → Configuración de instancia → Configuración de Correo → Correo de Automatización: se utiliza para los correos de las Automatizaciones cuando la acción Enviar correo electrónico no configura su propio servidor.
3. Administración del sistema → Configuración de instancia → Configuración de Correo → Correo de Notificación: se utiliza para verificar usuarios, restablecer contraseñas, enviar invitaciones y notificaciones del sistema y otros correos similares. También se utiliza como alternativa para los correos de Automatizaciones si no se ha configurado el Correo de Automatización.
4. Variables de entorno BACKEND_MAIL_*: configuración de correo predeterminada a nivel de despliegue. Solo se utiliza como alternativa cuando el buzón correspondiente no está configurado en Administración del sistema.

​

Campos de configuración

Campo	Descripción	Ejemplo
Dirección del servidor	Dirección del servidor SMTP	smtp.gmail.com
Puerto	Puerto SMTP	465 (SSL) o 587 (TLS)
SSL/TLS	Indica si se utiliza SSL/TLS	true
Nombre de usuario	Usuario de autenticación SMTP	[e-mail]
Contraseña	Contraseña SMTP o contraseña de aplicación	xxxxxxxxxxxxxx
Dirección del remitente	Dirección del campo De	[e-mail]
Nombre del remitente	Nombre para mostrar	Notificaciones de Teable

---

​

Opción 2: variables de entorno

En los despliegues donde prefieras una configuración basada en archivos, utiliza variables de entorno:

Recomendamos configurar primero Correo de Notificación y Correo de Automatización en Administración del sistema → Configuración de instancia → Configuración de Correo. Las variables de entorno se utilizan principalmente como valores predeterminados a nivel de despliegue y como configuración alternativa.

BACKEND_MAIL_HOST=smtp.example.com
BACKEND_MAIL_PORT=465
BACKEND_MAIL_SECURE=true
BACKEND_MAIL_SENDER=[e-mail]
BACKEND_MAIL_SENDER_NAME=Teable
BACKEND_MAIL_AUTH_USER=username
BACKEND_MAIL_AUTH_PASS=your_password

Después de modificar las variables de entorno, debes reiniciar el contenedor de Teable para que los cambios surtan efecto.

---

​

Ejemplos de proveedores SMTP

AWS SES

# Cómo obtener las credenciales: Consola de AWS → Simple Email Service → Ajustes de SMTP → Crear credenciales SMTP
BACKEND_MAIL_HOST=email-smtp.us-east-1.amazonaws.com  # Sustituir por tu región
BACKEND_MAIL_PORT=465
BACKEND_MAIL_SECURE=true
BACKEND_MAIL_SENDER=[e-mail]  # Debe ser una dirección de remitente verificada
BACKEND_MAIL_SENDER_NAME=Notificaciones de Teable
BACKEND_MAIL_AUTH_USER=your_smtp_username   # Nombre de usuario SMTP de AWS
BACKEND_MAIL_AUTH_PASS=xxxxxxxxxxxxxx       # Contraseña SMTP de AWS

Gmail

# Cómo obtenerla: Cuenta de Google → Seguridad → Verificación en dos pasos → Contraseñas de aplicaciones
BACKEND_MAIL_HOST=smtp.gmail.com
BACKEND_MAIL_PORT=465
BACKEND_MAIL_SECURE=true
BACKEND_MAIL_SENDER=[e-mail]
BACKEND_MAIL_SENDER_NAME=Notificaciones de Teable
BACKEND_MAIL_AUTH_USER=[e-mail]
BACKEND_MAIL_AUTH_PASS=xxxxxxxxxxxxxx  # Contraseña de aplicación de 16 dígitos

Microsoft 365 / Outlook

# Cómo obtenerla: Centro de administración de Microsoft 365 → Seguridad → Directivas y reglas → Autenticación del correo electrónico
BACKEND_MAIL_HOST=smtp.office365.com
BACKEND_MAIL_PORT=587
BACKEND_MAIL_SECURE=true
BACKEND_MAIL_SENDER=[e-mail]
BACKEND_MAIL_SENDER_NAME=Notificaciones de Teable
BACKEND_MAIL_AUTH_USER=[e-mail]
BACKEND_MAIL_AUTH_PASS=xxxxxxxxxxxxxx  # Tu contraseña de Microsoft 365 o contraseña de aplicación

SendGrid

# Cómo obtenerla: Panel de SendGrid → Ajustes → Claves de API → Crear clave de API
BACKEND_MAIL_HOST=smtp.sendgrid.net
BACKEND_MAIL_PORT=465
BACKEND_MAIL_SECURE=true
BACKEND_MAIL_SENDER=[e-mail]
BACKEND_MAIL_SENDER_NAME=Notificaciones de Teable
BACKEND_MAIL_AUTH_USER=apikey
BACKEND_MAIL_AUTH_PASS=xxxxxxxxxxxxxx  # Tu clave de API de SendGrid

---

​

Documentación relacionada

• Referencia de variables de entorno
• Descripción general de Administración del sistema