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.
- Från Kedjebyggareklickar du på Anslutningaroch sedan på Skapa längst upp till höger.
- Under Connector Connection, välj Email och standard CloudRunner.
- Ange ett unikt Namn och Beskrivning för att hjälpa till att identifiera anslutningen.
-
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.
- För Gmailär detta vanligtvis
-
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. - Klicka på Anslut.
- Välj de miljöer som ska använda anslutningen och klicka på Save.
- 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.