El conector de Correo electrónico te permite incluir un comando Enviar correo electrónico para enviar correo electrónico como parte de una cadena. Este comando utiliza el Protocolo Simple de Transferencia de Correo (SMTP) para enviar el correo electrónico. La autenticación puede hacerse utilizando la autenticación Básica o la autenticación OAuth2. El Correo electrónico puede incluir contexto adicional de comandos anteriores de la cadena para permitir una automatización mejorada.
Requisitos previos SMTP
Para utilizar el conector de Correo electrónico, tu organización necesita información sobre el servidor SMTP de su proveedor de correo electrónico, como Gmail® o Microsoft® Office 365®.
Para configurar el conector, necesitarás:
- El nombre de host del servidor SMTP
- El puerto que utiliza el servidor SMTP para enviar correos electrónicos
- El dominio HELO, si lo requiere el servidor SMTP
- Si el servidor SMTP requiere autenticación, el Nombre de usuario y Contraseña del usuario de integración que el conector debe autenticar como
Requisitos previos de OAuth2
Antes de que puedas utilizar la seguridad OAuth2 para este conector, deben estar presentes e implementados los siguientes elementos.
Elementos azules
Debes tener:
- Tanto una cuenta Microsoft Azure como una clave de cuenta Azure.
- Configure un flujo de código de autorización en Azure.
- Configurado el servicio Exchange Online en Azure.
-
Configure el URI de redirección correcto en Azure al configurar el flujo de código de autorización.
Entorno Redirigir URI APAC prod https://h.apac.wdesk.com/s/wdata/oc/app/oauth/callback Prod UE https://h.eu.wdesk.com/s/wdata/oc/app/oauth/callback EE.UU. prod https://h.app.wdesk.com/s/wdata/oc/app/oauth/callback
Consulta la documentación de Microsoft Azure para ver instrucciones sobre la obtención e implementación de estos requisitos previos.
Elementos de Workiva
- Debe haber habilitado el conector de correo electrónico de Workiva (para ello es necesario un administrador de seguridad de la organización).
Establece el conector de correo electrónico
Nota: Para que el conector esté disponible para su uso en las cadenas de su organización, un administrador de seguridad de la organización debe habilitarlo desde Configuración.
- Desde Generador de cadenas, haz clic en Conexiones , y luego en Crea en la parte superior derecha.
- Debajo de Conector Conexión, selecciona Correo electrónico y el valor predeterminado CloudRunner.
- Introduce un nombre que sea único y una descripción para ayudar a identificar la conexión.
-
En Propiedades, introduzca los datos de la conexión:
Propiedad Detalles Nombre del host Introduce el nombre de host del servidor SMTP:
- Para Gmail, suele ser
smtp.gmail.com - Para Microsoft 365, suele ser
smtp.office365.com - Para Mailgun, suele ser
smtp.mailgun.org
Puerto Ingresa el puerto en el que se ejecuta el servidor.
El puerto SMTP por defecto suele ser587, pero también podría ser25.TLS activado Si utiliza un servidor SMTP seguro que requiere una comunicación cifrada a través de la capa de transporte, configure Seguridad/Capa de sockets seguros (TLS/SSL) en Activado. Dominio HELO Si el servidor SMTP lo requiere, introduce el dominio HELO utilizado para garantizar un apretón de manos correcto. Nota: Todas las credenciales confidenciales se cifran automáticamente y se almacenan utilizando el cifrado Advanced Encryption Standard (AES)-256.
- Para Gmail, suele ser
-
En Autenticación, selecciona el tipo de autenticación que quieres utilizar e introduce la información necesaria para autenticar las llamadas a la API. La información necesaria dependerá del Tipo de Autenticación que selecciones.
Para Autenticación Básica
Propiedad Detalles Nombre de usuario Si el servidor SMTP utiliza la autenticación básica, introduce el Nombre de usuario del usuario de integración del conector. Contraseña Si el servidor SMTP requiere autenticación básica, introduce la Contraseña asociada al Nombre de usuario. Para Microsoft Office 365 Correo electrónico OAuth2
Propiedad Detalles Nombre de usuario Este es el Nombre de usuario para acceder al servidor SMTP. ID del inquilino Esta es la cadena de ID de tu inquilino de Microsoft. ID de cliente Es el Id de cliente de la clave que quieres que utilice la API. Secreto de cliente Es el Secreto de cliente de la clave que quieres que utilice la API. - Haz clic en Conectar.
- Selecciona los entornos para utilizar la conexión y haz clic en Guardar.
- Para probar la conexión, crea y ejecuta una cadena con el comando Enviar correo electrónico del conector para enviar un correo electrónico a tu propia dirección de correo electrónico, y verifica que devuelve un Resultado válido.
Solución de problemas
Si el conector no envía el Correo electrónico:
- Verifica que el nombre de host y el puerto del servidor SMTP de tu proveedor de Correo electrónico son correctos.
- Verifica que el tipo de dominio del servidor SMTP es correcto (TLS o HELO).
- Si utilizas la Autenticación básica, verifica que los valores de Nombre de usuario y Contraseña son correctos.
- Si utiliza la autenticación OAuth2, compruebe que:
- los valores ClientID y Client Secret son correctos.
- el Redirect URI es correcto en Azure al generar esos valores de Client ID y Client Secret.
- Verifica que las direcciones de correo electrónico del destinatario introducidas en las entradas Para, CC y CCO del comando Enviar correo electrónico son correctas.