Skip to main content

E-Mail In

Il task E-Mail In agisce come un "ascoltatore" o un "controllore" di una casella di posta elettronica. La sua funzione è quella di connettersi ad un account email e cercare un messaggio specifico che soddisfi determinati criteri (mittente, oggetto, etc.).

Questo task è fondamentale per avviare o proseguire un Workflow in base all'arrivo di una comunicazione specifica, ad esempio per automatizzare processi che partono da una richiesta via email, come la ricezione di una fattura, un ordine o un report.

Configurazione

La configurazione del task è suddivisa in due schede: la connessione al server e i filtri di ricerca dell'email.

1. Connessione al Server​

Questa sezione definisce i parametri per collegarsi alla casella di posta da cui leggere i messaggi.

  • Tipologia Server: Permette di scegliere il protocollo per la ricezione della posta.
  • IMAP (Internet Message Access Protocol)
  • POP3 SSL (Post Office Protocol 3 - Secure)
  • Nome Server: L'indirizzo del server di posta in arrivo.
  • Esempio per Gmail (IMAP): imap.gmail.com
  • Esempio per Gmail (POP3): pop.gmail.com
  • Porta: La porta di comunicazione con il server, che dipende dal protocollo scelto.
  • Esempio per IMAP (con SSL/TLS): 993
  • Esempio per POP3 SSL: 995
  • Utente: L'indirizzo email completo dell'account a cui connettersi.
  • Esempio: automazioni.aziendali@gmail.com
  • Password: La password per accedere all'account. Per servizi come Gmail, è necessario utilizzare una "Password per le app" specifica e non la password principale dell'account.

2. Proprietà Email​

Questa sezione serve a definire i criteri di ricerca. Il task cercherà la prima email non letta che corrisponde a tutti i filtri specificati.

  • From: Filtra le email in base al mittente. Lasciare vuoto per accettare email da qualsiasi mittente.
  • Esempio: report.contabilita@miaazienda.com
  • Oggetto Email(*): Filtra in base all'oggetto dell'email. L'asterisco (*) indica che questo campo è obbligatorio.
  • Esempio: Report Vendite Settimanale - Settimana 34.
  • Testo Email: Permette di cercare una specifica frase o parola chiave all'interno del corpo del messaggio.
  • Esempio: Allego il report definitivo
  • Tentativi: Il numero di tentativi che il task effettuerà per trovare l'email prima di andare in timeout.
  • Esempio: 10 (il task proverà a cercare 10 volte).
  • Attesa: Il tempo (in secondi) di attesa tra un tentativo e l'altro.
  • Esempio: 60 (il task attenderà 60 secondi tra ogni tentativo).
  • Salva allegati: Se questa casella è spuntata, tutti gli allegati presenti nell'email trovata verranno scaricati e resi disponibili per i task successivi nel workflow.

Parametri di Output

Una volta che il task trova un'email che corrisponde ai criteri, ne estrae le informazioni e le espone come parametri di output:

  • from: Contiene l'indirizzo email del mittente del messaggio trovato.
  • subject: Contiene l'oggetto completo dell'email trovata.
  • body: Contiene il testo completo del corpo dell'email.
  • result: Indica l'esito dell'operazione.
  • resultJson: rappresenta il risultato dell’esecuzione del task in formato JSON, includendo informazioni generali, configurazioni e dettagli sull’esecuzione.
  • Attachments.file*:* il percorso completo del file allegato
  • Attachments.filename: il nome dell'allegato