Se usi un gestionale, una cassa (POS), un programma di prenotazioni o di contabilità, puoi collegarlo a Menuristo. Così il programma legge e aggiorna da solo menu, prezzi, piatti esauriti e prenotazioni, e tu non devi scrivere le stesse cose due volte.
Il collegamento si fa con un token: una lunga chiave segreta che dai al programma, un po' come la password del Wi-Fi che dai a un ospite. Lo trovi in Integrazioni, nel menu laterale.
Le integrazioni si attivano su richiesta. Se nel menu laterale non vedi Integrazioni, scrivi all'assistenza: le attiviamo noi per il tuo locale.
Cosa può fare un programma collegato
- Leggere i dati del locale, gli orari, i menu con categorie, piatti, prezzi e allergeni.
- Aggiornare il menu: cambiare prezzi, segnare un piatto come esaurito quando finisce in cucina, aggiungere o togliere piatti.
- Gestire le prenotazioni (solo se il tuo piano include le Prenotazioni): leggere l'agenda, inserire le prenotazioni prese al telefono, confermarle o annullarle.
- Ricevere avvisi immediati (webhook) appena arriva una prenotazione o cambia un piatto.
Il programma vede solo i dati del tuo ristorante, mai quelli di altri locali.
Creare un token
- Apri Integrazioni dal menu laterale.
- Premi Nuovo token.
- Dai un nome che ti ricordi a cosa serve, ad esempio "Cassa sala" o "Gestionale magazzino".
- Scegli i permessi:
- Sola lettura: il programma può solo leggere. Va bene per un sito, un'app o un programma di statistiche.
- Lettura e scrittura: il programma può anche cambiare prezzi, disponibilità e prenotazioni. Serve a casse e gestionali.
- Premi Crea token e copia subito il token con il pulsante accanto: per sicurezza non potrai più rivederlo.
- Incollalo nelle impostazioni del programma, nel campo che di solito si chiama "API key", "token" o "chiave di accesso". Se il programma chiede anche un indirizzo, usa quello che trovi nella documentazione tecnica.
Consiglio: crea un token diverso per ogni programma. Se un giorno ne cambi uno, revochi solo il suo token e gli altri continuano a funzionare.
Revocare un token
Se smetti di usare un programma, se cambi fornitore o se pensi che il token sia finito nelle mani sbagliate, premi Revoca accanto al token. Da quel momento il programma non può più accedere. Puoi sempre crearne uno nuovo.
Accanto a ogni token vedi quando è stato usato l'ultima volta: un token mai usato da mesi probabilmente non serve più.
Gli avvisi automatici (webhook)
Alcuni programmi vogliono essere avvisati subito, ad esempio quando arriva una nuova prenotazione online. Se il fornitore te lo chiede:
- In Integrazioni premi Nuovo webhook.
- Incolla l'indirizzo che ti ha dato il fornitore (inizia con https://).
- Scegli gli eventi: nuova prenotazione, prenotazione modificata, annullata, piatto aggiunto, modificato o eliminato.
- Premi Salva e copia la chiave di firma che appare: il fornitore la usa per essere sicuro che gli avvisi arrivino davvero da Menuristo.
- Premi Prova per mandare un avviso di prova e chiedi al fornitore se gli è arrivato.
Accanto a ogni webhook vedi l'esito dell'ultimo invio. Se il programma non risponde riproviamo da soli più volte nelle ore successive. Puoi mettere un webhook in pausa togliendo Attivo.
Prenotazioni e piano
Le funzioni sulle prenotazioni sono disponibili solo se il tuo piano include il modulo Prenotazioni, anche durante la prova gratuita. Senza il modulo il programma collegato può comunque lavorare su ristorante, menu e piatti.
Cosa dare al tecnico o al fornitore
Di solito basta mandargli:
- il token (meglio a voce, per telefono o con un messaggio che si cancella, non in una email che resta in giro);
- il link alla documentazione tecnica, dove trova indirizzi, esempi e la specifica OpenAPI da importare.