Centro assistenza di Workiva

Il connettore Email ti permette di includere un comando Send Email per inviare email come parte di una catena. Questo comando utilizza il Simple Mail Transfer Protocol (SMTP) per inviare l'e-mail. L'autenticazione può essere effettuata utilizzando l'autenticazione di base o l'autenticazione OAuth2. L'email può includere un contesto aggiuntivo da comandi precedenti nella catena per consentire un'automazione avanzata.

Prerequisiti SMTP

Per utilizzare il connettore e-mail, la tua organizzazione ha bisogno di informazioni sul server SMTP del suo provider di posta elettronica, come Gmail® o Microsoft® Office 365®.

Per configurare il connettore, avrai bisogno di:

• Il nome dell'host del server SMTP
• La porta che il server SMTP utilizza per inviare le email
• Il dominio HELO, se richiesto dal server SMTP
• Se il server SMTP richiede l'autenticazione, il nome utente e la password dell'utente dell'integrazione come cui il connettore deve autenticarsi

Prerequisiti OAuth2

Prima di poter utilizzare la sicurezza OAuth2 per questo connettore, devono essere presenti e implementati i seguenti elementi.

Elementi di Azure

È necessario disporre di:

• Sia un account Microsoft Azure che una chiave di accesso all'account Azure.
• Configurare un flusso di codici di autorizzazione di tipo “ ” in Azure.
• Ho configurato il servizio Exchange Online " " in Azure.

• Configurare l'URI di reindirizzamento corretto per l',, in Azure durante la configurazione del flusso del codice di autorizzazione.

  Ambiente	URI di reindirizzamento
  Prodotti APAC (regione Asia-Pacifico)	https://h.apac.wdesk.com/s/wdata/oc/app/oauth/callback
  Prodotto CA (Canada)	https://h.ca.wdesk.com/s/wdata/oc/app/oauth/callback
  Prodotti UE (EMEA)	https://h.eu.wdesk.com/s/wdata/oc/app/oauth/callback
  Produzione statunitense (Stati Uniti, America Centrale, America del Sud)	https://h.app.wdesk.com/s/wdata/oc/app/oauth/callback

Consulta la documentazione di Microsoft Azure per istruzioni su come ottenere e implementare questi prerequisiti.

Elementi di Workiva

• È necessario aver abilitato il connettore e-mail " " di Workiva (per farlo è necessario essere un amministratore della sicurezza dell'organizzazione).

Configurare un connettore e-mail

Nota: Per rendere il connettore disponibile per l'uso nelle catene della propria organizzazione, un amministratore della sicurezza dell'organizzazione deve abilitarlo dalla configurazione .

1. Da Chain Builder, clicca su Connections compare_arrows, e poi Create in alto a destra.
2. In Connector Connection, seleziona Email e il default CloudRunner.
   
3. Inserisci un Nome e Descrizione per identificare la connessione.

4. In "Proprietà di " ( Properties), inserisci i dettagli della connessione:

   

   Proprietà	Dettagli
   Nome host	Inserisci il nome host del server SMTP: Per su Gmail, in genere è smtp.gmail.com Per Microsoft 365, in genere è smtp.office365.com Per Mailgun, in genere è smtp.mailgun.org
   Porta	Inserisci la porta su cui gira il server. La porta SMTP predefinita è in genere 587, ma potrebbe anche essere 25.
   TLS abilitato	Se si utilizza un server SMTP sicuro che richiede una comunicazione crittografata tramite il Transport Layer, impostare l'opzione Sicurezza/Secure Sockets Layer (TLS/SSL) su " " abilitato.
   Dominio HELO	Se richiesto dal server SMTP, inserisci il dominio HELO utilizzato per garantire il successo dell'handshake.

   Nota: Tutte le credenziali sensibili vengono automaticamente crittografate e archiviate utilizzando lo standard AES-256 (Advanced Encryption Standard).

5. In Autenticazione, seleziona il tipo di autenticazione che vuoi utilizzare e inserisci le informazioni necessarie per autenticare le chiamate API. Le informazioni richieste dipendono dal tipo di autenticazione selezionata.

   Per l'autenticazione di base

   

   Proprietà	Dettagli
   Nome utente	Se il server SMTP utilizza l'autenticazione di base, inserisci il nome utente dell'utente di integrazione del connettore.
   Password	Se il server SMTP richiede l'autenticazione di base, inserisci la password associata al nome utente.

    

   Per Microsoft Office 365 Email OAuth2

   

   Proprietà	Dettagli
   Nome utente	Questo è il nome utente per accedere al server SMTP.
   ID tenant	Questa è la stringa dell'ID del tuo cliente Microsoft.
   ID client	È l'ID del cliente per la chiave che vuoi che l'API utilizzi.
   Segreto del cliente	Questo è il Client Secret della chiave che vuoi utilizzare per l'API.

6. Clicca su Connect.
7. Seleziona gli ambienti da utilizzare per la connessione e clicca su Salva.
8. Per testare la connessione, crea ed esegui una catena con il comando Send Email del connettore per inviare un'e-mail al tuo indirizzo e-mail e verifica che restituisca un output valido.

Risoluzione dei problemi

Se il connettore non riesce a inviare l'email:

• Verifica che il nome dell'host e la porta del server SMTP del tuo provider di posta elettronica siano corretti.
• Verifica che il tipo di dominio del server SMTP sia corretto (TLS o HELO).
• Se si utilizza l'autenticazione di base, verifica che i valori del nome utente e della password siano corretti.
• Se si utilizza l'autenticazione OAuth2, verificare che:
  • I valori relativi all'ID cliente dell' e all'ID client secret di sono corretti.
  • L'URI di reindirizzamento ( ) è corretto in Azure quando si generano i valori dell'ID cliente e del segreto cliente.
• Verifica che gli indirizzi e-mail dei destinatari inseriti nei comandi Send Email To, CC, e BCC siano corretti.