Portail de support Workiva

Le connecteur Email vous permet d'inclure une commande Send Email pour envoyer un email dans le cadre d'une chaîne. Cette commande utilise le protocole SMTP (Simple Mail Transfer Protocol) pour envoyer le courrier électronique. L'authentification peut être effectuée à l'aide de l'authentification de base ou de l'authentification OAuth2. Le courriel peut inclure un contexte supplémentaire provenant de commandes antérieures dans la chaîne afin de permettre une meilleure automatisation.

Conditions préalables SMTP

Pour utiliser le connecteur Email, votre organisation a besoin d'informations sur le serveur SMTP de son fournisseur de messagerie, tel que Gmail® ou Microsoft® Office 365®.

Pour configurer le connecteur, vous aurez besoin de :

• Le nom d'hôte du serveur SMTP
• Le port que le serveur SMTP utilise pour envoyer des courriels
• Le domaine HELO, s'il est requis par le serveur SMTP
• Si le serveur SMTP requiert une authentification, le nom d'utilisateur et le mot de passe de l'utilisateur d'intégration en tant que lequel le connecteur doit s'authentifier.

Conditions préalables pour OAuth2

Avant de pouvoir utiliser la sécurité OAuth2 pour ce connecteur, les éléments suivants doivent être présents et mis en œuvre.

Éléments d'Azure

Vous devez disposer des éléments suivants :

• Un compte Microsoft Azure ainsi qu'une clé de compte Azure.
• Configurez un flux de code d'autorisation « » dans Azure.
• Configuration du service Exchange Online « » dans Azure.

• Configurez l'URI de redirection dans Azure lors de la configuration du flux de code d'autorisation.

  Environnement	URI de redirection
  Produits APAC (région Asie-Pacifique)	https://h.apac.wdesk.com/s/wdata/oc/app/oauth/callback
  CA prod (Canada)	https://h.ca.wdesk.com/s/wdata/oc/app/oauth/callback
  Produits de l'UE (EMEA)	https://h.eu.wdesk.com/s/wdata/oc/app/oauth/callback
  Production américaine (États-Unis, Amérique centrale, Amérique du Sud)	https://h.app.wdesk.com/s/wdata/oc/app/oauth/callback

Reportez-vous à la documentation de Microsoft Azure pour obtenir des instructions sur l'obtention et la mise en œuvre de ces conditions préalables.

Éléments Workiva

• Vous devez avoir activé le connecteur de messagerie « Workiva » (pour cela, vous devez disposer d'un accès à en tant qu'administrateur de sécurité de l'organisation).

Mise en place d'un connecteur de courrier électronique

Remarque : Pour que le connecteur soit disponible dans les chaînes de votre organisation, un administrateur de sécurité de l'organisation doit l'activer à partir de Configuration.

1. Depuis Chain Builder, cliquez sur Connections compare_arrows, puis Create en haut à droite.
2. Sous Connector Connection, sélectionnez Email et la valeur par défaut CloudRunner.
   
3. Entrez un nom unique Name et Description pour aider à identifier la connexion.

4. Sous « Propriétés d'», saisissez les informations relatives à la connexion :

   

   Propriété	Détails
   Nom d'hôte	Entrez le nom d'hôte du serveur SMTP : Pour Gmail, il s'agit généralement de smtp.gmail.com Pour Microsoft 365, il s'agit généralement de smtp.office365.com Pour Mailgun, il s'agit généralement de smtp.mailgun.org
   Port	Entrez le port sur lequel le serveur s’exécute. Le port SMTP par défaut est généralement 587, mais il peut également s'agir de 25.
   TLS activé	Si vous utilisez un serveur SMTP sécurisé qui nécessite une communication chiffrée via la couche de transport, configurez le paramètre « Sécurité/Secure Sockets Layer (TLS/SSL) » sur « activé ».
   Domaine HELO	Si le serveur SMTP l'exige, entrez le domaine HELO utilisé pour garantir la réussite de la poignée de main.

   Remarque : Toutes les informations d'identification sensibles sont automatiquement chiffrées et stockées à l'aide du standard AES-256 (Advanced Encryption Standard).

5. Sous Authentication, sélectionnez le type d'authentification que vous souhaitez utiliser et saisissez les informations nécessaires pour authentifier les appels API. Les informations requises dépendent du type d'authentification sélectionné.

   Pour l'authentification de base

   

   Propriété	Détails
   Nom de l'utilisateur	Si le serveur SMTP utilise l'authentification de base, saisissez le nom d'utilisateur de l'utilisateur d'intégration du connecteur.
   Mot de passe	Si le serveur SMTP requiert une authentification de base, saisissez le mot de passe associé au nom d'utilisateur.

    

   Pour Microsoft Office 365 Email OAuth2

   

   Propriété	Détails
   Nom d’utilisateur	Il s'agit du nom d'utilisateur permettant d'accéder au serveur SMTP.
   ID du locataire	Il s'agit de la chaîne d'identification de votre locataire Microsoft.
   Identifiant du client	Il s'agit de l'identifiant du client pour la clé que vous souhaitez que l'API utilise.
   Clé secrète client	Il s'agit du secret du client pour la clé que vous voulez que l'API utilise.

6. Cliquez sur Connecter.
7. Sélectionnez les environnements qui utiliseront la connexion et cliquez sur Enregistrer.
8. Pour tester la connexion, créez et exécutez une chaîne avec la commande Send Email du connecteur pour envoyer un courriel à votre propre adresse électronique, et vérifiez qu'elle renvoie un résultat valide.

Dépannage

Si le connecteur ne parvient pas à envoyer le courrier électronique :

• Vérifiez que le nom d'hôte et le port du serveur SMTP de votre fournisseur d'accès sont corrects.
• Vérifiez que le type de domaine du serveur SMTP est correct (TLS ou HELO).
• Si vous utilisez l'authentification de base, vérifiez que les valeurs du nom d'utilisateur et du mot de passe sont correctes.
• Si vous utilisez l'authentification OAuth2, vérifiez que :
  • Les valeurs « ClientID » de l' et « Client Secret » de l' sont correctes.
  • L'URI de redirection de l',, est correcte dans Azure lors de la génération de ces valeurs d'ID client et de clé secrète client.
• Vérifiez que les adresses électroniques des destinataires saisies pour les entrées To, CC, et BCC de la commande Send Email sont correctes.