Centro de soporte de Workiva

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.

1. Desde Generador de cadenas, haz clic en Conexiones compare_arrows, y luego en Crea en la parte superior derecha.
2. Debajo de Conector Conexión, selecciona Correo electrónico y el valor predeterminado CloudRunner.
   
3. Introduce un nombre que sea único y una descripción para ayudar a identificar la conexión.

4. 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 ser 587, pero también podría ser 25.
   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.

5. 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.

6. Haz clic en Conectar.
7. Selecciona los entornos para utilizar la conexión y haz clic en Guardar.
8. 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.