Vai al contenuto

Configurazione WhatsApp

Channels Channels

FRENZY.BOT include un'integrazione WhatsApp con un solo clic alimentata da WAHA (WhatsApp HTTP API). Una volta abilitata, il tuo assistente AI può ricevere e rispondere ai messaggi WhatsApp automaticamente — con cattura dei lead, supporto per l'handoff e tracciamento delle conversazioni.

Prerequisiti

  • Canale WhatsApp abilitato in Channels
  • Un numero di telefono compatibile con WhatsApp
  • Servizio WhatsApp abilitato sul tuo server (gestito automaticamente durante l'installazione)

Configurazione passo dopo passo

Passaggio 1: Aggiungi il canale WhatsApp

  1. Vai su Channels nella barra laterale della dashboard.
  2. Nella sezione Catalog (navigazione a sinistra), clicca su WhatsApp.
  3. Attiva il canale su Active.

Installazione automatica

Il servizio WhatsApp è pre-installato e pronto all'uso al momento della configurazione del server. Non è necessaria alcuna configurazione aggiuntiva oltre all'attivazione.

Passaggio 2: Avvia il servizio WhatsApp

  1. Una volta attivato, vedrai il pannello Service Status.
  2. La dashboard mostra lo stato del servizio:
    • Running (verde): Il servizio è attivo e pronto.
    • Starting (arancione): Il servizio si sta avviando. Attendi 10–30 secondi.
    • Stopped (rosso): Clicca su Start per avviare il servizio.
  3. Usa i pulsanti Start / Stop / Restart per controllare il servizio.

Passaggio 3: Connetti il tuo account WhatsApp

  1. Quando il servizio risulta Running e l'API è raggiungibile, la sezione WhatsApp si sblocca.
  2. Clicca su Connect WhatsApp.
  3. Un codice QR apparirà sullo schermo.
  4. Apri WhatsApp sul tuo telefono → Impostazioni → Dispositivi collegati → Collega un dispositivo.
  5. Scansiona il codice QR.
  6. Attendi che lo stato della connessione mostri Connected.

Tempistiche del codice QR

Il codice QR si aggiorna ogni 30 secondi. Se scade, clicca su Refresh QR per generarne uno nuovo. Tieni il telefono vicino durante la configurazione.

Passaggio 4: Tesa la connessione

  1. Invia un messaggio al tuo numero WhatsApp da un altro telefono.
  2. Il bot dovrebbe rispondere utilizzando la tua knowledge base e il modello AI.
  3. Controlla la pagina Conversations nella dashboard per verificare che il messaggio sia apparso.

Come funziona

Una volta connesso, FRENZY.BOT gestisce i messaggi WhatsApp end-to-end:

  1. Messaggio in entrata → WAHA lo riceve e lo inoltra a FRENZY.BOT tramite webhook.
  2. Elaborazione AI → Il bot recupera i contenuti rilevanti dalla knowledge base e genera una risposta.
  3. Risposta inviata → La risposta viene inviata all'utente tramite WhatsApp.
  4. Cattura Lead → Se l'utente fornisce dettagli di contatto, viene creato automaticamente un lead.
  5. Handoff → Se l'utente richiede un operatore umano, la conversazione viene passata ai tuoi agenti di live chat.

Stile di risposta del canale

Le risposte di WhatsApp vengono adattate automaticamente al formato di messaggistica:

  • Risposte più brevi e colloquiali (meno di 2 frasi per impostazione predefinita).
  • Tono amichevole adatto alla messaggistica mobile.
  • Puoi personalizzare lo stile di risposta di WhatsApp in Settings → Channels.

Gestione del servizio WhatsApp

Controlli del servizio

La dashboard fornisce controlli diretti per il servizio WhatsApp:

Azione Cosa fa
Start Avvia il servizio se è fermo
Stop Ferma il servizio in modo sicuro
Restart Ferma e riavvia (utile dopo modifiche alla configurazione)
Status Mostra lo stato attuale + controllo integrità API

Disconnettere WhatsApp

Per disconnettere il tuo account WhatsApp senza rimuovere il modulo:

  1. Vai su Settings → WhatsApp.
  2. Clicca su Disconnect.
  3. Il bot smetterà immediatamente di ricevere messaggi WhatsApp.
  4. Le conversazioni storiche e i lead vengono preservati.

Per riconnetterti in seguito, basterà scansionare un nuovo codice QR.

Sicurezza

  • Il servizio WhatsApp è protetto da firewall e accessibile solo dal tuo server.
  • Le chiavi API vengono generate automaticamente e memorizzate in modo sicuro.
  • I messaggi WhatsApp vengono elaborati sul tuo server privato — non passano mai attraverso servizi cloud di terze parti.

FAQ

D: Il codice QR non viene scansionato.

  • Assicurati che il servizio WAHA risulti Running e che il controllo integrità API sia verde.
  • Prova ad aggiornare il codice QR.
  • Assicurati che il tuo telefono abbia una connessione internet stabile.

D: I messaggi non vengono ricevuti.

  • Controlla che lo stato della sessione WhatsApp mostri Connected.
  • Verifica che l'URL del webhook sia configurato correttamente (questo è automatico nella maggior parte delle installazioni).
  • Contatta il tuo account manager se il problema persiste.

D: Posso usare l'API di WhatsApp Business?

  • FRENZY.BOT utilizza attualmente WAHA (WhatsApp basato su dispositivo). Il supporto per l'API di WhatsApp Business (basata su cloud) è in programma.

D: Quante conversazioni può gestire WhatsApp?

  • Il motore NOWEB è leggero e gestisce volumi aziendali standard in modo efficiente. Per volumi molto elevati (oltre 1000 chat simultanee), contatta il tuo account manager per opzioni di scalabilità.

D: Perderò la cronologia delle chat di WhatsApp se riavvio il servizio?

  • No. Il riavvio del servizio preserva la sessione WhatsApp. È necessario scansionare nuovamente il codice QR solo se si effettua esplicitamente la disconnessione.