Workiva supportcenter

Med Email Connector kan du inkludera ett kommando Send Email för att skicka e-post som en del av en kedja. Detta kommando använder SMTP (Simple Mail Transfer Protocol) för att skicka e-postmeddelandet. Autentisering kan ske med antingen Basic-autentisering eller OAuth2-autentisering. E-postmeddelandet kan innehålla ytterligare sammanhang från tidigare kommandon i kedjan för att möjliggöra förbättrad automatisering.

Förutsättningar för SMTP

För att kunna använda Email Connector behöver din organisation information om SMTP-servern hos sin e-postleverantör, t.ex. Gmail® eller Microsoft® Office 365®.

För att sätta upp kontakten behöver du:

• Värdnamnet på SMTP-servern
• Den port som SMTP-servern använder för att skicka e-post
• HELO-domänen, om så krävs av SMTP-servern
• Om SMTP-servern kräver autentisering, användarnamn och lösenord för den integrationsanvändare som kontakten ska autentisera sig som

Förutsättningar för OAuth2

Innan du kan använda OAuth2-säkerhet för den här kontakten måste följande objekt finnas och implementeras.

Azure-element

Du måste ha:

• Både ett Microsoft Azure -konto och en Azure-kontonyckel.
• Konfigurera ett auktoriseringskodflöde i Azure.
• Konfigurerade Exchange Online-tjänsten i Azure.

• Konfigurera korrekt omdirigerings-URI i Azure när du konfigurerar auktoriseringskodflödet.

  Miljö	Omdirigerings-URI
  APAC-produkt	https://h.apac.wdesk.com/s/wdata/oc/app/oauth/callback
  EU-produkt	https://h.eu.wdesk.com/s/wdata/oc/app/oauth/callback
  Amerikansk produkt	https://h.app.wdesk.com/s/wdata/oc/app/oauth/callback

Se Microsoft Azure-dokumentation för instruktioner om hur du skaffar och implementerar dessa förutsättningar.

Workiva-element

• Du måste ha aktiverat Workiva e-postanslutning (detta kräver en säkerhetsadministratör för organisationen).

Konfigurera en e-postanslutning

Obs: För att göra kopplingen tillgänglig för användning i din organisations kedjor måste en säkerhetsadministratör för organisationen aktivera den från Konfiguration.

1. Från Kedjebyggareklickar du på Anslutningarcompare_arrowsoch sedan på Skapa längst upp till höger.
2. Under Connector Connection, välj Email och standard CloudRunner.
   
3. Ange ett unikt Namn och Beskrivning för att hjälpa till att identifiera anslutningen.

4. Under Egenskaperanger du anslutningens detaljer:

   

   Egenskap	Information
   Värdnamn	Ange SMTP-serverns värdnamn: För Gmailär detta vanligtvis smtp.gmail.com För Microsoft 365är detta vanligtvis smtp.office365.com För Mailgunär detta vanligtvis smtp.mailgun.org
   Port	Ange den port som servern körs på. Standard-SMTP-porten är vanligtvis587, men den kan också vara25.
   TLS aktiverad	Om du använder en säker SMTP-server som kräver krypterad kommunikation via Transport Layer, ställ in Security/Secure Sockets Layer (TLS/SSL) till Aktiverad.
   HELO domän	Om det krävs av SMTP-servern anger du HELO-domänen som används för att säkerställa en lyckad handskakning.

   Obs: Alla känsliga inloggningsuppgifter krypteras automatiskt och lagras med Advanced Encryption Standard (AES)-256-kryptering.

5. Under Authentication väljer du den autentiseringstyp du vill använda och anger den information som behövs för att autentisera API-anropen. Vilken information som krävs beror på vilken typ av autentisering du väljer.

   För grundläggande autentisering

   

   Egenskap	Information
   Användarens namn	Om SMTP-servern använder grundläggande autentisering anger du användarnamnet för connectorens integrationsanvändare.
   Lösenord	Om SMTP-servern kräver grundläggande autentisering anger du det lösenord som är kopplat till användarnamnet.

    

   För Microsoft Office 365 Email OAuth2

   

   Egenskap	Information
   Användarnamn	Detta är användarnamnet för åtkomst till SMTP-servern.
   Hyresgäst-ID	Detta är ID-strängen för din Microsoft-hyresgäst.
   Klient-ID	Detta är klient-ID för den nyckel som du vill att API:et ska använda.
   Klienthemlighet	Detta är klienthemligheten för den nyckel som du vill att API:et ska använda.

6. Klicka på Anslut.
7. Välj de miljöer som ska använda anslutningen och klicka på Save.
8. För att testa anslutningen kan du skapa och köra en kedja med kommandot Send Email i connector för att skicka ett e-postmeddelande till din egen e-postadress och verifiera att det returnerar ett giltigt utdata.

Felsökning

Om kontakten inte kan skicka e-post:

• Kontrollera att värdnamnet och porten för SMTP-servern hos din e-postleverantör är korrekta.
• Kontrollera att SMTP-serverns domäntyp är korrekt (TLS eller HELO).
• Om du använder Basic-autentisering kontrollerar du att användarnamnet och lösenordet är korrekta.
• Om du använder OAuth2-autentisering, verifiera att:
  • Värdena för ClientID och Client Secret är korrekta.
  • Omdirigerings-URI:n är korrekt i Azure vid generering av dessa värden för klient-ID och klienthemlighet.
• Kontrollera att de e-postadresser som angetts för kommandot Send Email i To, CC och BCC är korrekta.