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 de Azure
Debes cumplir los siguientes requisitos:
- Tanto una cuenta de Microsoft Azure como una clave de cuenta de Azure.
- Configura un flujo de códigos de autorización de « » en Azure.
- He configurado el servicio Exchange Online de en Azure.
-
Configura el URI de redireccionamiento correcto de ( ) en Azure al configurar el flujo de código de autorización.
Medioambiente URI de redirección Producción en APAC (región de Asia-Pacífico) https://h.apac.wdesk.com/s/wdata/oc/app/oauth/callback CA prod (Canadá) https://h.ca.wdesk.com/s/wdata/oc/app/oauth/callback Productos de la UE (EMEA) https://h.eu.wdesk.com/s/wdata/oc/app/oauth/callback Producción estadounidense (EE. UU., América Central, América del Sur) 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
- Debes haber habilitado el conector de correo electrónico « » de Workiva (para ello, es necesario ser 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 tu 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), introduce los datos de la conexión:
Propiedad Detalles Nombre del host Introduce el nombre de host del servidor SMTP:
- Para en Gmail, suele ser
smtp.gmail.com - Para Microsoft 365, suele ser
smtp.office365.com - En el caso de Mailgun, suele ser
smtp.mailgun.org
Puerto Ingresa el puerto en el que se ejecuta el servidor.
El puerto SMTP predeterminado suele ser587, aunque también podría ser25.TLS activado Si utilizas un servidor SMTP seguro que requiere comunicación cifrada a través de la capa de transporte, configura la opción «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 y almacenan automáticamente mediante el estándar de cifrado avanzado (AES) de 256 bits.
- Para en 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 utilizas la autenticación OAuth2, comprueba que:
- Los valores de ClientID de ( ) y de Client Secret de ( ) son correctos.
- La URI de redirección es correcta en Azure al generar esos valores de ID de cliente y secreto de cliente.
- 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.