[comment]: # ({473c0010-d40475f4})
# 1 Correo electrónico

[comment]: # ({/473c0010-d40475f4})

[comment]: # ({860d77dd-9d59e93d})
#### Descripción general

Para configurar el correo electrónico como canal de entrega de mensajes, debe configurarlo como tipo de medio y asignar direcciones específicas a los usuarios.

::: noteclassic
Varias notificaciones para un mismo evento se agruparán en el mismo hilo de correo electrónico.
:::

[comment]: # ({/860d77dd-9d59e93d})

[comment]: # ({8dc4cca3-3711e99d})
#### Configuración

Para configurar el correo electrónico como tipo de medio:

1. Vaya a *Alertas > Tipos de medio*.
2. Haga clic en *Crear tipo de medio* (o haga clic en *Email* en la lista de tipos de medio predefinidos).

La pestaña **Tipo de medio** contiene los atributos generales del tipo de medio:

![](../../../../../assets/en/manual/config/notifications/media/media_email.png){width="600"}

Todos los campos de entrada obligatorios están marcados con un asterisco rojo.

:::notewarning
La contraseña se exporta en texto claro al exportar la configuración del tipo de medio de correo electrónico.
:::

Los siguientes parámetros son específicos del tipo de medio de correo electrónico:

|Parámetro|Descripción|
|--|--------|
|*Proveedor de correo electrónico*|Seleccione el proveedor de correo electrónico: *SMTP genérico*, *Gmail*, *Relay de Gmail*, *Office365* o *Relay de Office365*.<br>Si selecciona las opciones relacionadas con Gmail/Office365, solo tendrá que proporcionar la dirección de correo electrónico del remitente y la contraseña; opciones como *Servidor SMTP*, *Puerto del servidor SMTP*, *SMTP helo* y *Seguridad de la conexión* se completarán automáticamente por Zabbix. Véase también: [Tipos de medio automatizados de Gmail/Office365](/manual/config/notifications/media/email/gmail_office). |
|*Servidor SMTP*|Configure un servidor SMTP para gestionar los mensajes salientes.<br>Este campo está disponible si se selecciona *SMTP genérico* como proveedor de correo electrónico.|
|*Puerto del servidor SMTP*|Configure el puerto del servidor SMTP para gestionar los mensajes salientes.<br>Este campo está disponible si se selecciona *SMTP genérico* como proveedor de correo electrónico.|
|*Email*|La dirección introducida aquí se utilizará como dirección **From** para los mensajes enviados.<br>Se admite añadir un nombre para mostrar del remitente (como "Zabbix\_info" en *Zabbix\_info <zabbix\@company.com>* en la captura de pantalla anterior) junto con la dirección de correo electrónico real.<br>Existen algunas restricciones para los nombres para mostrar en los correos electrónicos de Zabbix en comparación con lo permitido por RFC 5322, como se ilustra en los ejemplos:<br>Ejemplos válidos:<br>*zabbix\@company.com* (solo dirección de correo electrónico, no es necesario usar corchetes angulares)<br>*Zabbix\_info <zabbix\@company.com>* (nombre para mostrar y dirección de correo electrónico entre corchetes angulares)<br>*∑Ω-monitoring <zabbix\@company.com>* (caracteres UTF-8 en el nombre para mostrar)<br>Ejemplos no válidos:<br>*Zabbix HQ zabbix\@company.com* (hay nombre para mostrar, pero no hay corchetes angulares alrededor de la dirección de correo electrónico)<br>*"Zabbix\\@\\<H(comment)Q\\>" <zabbix\@company.com>* (aunque es válido según RFC 5322, los pares entrecomillados y los comentarios no son compatibles en los correos electrónicos de Zabbix)|
|*SMTP helo*|Configure un valor SMTP helo correcto, normalmente un nombre de dominio.<br>Si está vacío, se enviará el nombre de dominio del correo electrónico (es decir, lo que aparece después de `@` en el campo *Email*). Si no es posible obtener el nombre de dominio, se registrará una advertencia de nivel de depuración y se enviará el hostname del server como dominio para el comando HELO.<br>Este campo está disponible si se selecciona *SMTP genérico* como proveedor de correo electrónico.|
|*Seguridad de la conexión*|Seleccione el nivel de seguridad de la conexión:<br>**Ninguna** - no usar la opción [CURLOPT\_USE\_SSL](http://curl.haxx.se/libcurl/c/CURLOPT_USE_SSL.html)<br>**STARTTLS** - usar la opción CURLOPT\_USE\_SSL con el valor CURLUSESSL\_ALL<br>**SSL/TLS** - el uso de CURLOPT\_USE\_SSL es opcional|
|*Verificar par SSL*|Marque la casilla para verificar el certificado SSL del servidor SMTP.<br>El valor de la directiva de configuración del server "SSLCALocation" debe colocarse en [CURLOPT\_CAPATH](http://curl.haxx.se/libcurl/c/CURLOPT_CAPATH.html) para la validación del certificado.<br>Esto establece la opción de cURL [CURLOPT\_SSL\_VERIFYPEER](http://curl.haxx.se/libcurl/c/CURLOPT_SSL_VERIFYPEER.html).|
|*Verificar host SSL*|Marque la casilla para verificar que el campo *Common Name* o el campo *Subject Alternate Name* del certificado del servidor SMTP coincidan.<br>Esto establece la opción de cURL [CURLOPT\_SSL\_VERIFYHOST](http://curl.haxx.se/libcurl/c/CURLOPT_SSL_VERIFYHOST.html).|
|*Autenticación*|Seleccione el nivel de autenticación:<br>**Ninguna** - no se establecen opciones de cURL<br>**Nombre de usuario y contraseña** - implica "AUTH=\*" dejando la elección del mecanismo de autenticación a cURL<br>**OAuth** - autenticación OAuth<br>La autenticación OAuth no es compatible con el proveedor de correo electrónico *Relay de Office365*.|
|*Nombre de usuario*|Nombre de usuario que se utilizará en la autenticación.<br>Esto establece el valor de [CURLOPT\_USERNAME](http://curl.haxx.se/libcurl/c/CURLOPT_USERNAME.html).<br>Se admiten [macros de usuario](/manual/appendix/macros/supported_by_location_user#other-locations).|
|*Contraseña*|Contraseña que se utilizará en la autenticación.<br>Esto establece el valor de [CURLOPT\_PASSWORD](http://curl.haxx.se/libcurl/c/CURLOPT_PASSWORD.html).<br>Se admiten [macros de usuario](/manual/appendix/macros/supported_by_location_user#other-locations).<br>El valor introducido aquí se exporta tal cual cuando se exporta la configuración del tipo de medio. Para evitar exponer credenciales sensibles en los archivos exportados, utilice una macro de usuario (por ejemplo, `{$EMAIL_SMTP_PASSWORD}`) en lugar de una contraseña literal; se exportará la referencia a la macro, mientras que el valor secreto deberá configurarse (o volver a configurarse) en el sistema de destino.|
|*Tokens OAuth*|Haga clic en *Configurar* para establecer los parámetros para recuperar [tokens OAuth](#oauth-tokens) en una nueva ventana.<br>Este campo solo está disponible si se selecciona "OAuth" en el campo *Autenticación*.|
|*Formato del mensaje*|Seleccione el formato del mensaje:<br>**HTML** - enviar como HTML<br>**Texto sin formato** - enviar como texto sin formato|

::: noteimportant
Para habilitar la autenticación SMTP, el server de Zabbix debe compilarse con la opción de [compilación](/manual/installation/install/sources#configure-the-sources) `--with-libcurl`, que requiere libcurl (consulte los requisitos de [server](/manual/installation/requirements#serverproxy) para obtener detalles sobre la versión).
:::

Consulte también [parámetros comunes del tipo de medio](/manual/config/notifications/media#common-parameters) para obtener detalles sobre cómo configurar los mensajes predeterminados y las opciones de procesamiento de alertas.

[comment]: # ({/8dc4cca3-3711e99d})

[comment]: # ({6f74aa36-61f2be67})
#### Tokens OAuth

Los siguientes parámetros son necesarios para recuperar tokens OAuth:

![](../../../../../assets/en/manual/config/notifications/media/media_email_oauth.png){width="600"}

|Parámetro|Descripción|
|--|--------|
|*Punto final de redirección*|Introduzca la URL del frontend de Zabbix donde el servicio OAuth redirigirá la autorización OAuth (usando el formato `https://<zabbix-frontend-url>/zabbix.php?action=oauth.authorize`).<br>Se establece automáticamente para un nuevo tipo de medio de correo electrónico cuando se define la [URL del frontend](/manual/web_interface/frontend_sections/administration/general#other).|
|*ID de cliente*|Introduzca el identificador único de la aplicación cliente registrada en el servidor de autorización OAuth.|
|*Secreto de cliente*|Introduzca el secreto privado de la aplicación cliente registrada en el servidor de autorización OAuth.|
|*Punto final de autorización*|Introduzca la URL del servidor de autorización OAuth para solicitar la autorización del usuario.|
|*Parámetros de autorización*|Introduzca los parámetros para el punto final de autorización.|
|*Código de autorización*|Introduzca el código de autorización:<br>**Automático**: el código se recuperará automáticamente a través de una página de redirección<br>**Manual**: introduzca el código manualmente si la recuperación automática falla|
|*Punto final de token*|Introduzca la URL del servidor de autorización OAuth para intercambiar el código de autorización por tokens de acceso y actualización.|
|*Parámetros de token*|Introduzca los parámetros para el token de acceso.|

:::notetip
La recuperación de tokens OAuth tiene [características automatizadas](/manual/config/notifications/media/email/gmail_office#oauth-tokens) para los proveedores de correo electrónico **Gmail**, **Gmail relay** y **Office365**. Solo es necesario proporcionar los valores de los parámetros *Punto final de redirección*, *ID de cliente* y *Secreto de cliente*. Zabbix completará automáticamente los demás valores requeridos (consulte [Valores predeterminados de URL OAuth por proveedor](/manual/config/notifications/media/email/gmail_office#oauth-url-defaults-by-provider)).
:::

[comment]: # ({/6f74aa36-61f2be67})

[comment]: # ({cdcb5c81-7bf715f0})
##### Obtención de tokens de acceso y actualización OAuth

Después de enviar los parámetros OAuth:

1. Se abre una ventana emergente del navegador que dirige al usuario al *Punto final de autorización*.

2. El usuario autoriza a Zabbix en el servicio OAuth.

3. El servicio OAuth redirige al usuario a la acción del frontend de Zabbix `oauth.authorize` con el código de autorización y el valor del alcance.

4. En respuesta, Zabbix realizará una solicitud al *Punto final de token* para intercambiar el código de autorización por los tokens de acceso y actualización.

[comment]: # ({/cdcb5c81-7bf715f0})

[comment]: # ({50e8f033-98f29ec0})
#### Prueba

Para comprobar si un tipo de medio de correo electrónico configurado funciona correctamente:

1. Localice el correo electrónico relevante en la [lista](/manual/config/notifications/media#overview) de tipos de medios.
2. Haga clic en *Probar* en la última columna de la lista (se abrirá una ventana de prueba).
3. Introduzca una dirección de destinatario en *Enviar a*, el cuerpo del mensaje y, opcionalmente, el asunto.
4. Haga clic en *Probar* para enviar un mensaje de prueba.

El mensaje de éxito o fallo de la prueba se mostrará en la misma ventana:

![](../../../../../assets/en/manual/config/notifications/media/test_email0.png){width="600"}

[comment]: # ({/50e8f033-98f29ec0})

[comment]: # ({859be4b6-5e74f274})
#### Medios del usuario

Una vez configurado el tipo de medio de correo electrónico, vaya a la sección *Usuarios > Usuarios* y edite el perfil del usuario para asignarle el medio de correo electrónico.
Los pasos para configurar los medios del usuario, que son comunes para todos los tipos de medios, se describen en la página [Tipos de medios](/manual/config/notifications/media#user-media).

[comment]: # ({/859be4b6-5e74f274})