ilMenu

View saved version →

---
name: manage-ilmenu
description: "Gestisci il menu del ristorante collegato a ilMenu tramite i tool MCP: consulta e modifica menu, categorie, piatti, eventi, abbinamenti e aggiunte consigliate, leggi le statistiche aggregate di upselling e cross-selling oppure recupera il link pubblico del locale. Non usare per prenotazioni, ordini, pagamenti o gestione di ristoranti non autorizzati."
---

# Gestire un menu ilMenu

Usa i tool dell'MCP ilMenu con la connessione OAuth del proprietario. Non chiedere password, OTP, chiavi API o token in chat. Se manca il collegamento, chiedi di connettere ilMenu tramite il normale consenso del client.

## Individuare il locale e il menu

- Parti da `get_restaurant`. Opera solo sul locale collegato: il nome di un altro ristorante o un sottodominio scritto dall'utente non autorizzano a cambiarne i dati.
- Usa `list_menus` e `list_categories` per individuare il contesto. Lavora in italiano; il backend gestisce le traduzioni. Non creare copie per altre lingue.
- Usa nomi, categoria, descrizione e prezzo per risolvere le ambiguità. Gli ID e i token restituiti dai tool servono alle chiamate, non mostrarli né chiederli all'utente.
- Le ricerche di piatti ed eventi cercano testo letterale nel nome e nella descrizione. Per cercare in tutto il menu ometti `category_id`; segui `next_offset` e riparti da zero quando cambi filtri. Non modificare un elemento simile se non trovi quello richiesto.

## Sedi e prezzi condivisi

- `get_restaurant` restituisce anche le sedi attive. Con più sedi chiedi quale usare, salvo l’utente l’abbia già specificato; non scegliere automaticamente la prima. Con zero o una sede non aggiungere una domanda obbligatoria.
- In ogni scrittura multisede passa `operating_zone_id`: UUID della sede scelta, oppure `null` esplicito per «entrambe/tutte le sedi». Ometterlo non equivale a scegliere tutte le sedi. Il contesto non è memorizzato tra le chiamate.
- Prezzi, testi e altri campi condivisi non diventano indipendenti selezionando una sede. Se l’utente sceglie una sola sede, chiarisci l’effetto sulle altre sedi e passa `confirm_shared_changes=true` solo dopo l’autorizzazione. Con `operating_zone_id=null` autorizzato, il flag è facoltativo e `true` è accettato: non chiedere un’altra conferma per le sedi. Non ripetere conferme per una modifica e un ambito già autorizzati; rispetta comunque quelle richieste dal client.
- Per il solo prezzo base usa `update_dish` con `dish_id`, `price` numerico, contesto sedi e un `request_id` distinto per ogni operazione/piatto. Non duplicare la modifica per ogni sede. Ometti `zone_ids`, `allergens` e `variants` se non richiesto; per cambiare un prezzo di variante invia invece l’intera lista `variants` con i token esistenti. Il prezzo base salvato si sincronizza subito alle traduzioni già presenti, senza attendere la coda.
- `zone_ids` modifica invece la visibilità: lista completa delle sedi, `null` eredita dai genitori, `[]` nessuna sede. Non ampliarla per una semplice modifica del prezzo. Rispetta le restrizioni della categoria padre.

## Link del menu pubblico

`get_restaurant` restituisce attualmente `restaurant.name` e `restaurant.subdomain`, non un URL completo né lo stato del piano.

Per il servizio di produzione ilMenu.link, un sottodominio valido restituito dal tool identifica il link `https://<subdomain>.ilmenu.link`. Non inventare il sottodominio e non ricavarlo soltanto dal nome commerciale. Se manca o contiene caratteri diversi da lettere, numeri e trattini, chiedi di verificarlo nel gestionale invece di costruire un link.

Se la risposta include in futuro un campo `public_menu_url`, usa quello. Non confondere il link pubblico con `/mcp`, gli endpoint API, il consenso OAuth o un invito di claim. Non inserire credenziali nel link.

Se l'utente chiede il menu pubblicato, consulta `list_menus`: non dichiarare un menu attivo se non risulta tale. Il link del locale non cambia quando cambia il menu attivo. La costruzione del link non certifica la r

Preview of the first 4,000 characters. Read full instructions →