# Risposte arricchite: tabelle, schede e risposte rapide in chat

> Fai rispondere l'agente con una tabella per confrontare opzioni, una fila di schede tra cui scegliere o pulsanti di risposta rapida per il passo successivo, insieme al suo testo. Scopri quando li usa, i limiti, come appaiono nel widget e dove altro compaiono.

Con **Rich replies** attivo, l'agente può mostrare contenuti strutturati dentro la chat, sotto il suo testo:

- una **tabella**, per confrontare più cose sugli stessi punti, come piani, prodotti o orari di apertura;
- **schede**, una fila di opzioni tra cui scegliere, ognuna con un titolo e, se serve, un'immagine, un prezzo e dei pulsanti;
- **risposte rapide**, pulsanti brevi per passi successivi chiari. Toccandone uno, il suo testo viene inviato come messaggio del visitatore.

L'agente scrive sempre anche una risposta di testo. Le risposte arricchite stanno sotto di essa, come le [schede prodotto](/it/docs/connect-your-store) e gli [orari di prenotazione](/it/docs/booking).

## Attivarle o disattivarle

Apri il tuo agente, seleziona la scheda **Appearance** e trova l'interruttore **Rich replies**, accanto a **Suggest follow-up questions** e **Show sources under replies**. È attivo di default per ogni agente. Fai clic su **Save changes** per applicare una modifica.

Il **Playground** usa l'interruttore così come è sullo schermo, quindi puoi provarlo prima di salvare.

Disattivandolo, non vengono più mostrate nuove risposte arricchite. Le risposte che ne hanno già mostrata una la mantengono nella conversazione.

## Quando l'agente le usa

L'agente decide per ogni risposta. Gli viene detto di usare le risposte arricchite solo quando aiutano:

| Situazione | Che cosa mostra |
|---|---|
| Un confronto tra più elementi sugli stessi punti | Una tabella |
| Più opzioni tra cui il visitatore può scegliere | Schede |
| Passi successivi chiari tra cui il visitatore sceglierebbe | Risposte rapide |

Gli viene detto di non usarle per un singolo dato, un sì o un no, due chiacchiere o una risposta di un solo paragrafo breve, e di riempirle solo con fatti presi dalla tua conoscenza, dalla conversazione o dai risultati delle tue [azioni](/it/docs/api-actions), mai con prodotti, prezzi, link o immagini inventati. Come per qualsiasi risposta dell'IA, controlla le risposte importanti nel **Playground** e usa le tue [istruzioni](/it/docs/instructions) per guidarlo, per esempio "Mostra i nostri piani in una tabella quando qualcuno chiede dei prezzi."

Una risposta arricchita fa parte della stessa risposta, quindi non usa un messaggio in più, e attivare l'interruttore non cambia il modo in cui la risposta viene trasmessa in streaming. La risposta arricchita compare quando il testo è completo. Un visitatore che tocca una risposta rapida o il pulsante di risposta di una scheda invia un messaggio, che conta come uno scritto a mano.

## Limiti e regole di sicurezza

Una risposta mostra al massimo una tabella, una fila di schede e un gruppo di risposte rapide.

| Tipo | Limiti |
|---|---|
| Tabella | Da 1 a 8 colonne e da 1 a 20 righe. Ogni cella è testo semplice fino a 200 caratteri, le intestazioni di colonna fino a 60, una didascalia facoltativa fino a 100. Ogni riga ha una cella per colonna. |
| Schede | Da 1 a 10 schede. Ognuna ha un titolo fino a 80 caratteri e, facoltativamente, un sottotitolo fino a 200, un'immagine, un prezzo scritto come testo fino a 40 (come "CHF 49" o "from $9/month") e fino a 2 pulsanti. Un pulsante apre un link oppure invia una risposta fino a 120 caratteri come messaggio del visitatore. Le etichette dei pulsanti arrivano fino a 40 caratteri. |
| Risposte rapide | Da 1 a 6 pulsanti, fino a 40 caratteri ciascuno. I doppioni vengono mostrati una sola volta. |

intoCHAT controlla ogni risposta arricchita prima di mostrarla:

- Tutto è testo semplice. L'HTML viene rifiutato, e i segni Markdown come `**` vengono rimossi.
- Link e immagini devono essere indirizzi `https://` completi. I link `http://`, `javascript:` e `data:`, gli indirizzi con nome utente o password e gli indirizzi senza dominio come `localhost` vengono rifiutati.
- Le risposte rapide e i pulsanti di risposta non possono contenere un link, perché il loro testo viene inviato come messaggio del visitatore.

Una tabella, una fila di schede o un gruppo di risposte rapide che viola una regola non viene mostrato affatto, mai in parte. La risposta di testo e le altre risposte arricchite valide compaiono comunque. Quando il tuo agente ha anche [azioni](/it/docs/api-actions), [moduli in chat](/it/docs/chat-forms) o altri strumenti, gli viene detto che cosa non andava e può correggerlo nella stessa risposta.

## Come appaiono nel widget

- Le risposte arricchite compaiono sotto il messaggio dell'agente, allineate a esso, nel tema chiaro o scuro del tuo widget. I pulsanti di link e di risposta sulle schede usano il colore di **Launcher bubble**.
- Su uno schermo stretto, una tabella scorre di lato. Più schede formano una fila che scorre di lato, con le frecce per chi usa il mouse. Una scheda singola viene mostrata a tutta larghezza.
- Le risposte rapide compaiono solo sotto l'ultima risposta e spariscono quando il visitatore invia un messaggio. Mentre sono mostrate le risposte rapide, le [domande di approfondimento](/it/docs/appearance#domande-di-approfondimento) non lo sono, così le due non si fanno concorrenza.
- I link delle schede si aprono in una nuova scheda del browser. Con **Keep campaign tags on links** attivo (vedi [Aspetto](/it/docs/appearance)), portano con sé i tuoi tag di campagna come gli altri link nelle risposte.
- Tutto funziona con la tastiera: pulsanti e link si raggiungono con Tab, e la tabella e la fila di schede possono ricevere il focus e scorrere con i tasti freccia. Gli screen reader annunciano la didascalia della tabella, il numero di schede e il gruppo di risposte rapide.

Le etichette del widget stesso, come "More", "Previous", "Quick replies" e la nota che un link si apre in una nuova scheda, seguono la [lingua del widget](/it/docs/appearance#lingua-del-widget); in italiano sono "Altro", "Precedente", "Risposte rapide" e "si apre in una nuova scheda". Il testo dentro una risposta arricchita è scritto dall'agente, nella lingua della sua risposta.

## Dove altro compaiono le risposte arricchite

| Dove | Che cosa vedi |
|---|---|
| Scheda **Conversations** e **Playground** | La risposta arricchita come l'ha vista il visitatore. Nella scheda **Conversations** i suoi pulsanti non inviano nulla. |
| [Casella Live chat](/it/docs/live-chat), [email di passaggio](/it/docs/handoff), [ticket helpdesk](/it/docs/helpdesk-tickets) ed [esportazione CSV](/it/docs/conversations-and-dashboard) | Una versione testuale: una tabella come righe di celle separate da `\|`, le schede come `• Title — subtitle — price` con i loro link, le risposte rapide come `[Yes] [No]`. |
| Conversazioni su [Slack](/it/docs/slack-agent) e via [email](/it/docs/email-agent) | Non proposte: lì l'agente scrive testo semplice. |
| [REST API](/it/docs/rest-api) e [server MCP](/it/docs/mcp-server) | Un campo `ui`, descritto sotto. |

## Nell'API

[Inviare un messaggio](/it/docs/rest-api#inviare-un-messaggio) (senza streaming) e [Leggere una conversazione](/it/docs/rest-api#leggere-una-conversazione) aggiungono un campo `ui` a una risposta dell'agente che ha mostrato una risposta arricchita. Una risposta senza non ha il campo `ui`. Gli strumenti MCP `chat_with_agent` e `get_conversation` restituiscono lo stesso. `content` e `reply` restano testo semplice senza la risposta arricchita.

```json
{
  "id": "MESSAGE_ID",
  "role": "assistant",
  "content": "Here are our two plans.",
  "createdAt": "2026-10-27T10:00:00.000Z",
  "authorName": null,
  "sources": [],
  "ui": [
    {
      "type": "table",
      "title": "Plans",
      "columns": ["Plan", "Price", "Seats"],
      "rows": [["Basic", "CHF 9", "1"], ["Pro", "CHF 29", "5"]]
    },
    {
      "type": "cards",
      "cards": [
        {
          "title": "Pro",
          "subtitle": "For growing teams",
          "image": "https://www.example.com/pro.png",
          "price": "CHF 29 / month",
          "buttons": [
            { "label": "See details", "url": "https://www.example.com/pricing" },
            { "label": "Start a trial", "reply": "I'd like to start a Pro trial" }
          ]
        }
      ]
    },
    { "type": "quick_replies", "replies": ["Compare features", "Talk to sales"] }
  ]
}
```

Ogni elemento ha un `type`: `table` (con `columns`, `rows` e un `title` facoltativo), `cards` (ogni scheda con `title`, `subtitle`, `image` e `price` facoltativi, e `buttons` con una `label` e un `url` oppure una `reply`) oppure `quick_replies` (con `replies`). I campi facoltativi vengono omessi quando sono vuoti.

## Passi successivi

- [Personalizza l'aspetto del widget](/it/docs/appearance)
- [Collega il negozio](/it/docs/connect-your-store) per avere schede prodotto da ricerche in tempo reale
- [Scrivi istruzioni](/it/docs/instructions) che dicano all'agente quando fare un confronto in una tabella