---
title: Bot AI
description: Gli assistenti AI di Audin — voce, messaggistica, coach, suggester e analizzatore. Creare un bot, scegliere il modello, e il percorso completo per portare online un bot vocale che risponde alle chiamate.
---

I **Bot AI** sono gli assistenti conversazionali di Audin: rispondono alle
chiamate e le effettuano, gestiscono WhatsApp e SMS, chattano sul widget
del sito, affiancano gli operatori in chiamata e analizzano le
conversazioni. Ogni bot ha un **prompt** (le istruzioni), dei **tool** (le
azioni che può compiere) e una **knowledge base** (i contenuti da cui
attinge).

La sezione è in **Automazione → Bot** (`app.audin.ai`); servono i permessi
sugli Assistenti AI.

## I cinque tipi di bot

Ogni bot ha **un** tipo, scelto alla creazione:

| Tipo | A cosa serve |
|---|---|
| **Voice Agent** | Chiamate vocali AI, in entrata e in uscita |
| **Messaging Agent** | Conversazioni WhatsApp e SMS (e chat del widget) |
| **Coach** | Assistente di coaching per gli operatori durante la chiamata |
| **Suggester** | Assistente informativo per gli operatori durante la chiamata |
| **Analizzatore** | Analizza automaticamente le chiamate concluse |

Un bot voce non risponde su WhatsApp e viceversa. Per riusare una
configurazione su un altro canale, dalla pagina del bot c'è **"Crea da
questo bot"** (duplica nello stesso tipo, o crea la variante Voice /
Messaging).

## Creare un bot

<Steps>
<Step>
**Bot → Nuovo Bot.** Scegli il **Tipo Assistente**, dai un **Nome** (a uso
interno, opzionale) e il **Ruolo Bot** (obbligatorio: Support, Commerciale,
Reception, Assistente, Vendite, Customer Service).
</Step>
<Step>
**Voce e tono.** Per i bot voce: **Preferenza Voce** (Maschile /
Femminile) e **Tono Conversazione** (Professionale, Amichevole, Formale,
Informale, Entusiasta). Per messaging/coach/suggester c'è il solo Tono.
</Step>
<Step>
**Modello AI.** Tre livelli: **Lite** (consigliata — veloce ed economica,
adatta alla maggior parte delle conversazioni), **Full** (massima qualità e
robustezza: ragionamento più sofisticato, da preferire per casi d'uso ad
alta criticità) e **Quality** (beta — voce sintetica più naturale e
trascrizione più precisa, con latenza leggermente superiore).
</Step>
<Step>
**Opzioni e crea.** Le tre spunte: **Bot attivo**, **Bot predefinito**
(risponde alle chiamate quando nessun workflow indica un bot specifico) e
**"Saluta per primo all'apertura della chiamata/chat"**. Puoi anche
collegare il bot a un'azienda o a un contatto specifico. → **Crea Bot**.
</Step>
</Steps>

## La pagina del bot

La pagina di dettaglio mostra a sinistra l'identità (stato, ruolo, tipo,
contatori di chiamate e conversazioni) e al centro **sette tab**:

- **Prompt** — le istruzioni ([guida](/docs/bot/prompt));
- **Tool AI** — le azioni collegabili ([guida](/docs/bot/tool));
- **Knowledge Base** — i contenuti ([guida](/docs/bot/knowledge-base));
- **Test Bot** — la prova in chat testuale o vocale
  ([guida](/docs/bot/canali-e-test));
- **Chiamate**, **Conversazioni**, **Statistiche** — lo storico e i numeri.

Eliminando un bot, chiamate e conversazioni restano nello storico (solo
scollegate dal bot).

## Percorso completo: bot voce che risponde alle chiamate

<Steps>
<Step>
**Crea il bot** di tipo Voice Agent (vedi sopra), modello **Lite**.
</Step>
<Step>
**Scrivi il prompt** — tab Prompt, col wizard guidato o a mano
([guida](/docs/bot/prompt)). Qui si decide anche la **lingua** del bot.
</Step>
<Step>
**Collega i tool** — tab Tool AI: per un inbound tipico, **Ricerca
Knowledge Base**, **Dati Lead** e **Storico Lead**, i quattro tool di
**appuntamenti** (disponibilità, prenota, annulla, riprogramma),
**Inoltro a Operatore** (o **Trasferimento Chiamata** verso numeri
esterni) e **Termina Chiamata** ([guida](/docs/bot/tool)).
</Step>
<Step>
**Carica la knowledge base** — tab Knowledge Base: documenti, note, pagine
web ([guida](/docs/bot/knowledge-base)). Ricorda: senza il tool "Ricerca
Knowledge Base" collegato, i file non vengono mai interrogati.
</Step>
<Step>
**Provalo** — tab **Test Bot → Chat Vocale**: parli col bot come al
telefono, e in modalità Full Screen correggi il prompt e ritesti al volo.
</Step>
<Step>
**Collegalo al numero** — dalla pagina del numero (Impostazioni → Numeri),
tab Workflows: un workflow con trigger "Chiamata in Arrivo" e step
**"Rispondi con Bot Specifico"**. In alternativa, marca il bot come **Bot
predefinito**: risponde lui quando nessun workflow indica altro
([dettagli](/docs/bot/canali-e-test)).
</Step>
</Steps>

## Prossimi passi

<Cards>
  <Card
    href="/docs/bot/prompt"
    title="Prompt"
    description="Struttura delle istruzioni, wizard guidato, assistente AI e cronologia versioni."
  />
  <Card
    href="/docs/bot/tool"
    title="Tool"
    description="Il catalogo completo delle azioni che un bot può compiere."
  />
  <Card
    href="/docs/bot/knowledge-base"
    title="Knowledge Base"
    description="Documenti, note e pagine web da cui il bot attinge le risposte."
  />
  <Card
    href="/docs/bot/canali-e-test"
    title="Canali e test"
    description="Provare il bot e collegarlo a numeri, campagne, WhatsApp e widget."
  />
</Cards>
