
# TheFork

> **A chi è rivolto?** Questa integrazione è pensata per i ristoranti che gestiscono le prenotazioni tramite TheFork (TheFork Manager). Se non utilizzi TheFork, puoi ignorare questa pagina.
>
> Utilizzi un sistema di prenotazione diverso? Qualsiasi strumento dotato di API può essere collegato: consulta [Collegare uno strumento non presente nel nostro elenco](connecting-other-tools.md), che tratta le funzioni personalizzate, le API e i webhook.

> **Availability.** The TheFork connection is built, but it is not switched on yet. It runs on TheFork's partner API, and TheFork issues those partner credentials only after approving a partnership, so the TheFork card stays hidden until that approval comes through. There is no date to give you yet — if you run your reservations in TheFork and want to know the moment it opens up, send us a note via [email support](mailto:hi@dmchamp.com).

TheFork è la piattaforma di prenotazione dietro thefork.com, utilizzata dai ristoranti in Francia, Spagna, Italia e altri mercati europei per le prenotazioni online e la gestione dei tavoli. Collegare TheFork a <span data-t="appName">DM Champ</span> permette al tuo Agente AI di verificare la disponibilità in tempo reale, prenotare un tavolo, modificare o cancellare una prenotazione per un cliente, direttamente all'interno della chat di WhatsApp, SMS, Instagram o del sito web che il cliente sta già utilizzando.

---

## Cosa può fare l'IA con TheFork

Una volta collegato e selezionato come fornitore di prenotazioni su un Agente AI, l'Agente può:

- **Verificare gli orari prenotabili** per una data e un numero di persone in base alla disponibilità in tempo reale del ristorante su TheFork, e consultare un intervallo di date per indicare al cliente quali giorni hanno ancora tavoli disponibili.
- **Segnalare il costo di un orario prima della prenotazione.** Se uno slot richiede una garanzia con carta di credito, o è prenotabile solo insieme a un'offerta specifica o a un menu fisso, l'Agente lo comunicherà invece di prenotare qualcos'altro senza avvisare.
- **Prenotare il tavolo** con il nome del cliente, l'email, il numero di persone, la data, l'ora ed eventuali richieste speciali indicate.
- **Trovare le prenotazioni imminenti del cliente** per poterle citare o gestire. Su WhatsApp e SMS le cerca tramite il numero di telefono da cui avviene la conversazione; su altri canali, è a conoscenza solo delle prenotazioni effettuate all'interno della stessa chat.
- **Modificare** la data, l'ora o il numero di persone di una prenotazione.
- **Cancellare** una prenotazione.

Il tuo team vedrà ognuna di queste prenotazioni in TheFork Manager come qualsiasi altra, elencata con **TheFork Manager API** come canale di provenienza.

### Buono a sapersi

- **Alcune prenotazioni vengono ricevute "su richiesta".** Il ristorante le conferma in un secondo momento invece di bloccare subito il tavolo, e l'Agente lo comunicherà chiaramente al cliente invece di promettere un tavolo confermato.
- **Gli orari che richiedono un deposito o una pre-autorizzazione su carta non possono essere prenotati in chat.** L'Agente spiegherà il motivo e indirizzerà il cliente verso di te o sulla tua pagina TheFork per completare l'operazione.
- **Solo prenotazioni, non il menu.** Consulta [Domande sul menu](#menu-questions) qui sotto.

---

## Dove appaiono le prenotazioni

Ogni prenotazione effettuata dall'Agente appare anche nella tua pagina **Appuntamenti** con un badge THEFORK, così potrai vederla accanto alle altre prenotazioni.

TheFork rimane il sistema di riferimento per il cliente: TheFork invia la propria email di conferma, quindi <span data-t="appName">DM Champ</span> non ne invia una seconda e queste prenotazioni non vengono copiate su Google Calendar. Il calendario del tuo ristorante è TheFork Manager.

---

## Collegare TheFork

> **Prima di iniziare:** il tuo ristorante deve avere il partner <span data-t="appName">DM Champ</span> abilitato sul proprio account TheFork. Questa è un'operazione che TheFork attiva per il ristorante; chiedi al tuo account manager di TheFork o all'assistenza TheFork. Finché non sarà completata, TheFork non ci permetterà di raggiungere il ristorante e il passaggio relativo all'ID Ristorante qui sotto si interromperà con un messaggio di errore.

1. Nella barra laterale sinistra, clicca su **Impostazioni** (icona dell'ingranaggio).
2. Nella barra laterale delle Impostazioni, sotto il gruppo **Integrazioni**, clicca su **Prenotazioni e Calendario**.
3. Trova la scheda **TheFork** e clicca su **Aggiungi ristorante**.
4. Incolla il tuo **ID Ristorante** e clicca su **Verifica**. Si tratta del lungo identificativo che TheFork assegna al tuo ristorante (un UUID, una stringa di lettere, numeri e trattini); lo troverai in TheFork Manager, oppure puoi richiederlo all'assistenza TheFork. Verificheremo che il ristorante sia raggiungibile prima di procedere.
5. Assegna al ristorante un **nome** (questo è ciò che vedrai nell'elenco e come l'IA lo chiamerà), quindi salva.

Puoi aggiungere diversi ristoranti in questo modo, uno per ogni ID Ristorante TheFork: clicca su **Aggiungi ristorante** sulla riga di TheFork collegata per ciascuno di essi. L'IA effettuerà le prenotazioni presso quello attivo; metti in pausa gli altri.

### Mettere in pausa o rimuovere un ristorante

Ogni ristorante connesso ha i propri pulsanti **Pausa** e **Rimuovi** nella pagina Prenotazioni e Calendario. Mettere in pausa impedisce all'IA di accettare prenotazioni per quel ristorante pur mantenendo la configurazione; la rimozione lo elimina completamente, anche se puoi riaggiungerlo in qualsiasi momento con lo stesso ID.

---

## Dire al tuo Agente AI di prenotare con TheFork

1. Fai clic su **Agenti AI** nella barra laterale e apri l'Agente.
2. Vai al passaggio **Abilità AI** e trova la scheda **Prenotazioni**.
3. Attiva **Consenti a questo agente di prenotare appuntamenti**.
4. Fai clic sul selettore del provider, scegli **TheFork** e seleziona per quale dei tuoi ristoranti collegati questo Agente deve prenotare.

Non è necessario alcun tipo di evento: TheFork fornisce autonomamente disponibilità, orari di apertura e piano dei tavoli.

---

## Come si svolge una conversazione di prenotazione

1. L'ospite chiede un tavolo. L'Agente richiede la data, il numero di ospiti e un orario preferito, se ne hanno uno.
2. L'Agente controlla TheFork e comunica all'ospite cosa è prenotabile. Se non c'è nulla di disponibile in quel giorno, può indicare quali giorni vicini hanno ancora tavoli liberi. Se l'orario desiderato richiede una garanzia con carta di credito, o appartiene a un'offerta particolare o a un menu fisso, l'Agente lo comunica prima di prenotare.
3. L'ospite sceglie un orario e fornisce nome ed email. L'Agente prenota il tavolo e lo conferma, oppure spiega che il ristorante deve ancora confermarlo quando TheFork restituisce la prenotazione come richiesta.
4. In seguito, l'ospite può chiedere allo stesso Agente di cambiare giorno, orario o numero di persone, oppure di annullare.

Gli orari sono sempre quelli locali del ristorante.

---

## Domande sul menu

La connessione a TheFork copre le prenotazioni; non legge il tuo menu. Per consentire all'IA di rispondere alle domande sul menu:

- **Aggiungi il menu alla knowledge base:** inserisci i tuoi piatti, i prezzi, le note sugli allergeni e i piatti del giorno nelle FAQ o nelle fonti di conoscenza del tuo Agente IA, e il bot risponderà a "Quali opzioni vegetariane avete?" da lì — vedi [Gestione delle FAQ](../ai-automation/faq-management.md).
- **Invia il menu come file:** carica il PDF o l'immagine del menu nella libreria multimediale con una nota su "quando inviare", e il bot lo invierà quando un ospite chiederà il menu o il listino prezzi.

---

## Suggerimenti per i ristoranti

- **Inserisci il tuo numero di telefono e il sito web** nel tuo account e nel ristorante, in modo che quando l'IA deve passare la palla a un ospite (uno slot che richiede un deposito, una modifica che il ristorante deve effettuare), fornisca loro un modo reale per raggiungerti.
- **Aggiungi FAQ operative** alla base di conoscenza del tuo Agente AI: orari, parcheggio, cene private, politiche sugli allergeni, codice di abbigliamento — vedi [Gestione delle FAQ](../ai-automation/faq-management.md).
- **Usa i tag** per segmentare la tua lista ospiti — ad esempio "amante del vino", "festa di compleanno", "gruppo numeroso" — e invia comunicazioni mirate a ciascun segmento.

---

## Prossimi passi

- [AI Agents](../ai-agents/ai-agents.md) — configura l'Agente IA del tuo ristorante.
- [Sistema di prenotazione](../appointments/booking-system.md) — come funzionano le prenotazioni tra i vari provider.
- [Gestione delle FAQ](../ai-automation/faq-management.md) — aggiungi domande e risposte specifiche del ristorante.
