# Quoting24 Help Center — testo completo
Testo integrale della documentazione pubblica https://wiki.quoting24.com/ in tutte le lingue.
Indice: https://wiki.quoting24.com/llms.txt
Sitemap: https://wiki.quoting24.com/sitemap.xml
# Home
URL: https://wiki.quoting24.com/
Language: it
Updated: 2026-11-04
# Quoting24 Help Center
Benvenuto nell' **Help Center di Quoting24**.
Questa documentazione ti guiderà passo dopo passo nell’utilizzo di Quoting24,
spiegando **cosa fa la piattaforma**, **a chi è rivolta** e **come sfruttarla al meglio**
nelle attività quotidiane.
---
## Cos’è Quoting24
**Quoting24** è una piattaforma progettata per **gestire, organizzare e automatizzare
le richieste di preventivo ricevute tramite WhatsApp**, trasformando le conversazioni
con i clienti in un flusso di lavoro strutturato ed efficiente. Quoting24 è particolarmente utile quando:
- Più operatori lavorano sullo stesso numero e il volume di richieste è elevato
- Ridurre il tempo di sviluppo dei preventivi tramite una serie di automatismi pensati per la vendita di ricambi automotive.
A differenza di WhatsApp tradizionale, Quoting24:
- divide le conversazioni in **ticket**
- permette di lavorare in **team** senza limiti di numeri e operatori collegati
- si collega direttamente a **Qricambi** e al tuo **gestionale**
Quoting24 serve a:
- gestire **molte richieste contemporaneamente** senza perdere messaggi
- automatizzare ricerche di **targhe, telai e ricambi**
- collaborare tra colleghi con note interne, reaction e notifiche unificate
- creare un flusso continuo tra **richiesta → ricerca → preventivo → risposta**
---
## Indice della documentazione
### 🚀 Inizia con Quoting 24
- [Accesso a Quoting 24](content/login.md)
Come effettuare il login e accedere alla piattaforma.
- [Panoramica generale](content/general_overview.md)
Visione d’insieme dell’interfaccia e del flusso di lavoro.
---
### 🧾 Gestione richieste
- [Schermata principale](content/main_screen.md)
Vista principale con ticket, chat e ricerca ricambi.
- [Gestione ticket](content/gestione_ticket.md)
Un ticket scrivibile per conversazione, reply, riapertura e messaggi programmati.
- [Lista richieste](content/requested_list.md)
Storico, ricerca e filtri delle richieste ricevute.
- [Etichette](content/type_of_request.md)
Etichette dei ticket, categorizzazione automatica e urgenza.
- [Risposte salvate](content/save_response.md)
Messaggi predefiniti per rispondere più velocemente.
- [Assegnazioni](content/assegnazioni.md)
Assegnazione automatica e gestione intelligente dei ticket.
- [Turni di consegna](content/delivery_shifts.md)
Gestione e assegnazione dei turni alle aziende.
- [Report giornaliero attività](content/daily_activity_report.md)
Report email con KPI ticket, operatori e andamento giornaliero.
- [Quoting News](content/quoting_news.md)
Canale in sola lettura per le comunicazioni di prodotto di Quoting.
---
### 💬 Canale WhatsApp
- [Panoramica WhatsApp](content/whatsapp.md)
Collegamento del numero WhatsApp tramite API ufficiali.
- [Migrazione WhatsApp API](content/migrazione_whatsapp_api.md)
Collegare a Quoting24 un numero già sulle API di un altro fornitore, senza cambiarlo.
- [WhatsApp Coexistence](content/whatsapp_coexistence.md)
Usare insieme l'app WhatsApp Business e le API ufficiali sullo stesso numero.
- [Broadcast API](content/broadcast_api.md)
Campagne con template Meta verso molti numeri, con destinatari da un file Excel.
---
### 🌐 Canale Widget
- [Panoramica Widget](content/widget.md)
Chat sul sito: ospite, associazione azienda e ripristino della cronologia.
- [Widget B2C](content/widget_b2c.md)
Script, visitatore sconosciuto e payload con `external_id` / `company_name`.
- [Widget B2B](content/widget_b2b.md)
Cronologia tra dispositivi con `external_user_id` e `restore_id`.
- [Integrazione tecnica](content/widget_tecnico.md)
Contratto di `init()`, creazione azienda, CSP e risoluzione problemi.
---
### 👥 Contatti e aziende
- [Contatti](content/contacts.md)
Gestione dei contatti del canale WhatsApp.
- [Aziende](content/companies.md)
Creazione e gestione delle aziende clienti.
---
### 🤖 Intelligenza artificiale
- [Panoramica AI](content/ai.md)
Come l’AI legge il ticket e aggiorna veicoli/ricambi.
- [Riconoscimento](content/ai_riconoscimento.md)
Veicoli, ricambi, etichette, note interne e glossario.
- [Foto, PDF e vocali](content/ai_media.md)
Lettura media e scheda “Letture AI”.
- [Riquadro e correzione](content/ai_riquadro.md)
Riquadro in chat, click, Correggi e modalità di visualizzazione.
- [Automazioni](content/automations.md)
Ricerche automatiche di targhe, telai e ricambi.
---
### 🔌 Integrazioni
- [Ricerca fornitori Qricambi](content/qricambi_integration.md)
Collegamento con Qricambi e gestione fornitori.
- [Ricerca con estensione](content/search_with_extension.md)
Cercare su Partslink o Eper i telai non trovati, con Qricambi Assistant.
- [Crediti Qricambi](content/credits.md)
Utilizzo e gestione dei crediti condivisi con Qricambi.
- [Invia preventivo a gestionale](content/invia_preventivo_gestionale.md)
Invia i dati del preventivo al tuo gestionale.
- [Scrivi su Whatsapp tramite le nostre API](content/invia_whatsapp_api.md)
Invia messaggi tramite le API ufficiali di WhatsApp.
- [Ricerca di un codice sul proprio gestionale](content/management_research.md)
Ricerca al gestionale per avere prezzi e disponibilità per cliente.
---
### 👤 Impostazioni account
- [Profilo utente](content/profilo.md)
Personalizzazione del profilo e messaggi automatici.
- [Attività](content/activities.md)
Impostazioni dell’attività e comportamento generale.
- [Utenti e permessi](content/user.md)
Gestione utenti, ruoli e autorizzazioni.
- [Notifiche](content/notifications.md)
Configurazione delle notifiche personali, unificate e desktop.
---
---
## Da dove iniziare
Se è la tua prima volta su Quoting24, ti consigliamo questo percorso:
1. [Accesso a Quoting 24](content/login.md)
2. [Panoramica generale](content/general_overview.md)
3. [Schermata principale](content/main_screen.md)
4. [Panoramica WhatsApp](content/whatsapp.md)
5. [Attività](content/activities.md) e [Automazioni](content/automations.md)
Questo ti permetterà di avere una visione completa del funzionamento
prima di entrare nei dettagli.
---
# Accesso a Quoting 24
URL: https://wiki.quoting24.com/content/login/
Language: it
Updated: 2026-11-04
# Accesso a Quoting24
Per accedere a **Quoting24** è necessario essere registrati (più informazioni [qui](https://welcome.quoting24.com/registrazione)) e disporre di una credenziale da poter usare per accedere al seguente link:
[https://beta.quoting24.com/auth/login](https://beta.quoting24.com/auth/login)
L’**Username** e la **password** sono le stesse utilizzate per accedere a [**Qricambi**](https://qricambi.com/).
---
## Gestione password
Al momento, per cambiare o recuperare la password è necessario utilizzare Qricambi, tramite una delle seguenti opzioni:
- Pagina di [recupero password](https://app.qricambi.com/Authentication/RequestRecover?user=)
- Sezione [Gestione utenti](https://app.qricambi.com/youraccount/UsersManager)
---
## Primo accesso e selezione attività
Al primo accesso alla piattaforma, l’utente è **già stato creato e configurato** da colleghi con ruolo amministrativo.
Dopo aver effettuato il login, il comportamento dipende dai **numeri di telefono/attività** associati all’utente.
### Utente associato a più numeri di telefono
Se l’utente è assegnato a **più numeri di telefono**, verrà richiesto di scegliere **in quale attività entrare**.
### Utente associato a un solo numero di telefono
Se l’utente è assegnato a **un solo numero di telefono**, l’accesso avverrà automaticamente, senza alcuna selezione.
---
## Dopo l’accesso
Una volta entrati, verrà mostrata la [**schermata principale di Quoting24**](main_screen.md), dalla quale è possibile iniziare a lavorare sulle richieste.
---
# Panoramica generale
URL: https://wiki.quoting24.com/content/general_overview/
Language: it
Updated: 2026-11-04
# Panoramica generale
Quoting24 è una piattaforma progettata per **gestire in modo centralizzato e intelligente
le richieste di preventivo ricevute via WhatsApp**, integrando automazione,
ricerca ricambi e collaborazione tra operatori.
Questa panoramica ti aiuterà a capire:
- com'è organizzata l’interfaccia
- come funziona il flusso di lavoro
- quali sono le principali funzionalità disponibili
---
## La schermata principale
Una volta effettuato l’accesso, l’utente viene indirizzato alla
**[schermata principale](main_screen.md)** di Quoting24.
La schermata è divisa in **tre aree principali**, che lavorano insieme per
trasformare una conversazione WhatsApp in un preventivo strutturato.
---
## 1. Gestione delle richieste (chat e ticket)
Ogni richiesta ricevuta da un cliente viene gestita come un **ticket**.
A differenza di WhatsApp tradizionale:
- ogni nuova richiesta di preventivo genera un ticket distinto
- i ticket possono essere **assegnati**, messi **in pausa**, segnati **da leggere**, **chiusi** o **ripresi**
- il lavoro viene distribuito tra più operatori in modo ordinato
Da questa sezione è possibile:
- ordinare e filtrare i ticket (assegnatario fuori, altri filtri nell’imbuto)
- aprire nuove richieste dalla home o dai **Contatti**
- monitorare lo stato del lavoro del team
Per ogni conversazione c’è **un solo ticket scrivibile**: un ticket chiuso non si riapre a mano. Dettagli in **[Gestione ticket](gestione_ticket.md)**.
👉 Per approfondire:
- **[Gestione ticket](gestione_ticket.md)**
- **[Lista richieste](requested_list.md)**
- **[Assegnazioni automatiche](assegnazioni.md)**
- **[Etichette](type_of_request.md)**
- **[Quoting News](quoting_news.md)**
---
## 2. Conversazione con il cliente
Questa è l’area dedicata alla **comunicazione diretta con il cliente**.
Da qui è possibile:
- inviare e ricevere messaggi
- allegare foto, video e documenti
- inserire **note interne** visibili solo ai colleghi
- utilizzare **risposte salvate** per velocizzare le comunicazioni
Quoting24 analizza automaticamente i messaggi:
- trascrive vocali
- riconosce targhe, telai e riferimenti ai ricambi
- prepara i dati necessari alla fase di preventivazione
👉 Per approfondire:
- **[Risposte salvate](save_response.md)**
- **[Notifiche](notifications.md)**
---
## 3. Ricerca veicolo e ricambi
La sezione di destra è dedicata alla **ricerca tecnica**.
Qui vengono mostrati automaticamente:
- targhe
- telai
- informazioni sul veicolo
- componenti individuati nella conversazione
Attraverso gli **spaccati** è possibile:
- individuare il codice corretto del ricambio
- cercarlo su Qricambi
- avviare rapidamente la creazione del preventivo
👉 Per approfondire:
- **[Integrazione con Qricambi](qricambi_integration.md)**
- **[Automazioni](automations.md)**
---
## Automazioni e assegnazioni intelligenti
Quoting24 include funzionalità avanzate per **ridurre il lavoro manuale**:
- **Automazioni**
Ricerca automatica di targhe, telai e ricambi
👉 **[Vai alle Automazioni](automations.md)**
- **Assegnazione automatica dei ticket**
Assegnazione intelligente in base a:
- [etichetta](type_of_request.md)
- [azienda](companies.md)
- [contatto](contacts.md)
👉 **[Vai alle Assegnazioni automatiche](assegnazioni.md)**
Questo consente di:
- ridurre i tempi di risposta
- evitare errori di smistamento
- lavorare in modo strutturato anche con molti operatori
---
## Collaborazione tra operatori
Quoting24 è pensato per il lavoro di squadra.
Sono disponibili:
- ruoli (**amministratori** e **membri**)
- assegnazioni dei ticket
- note interne
- notifiche personalizzabili
- notifiche unificate anche su più numeri di telefono
- turni di consegna associabili alle aziende
👉 Per approfondire:
- **[Utenti e permessi](user.md)**
- **[Profilo utente](profilo.md)**
- **[Turni di consegna](delivery_shifts.md)**
---
## Integrazione con Qricambi
Quoting24 è profondamente integrato con **Qricambi**.
Questo permette di:
- utilizzare gli stessi **crediti**
- cercare ricambi su fornitori interni ed esterni
- creare preventivi su Qricambi
- inviarli al cliente direttamente dalla chat
👉 Approfondisci:
- **[Crediti](credits.md)**
- **[Integrazione Qricambi](qricambi_integration.md)**
- **[Invia preventivo a gestionale](invia_preventivo_gestionale.md)**
- **[Scrivi su Whatsapp tramite le nostre API](invia_whatsapp_api.md)**
Il flusso di lavoro diventa così continuo:
**richiesta → ricerca → preventivo → risposta al cliente**
---
## Da dove iniziare
La Wiki di Quoting24 è raggiungibile anche dall'applicazione, nelle **Impostazioni** in basso a sinistra.
Se sei nuovo su Quoting24, ti consigliamo questo percorso:
1. **[Accesso a Quoting24](login.md)**
2. **[Schermata principale](main_screen.md)**
3. **[Lista richieste](requested_list.md)**
4. **[Panoramica WhatsApp](whatsapp.md)**
5. **[Attività](activities.md)** e **[Automazioni](automations.md)**
Questo ti permetterà di avere una visione completa del funzionamento della piattaforma
prima di entrare nei dettagli.
---
# Schermata principale
URL: https://wiki.quoting24.com/content/main_screen/
Language: it
Updated: 2026-11-04
# Schermata principale
La schermata principale di **Quoting24** si divide in **tre sezioni principali**, illustrate di seguito da sinistra a destra.
- - -
## 1. Elenco chat / ticket (parte sinistra)
In questa sezione è presente l’elenco delle **chat / ticket**.
A differenza di WhatsApp, dove le conversazioni sono flussi unici e continui, su **Quoting24** la conversazione viene suddivisa in **ticket**: ogni richiesta di preventivo deve essere considerata come un **ticket separato**.
Per ogni contatto c’è **un solo ticket su cui si può scrivere**. Un ticket chiuso non si riapre a mano: vale il flusso descritto in [Gestione ticket](gestione_ticket.md).
Nella stessa area della sidebar è disponibile anche **[Quoting News](quoting_news.md)**: il canale in sola lettura per le comunicazioni di prodotto pubblicate da Quoting.
Quando si termina di lavorare su un preventivo, è consigliato **chiudere il ticket**.
### Stati del ticket
Un ticket può trovarsi in stati diversi, in base al punto del flusso di lavoro in cui si trova:
* **Aperto**: la richiesta è ancora da gestire o in lavorazione.
* **Da leggere**: il ticket deve essere ripreso dal team. Quando un ticket viene segnato come *Da leggere*, gli assegnatari vengono rimossi e la richiesta torna disponibile agli operatori abilitati.
* **In pausa**: la richiesta non è chiusa, ma si è in attesa di una risposta o di un'informazione dal cliente.
* **Chiuso**: la richiesta è conclusa e non deve più comparire tra i ticket da lavorare.
Lo stato **In pausa** è utile quando non si vuole chiudere definitivamente la richiesta. Se il cliente riscrive su un ticket in pausa, il ticket torna automaticamente **aperto**, rimane assegnato all'operatore originale e mostra di default anche i messaggi precedenti.
### Ordina per
Sopra la lista è disponibile **Ordina per**, con queste opzioni:
* **Messaggio più recente** (predefinito) — ultimo messaggio della chat, di qualsiasi mittente
* **Ricevuto più recente** — ultimo messaggio **del cliente**
* **Priorità decrescente** — priorità effettiva del contatto (personale o ereditata dall’azienda)
* **Turni più recenti** — prossimo turno di consegna
* **Messaggio meno recente**
### Filtri dei ticket
I filtri di **assegnazione / stato** restano sempre visibili (es. non assegnato, assegnato a me, ad altri, da leggere, in pausa, chiuso).
Il filtro **Assegnatario** resta **fuori**, nella riga principale.
Tutti gli altri filtri sono raggruppati nel pulsante a **imbuto** (come su mobile). Quando un filtro dell’imbuto è attivo, compare anche **fuori** come chip rimovibile.
Dentro l’imbuto trovi:
* **Etichette** — etichette del ticket
* **Utenti** — operatori assegnati
* **Tipologia azienda** — tipologia del contatto / azienda (cliente, fornitore, collaboratore, …)
* **Periodo ticket** — scorciatoie **Ultimi 7 giorni** o **Ultimi 30 giorni**
* intervallo manuale **Da** / **A** (date)
Un ticket assegnato presenta un’**icona con le iniziali dell’operatore** alla sinistra della preview del messaggio.
L’assegnazione dei ticket consente una migliore **divisione del lavoro** e un’**ottimizzazione del flusso operativo** tra colleghi.
### Anteprima e indicatori nella lista
Passando con il mouse sopra una chat nella parte sinistra è possibile visualizzare un'**anteprima della conversazione**, senza dover aprire subito il ticket.
Nella lista ticket, alla destra del **nome del contatto**, compare un **tag unico** che mostra:
* l’**icona di priorità** del contatto (personale o ereditata dall’azienda):
* triangolo verso l’alto → priorità **alta**
* pallino / trattino → priorità **media**
* triangolo verso il basso → priorità **bassa**
* subito dopo, il **codice azienda** (senza il `#` usato in passato)
* il **colore del tag** riflette la tipologia dell’azienda associata oppure, se presente, la tipologia personale del contatto
Passando il mouse sul tag compare un riepilogo (azienda, priorità, tipologia).
Nella preview restano utili anche:
* le **reaction** aggiunte dal cliente o dagli operatori
* l'icona dell'operatore assegnato
* lo stato del ticket e le eventuali [etichette](type_of_request.md) della richiesta
* il prossimo turno di consegna, quando disponibile
### Ricerca nella lista ticket
Nella parte sinistra è disponibile un campo di **ricerca** suddiviso in sezioni, con il conteggio dei risultati per ciascuna:
* **Tutte**
* **Conversazioni**
* **Messaggi**
* **Ricambi**
I chip delle sezioni si comprimono se lo spazio è stretto.
I contatti si trovano anche per **nome azienda** e **codice azienda**. Se la corrispondenza è sull’azienda, compare un’etichetta con nome o codice.
### Creazione rapida di un ticket
L’operatore può scrivere a uno dei propri contatti cliccando sul pulsante **‘+’** nella lista ticket
(azione *“Apri nuova richiesta”*).
La stessa azione è disponibile anche dalla sezione **[Contatti](contacts.md#apri-nuova-richiesta)** (lista e scheda del contatto).
Cliccando sui **tre puntini** in alto a destra è possibile:
* chiudere **tutti i ticket**
* oppure chiudere **tutti i ticket fino a ieri**
### Dettagli per singola chat
Qui spieghiamo nel dettaglio i componenti presenti nelle singole chat:
* Le icone accanto allo stato sono le [etichette](type_of_request.md) della richiesta
* Accanto al nome del contatto compare il **tag unico** con priorità e codice [azienda](companies.md) (senza `#`), colorato secondo la tipologia contatto/azienda
* Il valore presente nell'ovale azzurro, in questo caso 'Domani 08:00', equivale al primo cutoff / turno disponibile
- - -
## 2. Chat e gestione della conversazione
Questa sezione consente di:
* inviare messaggi
* allegare **foto, video e altri file**
* gestire la conversazione con il cliente
* controllare lo storico dei ticket collegati alla stessa chat
### Identificazione automatica dei dati
Gli elementi utili alla creazione di un preventivo
(es. **targa**, **telaio**, descrizione del veicolo o del ricambio richiesto)
vengono **automaticamente identificati** dalla conversazione con il cliente, **taggati** e riportati nella sezione di destra
(vedi punto **3**).
### Apertura, pausa e continuità dei ticket
Il flusso di scrittura e riapertura è descritto in dettaglio in **[Gestione ticket](gestione_ticket.md)**. In sintesi:
* se il ticket corrente è **aperto**, il messaggio resta sulla richiesta in corso
* se è **in pausa**, torna automaticamente **aperto** e resta assegnato all'operatore originale
* se è **chiuso**:
* con un ticket **già aperto** sullo stesso contatto → la risposta va sul ticket aperto (il chiuso resta collegato)
* se il chiuso **non è l’ultimo** → la risposta apre una **nuova richiesta** (il chiuso resta collegato)
* se il chiuso **è l’ultimo** → il ticket viene **riaperto**
Un ticket chiuso **non si riapre cambiando lo stato a mano**. Nei ticket chiusi sono disponibili i pulsanti **Vai al ticket aperto**, **Vai all’ultimo ticket chiuso** e **Apri nuova richiesta**.
Quando ha senso, resta possibile:
* visualizzare l’intera conversazione
* **unire** ticket collegati per recuperare il contesto già lavorato
I messaggi programmati vengono instradati **all’invio**. Se chiudi un ticket con messaggi ancora programmati, Quoting24 chiede conferma.
### Visualizzazione dei ticket nella chat
La chat principale mostra i ticket con lo stesso formato della chat intera: sono presenti linee e **banner** che indicano dove **inizia** e dove **finisce** ogni ticket.
Nei banner di separazione tra ticket (anche quando si usa **Vedi precedente**) vengono mostrati:
* **data** e **ora** di chiusura del ticket
* **chi ha chiuso** il ticket
Quando più ticket sono collegati alla stessa conversazione, sono disponibili azioni dedicate:
* **Unisci**: collega il ticket attuale a uno precedente, recuperando il contesto già lavorato.
* **Scollega richiesta**: separa una richiesta collegata per gestirla come ticket indipendente. L'azione è indicata dall'icona con l'**occhietto sbarrato**.
* **Apri conversazione intera**: se tra due ticket collegati ci sono altri ticket o messaggi intermedi, compare un pulsante per aprire la conversazione intera in quel punto e vederli tutti.
### Banner “N messaggi da leggere”
Aprendo un ticket con messaggi non letti del cliente, in chat compare un indicatore tra i messaggi già letti e quelli da leggere, ad esempio **“1 messaggio da leggere”** o **“N messaggi da leggere”**.
Il conteggio si aggiorna se arrivano altri messaggi del cliente mentre il banner è visibile. Non conta le **note interne** né i messaggi **inviati**.
### Trascrizione automatica vocali e immagini
Quoting24 trascrive automaticamente:
* i **messaggi vocali** ricevuti dai clienti
* il contenuto delle **immagini**, ad esempio:
* foto di una **targa**, che viene riconosciuta e trascritta automaticamente
Dal testo trascritto vengono ricavate tutte le informazioni utili
(targhe, telai, componenti del preventivo).
Se l'estrapolazione automatica dei dati da parte dell'AI è stata nascosta dalle impostazioni dell'attività, le informazioni tecniche possono comunque essere disponibili nella sezione di destra, ma non vengono mostrate come dettaglio operativo nella conversazione.
### Allegati
Cliccando sull’icona della **graffetta** è possibile allegare:
* foto
* video
* PDF
* altri file
Gli allegati possono anche essere **trascinati direttamente nella chat**.
### Anteprima PDF in chat
I **PDF** ricevuti o inviati in chat mostrano l’**anteprima della prima pagina** nel messaggio (miniatura in alto, nome e dimensione sotto). Cliccando sul file si apre il visualizzatore del documento.
Se l’anteprima non è disponibile, resta la scheda file classica.
### Editor immagini prima dell'invio
Quando si allega un'immagine a un messaggio, tramite icona della graffetta o trascinamento nella chat, Quoting24 mostra una preview dell'allegato prima dell'invio.
Cliccando sull'immagine nella preview si apre l'**editor immagini fullscreen**, che permette di modificare l'immagine prima di mandarla al cliente.
L'editor è disponibile solo per le immagini ancora in coda di invio. Non si applica a video, file generici o messaggi già inviati.
Gli strumenti disponibili sono:
* **Ritaglia**: permette di selezionare l'area dell'immagine da mantenere trascinando il riquadro
* **Ruota a sinistra / destra**: ruota l'immagine nella direzione scelta
* **Specchia orizzontale / verticale**: ribalta l'immagine sull'asse selezionato
* **Penna e colori**: consente di disegnare sull'immagine
* **Gomma**: rimuove i tratti disegnati
* **Sfocatura**: copre una zona con un rettangolo pixellato, regolabile in posizione e dimensione. Un altro clic sulla foto ne aggiunge un altro
* **Annulla**: annulla l'ultimo passaggio effettuato
Quando la modifica è terminata:
* cliccando **Fatto**, l'allegato originale viene sostituito con l'immagine modificata
* cliccando **Annulla**, l'immagine originale rimane invariata
Dopo la modifica, il messaggio può essere inviato normalmente.
La **sfocatura** serve a oscurare dati visibili nella foto, per esempio una targa, prima di mandarla al cliente. Ogni rettangolo si sposta e si ridimensiona; un altro clic sulla foto aggiunge un rettangolo in più.
### Messaggi vocali, audio e media
Quoting24 supporta i **messaggi vocali** e i file audio ricevuti in chat. I vocali possono essere ascoltati, trascritti automaticamente e, quando disponibile, scaricati come file audio.
Durante l’elaborazione compare lo stato **“Trascrizione in corso…”**. È disponibile anche il pulsante **Riprova**, per rilanciare la trascrizione se necessario.
Le foto e i video inviati nella conversazione possono essere aperti nel **carosello dei media**, che permette di scorrere rapidamente tra i contenuti multimediali ricevuti o inviati nella chat.
### Dettatura vocale
Sotto il campo di scrittura è disponibile l’icona **Dettatura**. Con il permesso al microfono, la voce viene trascritta in tempo reale nel messaggio.
### Indicatore "sta scrivendo"
Quando un altro utente sta digitando nella chat attiva, Quoting24 mostra l'indicatore **sta scrivendo**. Questo aiuta gli operatori a evitare risposte sovrapposte mentre un collega sta già preparando un messaggio.
### Invio senza intestazione o firma
Se nel proprio [profilo](profilo.md) sono state configurate intestazione o firma, Quoting24 le aggiunge in base alla scelta impostata: **sempre**, oppure **solo al primo messaggio del ticket e con Invia e chiudi**.
È comunque possibile inviare un singolo messaggio **senza intestazione e senza firma**.
Questa opzione è utile per risposte rapide, messaggi molto brevi o comunicazioni che non devono includere il testo automatico configurato dall'operatore.
### Azioni sui messaggi
Le azioni disponibili su un messaggio possono essere aperte in due modi:
* facendo **click destro** sul messaggio
* cliccando la **freccia** alla destra del messaggio
Da questo menu è possibile eseguire operazioni come rispondere, inoltrare o eliminare messaggi. Quando previsto dalla selezione, è possibile effettuare anche **inoltro** ed **eliminazione multipla**.
### Reaction ai messaggi
Le reaction permettono a clienti e operatori di reagire ai messaggi della conversazione.
Quoting24 mostra:
* la reaction applicata al messaggio
* chi ha aggiunto la reaction
* la reaction nella preview dei messaggi nella colonna di sinistra
Le reaction ricevute generano notifiche su Quoting24, nella **campanella** e, se abilitate, anche come **notifiche desktop**.
Se un cliente aggiunge una reaction a un messaggio appartenente a un ticket già chiuso, Quoting24 crea un riferimento al messaggio tramite **reply**, così la reaction resta visibile nel ticket attualmente aperto.
### Note interne
Nella chat è possibile inserire una **nota interna** per i colleghi:
* cliccando sull’icona dedicata
* oppure digitando **@ + SPAZIO**
Quando si scrive una nota interna:
* lo sfondo diventa **giallo**
* la nota **NON viene inviata al cliente**
* è visibile solo agli utenti di Quoting24
All’interno delle note è possibile **taggare un collega**
(scrivendo `@soprannome`) e il collega riceverà una notifica.
E' anche possibile taggare **tutti i colleghi** scrivendo `@tutti`.
Quando un utente viene taggato in una nota interna, la notifica generata da Quoting24 viene evidenziata in **arancione**. Accanto alle spunte di visualizzazione del messaggio viene inoltre mostrata l'icona della nota interna, così da distinguere subito i messaggi visibili solo agli operatori.
Le note interne di **testo** possono essere **modificate entro 15 minuti**, solo dall’**autore**.
Rispondendo a una nota interna:
* la risposta resta una **nota interna**
* l’autore della nota originale viene **riassegnato** al ticket
### Informazioni del ticket
Nella tab **Informazioni** (icona **i**) del ticket è possibile consultare e modificare rapidamente i dati collegati alla richiesta.
La sezione è organizzata così:
1. **In alto — Contatto**
Note, avvisi, assegnatari del contatto, **priorità** del contatto e **tipologia** del contatto (quest’ultima modificabile solo se il contatto non ha un’azienda).
2. **In basso — Azienda** (se presente)
Nome, note, sede, **priorità azienda** e **tipologia azienda**.
Sulla priorità del contatto:
* se non è impostata, viene **ereditata dall’azienda** (compare l’indicazione *Ereditata dall’azienda*)
* puoi comunque impostarne una personale, anche se l’azienda ha già una priorità
Sulla tipologia del contatto:
* **senza azienda** → puoi assegnarla sul contatto
* **con azienda** → è ereditata e **non modificabile** sul contatto; va cambiata sull’azienda
Nella select degli assegnatari del ticket è disponibile anche l’opzione **Nessuno**, che rimuove tutti gli assegnatari. Dettagli in [Assegnazioni](assegnazioni.md#assegnazione-manuale-e-assegnazione-a-tutti).
Se sul contatto sono presenti **avvisi importanti**, questi vengono mostrati sopra la chat per richiamare subito l'attenzione dell'operatore.
### Esportazione chat
Dalla chat è possibile **esportare** la conversazione.
All’avvio dell’export si può scegliere:
* esportazione **senza media**
* esportazione **con media**
Se si includono i media, questi vengono salvati in uno **zip a parte**, insieme al file della chat.
### Storico del ticket
Dal pannello laterale destro del ticket è possibile aprire la tab **Storico**, indicata dall'icona a forma di **orologio**.
Questa tab mostra una timeline in **sola lettura** degli eventi collegati al ticket. Serve per consultare cosa è successo sulla richiesta, chi ha effettuato l'azione e in quale momento.
Lo storico può includere eventi come:
* cambio di stato del ticket
* prima visualizzazione del ticket
* lettura dei messaggi non letti
* assegnazione o rimozione degli assegnatari del ticket
* autoassegnazione dell'operatore, indicata come azione di presa in carico automatica
* assegnazione delle ricerche collegate al ticket
* cambio stato delle ricerche, ad esempio aperta, in pausa o chiusa
Quando l'evento riguarda una ricerca veicolo, Quoting24 mostra anche i dati disponibili per riconoscerla più facilmente, come **targa**, **VIN** o **veicolo**.
Lo storico si aggiorna in tempo reale e non è modificabile da questa tab: è pensato esclusivamente per consultazione e tracciabilità operativa.
- - -
## 3. Sezione ricerca telaio e codici
La sezione di destra può essere **collassata** cliccando sull'icona della tab attiva. In questo modo è possibile lasciare più spazio alla conversazione quando non serve lavorare sui dati tecnici.
In questa sezione vengono riportate:
* **targhe**
* **telai**
* **descrizioni dei ricambi**
identificati direttamente dalla chat con il cliente.
La *targa* viene convertita automaticamente in *telaio* e vengono mostrate informazioni sul veicolo
(es. **marca**, **modello**, ecc.).
### Sub-assegnazioni
Le **sub-assegnazioni** permettono di assegnare non l’intero ticket, ma la **singola ricerca veicolo** all’interno della chat.
In un ticket possono coesistere **più ricerche** (ad esempio due targhe diverse o due veicoli dello stesso cliente). Ogni ricerca ha:
* un proprio **stato** (ad esempio *Aperto*, *In pausa*, *Chiuso*)
* uno o più **operatori assegnati**
In questo modo il lavoro può essere diviso per veicolo: un collega gestisce un mezzo, un altro collega un secondo mezzo, senza dover spezzare la conversazione in ticket diversi.
#### Differenza rispetto all’assegnazione del ticket
* **Assegnazione del ticket**: riguarda l’intera chat / richiesta e indica chi è responsabile della conversazione.
* **Sub-assegnazione**: riguarda la singola ricerca veicolo e indica chi lavora su quel mezzo specifico.
* **Dove si gestisce**: l’assegnazione del ticket sulla chat; la sub-assegnazione sul riquadro della ricerca, in alto a destra.
L’assegnazione del ticket e le sub-assegnazioni possono convivere: il ticket può restare assegnato a un operatore, mentre le ricerche interne vengono distribuite ad altri collaboratori.
#### Come assegnare una ricerca
1. Apri la ricerca veicolo nella sezione di destra.
2. Clicca l’icona della **persona** (o l’avatar dell’assegnatario) in alto a destra sulla riga del veicolo.
3. Cerca l’operatore e selezionalo, oppure scegli **Tutti** per coinvolgere tutti i collaboratori.
Nella stessa riga puoi anche cambiare lo **stato** della singola ricerca, in modo indipendente dallo stato del ticket.
Le variazioni di assegnazione e di stato delle ricerche vengono registrate anche nello [storico del ticket](#storico-del-ticket), insieme a targa, VIN o veicolo quando disponibili.
Per l’assegnazione automatica e manuale a livello di ticket, consulta la pagina [Assegnazioni](assegnazioni.md).
### Ricerca del ricambio tramite spaccati
Un modello di intelligenza artificiale propone una selezione di spaccati che possono includere la descrizione ricercata.
L'estrapolazione dei dati da immagini, vocali e testo può essere nascosta dalle impostazioni dell'attività, se l'amministratore preferisce non mostrare il dettaglio dell'elaborazione AI agli operatori.
L’operatore deve:
* entrare negli spaccati
* selezionare manualmente il **codice corretto**
Cliccando sull’anteprima di uno spaccato si apre la pagina di navigazione completa degli spaccati disponibili.
L’operatore:
* cerca il pezzo desiderato
* seleziona il codice spuntando la casella a sinistra
* chiude la pagina tramite la **‘X’** in alto a destra
Se l’operatore desidera visualizzare l’albero completo del telaio, può cliccare sulla **‘Q’** di Qricambi.
### Invio dello spaccato in chat
Dalla visualizzazione degli spaccati è possibile inviare direttamente in chat la **foto dello spaccato** collegata al ricambio selezionato. Questa funzione è utile quando si vuole chiedere conferma al cliente mostrando il dettaglio tecnico del pezzo.
### Azioni disponibili sui codici
Alla destra di ogni codice sono disponibili:
* una **‘i’** con informazioni aggiuntive sul pezzo
* una **‘Q’** rossa per cercare il codice su Qricambi
* l’icona per **copiare il codice**
Il codice selezionato viene riportato nella schermata precedente ed è possibile:
* cercarlo su **[Qricambi](https://app.qricambi.com/)**
* creare un **[preventivo](invia_preventivo_gestionale.md)**
* inviarlo al cliente tramite **Quoting24**
### Ricerca diretta sui fornitori
In alternativa, è possibile cercare i codici direttamente su alcuni fornitori da **Quoting24**.
Per farlo, dalla sezione **[Impostazioni → Qricambi](qricambi_integration.md)** è possibile selezionare:
* fornitori **interni** (es. proprie liste)
* fornitori **esterni**
La ricerca sui fornitori:
* è più sintetica rispetto a Qricambi
* segue la stessa logica
I risultati sono ordinati per:
* **prezzo**
* **disponibilità**
In alto vengono mostrati i prodotti:
* più economici
* immediatamente disponibili (**verde**)
Scorrendo i risultati:
* la disponibilità passa da **giallo** a **rosso**
* il prezzo aumenta
Vengono mostrati:
* codice
* marchio
* fornitore
* descrizione
* prezzo netto
* prezzo di listino, se disponibile
* disponibilità
Accanto a ogni risultato sono presenti due icone:
* aggiunta al **[carrello Qricambi](https://app.qricambi.com/?next=%2F&activetab=orders)**
* link al sito e-commerce del fornitore
> **NB**
> La ricerca automatica sui fornitori di Qricambi può essere disabilitata in qualsiasi momento
> dalla sezione **[Impostazioni → Qricambi](qricambi_integration.md)**
### Ricerca nei risultati Qricambi
Quando sono presenti molti risultati, è possibile effettuare una **ricerca per testo** all'interno dei risultati di Qricambi, così da individuare più rapidamente il codice, il marchio o la descrizione desiderata.
---
# Gestione ticket
URL: https://wiki.quoting24.com/content/gestione_ticket/
Language: it
Updated: 2026-11-04
# Gestione ticket
Quoting24 organizza ogni conversazione WhatsApp in **ticket**. Da ora il flusso è **ordinato**: per ogni contatto esiste **un solo ticket su cui si può scrivere** in modo libero.
Questa pagina spiega le regole di scrittura, riapertura, reply e messaggi programmati.
---
## Concetti base
| Concetto | Significato |
| --- | --- |
| **Thread** | Tutti i ticket dello stesso contatto |
| **Ticket scrivibile** | L’unico ticket del thread su cui puoi digitare liberamente (di solito quello aperto, oppure l’ultimo chiuso nelle condizioni sotto) |
| **Reply** | Risposta a un messaggio specifico: può instradare il testo verso un altro ticket del thread |
Regola pratica: **non puoi riaprire a mano un ticket chiuso** (cambiando lo stato). Per riprendere il lavoro usi un messaggio, una risposta a un messaggio, o i pulsanti dedicati nei ticket chiusi.
---
## Cosa succede quando scrivi
### C’è già un ticket aperto
Se il cliente (o tu) rispondete mentre esiste un ticket **aperto** (o **in pausa** che torna aperto), i messaggi vanno su quel ticket.
### Scrivi da un ticket chiuso
Dipende dalla posizione del ticket chiuso nel thread:
1. **Esiste già un ticket aperto**
La risposta viene inviata sul ticket aperto. Il ticket chiuso da cui stavi rispondendo resta chiuso e viene **collegato** al ticket che ha ricevuto il messaggio.
2. **Il ticket chiuso non è l’ultimo del thread**
La risposta **apre una nuova richiesta**. Anche in questo caso il ticket chiuso di partenza resta collegato al ticket di destinazione.
3. **Il ticket chiuso è l’ultimo del thread**
Solo in questo caso il messaggio **riapre** quel ticket.
Per scrivere da un ticket chiuso che non è quello scrivibile, Quoting24 chiede di **rispondere a un messaggio** (reply): senza reply, la composizione resta bloccata con l’indicazione di selezionare un messaggio.
---
## Pulsanti nei ticket chiusi
Quando apri un ticket chiuso, in basso compaiono azioni che seguono le stesse regole del flusso:
- **Vai al ticket aperto** — se nel thread c’è già una richiesta aperta
- **Vai all’ultimo ticket chiuso** — se non ci sono aperti (e l’ultimo chiuso non è quello che stai guardando)
- **Apri nuova richiesta** — crea una nuova richiesta nel thread, quando non c’è un ticket aperto
Questi pulsanti evitano di “lavorare sul ticket sbagliato” e ti portano nel punto corretto del flusso.
Quando fai reply da un ticket chiuso, Quoting24 ti indica anche dove andrà il messaggio, ad esempio:
- *La risposta verrà inviata nel ticket aperto.*
- *La risposta aprirà un nuovo ticket.*
---
## Messaggi programmati
I messaggi programmati **non decidono subito** il ticket definitivo: vengono **instradati al momento dell’invio**, con le regole del thread in vigore in quell’istante.
Conseguenza: se chiudi un ticket che ha ancora messaggi programmati in sospeso, Quoting24 chiede conferma. All’invio il messaggio potrebbe:
- riaprire il ticket (se è ancora l’ultimo chiuso)
- oppure finire in un’altra richiesta aperta / nuova
---
## Cosa non puoi più fare
- **Riaprire manualmente** un ticket chiuso cambiandone lo stato
Il sistema blocca l’azione e invita a scrivere un messaggio (nelle condizioni corrette) oppure a usare i pulsanti del flusso.
- Avere **due ticket aperti** sullo stesso contatto
Se ne esiste già uno aperto, non se ne apre un secondo.
---
## Stati del ticket (promemoria)
- **Aperto** — in lavorazione
- **Da leggere** — da riprendere; gli assegnatari vengono rimossi
- **In pausa** — in attesa del cliente; se il cliente riscrive, torna **aperto** e resta assegnato all’operatore originale
- **Chiuso** — concluso; non compare tra i ticket da lavorare, ma resta consultabile e soggetto alle regole di reply / riapertura sopra
La **pausa** non è una chiusura: non applica le regole dei ticket chiusi.
---
## Dove aprire una nuova richiesta
Puoi avviare una conversazione / nuova richiesta da:
- il pulsante **+** nella lista ticket della home (*Apri nuova richiesta*)
- la sezione **[Contatti](contacts.md#apri-nuova-richiesta)** (lista e scheda contatto)
- il pulsante **Apri nuova richiesta** dentro un ticket chiuso, quando previsto dal flusso
---
## Collegamenti utili
- [Schermata principale](main_screen.md) — lista, filtri, anteprima, chat
- [Lista richieste](requested_list.md) — storico e filtri di stato
- [Contatti](contacts.md) — apri richiesta, priorità e tipologia contatto
---
# Lista richieste
URL: https://wiki.quoting24.com/content/requested_list/
Language: it
Updated: 2026-11-04
# Lista richieste
Cliccando sul **menù in alto a destra** e selezionando **“Lista richieste”**, si apre lo **storico delle richieste** create dai vari contatti su Quoting24.
---
## Visualizzazione delle richieste
Di default vengono mostrate **solo le richieste aperte**.
Tramite il **filtro in alto a destra** è possibile:
- visualizzare le richieste **in pausa**
- visualizzare le richieste **da leggere**
- visualizzare le richieste **chiuse**
- applicare **altri filtri** per affinare la ricerca
---
## Ricerca tra le richieste
La lista richieste permette di cercare rapidamente tra i ticket presenti nello storico.
La ricerca può essere usata per individuare una richiesta partendo da informazioni come:
- nome o numero del contatto
- azienda collegata
- contenuto della richiesta
- stato del ticket
- dati tecnici riconosciuti, ad esempio targa o telaio
I filtri possono essere combinati con la ricerca testuale per restringere l'elenco e trovare più velocemente il ticket corretto.
---
## Richieste in pausa
Le richieste **in pausa** sono ticket non chiusi definitivamente, ma momentaneamente sospesi perché si è in attesa di un messaggio o di una conferma dal cliente.
Quando il cliente riscrive su un ticket in pausa:
- il ticket torna automaticamente **aperto**
- rimane assegnato all'operatore originale
- vengono mostrati di default anche i messaggi precedenti
Questo comportamento è diverso dai ticket **chiusi**: su un ticket chiuso valgono le regole del flusso ordinato (reply, riapertura solo se è l’ultimo, altrimenti nuova richiesta o instradamento sul ticket già aperto). Dettagli in [Gestione ticket](gestione_ticket.md).
---
## Apertura di una richiesta
Cliccando sulla **freccia rossa** in fondo a destra di una riga, è possibile aprire la **richiesta specifica** e accedere al relativo ticket.
Quando si apre una richiesta, Quoting24 mostra il contesto collegato al ticket, inclusi eventuali messaggi precedenti se la richiesta era stata messa in pausa o collegata ad altri ticket.
---
# Etichette
URL: https://wiki.quoting24.com/content/type_of_request/
Language: it
Updated: 2026-11-04
# Etichette
Un ticket può avere **più etichette** insieme. Servono a classificare la richiesta e, con l’[assegnazione automatica](assegnazioni.md) attiva, a passarla agli operatori collegati a quelle etichette.
Nella lista dei ticket ne compaiono fino a **3 come icone**. Se ce ne sono altre, compare **+N**. Se il nome non entra nello spazio, resta l’icona: il nome si legge nel tooltip.
---
## Tre tipi di etichetta
| Tipo | Chi la crea | Chi la può assegnare |
| --- | --- | --- |
| **Personalizzata** | La stanza | Gli operatori |
| **AI** | La stanza, con «assegna con l’AI» attivo (solo AI Premium) | Gli operatori e l’agente premium |
| **Predefinita** | Già presente in ogni stanza | Gli operatori e il classificatore |
Le etichette messe da un operatore **non vengono mai tolte in automatico**. Il classificatore e l’agente **aggiungono** soltanto.
---
## Etichette predefinite
Sono **11**, uguali per tutte le stanze:
* Informazioni
* Commerciale
* Ordini e logistica
* Acquisti
* Garanzie, resi e reclami
* Supporto
* Amministrazione
* IT
* Servizi
* Auth
* Altro
Non si possono **rinominare** né **eliminare**. Si possono cambiare il **colore** e gli **assegnatari**.
Si trovano in **Impostazioni → Ticket e automazioni → Etichette**, scheda **Etichette predefinite**.
Con **AI lite** non c’è categorizzazione automatica: le predefinite si possono comunque assegnare a mano. In quel modulo la scheda delle predefinite non compare.
---
## Etichette personalizzate
Nella scheda **Etichette personalizzate** il pulsante **Aggiungi** crea un’etichetta della stanza: nome, colore, icona e descrizione.
Con **AI Premium** si può attivare **Autoassegna questa etichetta ai ticket con intelligenza artificiale**. L’agente la usa solo se la descrizione dice con chiarezza quando applicarla. In lista queste etichette hanno il badge **AI**.
Gli assegnatari si impostano dalla colonna **Assegnato a**. Se l’[assegnazione automatica](assegnazioni.md) è attiva, una richiesta con quell’etichetta va a loro.
---
## Categorizzazione automatica
Ogni stanza sceglie chi mette le etichette in automatico, da **Impostazioni → Ticket e automazioni → Classificatore ticket**. La modifica si salva con **Salva modifiche**.
| Opzione | Cosa succede | Per chi |
| --- | --- | --- |
| **Disattivata** | Nessuna etichetta automatica, solo a mano | Tutti |
| **Etichette predefinite (AI economica)** | Il classificatore mette le etichette predefinite | Solo AI economica |
| **AI Premium** | L’agente premium mette le etichette AI della stanza | Solo AI Premium |
Quando cambia il modulo AI della stanza, l’opzione si adegua:
* **Premium** → AI Premium
* **Lite** → Disattivata
* **Economica**, se prima era Premium o Lite → Etichette predefinite. Se era già economica e disattivata, resta disattivata
Il classificatore mette le etichette solo sui **primi messaggi del cliente**. Appena un operatore risponde, scrive una nota interna o mette un’etichetta, si ferma.
---
## Urgenza
Tre livelli:
* **Bassa** — saluti, ringraziamenti, spam
* **Normale** — preventivi, ordini, fatture
* **Alta** — ricambio che serve oggi, auto ferma in officina, consegna in ritardo o sbagliata, pagamento in scadenza
I ticket con urgenza **alta** hanno un’icona di avviso nella lista.
Con l’**AI economica** la imposta il classificatore, a ogni nuovo gruppo di messaggi del cliente. Con l’**AI Premium** la imposta l’agente.
---
## Messaggi semplici
Molti messaggi del cliente sono chiacchiere o accordi pratici («grazie», «ok», orari, ritiro) e non hanno bisogno del riconoscimento ricambi.
Con l’**AI economica**, se il classificatore è abbastanza sicuro e il messaggio è **solo testo o vocale**, il riconoscimento ricambi non parte. **Immagini e file** passano sempre dal riconoscimento.
---
## Collegamento ai ticket precedenti
Nella stessa pagina **Classificatore ticket**, l’interruttore **Collegamento automatico ticket** è **spento** di default. Vale solo per l’**AI economica**.
Quando un contatto scrive in un nuovo ticket, prima che un operatore risponda, l’AI lo confronta con gli **ultimi due ticket chiusi** del contatto. Se è la continuazione di uno di questi (stesso veicolo, o un ticket senza veicolo), collega il nuovo ticket a quello e la conversazione precedente compare in chat.
Collega solo quando è molto sicura: a volte non collega anche quando avrebbe ragione. Non lavora su un ticket **già collegato**.
---
## Quando lavorano
| Funzione | Lavora solo se… |
| --- | --- |
| **Classificatore** | la stanza ha l’**AI economica**, arrivano **nuovi messaggi del cliente** e il classificatore è configurato |
| **Urgenza** | a ogni nuovo gruppo di messaggi del cliente |
| **Messaggi semplici** | i nuovi messaggi sono **solo testo o vocali** |
| **Etichette automatiche** | la stanza è su «Etichette predefinite», nel ticket **non ha ancora scritto nessun operatore** e **nessun operatore ha messo un’etichetta** |
| **Collegamento** | è **attivo**, nel ticket **non ha ancora scritto nessun operatore**, il contatto ha **ticket chiusi** (solo gli ultimi due) e il ticket **non è già collegato** |
Se il classificatore non è configurato, Quoting24 funziona comunque: semplicemente non classifica.
---
## Come usarle
* **A mano**: nel ticket, sul campo **Etichetta**, si scelgono una o più etichette (personalizzate e predefinite).
* **Etichette automatiche**: in Classificatore ticket scegli «Etichette predefinite (AI economica)», poi in Etichette imposta gli **assegnatari** di ogni etichetta predefinita.
* **Agente premium**: crea le etichette con l’assegnazione AI e scrivi una **descrizione chiara**.
* **Collegamento**: attivalo se i clienti tendono a riscrivere su richieste già chiuse.
* **Urgenze**: tieni d’occhio l’icona di avviso nella lista dei ticket.
Le impostazioni della stanza le vedono admin, owner e superadmin.
---
# Risposte salvate
URL: https://wiki.quoting24.com/content/save_response/
Language: it
Updated: 2026-11-04
# Risposte salvate
Dalla sezione **“Risposte salvate”** è possibile creare **risposte predefinite** da inviare rapidamente ai clienti.
---
## Creazione di una nuova risposta salvata
Per creare una nuova **Risposta salvata**, clicca sul pulsante rosso in alto
**“+ Aggiungi Risposta”**.
È necessario inserire:
- un **nome**
- il **contenuto** della risposta
E' possibile aggiungere un **file in allegato**.
---
## Tipologia di risposte salvate
Le risposte salvate possono essere gestite in **due modalità**:
- **Solo per me**
Pensata per risposte personali (es. *“Sono Antonio…”*).
Questa risposta sarà utilizzabile **solo dall’utente che la crea**.
Gli [utenti](user.md) **non amministratori** possono visualizzare e impostare **solo** risposte salvate di tipo *“solo per me”*.
- **Per tutta l’attività**
Tutti gli utenti dell’account vedranno la risposta salvata.
**Solo gli [utenti amministratori](user.md)** possono creare e modificare questo tipo di risposte.
---
## Gestione delle risposte salvate
Le risposte salvate possono essere:
- **attivate o disattivate** tramite l’apposita spunta
- **modificate** cliccando sull’icona a forma di **matita** alla destra di ogni risposta
---
## Utilizzo delle risposte salvate in chat
L’inserimento di una risposta salvata avviene direttamente dalla **barra di scrittura del messaggio**.
Per utilizzarla:
1. digita il carattere **`/`**
2. scrivi il **nome** della risposta salvata (anche parzialmente)
È possibile inserire la risposta:
- **senza completare il nome**
- premendo **Invio** sulla risposta evidenziata
(non è necessario utilizzare il mouse)
---
## Ordinamento dei suggerimenti
Nel caso in cui il testo inserito sia **parziale o ambiguo**
(es. `/o`), i suggerimenti delle risposte salvate vengono ordinati come segue:
1. **Ordine alfabetico** dei nomi che iniziano con il testo digitato
(es. `/o` → *ora*, *orario*)
2. Successivamente, vengono mostrati i risultati in cui il testo digitato
è contenuto **nel nome o nel contenuto**, anch’essi in ordine alfabetico
---
# Assegnazioni
URL: https://wiki.quoting24.com/content/assegnazioni/
Language: it
Updated: 2026-11-04
# Assegnazione automatica
Il sistema di **Assegnazione Automatica** ha l’obiettivo di rendere la gestione dei ticket
più **rapida**, **efficiente** e **precisa**, soprattutto in contesti in cui
più operatori lavorano su un unico numero WhatsApp.
Questa funzionalità assegna automaticamente i **nuovi ticket** all’operatore o al team
più adatto, basandosi su **regole predefinite**.
L’obiettivo è:
- eliminare l’assegnazione manuale
- ridurre i tempi di attesa per i clienti
- garantire che ogni richiesta arrivi subito alla persona giusta
---
## Quando entra in funzione l’assegnazione automatica
Il sistema entra in azione **quando arriva il primo messaggio di un nuovo ticket**.
Analizza le informazioni del ticket e le confronta con:
- competenze
- responsabilità
- configurazioni degli operatori
L’assegnazione si basa su **tre criteri di corrispondenza**:
1. **[Etichetta](type_of_request.md)**
(vedi sezione *Etichette*)
2. **[Azienda](companies.md) assegnata al contatto**
Se esistono operatori dedicati a una specifica azienda cliente
3. **[Contatto](contacts.md)**
Se esiste un referente di fiducia per uno specifico contatto
Per ogni nuovo ticket il sistema:
- calcola quante corrispondenze ha ciascun operatore
- procede con l’assegnazione secondo la regola scelta
⚠️ L’auto-assegnazione **si applica solo ai primi messaggi del cliente**
e smette di funzionare quando c’è un’attività dell’operatore sul ticket.
### Autoassegnazione all'apertura
Se un ticket è ancora **da leggere** e non è assegnato a nessun operatore, l'apertura del ticket può assegnarlo automaticamente all'operatore che lo sta prendendo in carico.
Questo comportamento evita che due operatori inizino a lavorare contemporaneamente sulla stessa richiesta e rende più chiaro chi è responsabile del ticket.
---
## Disponibilità degli operatori
Il sistema è progettato per lavorare **solo con operatori realmente disponibili**.
L’assegnazione automatica avviene **solo se almeno un operatore idoneo è online**.
- **Se nessun operatore qualificato è online**
Il ticket **non viene assegnato automaticamente**
e rimane disponibile per la presa in carico manuale.
- **Se almeno un operatore qualificato è online**
Il sistema procede con l’assegnazione automatica.
---
## Regole di assegnazione
Puoi configurare il sistema affinché utilizzi una delle seguenti **logiche di assegnazione**:
---
### Miglior corrispondenza
Con questa regola, il ticket viene assegnato **solo all’operatore (o agli operatori)**
con il **punteggio di corrispondenza più alto**.
È ideale per indirizzare le richieste verso un esperto specifico.
#### Esempio pratico
Un ticket arriva dall’azienda **“ACME Corp”** ed è di tipo **“Commerciale”**:
- **Anna** → responsabile per il tipo *Commerciale* (1 corrispondenza)
- **Marco** → responsabile per l’azienda *ACME Corp* (1 corrispondenza)
- **Lucia** → responsabile sia per il tipo *Commerciale* che per *ACME Corp* (2 corrispondenze)
➡️ Con la regola **Miglior Corrispondenza**,
il ticket viene assegnato **solo a Lucia**.
---
### Tutte le corrispondenze
Con questa regola, il ticket viene assegnato a **tutti gli operatori**
che hanno **almeno una corrispondenza**.
È adatta a team in cui più persone possono gestire lo stesso tipo di richiesta.
#### Esempio pratico
Usando lo stesso scenario precedente:
➡️ Con la regola **Tutte le Corrispondenze**,
il ticket viene assegnato ad **Anna, Marco e Lucia**.
---
## Gestione del ciclo di vita di un ticket auto-assegnato
### Assegnazione manuale e assegnazione a tutti
Oltre all'assegnazione automatica, un ticket può essere assegnato manualmente a uno o più operatori.
Nella select degli **assegnatari** è disponibile l’opzione **Nessuno**. Selezionandola si **rimuovono tutti gli assegnatari** dal ticket.
Quando serve coinvolgere tutto il team, è possibile assegnare il ticket a **tutti i collaboratori** abilitati. Questa funzione è utile per richieste urgenti o per ticket che possono essere gestiti dal primo operatore disponibile.
### Ticket segnato come "Da leggere"
Un ticket può essere segnato come **Da leggere** per rimetterlo nel flusso di presa in carico del team.
Quando un ticket viene segnato come *Da leggere*:
- vengono rimossi gli assegnatari presenti
- la richiesta torna visibile agli operatori che possono prendere in carico ticket non assegnati
- il ticket può essere riassegnato manualmente o tramite il normale flusso operativo
### Ticket senza risposta (tempo di sicurezza)
Per evitare che un ticket auto-assegnato rimanga ignorato,
è previsto un **tempo di sicurezza configurabile**.
Se un ticket:
- è stato auto-assegnato
- **non riceve risposta** entro il tempo impostato
l’assegnazione automatica viene **rimossa**.
Il ticket torna:
- **non assegnato**
- visibile a tutto il team
Questo meccanismo evita che le richieste vadano perse.
---
### La prima risposta “reclama” il ticket
Quando un ticket è assegnato automaticamente a **più operatori**:
1. il **primo operatore che risponde** reclama il ticket
2. tutti gli altri operatori vengono rimossi dall’assegnazione
3. l’operatore che ha risposto diventa l’**unico responsabile**
Questo garantisce:
- nessuna sovrapposizione
- responsabilità sempre chiara
---
## Configurazione dell’assegnazione automatica
L’amministratore può configurare il sistema seguendo questi passaggi:
1. **Abilita la funzione**
Attiva l’opzione *“Abilita Assegnazione Automatica”* nelle impostazioni.
2. **Scegli la regola di assegnazione**
- Miglior corrispondenza
- Tutte le corrispondenze
3. **Imposta il tempo di sicurezza**
Definisci dopo quanti minuti un ticket non gestito
deve tornare non assegnato
(di default **15 minuti**).
4. **Definisci le responsabilità degli operatori**
Associa gli operatori alle loro aree di competenza:
- **Tipi di ticket**
- **Aziende**
- **Contatti**
---
## Esempio pratico avanzato
- **Matteo** è esperto di *Jeep* e *carrozzeria*
- **Alessandro** è esperto di *carrozzeria*
Arriva una richiesta per una **portiera di una Jeep Renegade**.
- Con **Miglior Corrispondenza**
➜ il ticket viene assegnato **solo a Matteo**
- Con **Tutte le Corrispondenze**
➜ il ticket viene assegnato **a Matteo e Alessandro**
---
# Turni di consegna
URL: https://wiki.quoting24.com/content/delivery_shifts/
Language: it
Updated: 2026-11-04
# Turni di consegna
È possibile creare e gestire i **turni di consegna** dall’apposita voce presente nel menù.
Cliccando sul menù, viene mostrato l’elenco dei **turni di consegna già esistenti**.
Per creare un nuovo turno, è sufficiente cliccare sul pulsante rosso in alto a destra
**“+ aggiungi”**.
---
## Assegnazione dei turni alle aziende
Una volta creato un turno di consegna, è possibile **assegnarlo a una o più [aziende](companies.md)**.
L’assegnazione può essere effettuata da diversi punti dell’applicazione
(all’interno della gestione azienda), ma il metodo **consigliato** è quello di procedere **in modo massivo**.
Per farlo:
1. entra nel **turno di consegna** a cui vuoi assegnare le aziende
2. utilizza la schermata di modifica del turno
---
## Assegnazione massiva tramite filtri
Da questa schermata è possibile:
- filtrare le aziende
- selezionare più aziende contemporaneamente
- assegnare il turno in modo massivo
- salvare le modifiche
I filtri possono utilizzare anche **dati di anagrafica azienda**, ad esempio:
- città
- note
- note amministratore
---
# Report giornaliero attività
URL: https://wiki.quoting24.com/content/daily_activity_report/
Language: it
Updated: 2026-11-04
# Report giornaliero attività
È disponibile un **report giornaliero automatico** inviato via email che fornisce una panoramica sull’attività di gestione dei ticket di supporto.
I KPI si riferiscono al **giorno precedente** e sono confrontati con lo **stesso giorno della settimana precedente**. Tutti i tempi sono espressi in **minuti**.
---
## Requisiti
Per configurare i destinatari del report è necessario essere **[amministratore](user.md)**.
Se il proprio utente è un **membro**, occorre richiedere a un amministratore della stanza il **cambio di tipologia utenza** (da membro ad amministratore), oppure contattare il supporto Quoting24.
---
## Come impostare il report
1. Aprire **Impostazioni → Impostazioni generali → Stanza**
2. Nella sezione **Email report statistiche**, cliccare su **Modifica destinatari**
3. Aggiungere un **nuovo destinatario** e compilare:
- **Email** dell’indirizzo che deve ricevere il report
- **Attivo**: se disattivo, quell’indirizzo non riceve il report
- **Frequenza** (ad esempio **Giornaliera**)
- **Ora di invio**
4. Cliccare su **Salva**
---
## Cosa contiene il report
### KPI di ieri
Indicatori principali del giorno precedente, con confronto rispetto allo stesso giorno della settimana precedente:
- ticket creati e ticket chiusi
- percentuale di chiusura
- risposte inviate dagli operatori
- messaggi ricevuti
- tempo mediano di risposta
- tempo mediano di apertura ticket
- operatori attivi
- contatti attivi
- veicoli cercati
- richieste ricambi effettuate
### Performance operatori
Dettaglio per ciascun operatore su:
- risposte inviate
- note interne
- ticket assegnati e chiusi
- percentuale di chiusura
- tempo mediano di risposta e di apertura
### Messaggi per fascia oraria
Distribuzione dei **messaggi ricevuti e inviati** durante la giornata, suddivisi per fascia oraria (ora locale). Note interne e messaggi cancellati sono esclusi.
### Utenti online
Numero di **operatori diversi** che hanno lavorato in ciascuna fascia oraria (eventi ticket, messaggi o note inviati).
### Ticket aperti
Andamento dei ticket **in stato aperto** nel corso della giornata (campioni periodici), incluso il picco e quanti ne risultano aperti a fine giornata. Conta anche i ticket creati nei giorni precedenti, se ancora aperti.
### Top clienti
Elenco dei clienti con maggiore attività nel giorno, ordinati per messaggi ricevuti, con dettaglio su veicoli, ricerche, messaggi e operatori coinvolti.
### Andamento giornaliero
Confronto tra **settimana corrente e precedente**: ticket creati e risposte operatori giorno per giorno.
### Statistiche degli ultimi 7 giorni
- **Performance operatori** aggregate sugli ultimi 7 giorni
- **Heatmap di attività**, che evidenzia le risposte di ciascun operatore giorno per giorno
Questo report consente di **monitorare l’efficienza del servizio clienti**, analizzare i carichi di lavoro e valutare l’andamento delle performance nel tempo.
---
# Quoting News
URL: https://wiki.quoting24.com/content/quoting_news/
Language: it
Updated: 2026-11-04
# Quoting News
**Quoting News** è il canale dove Quoting pubblica aggiornamenti e avvisi sul prodotto.
Compare nella sidebar delle chat, insieme alle richieste. Non è un ticket: è una chat in **sola lettura**. Solo Quoting può inviare questi messaggi: gli operatori li leggono, non li creano né rispondono.
---
## Come funziona
1. Apri **Quoting News** dalla sidebar a sinistra.
2. Leggi lo storico delle comunicazioni, ordinate per data.
3. Quando hai finito, clicca **Ho letto**: sparisce il badge delle novità non lette, senza chiudere la chat.
Non puoi scrivere né rispondere. Se non ci sono messaggi, vedi lo stato *Nessuna novità*.
---
# Panoramica WhatsApp
URL: https://wiki.quoting24.com/content/whatsapp/
Language: it
Updated: 2026-11-04
# WhatsApp
Questa sezione è visibile **solo agli amministratori** e non ai membri (utenti).
Da qui è possibile collegare **Quoting24** a **WhatsApp** tramite le **API ufficiali di Meta** (WhatsApp Business Platform), abilitando:
- gestione delle chat
- gestione dei contatti
- invio e ricezione dei messaggi da Quoting24
Il collegamento tramite API ufficiali è la modalità prevista per questa versione della wiki.
---
## Collegamento tramite API ufficiali Meta
Le API ufficiali permettono a Quoting24 di gestire le conversazioni WhatsApp in modo stabile, tracciabile e supportato da Meta.
### Pro
- Possibilità di utilizzare **bottoni interattivi** nei messaggi
(es. "Approva preventivo"), collegabili a sistemi ERP
- **Alta stabilità** e supporto tecnico ufficiale
- Gestione centralizzata delle richieste in Quoting24, con ticket, assegnazioni e automazioni
### Regole operative
- I messaggi in uscita verso **nuovi contatti**
(da cui non abbiamo ricevuto messaggi nelle ultime 24 ore)
sono vincolati a **template pre-approvati da Meta**
Solo dopo una risposta del cliente è possibile comunicare liberamente.
Dopo l'invio di un messaggio pre-approvato è possibile scrivere messaggi normali, ma questi verranno recapitati al cliente **solo dopo una sua azione**
(es. click su bottone "dimmi pure" o risposta).
- Il cliente deve **approvare l'apertura del canale di comunicazione**
e deve trovarsi su **dispositivo mobile** per completare correttamente l'interazione con i template.
- A seconda della configurazione scelta, l'uso manuale dell'app WhatsApp Business sullo stesso numero può richiedere la funzione [WhatsApp Coexistence](whatsapp_coexistence.md).
- I gruppi WhatsApp e le liste broadcast dell'app non sono supportati sulle API Meta; per campagne con template usa la sezione [Broadcast API](broadcast_api.md).
Se il numero è già sulle API di un altro fornitore e vuoi portarlo su Quoting24 senza cambiarlo, segui [Migrazione WhatsApp API](migrazione_whatsapp_api.md).
---
## Funzionalità disponibili con Quoting24
Una volta collegato il canale ufficiale, Quoting24 permette di lavorare sulle richieste WhatsApp con le proprie funzioni operative:
- suddivisione delle conversazioni in **ticket**
- assegnazione manuale o automatica agli operatori
- riconoscimento di targhe, telai e ricambi nei messaggi
- invio di messaggi, immagini e documenti
- invio di preventivi e PDF dal gestionale
- utilizzo di bottoni interattivi quando previsti dal flusso API
Le funzionalità interne di Quoting24 restano gestite dalla piattaforma; l'invio dei messaggi verso il cliente segue invece le regole operative delle API ufficiali Meta.
---
# WhatsApp Coexistence
URL: https://wiki.quoting24.com/content/whatsapp_coexistence/
Language: it
Updated: 2026-11-04
# WhatsApp Coexistence
La funzione **WhatsApp Coexistence** (coesistenza) permette alle aziende di utilizzare contemporaneamente l'**App WhatsApp Business** (su telefono) e le **API di WhatsApp Business** (tramite Quoting24 o altri software) sullo stesso numero di telefono.
Questa è una **svolta significativa**, poiché in precedenza l'attivazione delle API richiedeva la cancellazione dell'account WhatsApp Business sul telefono, impedendo l'uso manuale dell'app.
---
## Vantaggi della Coesistenza
Attivando la coesistenza, puoi ottenere il meglio da entrambi i mondi:
1. **Interazione Umana e Personale (App Business)**:
- Continua a usare WhatsApp sul tuo smartphone come hai sempre fatto.
- Rispondi manualmente ai clienti quando necessario.
- Intervieni manualmente dal telefono quando serve una gestione diretta del cliente.
2. **Potenza e Automazione (API Business)**:
- Collega Quoting24 per gestire volumi elevati di richieste.
- Sfrutta i bot per l'auto-risposta e la qualificazione dei contatti.
- Invia preventivi strutturati direttamente dal gestionale.
- Gestisci le chat in team multi-utente tramite la piattaforma web.
In sintesi: **puoi automatizzare il lavoro pesante con le API, mantenendo la possibilità di intervenire personalmente dal telefono per i casi speciali.**
---
## Requisiti
Per attivare la coesistenza è necessario soddisfare alcuni requisiti tecnici:
- **App Aggiornata**: Assicurati di avere l'ultima versione di WhatsApp Business installata sul tuo dispositivo.
- **Account Business Verificato**: Potrebbe essere necessario completare la verifica dell'azienda nel Business Manager di Meta.
---
## Come attivare la Coesistenza
Il processo segue il flusso di "Embedded Signup" (registrazione integrata) usato per l'attivazione delle API ufficiali.
1. **Avvia la connessione**: Inizia il processo di collegamento del numero da Quoting24: il tuo BSP (Business Solution Provider).
2. **Scegli il numero**: Seleziona il numero di telefono che è **già attivo** sull'App WhatsApp Business.
3. **Verifica dell'idoneità**: Il sistema controlla che il numero e l'account rispettino i requisiti previsti da Meta.
4. **Conferma guidata**: Completa i passaggi richiesti dal flusso Meta e da Quoting24.
5. **Attivazione**: Una volta completato il processo, le API vengono abilitate sul numero esistente e possono lavorare in parallelo con l'app.
---
## Note Importanti
- **Sincronizzazione**: I messaggi inviati dall'app e quelli inviati dalle API saranno visibili su entrambe le piattaforme entro i limiti tecnici previsti da Meta.
- **Costi**: I messaggi iniziati tramite API (es. invio preventivi, template) seguono il listino prezzi di Meta. Le risposte manuali dall'app rimangono gratuite.
- **Limitazioni**: Alcune attività svolte dall'app possono non essere automatizzabili da Quoting24 e restano gestite direttamente dall'app WhatsApp Business.
---
## Limitazione importante: "Cold Chat" (Conversazioni spontanee)
È possibile avviare una nuova conversazione verso un cliente direttamente dall'App WhatsApp Business.
**Tuttavia, questa conversazione non potrà essere continuata su Quoting24.**
Il motivo è tecnico e riguarda le regole di Meta:
1. Un messaggio inviato manualmente dall'App **non apre la finestra di assistenza delle 24 ore** per le API (come invece farebbe un messaggio del cliente).
2. Non essendo un "Messaggio Template" a pagamento approvato da Meta, non crea una sessione valida per il software.
**Conseguenza**: Vedrai il messaggio su Quoting24 grazie alla sincronizzazione, ma **non potrai rispondere o inviare altri messaggi da Quoting24** all'interno di quella chat finché il cliente non risponderà al tuo messaggio.
Solo la risposta del cliente sblocca la conversazione e permette a Quoting24 di intervenire.
---
## Numero già in coesistenza con un altro fornitore
Se il numero è già in coesistenza presso un altro fornitore e va riportato su Quoting24, segui [Migrazione WhatsApp API](migrazione_whatsapp_api.md).
---
# Broadcast API
URL: https://wiki.quoting24.com/content/broadcast_api/
Language: it
Updated: 2026-11-04
# Broadcast API
La sezione **Broadcast** permette di creare e gestire **campagne di messaggistica broadcast** sui numeri collegati a Quoting24 tramite le **API ufficiali Meta** (WhatsApp Business Platform).
In pratica puoi **inviare lo stesso messaggio template a molti numeri WhatsApp**, caricando i destinatari da un file Excel, scegliendo data e ora di invio e monitorando lo stato di ogni messaggio.
> **Attenzione:** le Campagne Broadcast di Quoting24 **non** sono le “liste broadcast” dell’app WhatsApp.
> Funzionano solo con una connessione **WhatsApp Business / API Meta** in stato **connessa** e usano **template WhatsApp** già presenti in Quoting24 (sincronizzati / approvati da Meta).
---
## Requisiti
1. **Connessione WhatsApp Business attiva**
La voce di menu **Broadcast** compare solo se lo stato della connessione API Meta è **connected**.
Vedi [WhatsApp](whatsapp.md) e, se usi lo stesso numero anche dal telefono, [WhatsApp Coexistence](whatsapp_coexistence.md).
2. **Permessi**
Tutti i membri della stanza possono **vedere** le campagne.
Solo **owner** e **admin** possono **creare**, modificare o eliminare campagne e messaggi in coda.
3. **Template WhatsApp**
Serve almeno un template disponibile in Quoting24 (quelli selezionabili nel wizard).
Se il template ha un **header di tipo immagine, video o documento**, in creazione campagna è obbligatorio caricare il file media: Meta non riutilizza automaticamente l’anteprima del modello.
4. **File destinatari**
I destinatari si caricano da un **file XLSX** (non dalla rubrica Contatti). Massimo **1000** destinatari per campagna.
5. **Pagamento Meta**
I messaggi template seguono il listino Meta (categoria Marketing / Utility / Authentication, ecc.).
---
## Come aprire la sezione Broadcast
1. Apri il **menu** di Quoting24 (icona in alto a destra).
2. Seleziona **Broadcast**.
Si apre la pagina **Campagne Broadcast**, con sottotitolo *Gestisci le campagne di messaggistica broadcast WhatsApp.*
---
## Lista delle campagne
| Colonna | Descrizione |
| ------- | ----------- |
| **Nome** | Nome della campagna (cliccabile per il dettaglio) |
| **Programmazione** | Data e ora di invio programmate |
| **Progresso** | `inviati / totale (percentuale)` — la percentuale considera messaggi **inviati + falliti** sul totale |
| **Stato** | Stato della campagna (vedi sotto) |
In alto a destra: **+ Nuova campagna**.
Su ogni riga puoi eliminare la campagna o aprirne il dettaglio.
### Stati campagna
| Stato | Significato |
| ----- | ----------- |
| **Bozza** | Bozza (non usata dal flusso standard di creazione) |
| **Attiva** | Campagna creata e in coda / in attesa dell’orario programmato |
| **In invio** | Invio in corso |
| **Completata** | Tutti i messaggi sono stati elaborati (inviati o falliti) |
| **Fallita** | Campagna fallita |
| **Annullata** | Campagna fermata dall’utente: i messaggi non ancora inviati non vengono più spediti |
| **Archiviata** | Archiviazione automatica dopo circa 30 giorni |
---
## Creare una nuova campagna
Il wizard ha **tre passaggi**:
1. **Configurazione**
2. **Destinatari (XLS)**
3. **Anteprima e conferma**
### Passo 1 — Configurazione
Dalla lista clicca **+ Nuova campagna** e compila:
| Campo | Cosa inserire |
| ----- | ------------- |
| **Nome campagna** | Nome per riconoscerla in lista |
| **Template** | Template WhatsApp da inviare |
| **Immagine / video / documento header** | Comparte **solo** se il template selezionato lo richiede; in quel caso il file è obbligatorio |
| **Data** | Giorno di avvio invio |
| **Ora** | Orario di avvio invio |
Nella stessa schermata vedi l’**anteprima** del template (testo, footer, pulsanti e media se caricato).
Poi clicca **Avanti**.
#### Media in header (solo se il template lo permette)
Il campo per caricare un media in header **non è sempre presente**.
Compare **solo** dopo aver scelto un template il cui header Meta è di tipo:
- **immagine** → formati `JPG`, `JPEG`, `PNG`
- **video** → formato `MP4`
- **documento** → formato `PDF`
Se il template non prevede media in header, il campo non viene mostrato e puoi proseguire senza allegati.
Se invece il template lo richiede, senza file caricato non puoi andare avanti: Meta non riutilizza automaticamente l’anteprima del modello.
Nell’esempio sotto, selezionando un template con header immagine compare l’area **Immagine header** (clic o drag-and-drop).
### Passo 2 — Destinatari (XLS)
1. Clicca **Scarica template XLSX** per ottenere il file di esempio.
2. Compila il foglio con queste colonne:
| Colonna | Obbligatoria | Descrizione |
| ------- | ------------ | ----------- |
| `recipient_name` | No | Nome del destinatario (solo etichetta in Quoting24) |
| `recipient_address` | **Sì** | Numero WhatsApp (con o senza `+`; spazi e prefisso `00` vengono normalizzati in invio) |
| `var1`, `var2`, `var3`, … | Se il template ha variabili | Valori delle variabili del template, in ordine |
3. Carica il file compilato (**Carica file compilato**, formato `.xlsx`).
4. Quando compare almeno un destinatario valido, clicca **Avanti**.
Limite: **massimo 1000 destinatari** per campagna.
### Passo 3 — Anteprima e conferma
Controlla:
- anteprima del template
- elenco destinatari (puoi **modificare** o **eliminare** singole righe)
Poi clicca **Conferma e invia**.
La campagna viene creata nello stato **Attiva** e i messaggi entrano in coda con stato **In attesa**, programmati per la data/ora scelte. Verrai portato al **dettaglio campagna**.
---
## Dettaglio campagna e messaggi
Nel dettaglio vedi:
- stato e programmazione della campagna
- elenco di ogni messaggio con:
- nome e numero
- prossimo invio (se ancora in coda)
- stato messaggio
- tentativi (`retry / max`)
- eventuale errore
- anteprima del testo reso (con variabili sostituite)
### Stati messaggio
| Stato | Significato |
| ----- | ----------- |
| **In attesa** | In coda, non ancora inviato |
| **Programmato** | Programmato |
| **In invio** | Invio in corso verso Meta |
| **Inviato** | Inviato con successo |
| **Fallito** | Fallito dopo i tentativi previsti |
| **Annullato** | Annullato |
| **Archiviato** | Archiviato (messaggi vecchi) |
Se un invio fallisce, il sistema può **riprovarlo** automaticamente (fino a 10 tentativi, con attesa tra un tentativo e l’altro).
Puoi anche modificare o rimuovere dalla coda i messaggi non ancora inviati (solo owner/admin).
### Annullare una campagna
Finché lo stato è **Attiva** (o **Bozza**), puoi usare **Annulla campagna**.
I messaggi già spediti restano inviati; quelli ancora in coda **non vengono più spediti**.
---
## Come avviene l’invio
- L’invio parte **alla data/ora programmate** (o subito dopo, se l’orario è già passato).
- I messaggi vengono spediti **uno alla volta**, con una piccola pausa tra un invio e l’altro.
- Ogni messaggio è un **template WhatsApp** inviato via API Meta sulla connessione della stanza.
- Quando tutti i messaggi risultano **inviati** o **falliti**, la campagna passa a **Completata**.
---
## Note importanti
- **Solo API Meta:** la sezione è disponibile con il numero collegato tramite le API ufficiali WhatsApp Business.
- **Menu nascosto senza Business connesso:** se non vedi **Broadcast**, verifica che WhatsApp Business sia collegato e in stato connesso.
- **Non usa la rubrica Contatti:** i numeri arrivano dal file XLSX (o dalle modifiche fatte in anteprima).
- **Costi Meta:** ogni template recapitabile può generare un addebito secondo categoria e regole Meta. Vedi anche [WhatsApp Coexistence](whatsapp_coexistence.md) per i costi in caso di coesistenza.
- **Consenso e conformità:** per campagne marketing assicurati di avere il consenso dei destinatari e di rispettare le policy WhatsApp / Meta.
- **Invio 1:1 dal gestionale:** per mandare un messaggio a un singolo contatto da un software esterno usa [Scrivi su WhatsApp tramite le nostre API](invia_whatsapp_api.md). Quella integrazione non sostituisce le campagne Broadcast di massa.
---
## Riepilogo operativo
1. Collega il numero con **API Meta** (stato connesso).
2. Assicurati di essere **owner** o **admin**.
3. Prepara i **template** WhatsApp in Quoting24.
4. Apri **Broadcast** → **+ Nuova campagna**.
5. Configura nome, template, data/ora (e media header se richiesto).
6. Scarica il template XLSX, compilalo e caricalo.
7. Controlla l’anteprima e conferma.
8. Monitora progresso, stato campagna e dettaglio messaggi.
---
# Migrazione WhatsApp API
URL: https://wiki.quoting24.com/content/migrazione_whatsapp_api/
Language: it
Updated: 2026-11-04
# Migrazione WhatsApp API
Questa guida spiega come collegare a **Quoting24** un numero già attivo sulle **API ufficiali di WhatsApp** (WhatsApp Business Platform) presso un altro fornitore, **senza cambiare il numero**.
La sezione **WhatsApp** è visibile **solo agli amministratori**.
Il collegamento parte sempre dallo stesso punto in Quoting24: **Impostazioni → WhatsApp → WhatsApp Business → Connetti**. Il pulsante **Connetti** apre la registrazione integrata di Meta (Embedded Signup). Da lì Quoting24 diventa il fornitore che riceve e invia i messaggi di quel numero. La modalità prevista è il collegamento alle API ufficiali, descritto in [Panoramica WhatsApp](whatsapp.md).
---
## Quale procedura seguire
Meta ha due modi di collegare un numero già usato da un altro fornitore. Prima di cliccare **Connetti**, controlla il portfolio in **Meta Business Suite → Impostazioni → Account**.
| In Meta Business Suite vedi | Cosa fare |
| --- | --- |
| **Account WhatsApp** e **Account di messaggistica** (Messaging Accounts) separati | Modello attuale: **condividi** l’account WhatsApp con Quoting24. Il numero resta dov’è. |
| Solo **Account WhatsApp** | Modello precedente: **migra** il numero con un codice SMS o vocale. |
Sul modello attuale Meta rifiuta lo spostamento del numero da un account a un altro. Scollegarlo dal fornitore precedente non lo rende libero.
---
## Cosa preparare
- Accesso **amministratore** a Quoting24.
- Accesso **amministratore** al portfolio Meta (Business Manager) che possiede il numero, con l’utente Facebook che userai nella finestra di **Connetti**.
- Il numero già registrato sulle API ufficiali. I numeri di prova gratuiti assegnati da Meta non si possono migrare.
- Possibilità di ricevere un SMS o una chiamata vocale su quel numero, se Meta chiede un codice.
Per la migrazione del modello precedente servono anche:
- nome visualizzato **già approvato**, senza una richiesta di cambio nome ancora aperta;
- verifica in due passaggi (PIN) **disattivata** sul numero, senza cancellare il numero né chiudere l’account. Se non hai accesso all’account WhatsApp, la disattivazione va chiesta al fornitore attuale.
---
## Modello attuale: condividi il numero con Quoting24
Usa questa procedura se in Meta Business Suite compaiono sia **Account WhatsApp** sia **Account di messaggistica**.
Lascia il numero attivo sul fornitore attuale fino alla fine. Toglierlo prima, con messaggi dei clienti in arrivo, interrompe la ricezione.
1. In Quoting24 apri **Impostazioni → WhatsApp**.
2. Sulla riga **WhatsApp Business** clicca **Connetti** e accedi con l’amministratore del portfolio Meta.
3. Seleziona il numero già registrato presso l’altro fornitore. Meta lo mostra in elenco e non chiede un nuovo codice: il numero è già registrato.
4. Meta propone il portfolio e l’account WhatsApp di quel numero. Conferma la condivisione con Quoting24.
5. Inserisci il nome visualizzato del numero e prosegui. Meta può riesaminarlo dopo l’attivazione.
6. Controlla i permessi richiesti (account WhatsApp, account di messaggistica e risorse collegate) e conferma.
7. Chiudi la finestra Meta. In Quoting24 la riga **WhatsApp Business** risulta **connessa**.
Meta crea un account di messaggistica nuovo per Quoting24, sotto lo stesso account WhatsApp. Il fornitore precedente resta collegato finché non lo rimuovi.
### Far arrivare i messaggi su Quoting24
La condivisione da sola non sposta i messaggi in arrivo. Finché il fornitore precedente è ancora partner, Meta può continuare a consegnarli a lui.
Quando in Quoting24 la riga **WhatsApp Business** è connessa:
1. In **Meta Business Suite** apri **Impostazioni → Account → Account di messaggistica**, seleziona l’account, vai in **Partner** e rimuovi l’accesso dell’app del fornitore precedente.
2. Apri **Impostazioni → Account → Account WhatsApp**, seleziona l’account del numero, vai in **Partner** e rimuovi anche lì l’accesso dello stesso fornitore.
3. Nello stesso account WhatsApp apri **Routing delle conversazioni** (Conversation routing) e assegna a Quoting24 ogni tipo di conversazione.
In elenco partner può comparire il nome dell’app Meta collegata a Quoting24, non la scritta «Quoting24». Se non è chiaro quale accesso togliere, fermati e chiedi al supporto Quoting24 prima di rimuovere un partner.
Quando resta un solo partner, Meta disattiva il routing e consegna i messaggi a quel partner.
### Cosa resta su questo modello
Restano sul numero, perché l’account WhatsApp non cambia:
- numero di telefono
- nome visualizzato
- valutazione della qualità
- limiti di messaggistica
- stato di Official Business Account, se era già attivo
I **template** stanno sull’account di messaggistica, non sul numero. L’account creato per Quoting24 nasce vuoto: i template del fornitore precedente vanno **ricreati in Quoting24** e approvati di nuovo da Meta.
Finché non sono approvati:
- da Quoting24 puoi rispondere liberamente solo entro **24 ore** dall’ultimo messaggio del cliente;
- in [Broadcast API](broadcast_api.md) non ci sono modelli da selezionare.
Le chat salvate nel software precedente **non** entrano nei ticket di Quoting24. I messaggi che arrivano dopo la connessione diventano ticket. Le chat già presenti sul telefono del cliente restano sull’app WhatsApp del cliente.
---
## Modello precedente: migra il numero
Usa questa procedura solo se in Meta Business Suite compare **soltanto Account WhatsApp**.
### Disattiva la verifica in due passaggi
Chiedi al fornitore attuale di disattivare il PIN del numero, oppure fallo tu dal portfolio Meta se ne hai l’accesso.
Il numero e l’account devono restare attivi. Va tolta solo la verifica in due passaggi.
### Collega il numero da Quoting24
1. In Quoting24 apri **Impostazioni → WhatsApp**.
2. Sulla riga **WhatsApp Business** clicca **Connetti** e accedi come amministratore del portfolio Meta.
3. Scegli di **creare un nuovo account WhatsApp**. È il passaggio con cui Meta sposta il numero già esistente: non è un secondo numero.
4. Inserisci **lo stesso nome visualizzato** già approvato su quel numero.
5. Inserisci **lo stesso numero**. Meta avvisa che è già registrato su un account WhatsApp Business o presso un altro fornitore.
6. Chiedi il codice via **SMS** o **chiamata vocale** e inseriscilo.
7. Completa i passaggi rimasti nella finestra Meta.
Lo spostamento di solito si conclude in pochi minuti. In Quoting24 la riga **WhatsApp Business** passa a **connessa**. Durante il passaggio la ricezione può interrompersi per qualche minuto.
### Cosa resta e cosa va rifatto
Restano sul numero:
- nome visualizzato
- valutazione della qualità
- stato di Official Business Account
- limiti di messaggistica
Vanno rifatti in Quoting24:
- i **template**, da reinviare e far riapprovare da Meta, prima di scrivere fuori dalla finestra di 24 ore e prima di usare [Broadcast API](broadcast_api.md);
- le campagne del fornitore precedente;
- lo storico chat di quel software, che non viene importato. I messaggi nuovi arrivano come ticket.
---
## Numero già in coesistenza con un altro fornitore
Se lo stesso numero è usato **insieme** dall’app WhatsApp Business e dalle API presso un altro fornitore, il collegamento API non riallaccia da solo l’app sul telefono.
1. Fai un **backup delle chat** nell’app WhatsApp Business.
2. Registra lo stesso numero sull’app **WhatsApp personale**: il numero esce dall’app Business.
3. Registralo di nuovo sull’app **WhatsApp Business**.
4. In Quoting24 clicca **Connetti** su **WhatsApp Business** e completa la coesistenza descritta in [WhatsApp Coexistence](whatsapp_coexistence.md): sull’app, **Impostazioni → Dispositivi collegati → Collega un dispositivo**, poi scansiona il QR mostrato da Quoting24.
Per portare il numero sulle sole API, senza app sul telefono, usa la procedura del modello Meta verificato sopra.
---
## Dopo il collegamento
- I messaggi nuovi del numero diventano **ticket** in Quoting24.
- Fuori dalle 24 ore dall’ultimo messaggio del cliente si scrive con un **template approvato**. Le regole del canale ufficiale sono in [Panoramica WhatsApp](whatsapp.md).
- Le campagne si creano in [Broadcast API](broadcast_api.md) quando i template sono disponibili in Quoting24.
- Per usare anche l’app WhatsApp Business sullo stesso numero serve [WhatsApp Coexistence](whatsapp_coexistence.md).
- Gruppi e liste broadcast dell’app non passano sulle API.
---
## Se la procedura si ferma
- **Meta rifiuta lo spostamento del numero.** Il portfolio è sul modello attuale: torna alla condivisione e lascia il numero registrato sul fornitore precedente finché Quoting24 non risulta connesso.
- **Il codice SMS o vocale non arriva.** Sul modello precedente la verifica in due passaggi è ancora attiva. Falla disattivare e ripeti **Connetti**.
- **Il nome visualizzato blocca la migrazione precedente.** Meta accetta il passaggio solo con nome approvato e senza un cambio nome in sospeso.
- **Quoting24 è connesso ma i messaggi non arrivano.** Sul modello attuale il routing punta ancora al fornitore precedente. Controlla **Partner** e **Routing delle conversazioni** prima di scollegare il numero.
- Se il partner da rimuovere non è riconoscibile, contatta il supporto Quoting24 con il numero e l’ID del portfolio Meta.
---
# Panoramica Widget
URL: https://wiki.quoting24.com/content/widget/
Language: it
Updated: 2026-11-04
# Canale Widget — Panoramica
Il **Canale Widget** riceve richieste di assistenza e preventivo dal **sito web**. I visitatori aprono una chat sul sito; i messaggi arrivano in Quoting24 come ticket e gli operatori rispondono dall’interfaccia abituale, con la stessa logica già usata per gli altri canali.
L’interfaccia è in un **iframe**. Nel sito ospitante bastano uno script e, quando i dati sono già noti, una chiamata a `init()`. Non servono Angular, un client Supabase o accesso diretto al database di Quoting24.
---
## Quale integrazione serve
Associare un’azienda e recuperare la cronologia sono operazioni distinte. `external_id`, `company_name`, `name`, `phone` e `email` non autorizzano l’accesso alle conversazioni di un’altra persona. Un utente già autenticato nel sito resta un ospite del widget finché il sito non passa una credenziale di ripristino valida.
| Caso | Cosa implementare | Continuità | Sezione |
| --- | --- | --- | --- |
| Sito pubblico, visitatore sconosciuto | Solo lo script. Il visitatore compila il modulo di contatto. | Sessione ospite nello stesso browser | [Widget B2C](widget_b2c.md) |
| Sito che conosce già profilo e azienda | Script e `init()` con il profilo e i dati dell’azienda | Sessione ospite precompilata e associazione aziendale | [Widget B2C](widget_b2c.md#inviare-il-profilo-del-cliente) |
| Portale con cronologia personale tra dispositivi | Anche un’integrazione backend per `external_user_id` e `restore_id` | Cronologia personale nel canale widget autorizzato | [Widget B2B](widget_b2b.md) |
| Contratto dei campi, CSP, login/logout, provisioning | Guida per sviluppatori | — | [Integrazione tecnica](widget_tecnico.md) |
---
## Cosa fa il widget
- Mostra un **pulsante flottante** oppure una chat **incorporata** in pagina
- Per un nuovo visitatore apre il modulo con le etichette Telefono e Nome. In `init()` i campi si chiamano `phone` e `name`; l’email, se il sito la conosce, si chiama `email`
- Se il sito chiama `init()`, usa i dati già disponibili e può collegare il contatto a un’azienda tramite `external_id` (`web_code`). Se l’azienda manca e arriva anche `company_name`, può crearla
- Apre una conversazione gestita in Quoting24 come gli altri canali
- Accetta allegati PDF, DOC/DOCX, JPG/JPEG e PNG, fino a 10 MiB per file e 100 MiB di allegati referenziati per conversazione
- Mostra saluto, benvenuto e, fuori orario, il banner configurato. La composizione dei messaggi resta disponibile
Il loader conserva la credenziale ospite nel `localStorage` del sito, separata per chiave widget. Se lo storage è bloccato, la continuità può limitarsi alla pagina corrente. La sessione ospite permette di rileggere la conversazione più recente anche dopo la chiusura, nello stesso browser. Su un altro dispositivo serve il [ripristino autenticato](widget_b2b.md).
---
## Dove si configura in Quoting24
1. Apri **Impostazioni → Canali**
2. Seleziona il canale di tipo **Widget**
3. Apri la configurazione
Da lì si impostano:
- logo, colore principale, posizione del pulsante
- messaggio di saluto, messaggio di benvenuto, messaggio fuori orario
- **domini consentiti**
- **codice di incorporamento** (URL completo dello script e chiave pubblica del widget)
Gli orari del canale determinano il banner fuori orario.
Chiedi all’amministratore il codice di incorporamento e i domini autorizzati, compresi collaudo e sviluppo locale. Usa URL e chiave dello stesso ambiente. Negli esempi, `HOST_WIDGET` e `CHIAVE_PUBBLICA_WIDGET` vanno sostituiti con i valori ricevuti.
I domini autorizzati sono nomi host, per esempio `shop.example.com` o `localhost`, senza `https://`, porta, percorso o prefisso `*.`. `example.com` autorizza anche i suoi sottodomini. Una lista vuota non applica restrizioni di dominio. Per il collaudo locale servi la pagina via HTTP: aprirla come file non basta.
Logo, colore, posizione e messaggi si configurano in Quoting24. Il `company_name` passato a `init()` è la ragione sociale del cliente, non il titolo del widget. Non esiste un parametro pubblico `language` o `locale`: l’interfaccia attuale è in italiano.
---
## Due modi di mostrarlo sul sito
### Pulsante flottante
Lo script aggiunge il pulsante dopo il caricamento delle impostazioni grafiche. Al click si apre la chat. Su mobile la chat flottante si espande fino a occupare il viewport.
Vedi [Widget B2C](widget_b2c.md).
### Chat incorporata
La chat occupa un contenitore della pagina, con altezza esplicita. Non c’è pulsante flottante: layout e titolo li fornisce il sito. In questa modalità `open()`, `close()` e `toggle()` non hanno effetto. Il sito controlla altezza e larghezza del contenitore.
Vedi [Widget B2C](widget_b2c.md#incorporare-la-chat-in-pagina).
Una sola istanza per pagina: il loader espone un unico `window.Quoting24Widget`. Un secondo script non crea un secondo widget.
---
## Chiave pubblica e segreti {#chiave-pubblica-e-segreti}
| Valore | Dove sta | A cosa serve |
| --- | --- | --- |
| Chiave pubblica del widget | URL dello script | Seleziona il canale. È pubblica: non è una credenziale personale né un segreto di integrazione backend |
| Segreto privato dell’integrazione | Solo nel backend del sito | Autorizza la creazione e il riutilizzo di `restore_id` |
| `restore_id` | Archivio privato per utente, nel backend | Credenziale con cui ripristinare la cronologia di quella persona su quel widget |
| Credenziale sessione ospite | `localStorage` del sito, gestita dal loader | Continuità ospite nello stesso browser, per chiave widget |
---
## Flusso per l’operatore
1. Il visitatore apre la chat sul sito e invia un messaggio
2. In Quoting24 nasce o continua un **ticket** sul canale Widget
3. Se l’inizializzazione ha risolto un `external_id`, il contatto risulta collegato all’azienda con quel `web_code`. Un’azienda appena creata dal widget ha ragione sociale e, se inviata, email; un’azienda già presente non viene rinominata da `init()`
4. L’operatore gestisce la richiesta e risponde dalla chat
5. Il cliente vede le risposte nel widget
I messaggi del widget si eliminano solo **per tutti**.
Il dato arriva dal browser e il visitatore può modificarlo. Il collegamento all’azienda non dimostra identità e non apre la cronologia degli altri contatti di quell’azienda.
---
## Da dove iniziare
1. Configura aspetto, orari e domini in **Impostazioni → Canali → Widget**
2. Sito pubblico o portale che precompila il profilo: [Widget B2C](widget_b2c.md)
3. Cronologia della stessa persona su un altro browser: [Widget B2B](widget_b2b.md)
4. Campi, creazione azienda, CSP e checklist: [Integrazione tecnica](widget_tecnico.md)
---
# Widget B2C
URL: https://wiki.quoting24.com/content/widget_b2c/
Language: it
Updated: 2026-11-04
# Widget B2C — visitatore ospite e azienda
Questa sezione copre le integrazioni in cui il widget resta in **sessione ospite**:
- sito pubblico, visitatore sconosciuto: solo lo script e il modulo di contatto
- sito o portale che conosce già l’account: `init()` con profilo e dati azienda, modulo saltato quando i dati bastano, contatto collegato all’azienda
La cronologia personale su un altro browser o dispositivo è un’altra integrazione. Vedi [Widget B2B](widget_b2b.md). Contratto completo dei campi, cambio account in una SPA, CSP e provisioning: [Integrazione tecnica](widget_tecnico.md).
**Associare un’azienda non autorizza la cronologia di un’altra persona.** Anche un utente autenticato nel sito resta un ospite del widget finché non invii `external_user_id` insieme a un `restore_id` valido.
---
## Cosa ottieni
- Pulsante flottante, oppure chat incorporata in un contenitore della pagina
- Modulo iniziale per chi è sconosciuto: etichette Telefono e Nome. In `init()` i campi sono `phone` e `name`
- Sessione ospite salvata dal loader nello stesso browser, separata per chiave widget. Se il `localStorage` è bloccato, la continuità può restare sulla pagina corrente
- Se invii `external_id`, Quoting24 cerca un’azienda con lo stesso `web_code`. Con anche `company_name`, può creare l’azienda mancante e collegarvi il contatto
- Ticket e risposte in Quoting24, come sugli altri canali
La sessione ospite rilegge la propria conversazione più recente anche dopo la chiusura della scheda. Non segue la persona su un altro browser.
---
## 1. Prerequisiti in Quoting24
1. Canale **Widget** attivo in **Impostazioni → Canali**
2. Logo, colore, posizione, saluto, benvenuto e fuori orario configurati
3. **Domini consentiti** aggiornati, compresi collaudo e `localhost`
4. Codice embed copiato dalla configurazione del canale: URL dello script e chiave pubblica
Usa host e chiave dello **stesso ambiente**. Negli esempi sostituisci `HOST_WIDGET` e `CHIAVE_PUBBLICA_WIDGET`.
I domini sono nomi host, senza `https://`, porta, percorso o `*.`. `example.com` include i sottodomini. Lista vuota: nessuna restrizione. In locale servi la pagina via HTTP, non come `file://`.
Il `company_name` di `init()` è la ragione sociale del cliente. Non è il titolo del widget e non si configura da questo payload.
---
## 2. Installare il pulsante flottante
Incolla lo script **una sola volta**, prima di ``:
```html