1️⃣ Autorizzazione alle notifiche

• Scopo: permettere all’app di risposta automatica di mostrare le proprie notifiche (ad esempio, quando la funzione è attiva o quando arrivano nuove richieste).
  
  

• Perché è necessaria? Senza questa autorizzazione non vedrai gli avvisi dell’app. Ti aiuta a monitorare le attività in tempo reale.
  
  

• Come attivarla? Alla prima apertura, l’app ti chiederà di consentire le notifiche. Puoi anche abilitarla da: Impostazioni > Notifiche > Consenti notifiche per l’app.
  
  

2️⃣ Autorizzazione batteria

• Scopo: impedire al sistema di chiudere l’app in background.
  
  

• Perché è necessaria? Se il sistema interrompe l’app, le risposte automatiche non funzioneranno continuamente.
  
  

• Come attivarla? Tocca il lampeggiante in alto allo schermo. Oppure vai su: Impostazioni > Batteria > Ottimizzazione batteria, seleziona l’app e imposta su Non ottimizzare o Consenti sempre.
  
  

3️⃣ Autorizzazione lettura notifiche

• Scopo: permette all’app di leggere il contenuto delle notifiche in arrivo da altre app (come WhatsApp o Telegram).
  
  

• Perché è necessaria? L’app deve leggere i messaggi per generare la risposta corretta. Senza questa autorizzazione, riconoscerà la notifica ma non potrà leggerne il testo o rispondere.
  
  

• Come attivarla? Quando abiliti la risposta automatica, ti verrà richiesto l’accesso alle notifiche. Puoi anche andare su: Impostazioni > App > Accesso speciale > Accesso alle notifiche, quindi abilita l’opzione per l’app.
  
  

⚠️ Nota importante: tutte e tre le autorizzazioni devono essere attivate affinché l’app funzioni correttamente.

App supportate
Vai nella sezione delle app all’interno dell’applicazione.
Seleziona le app autorizzate alla risposta automatica.
Assicurati che le notifiche siano abilitate per ciascuna app:
Senza l’autorizzazione alle notifiche, l’app non può leggere o rispondere ai messaggi.
Una volta confermato, la risposta automatica funzionerà solo sulle app selezionate.

⚠️ Note importanti

• Se a un’app della lista non viene concessa l’autorizzazione alle notifiche, la risposta automatica non funzionerà per quella app.
  
  

• Non è possibile aggiungere nuove app al di fuori dell’elenco predefinito.
  
  

• Puoi attivare o disattivare qualsiasi app dall’elenco come desideri, ma l’autorizzazione alle notifiche è essenziale.
  
  

💡 Suggerimento per gli utenti: Inizia attivando WhatsApp e SMS per verificare il corretto funzionamento della risposta automatica, poi prova le altre app una alla volta.

Le impostazioni di interazione ti danno il controllo totale su come funziona la risposta automatica, dallo stile di risposta agli orari di funzionamento.

📝 1. Stile e modalità di risposta

• Risposta predefinita
  
  

• Risposte professionali
  
  

• Risposte casuali
  
  

• Menu interattivi
  
  

• Risposte con IA
  
  

👥 2. Opzioni di targeting

• Rispondere a tutti
  
  

• Rispondere solo a contatti selezionati
  
  

• Bloccare le risposte a contatti selezionati
  
  

• Rispondere nei gruppi o disabilitare le risposte nei gruppi
  
  

🔢 3. Numero di messaggi per utente

• Imposta un numero massimo di risposte per utente
  
  

• Valore (0) = illimitato
  
  

📩 4. Messaggio al raggiungimento del limite giornaliero

• Messaggio inviato quando l’utente raggiunge il limite giornaliero
  
  

• Può essere lasciato vuoto → nessun messaggio verrà inviato
  
  

⏳ 5. Ritardo nella risposta

• Opzione 1: Rispondere subito, poi mettere in pausa per un periodo definito (secondi, minuti, ore, giorni)
  
  

• Opzione 2: Ritardare la risposta fino a 99 secondi prima dell’invio
  
  

📱 6. Rispondere a schermo bloccato

• Abilitare le risposte solo quando lo schermo è bloccato
  
  

🙌 7. Messaggio di benvenuto

• Inviare un messaggio fisso al primo contatto
  
  

• Oppure inviare un messaggio casuale dalle risposte di backup
  
  

• Opzioni di ripetizione:
  
  

  • Solo una volta per utente
    
    

  • Una volta al giorno (al primo messaggio del giorno)
    
    

  • Disattivare il messaggio di benvenuto
    
    

📝 8. Intestazione e piè di pagina del messaggio

• Aggiungi testo fisso all’inizio o alla fine di ogni messaggio (es. firma o slogan aziendale)
  
  

🔔 9. Notifiche

• Notifica all’invio di ogni risposta (attivo/disattivo)
  
  

• Notifica in caso di errore di risposta (attivo/disattivo)
  
  

🕒 10. Orari di risposta

• Rispondere sempre
  
  

• Impostare orari di inizio e fine per ogni giorno della settimana
  
  

⚠️ Nota: Usare queste impostazioni in modo intelligente rende le tue risposte più professionali e flessibili, in base alle tue esigenze lavorative o personali.

Le risposte professionali sono il cuore del sistema. Ti permettono di creare regole avanzate per gestire i messaggi degli utenti in modo flessibile e intelligente.

📌 Aggiungi una nuova regola

1. Parole chiave target
   Puoi inserire una o più parole. La regola verrà applicata quando compaiono nel messaggio dell’utente.
   Se inserisci più parole, separale con //.
   Esempio:
   "Prenotazione // Acquisto // Richiesta"
   Se l’utente invia una di queste parole, la regola sarà applicata.
   
   

2. Tipo di corrispondenza
   
   

• Tutti i messaggi: Si applica a tutti i messaggi in arrivo.
  
  

• Corrispondenza esatta: Il messaggio deve corrispondere esattamente alla parola chiave.
  
  

• Contiene parola: Si applica se il messaggio contiene la parola chiave.
  
  

• Termina con parola: Si applica se il messaggio termina con la parola chiave.
  
  

• Rilevamento lingua: Rileva la lingua del messaggio (ISO 639-1, es. "ar", "en").
  
  

• Corrispondenza intelligente del modello: Supporta *, ?, //.
  
  

• Più lungo/più corto di un certo numero di caratteri.
  
  

• Solo numeri: Messaggio composto solo da cifre.
  
  

• Messaggio domanda: Se contiene ?.
  
  

• Corrispondenza Regex: Controllo avanzato, es. ^\d{10}$.
  
  

3. Metodo di risposta
   
   

• Invia una risposta fissa.
  
  

• Invia tutte le risposte sotto la regola.
  
  

• Invia una risposta casuale.
  
  

• Non rispondere.
  
  

• Usa una risposta di backup casuale.
  
  

• Attiva menu interattivi.
  
  

• Risposta generata da IA (con istruzioni opzionali).
  
  

• Invia messaggio di benvenuto.
  
  

• Raccogli dati del cliente (nome, indirizzo, telefono…).
  
  

• Trasferisci a un operatore umano (temporaneamente).
  
  

4. Elenco risposte
   È possibile aggiungere più risposte e utilizzarle in base al metodo scelto.
   
   

5. Impostazioni aggiuntive
   
   

• Interrompi altre regole se questa corrisponde.
  
  

• Ritarda l’invio della risposta (secondi/minuti).
  
  

• Evita risposte duplicate nello stesso periodo.
  
  

• Definisci una fascia oraria (es. 9:00–17:00).
  
  

6. Regole specifiche per applicazioni
   Le regole possono essere limitate a una o più app (es. solo WhatsApp, solo Telegram).
   
   

📌 Sotto-regole
Le sotto-regole sono un’estensione delle regole principali.
Una sotto-regola non funziona in modo indipendente; viene attivata solo dopo che una regola principale è stata eseguita.
Quando una regola principale è attiva, i nuovi messaggi in arrivo vengono prima confrontati con le sotto-regole collegate.

• Se viene trovata una corrispondenza → viene inviata la risposta della sotto-regola.
  
  

• Se non viene trovata corrispondenza → le sotto-regole vengono disattivate e il sistema torna a controllare le altre regole principali.
  
  

📝 Esempio pratico:

• Regola principale: Se l’utente scrive "Ordine" → risposta: "Quale prodotto desideri acquistare?"
  
  

• Sotto-regole:
  
  

  • Se l’utente scrive "Libro" → risposta: "È stato registrato un ordine per un libro."
    
    

  • Se l’utente scrive "Penna" → risposta: "È stato registrato un ordine per una penna."

⚙️ Impostazioni generali delle risposte professionali

• Timeout nel trasferimento a un operatore umano: ritorno automatico alla risposta automatica dopo un periodo definito.
  
  

• Comportamento in caso di errore: ignora, rispondi con IA o invia risposta di backup casuale.
  
  

📌 Esempio pratico:
Parole chiave: Prenotazione // Appuntamento
Tipo di corrispondenza: Contiene parola
Metodo di risposta: Risposta con IA
Istruzioni IA: "Rispondi in modo formale come servizio clienti Aldhobhani."
App target: Solo WhatsApp
Impostazione aggiuntiva: Blocca risposte ripetute allo stesso utente per 10 minuti.

Moduli di richiesta sono una funzione avanzata che ti aiuta a raccogliere dati e richieste dei clienti come:

• Nome
  
  

• Numero di telefono
  
  

• Email
  
  

• Indirizzo
  
  

• Richieste o numero di transazione
  
  

Questi moduli possono essere collegati direttamente alle risposte professionali o ai menu interattivi, in modo che il modulo venga attivato automaticamente quando una regola corrisponde (ad esempio: "Voglio prenotare", "Voglio acquistare"...).

📌 Componenti del modulo

1. Nome del modulo
   Nome descrittivo che aiuta a comprendere lo scopo del modulo (es.: Richiesta Prenotazione – Dati Cliente).
   
   

2. Contenuto del messaggio
   Messaggio di benvenuto o introduttivo inviato per primo all’utente.
   Fornisce una panoramica del servizio o spiega cosa è richiesto (es.: "Ciao 👋, per completare la prenotazione inserisci i tuoi dati").
   
   

3. Risposte interattive (Domande)
   Ogni risposta interattiva include:
   
   

• Nome campo: titolo interno memorizzato nell’app (es.: Nome, Telefono, Email).
  
  

• Domanda all’utente: testo mostrato all’utente (es.: "Inserisci il tuo nome completo").
  
  

• Tipo di dato:
  
  

  • Testo normale
    
    

  • Numero di telefono (verifica la correttezza del numero)
    
    

  • Email (verifica il formato corretto)
    
    

  • Solo numeri (impedisce input non numerico)
    
    

Si possono aggiungere più domande consecutive; l’app invia la domanda successiva dopo la risposta alla precedente.

📌 Opzioni aggiuntive
✅ Conferma salvataggio (opzionale)

• Testo del messaggio di conferma: es.: "Vuoi salvare questi dati?"
  
  

• Codice di conferma salvataggio: parola o simbolo inserito dall’utente per salvare la richiesta (es.: "Sì")
  
  

• Codice annulla: parola o simbolo per ignorare la richiesta (es.: "No")
  
  

📩 Messaggio di completamento
Messaggio di ringraziamento o notifica dopo il salvataggio della richiesta.
Esempio: "La tua richiesta è stata salvata ✅, ti contatteremo a breve."

🔔 Notifiche

• Invia notifica in-app quando arriva una nuova richiesta.
  
  

• Invia riepilogo al cliente con i dati inseriti (es.:
  Nome: …
  Telefono: …
  Indirizzo: …)
  
  

🔗 Collegamento del modulo
Il modulo può essere collegato a una regola professionale (Keyword Rule) o a un menu interattivo, attivandosi quando l’utente seleziona un elemento specifico.

💡 Vantaggio: Con i moduli di richiesta, puoi trasformare il sistema di risposta automatica in un sistema completo di gestione degli ordini che raccoglie i dati dei clienti in modo organizzato e rapido.

Impostazioni:
⏳ Tempo di annullamento
Definisci il tempo consentito all’utente per inserire tutti i dati prima che la richiesta venga annullata automaticamente.
Misurato in minuti (1–60). Esempio: 30 minuti.

🕑 Messaggio dopo scadenza tempo (opzionale)
Messaggio inviato se l’utente non completa l’inserimento dati entro il tempo stabilito.
Esempio: "Spiacente, la tua richiesta è stata annullata perché i dati non sono stati completati entro 30 minuti. Puoi riprovare in qualsiasi momento."

Le risposte con intelligenza artificiale consentono al sistema di rispondere ai clienti in modo naturale e intelligente, invece di usare solo risposte predefinite. Per utilizzare questa funzione, è necessario inserire la chiave API di Gemini.

🔑 Passo 1: Inserire la chiave API di Gemini

Importanza della chiave:
La chiave serve come metodo di autenticazione che informa Gemini che queste richieste appartengono al tuo account. Senza la chiave, l’IA non funzionerà.

Come ottenere la chiave:

• Premi il pulsante "Ottieni chiave API".
  
  

• Verrai reindirizzato alla pagina di creazione della chiave tramite il tuo account Gmail.
  
  

• Se possiedi già una chiave, copiala.
  
  

• Altrimenti, crea una nuova chiave.
  
  

Inserimento della chiave:

• Copia la chiave e inseriscila nel campo della chiave principale nell’app.
  
  

• Puoi testare la chiave cliccando su "Testa chiave" per verificare il corretto funzionamento.
  
  

Chiave di riserva:

• È presente un campo aggiuntivo per inserire una chiave API di riserva.
  
  

• Se la chiave principale non funziona, l’app passerà automaticamente alla chiave di riserva per garantire la continuità delle risposte.
  
  

⚡ Modelli disponibili di Gemini:

• Gemini 1.5 Flash: Molto veloce, adatto a risposte brevi e immediate, consuma meno token.
  
  

• Gemini 2.0 Flash: Generazione più recente, veloce e più precisa, ideale per risposte brevi e migliore comprensione del contesto.
  
  

• Gemini 2.5 Flash: Modello Flash più avanzato, ottimo equilibrio tra velocità e qualità.
  
  

• Gemini 1.5 Flash Lite: Versione leggera, ideale per ridurre i costi o per risposte semplici.
  
  

• Gemini 1.5 Pro: Più intelligente e accurato, adatto a risposte complesse o testi lunghi, consuma più token.
  
  

🏋️ Addestramento di Gemini (istruzioni personalizzate):
Dopo aver attivato Gemini, puoi addestrarlo secondo la personalità e i servizi della tua azienda:

• Clicca su "Aggiungi istruzioni" per aprire la schermata di inserimento dati di addestramento.
  
  

• Queste istruzioni aiutano l’IA a rispondere per tuo conto in modo coerente con la tua attività.
  
  

Esempio pratico (Azienda Al-Dhobhani per sviluppo applicazioni):
Istruzioni:
"Sei un assistente virtuale per l’azienda Al-Dhobhani per lo sviluppo di applicazioni. La nostra azienda è specializzata in applicazioni mobili, intelligenza artificiale e software web. Quando un cliente chiede informazioni sui nostri servizi, fornisci una spiegazione concisa delle nostre soluzioni e informalo che offriamo supporto tecnico di alta qualità. Non usare un linguaggio troppo formale, mantieni il tono amichevole e professionale."

Esempio 2 (Prodotto/app attuale):
Istruzioni:
*"Sei un assistente virtuale per l’app [Auto Reply]. L’app gestisce risposte automatiche e conversazioni su WhatsApp, Messenger, Instagram, Telegram e SMS. L’utente può configurare risposte professionali, trasferire conversazioni a operatori umani e attivare risposte AI. Se il cliente chiede le funzionalità dell’app, spiega che offre:

• Automazione intelligente delle risposte
  
  

• Supporto per menu interattivi
  
  

• Gestione richieste clienti tramite moduli
  
  

• Report e statistiche precise
  
  

• Integrazione con l’IA Gemini per risposte naturali
  Assicurati che le risposte siano chiare, amichevoli e professionali."*
  
  

🔹 Risultato: Gemini risponderà come un operatore di supporto dell’app, conoscendo dettagli e funzionalità.

⚙️ Impostazioni avanzate (Advanced Settings):
Se abilitate, puoi controllare il comportamento di Gemini in dettaglio; altrimenti verranno utilizzate le impostazioni predefinite.

• maxOutputTokens: Imposta il numero massimo di token per la risposta (es. 64 → risposta breve, 2000 → risposta lunga)
  
  

• temperature: Controlla la varietà e creatività della risposta (0.0 → risposte precise e consistenti, 1.0 → risposte più creative; consigliato 0.6–0.8)
  
  

• topK: Numero di scelte considerate dal modello per la parola successiva (valore piccolo → risposte più concentrate, valore grande → più variegate)
  
  

• topP: Probabilità cumulativa per la selezione della parola (0.9 → più variegato, 0.5 → più conservativo)
  
  

🎭 Stile della risposta:

• Formale → cortese e ufficiale
  
  

• Amichevole → vicino al cliente
  
  

• Divertente → leggero e simpatico
  
  

• Neutro → senza emozioni o tono particolare
  
  

• Professionale → combina formalità e cordialità
  
  

✍️ Tipo di risposta:

• Breve → risposta rapida e diretta
  
  

• Dettagliata → risposta con spiegazione più ampia
  
  

📏 Impostazioni aggiuntive:

• Lunghezza massima caratteri: Definisce la lunghezza della risposta desiderata (es. 250 caratteri → risposta breve, 1000 → dettagliata)
  
  

• Numero di messaggi precedenti ricordati da Gemini: Definisce quanto l’IA ricorda della conversazione attuale (es. 3 → Gemini ricorderà gli ultimi 3 messaggi dell’utente per rispondere di conseguenza)
  
  

⚠️ Nota: La memoria riguarda solo la giornata corrente, non include le conversazioni dei giorni precedenti. Non consigliato un numero elevato perché consuma più token giornalieri.

I menu interattivi ti permettono di guidare l’utente attraverso opzioni predefinite anziché fargli scrivere testo libero. Questo riduce gli errori e velocizza l’accesso all’informazione o all’azione corretta.

1) Denominazione del menu principale

Inizia con un nome chiaro che rappresenti il contenuto (esempio: Menu principale – Servizi Azienda Al-Dhobhani).

2) Definizione degli elementi del menu (fino a 7)

Puoi creare fino a 7 elementi nel menu principale.
Per ogni elemento, specifica cosa accade quando viene selezionato (vedi “Tipi di azione” sotto).
Consiglio: se servono più di 7 opzioni, raggruppale in sottomenu (classificazione logica).

3) Collegamento degli elementi a risposte professionali

Ogni elemento principale o sottomenu può essere collegato a una risposta professionale.
Quando l’utente seleziona questo elemento, la regola viene attivata (come se avesse scritto la parola chiave).
Esempio:
Elemento “Richiedi preventivo” ↔ risposta professionale invia un modulo di richiesta clienti.

4) Sottomenu (gerarchia)

Ogni elemento può aprire un sottomenu con fino a 7 elementi.
Ogni elemento del sottomenu può aprire a sua volta un sottomenu… e così via (multi-livello).
Esempio comune:
Menu principale “Servizi” →
Elemento “Pacchetti sviluppo” (sottomenu) →
Sotto-elementi: “Base / Professionale / Aziendale”.

5) Personalizzazione tramite import CSV (alternativa al sottomenu manuale)

Invece di creare manualmente molti elementi, puoi far sì che un elemento dipenda da un file CSV come riferimento:
Requisiti del file: solo due colonne:

• input: valore che l’utente digita
  
  

• output: risposta che il sistema mostra se il valore corrisponde
  
  

Esempio CSV (2 righe + intestazione):

• input,output

• ADEN,Il servizio di consegna è disponibile ad Aden entro 24 ore

• SANA,Il servizio di consegna è disponibile a Sana’a entro 48 ore

Quando l’utente invia ADEN, l’app mostra: “Il servizio di consegna è disponibile ad Aden entro 24 ore.”

Quando usare CSV? Quando ci sono decine o centinaia di valori (codici prodotti, città, filiali…), invece di creare menu lunghi.

6) Personalizzazione tramite azioni speciali

Ogni elemento (principale o sottomenu) può avere una delle seguenti azioni:

• Apri sottomenu: mostra opzioni più profonde (fino a 7 per livello).
  
  

• Collega a modulo richieste clienti: trasforma la scelta dell’utente in un modulo interattivo (Nome, Telefono, Indirizzo…), i dati vengono salvati nella sezione richieste.
  
  

• Trasferimento a operatore umano: interrompe le risposte automatiche e trasferisce la conversazione all’assistenza umana.
  
  

  • Dopo il timeout (impostazioni generali) le risposte automatiche tornano attive.
    
    

• Collega a risposta professionale: attiva una regola predefinita per inviare risposte/menu/AI.
  
  

• Risposta predefinita: messaggio usato quando l’utente inserisce un valore non valido o chiede “Indietro”.
  
  

7) Best practice nella progettazione dei menu

• Mantieni la struttura semplice: max 7 elementi per livello; distribuisci su 2–3 livelli.
  
  

• Nomi chiari: inizia con l’azione (es. Richiedi preventivo, Apri ticket supporto…).
  
  

• Istruzioni brevi: indica come selezionare (numero o testo).
  
  

• Inserisci “Indietro” e “Menu principale” nei sottomenu.
  
  

• CSV per grandi quantità di dati: città, filiali, codici.
  
  

• Testa ogni percorso: verifica che moduli/regole/trasferimenti funzionino.
  
  

8) Esempio pratico – Azienda Al-Dhobhani

Menu principale – Servizi Al-Dhobhani

• I nostri servizi → sottomenu
  
  

  • Sviluppo app mobile → collega a regola “Dettagli servizio”
    
    

  • Soluzioni AI → collega a regola “Dettagli servizio”
    
    

  • Siti web & negozi → collega a regola “Dettagli servizio”
    
    

• Pacchetti → sottomenu
  
  

  • Base
    
    

  • Professionale
    
    

  • Aziendale
    
    

• Richiedi preventivo → collega a modulo richieste clienti (Nome/Telefono/Esigenze)
  
  

• Supporto tecnico → trasferimento a operatore umano (“Verrai connesso a un operatore in pochi minuti”)
  
  

• Prezzi per città → importa CSV (città ← disponibilità/durata/costo)
  
  

• Contattaci → invia info contatto tramite regola
  
  

Note:

• “Richiedi preventivo” apre il modulo e salva nella sezione richieste.
  
  

• “Supporto tecnico” sospende temporaneamente le risposte automatiche e trasferisce a umano.
  
  

• “Prezzi per città” utilizza CSV per risposte personalizzate.
  
  

⚙️ Impostazioni menu interattivo

1. Pulsanti di navigazione fissi
   Simboli predefiniti:
   
   

• 0 → Torna al menu principale (inizio)
  
  

• 9 → Torna al livello precedente
  
  

• 99 → Esci completamente dal menu interattivo
  
  

2. Timeout automatico
   Imposta da 1 a 60 minuti; se l’utente non interagisce, il menu si chiude.
   Messaggio opzionale: inviato automaticamente al timeout.
   Esempio: “Tempo scaduto. Invia qualsiasi messaggio per ricominciare 👋.”
   
   

3. Gestione errori (input errato)
   Se l’utente inserisce un numero o valore non valido:
   
   

• Reinvia il menu
  
  

• Invia messaggio di guida
  Esempio: “Opzione non trovata. Per scegliere correttamente, inserisci il numero dal menu.”
  
  

4. Nota importante 📝
   Selezione solo tramite numeri.
   Testo libero o parole casuali non funzionano nei menu interattivi.
   
   

Esempio pratico – impostazioni menu Al-Dhobhani:

• 0: torna al menu principale
  
  

• 9: torna al menu precedente (Pacchetti ← Principale)
  
  

• 99: termina menu interattivo e torna alla chat normale
  
  

• Timeout: 5 minuti
  
  

• Messaggio timeout: “Tempo scaduto ⏳. Invia un messaggio qualsiasi per riaprire il menu principale.”
  
  

• Input errato: reinvia menu + messaggio: “Opzione non valida. Seleziona un numero corretto dal menu 👇”