Hello Worker Docs

Canali

Hello Worker supporta due canali di comunicazione: il widget web integrato nel tuo sito e Telegram. Entrambi condividono la stessa knowledge base e le stesse impostazioni.

Widget Web

Il widget web è una chat che puoi incorporare nel tuo sito web. I visitatori possono porre domande e ricevere risposte immediate dal worker, senza uscire dalla pagina.

Codice di incorporamento

Vai nella sezione Canali della dashboard, seleziona “Widget Web” e copia il codice di incorporamento. Il codice va inserito prima della chiusura del tag </body> nel tuo sito.

Esempio di codice embed:

<script
  src="https://app.helloworker.it/widget.js"
  data-worker-id="IL_TUO_WORKER_ID"
  data-theme="auto"
  async
></script>

Personalizzazione

Il widget si adatta automaticamente al tema del tuo sito (chiaro o scuro). Puoi personalizzare:

  • Tema auto, light o dark
  • Posizione — Angolo in basso a destra (default) o in basso a sinistra
  • Messaggio di benvenuto — Il testo mostrato quando il widget si apre per la prima volta
  • Avatar e nome — Configurati automaticamente dalle impostazioni del worker

Telegram

Il canale Telegram permette ai tuoi clienti di contattare il worker direttamente dalla loro app di messaggistica preferita, senza installare nulla.

Connessione tramite Composio

La connessione con Telegram avviene tramite Composio, la piattaforma di integrazioni di Hello Worker. Il processo è semplice:

  1. Dalla dashboard, vai su Canali e clicca su “Connetti Telegram”.
  2. Verrai guidato nella creazione di un bot Telegram tramite @BotFather (se non ne hai già uno).
  3. Incolla il token del bot nella dashboard e conferma la connessione.
  4. Il worker inizia a rispondere automaticamente ai messaggi ricevuti dal bot.

Come funziona

Quando un utente invia un messaggio al tuo bot Telegram, il sistema:

  • Riceve il messaggio tramite webhook
  • Lo elabora con lo stesso motore AI utilizzato per il widget web
  • Invia la risposta formattata direttamente su Telegram
  • Salva la conversazione nella cronologia, visibile dalla dashboard

Differenze tra i canali

CaratteristicaWidget WebTelegram
FormattazioneMarkdown con rendering riccoMarkdown compatibile con Telegram (grassetto, corsivo, codice)
ImmaginiSupportate inlineNon supportate nelle risposte
Stato di scritturaIndicatore “sta scrivendo”Azione “typing” di Telegram
Sessione utenteIdentificata tramite cookie di sessioneIdentificata tramite ID utente Telegram