API e integrazioni
L'integrazione pronta all'uso è il Widget prenotazioni: la card per prenotare tavoli e chiedere eventi, da incollare sul tuo sito (codice o plugin WordPress). È un add-on da 9 €/mese, dal piano Ristorante. API vere, sincronizzazione con cassa/gestionale e white-label non sono incluse in nessun piano self-service: si fanno su richiesta, scrivendoci.
In breve
Tante "integrazioni" si riducono a una sola domanda pratica: come faccio a far prenotare i clienti direttamente dal mio sito? Carteia ha la risposta pronta: il Widget prenotazioni. È la card per prenotare un tavolo o chiedere un evento, che incolli sul tuo sito in pochi minuti.
Le integrazioni più tecniche — collegare Carteia alla cassa, a un gestionale, o usare un tuo dominio senza marchio (white-label) — non sono incluse nei piani di listino: si realizzano su misura, parlandone insieme.
Ristorante Il Widget prenotazioni è un add-on da 9 €/mese, disponibile dal piano Ristorante in su.
Il Widget prenotazioni: l'integrazione pronta all'uso
Pensalo come un "blocco prenotazioni" che vive sul tuo sito. Il cliente lo compila lì, senza saltare su un altro indirizzo, e la richiesta arriva dritta nella tua dashboard Carteia, insieme a tutte le altre.
Cosa puoi mostrare
- La prenotazione tavolo (la stessa che hai sulla tua pagina pubblica Carteia).
- La richiesta di evento (per chi vuole organizzare una cena di gruppo o una festa).
- Puoi scegliere quale dei due mostrare per primo, il tema chiaro o scuro, e se tenere o togliere la piccola firma Carteia in fondo.
Come si mette sul sito
Dalla dashboard apri la sezione delle integrazioni e attiva il widget: generi un codice di collegamento (un token). Te lo mostriamo una volta sola, quindi salvalo subito.
Indica i domini del tuo sito dove il widget può comparire (per esempio
iltuoristorante.it). Funzionerà solo lì: è una protezione contro chi prova a copiarlo altrove.Copia lo snippet di codice (una riga di
<script>) e incollalo nella pagina del tuo sito dove vuoi le prenotazioni.In alternativa, se il tuo sito è su WordPress, installa il plugin "Carteia Booking", incolla il token nelle impostazioni e aggiungi lo shortcode dove preferisci.
È sicuro per il tuo sito
Il widget gira in una finestra isolata dal resto del tuo sito (non può "toccare" le altre parti della pagina). Compare solo sui domini che hai autorizzato tu, ha un limite alle richieste per non farsi prendere d'assalto e una protezione anti-spam integrata. In più, nella dashboard vedi le statistiche degli ultimi 30 giorni: quante volte è stato caricato e quante richieste sono state bloccate.
Cosa ti serve per attivarlo
Due cose insieme:
- Un piano Ristorante o superiore.
- L'add-on Widget prenotazioni attivo (9 €/mese), che attivi dalla sezione abbonamento.
Se hai il piano giusto ma non l'add-on, vedi comunque l'anteprima del widget; per pubblicarlo davvero serve attivare l'add-on.
API, cassa, gestionale, white-label: come funzionano davvero
Qui chiariamo una cosa importante, senza giri di parole.
"Far parlare Carteia con altri programmi" — è questo che si intende con API — richiede un lavoro dedicato. Lo stesso vale per chi gestisce molti locali con un proprio marchio (agenzie, franchising, catene) e vuole nascondere completamente Carteia dietro il proprio brand.
Se è il tuo caso, scrivici raccontandoci:
- cosa vuoi collegare (quale cassa, quale gestionale, quale sito);
- quante sedi sono coinvolte;
- cosa deve succedere quando, per esempio, cambi un prezzo in cassa o arriva una prenotazione.
Da lì valutiamo insieme la soluzione giusta. Non promettiamo bottoni che non esistono: costruiamo quello che ti serve.
Quale scegliere
- Voglio le prenotazioni sul mio sito
- È il Widget prenotazioni. Pronto, self-service, 9 €/mese dal piano Ristorante. Lo attivi e lo incolli oggi stesso.
- Voglio collegare la cassa o il gestionale
- È un'integrazione su misura. Scrivici e ne parliamo: non è una funzione che si attiva da sola.
- Gestisco tanti locali e voglio il mio marchio ovunque
- È il territorio del white-label su misura. Anche qui: contatto diretto, soluzione costruita sul tuo caso.
Prossimi passi
Domande frequenti
- Posso mettere le prenotazioni sul mio sito?
- Sì, è proprio quello che fa il Widget prenotazioni. Attivi l'add-on (9 €/mese, dal piano Ristorante), copi un pezzo di codice o installi il plugin WordPress, e la card di prenotazione compare sul tuo sito.
- Carteia ha delle API per collegarlo al mio gestionale o alla cassa?
- Far parlare Carteia con altri programmi (cassa, gestionale, sito su misura) non è una funzione self-service inclusa nei piani. È un'integrazione su misura: scrivici descrivendo cosa vuoi collegare e ne parliamo.
- Posso togliere il marchio Carteia e usare un mio dominio (white-label)?
- Il white-label completo non è incluso in nessuno dei piani di listino. È riservato a progetti su misura (catene, franchising, agenzie): si valuta caso per caso su richiesta.
- Il widget rallenta o espone il mio sito?
- No. Il widget gira in una finestra isolata (sandbox) e funziona solo sui domini che autorizzi tu. Ha un limite di richieste e una protezione anti-spam integrata.
Cronologia versioni
v2.0.02026-05-29— Riscrittura completa e correzione di rotta: rimosse le API REST, i webhook e il white-label descritti come prodotti pronti (non esistono come funzione self-service; whiteLabelApi=false su tutti i piani). Documentato il Widget prenotazioni come l'unica integrazione realmente disponibile (add-on booking_embed_widget 9 €/mese, dal piano Ristorante). API/white-label spostati su 'contatto su richiesta'. Rimosso noindex.v1.1.02026-05-22— Pagina riformulata come integrazione enterprise su contatto (con noindex).v1.0.02026-05-20— Prima pubblicazione (descriveva API/webhook/white-label non implementati).