Hello Worker Docs

Integrazioni

Connetti gli strumenti che già usi alla tua piattaforma Hello Worker. Le integrazioni permettono al worker di eseguire azioni concrete come inviare email o consultare il calendario.

Come funzionano le integrazioni

Hello Worker utilizza Composio come piattaforma di integrazioni. Composio gestisce le connessioni OAuth, le autorizzazioni e la comunicazione con i servizi esterni.

Quando attivi un'integrazione, Composio:

  1. Ti reindirizza al servizio esterno per l'autenticazione OAuth
  2. Memorizza in modo sicuro i token di accesso (mai visibili nel tuo account)
  3. Rende disponibili al worker gli strumenti (tools) relativi a quel servizio
  4. Gestisce automaticamente il rinnovo dei token scaduti

Gmail

L'integrazione Gmail permette al worker di inviare email per conto tuo, ad esempio per confermare prenotazioni, inviare preventivi o rispondere a richieste di contatto.

Configurazione

  1. Dalla dashboard, vai su Integrazioni.
  2. Clicca su “Connetti Gmail”.
  3. Accedi con il tuo account Google e concedi i permessi richiesti.
  4. Torna alla dashboard: la connessione è attiva e il worker può inviare email.

Cosa può fare il worker

  • Inviare email a un indirizzo specificato dal cliente
  • Comporre il corpo dell'email con le informazioni pertinenti
  • Includere oggetto e formattazione appropriata

Sicurezza: Il worker non ha accesso alla tua casella di posta in arrivo. Può solo inviare email in uscita, e ogni invio viene registrato nella cronologia delle conversazioni.

Google Calendar

Con Google Calendar collegato, il worker può consultare la tua disponibilità e aiutare i clienti a prenotare appuntamenti.

Configurazione

La configurazione segue lo stesso flusso OAuth di Gmail. Dalla sezione Integrazioni, clicca su “Connetti Google Calendar” e autorizza l'accesso.

Cosa può fare il worker

  • Controllare la disponibilità su uno o più calendari
  • Proporre orari liberi ai clienti
  • Creare nuovi eventi con titolo, descrizione e partecipanti

Integrazioni disponibili

Composio supporta oltre 200 servizi. Le integrazioni più comuni per le PMI italiane includono:

ServizioFunzionalitàPiano minimo
GmailInvio emailPro
Google CalendarConsultare disponibilità, creare eventiPro
TelegramCanale di messaggisticaStarter
Brave SearchRicerca web in tempo realeStarter
Altre (via Composio)Slack, Notion, HubSpot, ecc.Business

Come l'AI usa gli strumenti

Quando un cliente fa una richiesta che richiede un'azione esterna (es. “inviami i dettagli via email”), il worker:

  1. Analizza la richiesta e identifica lo strumento appropriato (es. Gmail, Calendar).
  2. Prepara i parametri necessari (destinatario, oggetto, corpo dell'email).
  3. Esegue l'azione tramite Composio e riceve conferma del risultato.
  4. Comunica al cliente l'esito dell'operazione (es. “Email inviata con successo”).

Nota: Il worker non esegue mai azioni distruttive senza un contesto chiaro. Se la richiesta è ambigua, chiederà conferma al cliente prima di procedere.