Integrazioni — POS, consegna, messenger, API

Panoramica#

Cenaly si integra con i più diffusi sistemi di automazione, piattaforme di pagamento, servizi di consegna e messenger. Questo permette di inserire il menu digitale nell'infrastruttura già presente della struttura.

Sistemi contabili e commerciali#

Sistemi supportati#

Nel Negozio di app sono presenti le schede anche dei sistemi per cui lo scambio è ancora solo pianificato, con l'etichetta «Prossimamente». Per il mercato russo si tratta di gestione merci e casse (MoySklad, iiko, r_keeper, StoreHouse 5, Quick Resto, Frontpad, Kontur.Market), Saby (SBIS) — con le schede Presto per la ristorazione e Retail per il negozio —, CRM (Bitrix24, amoCRM, RetailCRM, YCLIENTS), EDO (Diadoc, Taxcom, «Moyo Delo»), marketplace (Megamarket, Avito), marketing (Yandex Business, VK Reklama, Mindbox), fidelizzazione (UDS), estratti conto bancari (T-Bank, Tochka, Modulbank, Alfa-Bank, SberBusiness) e hh.ru. Nel catalogo entra solo ciò che ha un'API descritta pubblicamente: la scheda significa «lo faremo», non «forse».

Cosa si sincronizza#

• Catalogo → articoli, prezzi, categorie; la direzione la scegliete voi (chi è il «principale» — Cenaly o il sistema esterno)
• Ordini → le vendite viaggiano in entrambe le direzioni: la ricevuta di Evotor diventa un ordine in Cenaly, l'ordine di Cenaly va alla cassa
• Magazzino → le giacenze si aggiornano alla vendita e al carico, il conflitto dei «due padroni» si risolve con l'impostazione «master delle giacenze»
• Anagrafiche → controparti, fornitori, dipendenti

Configurazione (sull'esempio di Evotor)#

1. Nel pannello Cenaly → Negozio di app → scheda «Per sedi» → scheda Evotor
2. Copiate il codice di collegamento mostrato
3. Installate l'app cenaly in Evotor.Market e inserite questo codice nel modulo di collegamento
4. Tornate nel pannello, indicate l'UUID del negozio (area riservata di Evotor → Negozi) e premete «Collega negozio»
5. Configurate la sincronizzazione: master delle giacenze, ricezione degli ordini cenaly sul terminale, aliquota IVA predefinita
6. Inviate il catalogo

Piattaforme di consegna#

Aggregatori con integrazione pronta#

Gli ordini arrivano nel feed unico di Cenaly, menu e stop-list vanno alla piattaforma automaticamente:

Guide dettagliate: Wolt · Glovo · Yandex Eats.

Altre piattaforme (Uber Eats, Bolt Food, Just Eat, foodpanda, talabat, Yemeksepeti, Trendyol GO, iFood, Rappi e un'altra ventina) sono presenti nel repertorio dei canali di consegna all'interno del pannello — con le condizioni di attivazione e i contatti della piattaforma, ma per ora senza connettore pronto. Il link al profilo della struttura su una qualsiasi di esse si può aggiungere alla scheda della sede, perché venga mostrato agli ospiti.

Oltre al repertorio, i servizi di consegna del vostro paese si vedono direttamente nel Negozio di app, nella categoria «Consegna»: ogni servizio ha la sua scheda, che mostra onestamente lo stato di prontezza — da «si attiva oggi» a «lo conosciamo solo dalla documentazione». Dalla scheda senza connettore pronto si può inviare una richiesta: è in base a queste che decidiamo quale adattatore scrivere per primo.

Marketplace di prodotti#

Nella stessa categoria si trovano le schede dei marketplace di prodotti — un catalogo mondiale di piattaforme dove il negozio esporta i prodotti e da cui preleva gli ordini. Anche la selezione è per paese: non vedete l'intero elenco, ma le piattaforme che accettano un venditore dal vostro paese. Gli adattatori Ozon, Wildberries e Kaspi sono scritti e si attivano in modalità pilota (la scheda lo dice chiaramente), per gli altri la scheda funziona come richiesta «Prossimamente».

Vantaggi della consegna propria#

Tramite Cenaly si possono ricevere ordini di consegna direttamente, senza passare dagli aggregatori:

• 0% di commissione (gli aggregatori prendono il 15–30%)
• Pieno controllo sulla base clienti
• Possibilità di fare uno sconto al cliente e guadagnare comunque di più

Messaggeri#

Telegram#

• Mini App — menu completo all'interno di Telegram, si apre con il pulsante «Menu» nella chat del vostro bot
• Procedura guidata di connessione — Cenaly configura da solo il bot tramite Telegram API: nome, descrizione, pulsante «Menu» e webhook; manualmente resta solo da creare il bot in @BotFather
• Bot per appuntamenti e promemoria — il cliente si iscrive al promemoria della visita e conferma o annulla con un pulsante direttamente in chat; il titolare riceve le notifiche sui nuovi appuntamenti nel proprio Telegram

Per saperne di più: Telegram Mini App — guida

WhatsApp#

• Pulsante d'ordine — il cliente compone il carrello nel menu QR e invia l'ordine come messaggio già pronto in WhatsApp (link wa.me, senza server e Business API)
• Copia nel pannello di amministrazione — l'ordine viene registrato in parallelo nella sezione «Ordini» con il canale WhatsApp

Per saperne di più: Integrazione con WhatsApp — guida

Hardware#

L'hardware si collega tramite Cenaly Hardware Bridge — un piccolo programma per Windows o Linux, installato sul computer della cassa. Il pannello lo trova da solo e riesce a inviare comandi anche da un altro dispositivo.

Stampanti per ricevute#

È supportata qualsiasi stampante ESC/POS — è il linguaggio comune delle stampanti per ricevute, parlato da Epson TM, Star Micronics, Xprinter, Rongta e decine di altre.

Il bridge apre da solo il cassetto portamonete, stampa una ricevuta di prova e sa stampare i caratteri non latini come immagine — dove la stampante non ha la tabella codici necessaria (ad esempio, per il georgiano).

Registratori fiscali#

ATOL, Shtrih-M, Daisy, Mercury, Pirit — fiscalizzazione della ricevuta, report X e Z, editor del cliché, aliquote fiscali. Per saperne di più: Cassa e fiscalizzazione.

Kitchen Display System (KDS)#

• Qualsiasi tablet o Smart TV
• Funziona tramite browser web
• Non richiede l'installazione di un'app

Altro hardware#

Scanner per codici a barre, bilance (peso in tempo reale con indicatore di stabilità), display per il cliente, cassetti portamonete, telecamere di videosorveglianza.

Terminali di pagamento#

Esiste anche la modalità «terminale esterno» — quando il pagamento avviene su un dispositivo separato della banca e il cassiere conferma semplicemente il risultato.

API e Webhooks#

Guest API — per agenti IA e servizi esterni#

REST-API pubblico (OpenAPI 3.1) senza autorizzazione: leggere il menu, effettuare un ordine, verificare i tavoli liberi e prenotare. Esattamente le stesse operazioni disponibili al cliente sulla pagina del menu.

• Per saperne di più: Guest API per agenti IA

Protocollo MCP#

Per gli assistenti IA (Claude, ChatGPT, Cursor) ci sono due server MCP. Guest — menu, ordini e prenotazioni a nome del cliente, senza chiave (Guest API). MCP del proprio centralino — registro delle chiamate, registrazioni, chiamata con un clic, inoltro e regole di chiamata tramite chiave da «Telefonia → API e MCP» oppure tramite OAuth.

• Per saperne di più: Telefonia → API e MCP

Webhooks#

Impostazioni → Ordini → Scenari (Flow): regola «quando si verifica un evento e le condizioni corrispondono — eseguire un'azione». Una delle azioni è inviare un webhook al vostro URL con il corpo dell'ordine.

Eventi:

• Nuovo ordine
• Pagamento dell'ordine
• Cambio di stato dell'ordine
• Annullamento dell'ordine

Contabilità e gestione amministrativa#

Integrazioni di marketing#

Contatori e pixel (si impostano per ogni sede)#

Tutti i contatori si collegano solo dopo il consenso del cliente ai cookies: quelli analitici — per la categoria «statistiche», quelli pubblicitari — per la categoria «marketing».

Link a piattaforme esterne#

Google Maps, Yandex Maps, TripAdvisor, Yelp, Foursquare, 2GIS, Instagram, Facebook e altre — l'indirizzo del profilo dell'esercizio si aggiunge alla scheda della sede e viene mostrato ai clienti.

8. Gestione delle zone di consegna#

Configurazione#

1. Sezione «Corrieri» → blocco «Zone di consegna»
2. Disegnate la zona sulla mappa (poligono)
3. Per ogni zona impostate:

Nello stesso punto si attiva la distribuzione automatica degli ordini tra i corrieri.

Consegna propria vs aggregatori#

• Propria: corrieri del locale, pieno controllo, commissione inferiore
• Aggregatori (Wolt, Glovo, Deliveroo, Яндекс Еда): maggiore copertura, ma commissione 15–30%
• Ibrida: consegna propria nelle zone vicine + aggregatori in quelle lontane

9. SEO per il sito del ristorante#

Ottimizzazione SEO automatica#

Cenaly genera automaticamente:

• Meta tag: title, description per ogni pagina
• Schema.org: dati strutturati (Restaurant, Menu, MenuItem)
• Open Graph: anteprima durante la condivisione sui social
• Sitemap.xml: mappa del sito per i motori di ricerca
• Robots.txt: regole di indicizzazione

Raccomandazioni#

• Collegate Google Search Console per il monitoraggio
• Usate un dominio proprio (menu.yourrestaurant.com)
• Compilate la descrizione del locale in modo dettagliato (per Google Maps)
• Aggiungete fotografie — vengono indicizzate da Google Images
• Attivate le recensioni — la valutazione viene mostrata nei risultati di ricerca