Med e-postkoblingen kan du inkludere en Send e-post -kommando for å sende e-post som en del av en kjede. Denne kommandoen bruker Simple Mail Transfer Protocol (SMTP) til å sende e-posten. Autentisering kan gjøres ved hjelp av enten grunnleggende autentisering eller OAuth2-autentisering. E-posten kan inkludere ytterligere kontekst fra tidligere kommandoer i kjeden for å muliggjøre forbedret automatisering.
SMTP-forutsetninger
For å bruke e-postkoblingen trenger organisasjonen din informasjon om SMTP-serveren til e-postleverandøren, for eksempel Gmail® eller Microsoft® Office 365®.
For å sette opp koblingen trenger du:
- Vertsnavnet til SMTP-serveren
- Porten SMTP-serveren bruker til å sende e-post
- HELO-domenet, hvis det kreves av SMTP-serveren
- Hvis SMTP-serveren krever autentisering, må brukernavnet og passordet til integrasjonsbrukeren som koblingen skal autentisere som
OAuth2-forutsetninger
Før du kan bruke OAuth2-sikkerhet for denne koblingen, må følgende elementer være til stede og implementert.
Azure-elementer
Du må ha:
- Både en Microsoft Azure -konto og en Azure-kontonøkkel.
- Sett opp en autorisasjonskodeflyt i Azure.
- Konfigurerte Exchange Online-tjenesten i Azure.
-
Konfigurer riktig omdirigerings-URI i Azure når du konfigurerer autorisasjonskodeflyten.
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-dokumentasjonen for instruksjoner om hvordan du får tak i og implementerer disse forutsetningene.
Workiva-elementer
- Du må ha aktivert Workiva e-postkoblingen (dette krever en sikkerhetsadministrator for organisasjonen).
Konfigurer en e-postkobling
Merk: For å gjøre koblingen tilgjengelig for bruk i organisasjonens kjeder, må en sikkerhetsadministrator i organisasjonen aktivere den fra Konfigurasjon.
- Fra Kjedebyggerklikker du på Tilkoblingerog deretter på Opprett øverst til høyre.
- Under Koblingstilkoblingvelger du E-post og standardinnstillingen CloudRunner.
- Skriv inn et unikt Navn og en Beskrivelse for å identifisere forbindelsen.
-
Under Egenskaperskriver du inn tilkoblingsdetaljene:
Egenskap Detaljer Vertsnavn Skriv inn vertsnavnet til SMTP-serveren:
- For Gmailer dette vanligvis
smtp.gmail.com - For Microsoft 365er dette vanligvis
smtp.office365.com - For Mailguner dette vanligvis
smtp.mailgun.org
Port Skriv inn porten serveren kjører på.
Standard SMTP-port er vanligvis587, men den kan også være25.TLS aktivert Hvis du bruker en sikker SMTP-server som krever kryptert kommunikasjon via Transport Layer, sett Security/Secure Sockets Layer (TLS/SSL) til Aktivert. HELO-domene Hvis SMTP-serveren krever det, angi HELO-domenet som brukes for å sikre et vellykket håndtrykk. Merk: All sensitiv påloggingsinformasjon krypteres og lagres automatisk ved hjelp av Advanced Encryption Standard (AES)-256-kryptering.
- For Gmailer dette vanligvis
-
Under Autentiseringvelger du autentiseringstypen du vil bruke, og skriver inn informasjonen som trengs for å autentisere API-kallene. Informasjonen som kreves vil avhenge av hvilken autentiseringstype du velger.
For grunnleggende autentisering
Egenskap Detaljer Brukernavn Hvis SMTP-serveren bruker grunnleggende autentisering, skriver du inn brukernavnet til koblingens integrasjonsbruker. Passord Hvis SMTP-serveren krever grunnleggende autentisering, skriver du inn passordet som er knyttet til brukernavnet. For Microsoft Office 365 Email OAuth2
Egenskap Detaljer Brukernavn Dette er brukernavnet for å få tilgang til SMTP-serveren. Leietaker-ID Dette er ID-strengen for Microsoft-leietakeren din. Klient-ID Dette er klient-ID-en for nøkkelen du vil at API-et skal bruke. Klienthemmelighet Dette er klienthemmeligheten for nøkkelen du vil at API-et skal bruke. - Klikk på Koble til.
- Velg miljøene du vil bruke tilkoblingen i, og klikk på Lagre.
- For å teste tilkoblingen, opprett og kjør en kjede med -koblingens Send e-post-kommandofor å sende en e-post til din egen e-postadresse, og bekreft at den returnerer gyldige utdata.
Feilsøking
Hvis koblingen ikke sender e-post:
- Bekreft at vertsnavnet og porten til e-postleverandørens SMTP-server er riktige.
- Kontroller at domenetypen for SMTP-serveren er riktig (TLS eller HELO).
- Hvis du bruker grunnleggende autentisering, må du kontrollere at brukernavn- og passordverdiene er riktige.
- Hvis du bruker OAuth2-autentisering, må du bekrefte at:
- Verdiene for ClientID og Client Secret er riktige.
- Omdirigerings-URI-en er riktig i Azure når disse verdiene for klient-ID og klienthemmelighet genereres.
- Bekreft at mottakerens e-postadresser som er angitt for kommandoene Send e-postog BCCer riktige.