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 azzurri

È necessario avere:

• Sia un account Microsoft Azure che una chiave dell'account Azure.
• Configurare un flusso di codici di autorizzazione in Azure.
• Configurato il servizio Exchange Online in Azure.

• Impostare l'URI di reindirizzamento corretto in Azure quando si imposta il flusso del codice di autorizzazione.

  Ambiente	Reindirizzamento URI
  Prod APAC	https://h.apac.wdesk.com/s/wdata/oc/app/oauth/callback
  Prodotto UE	https://h.eu.wdesk.com/s/wdata/oc/app/oauth/callback
  Prodotto statunitense	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 (questo richiede un amministratore della sicurezza dell'organizzazione).

Configurare un connettore e-mail

Nota: Per rendere il connettore disponibile per l'uso nelle catene dell'organizzazione, un amministratore della sicurezza dell'organizzazione deve abilitarlo da 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 Properties, inserire i dettagli della connessione:

   

   Proprietà	Dettagli
   Nome host	Inserisci il nome host del server SMTP: Per Gmail, questo è tipicamente smtp.gmail.com Per Microsoft 365, questo è tipicamente smtp.office365.com Per Mailgun, questo è tipicamente 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 Transport Layer, impostare Security/Secure Sockets Layer (TLS/SSL) su Enabled.
   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 memorizzate utilizzando la crittografia Advanced Encryption Standard (AES)-256.

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 ClientID e Client Secret sono corretti.
  • l'URI di reindirizzamento è corretto in Azure quando si generano i valori di ID cliente e Segreto cliente.
• Verifica che gli indirizzi e-mail dei destinatari inseriti nei comandi Send Email To, CC, e BCC siano corretti.