Integrazioni

Cosa c'è nella scheda#

Nella dashboard, sotto Impostazioni, scheda Integrazioni, c'è tutto ciò che, fuori da Flavoso, lavora con il tuo locale. In cima, una riga mostra a colpo d'occhio che cosa è collegato in questo momento.

Sotto, ogni collegamento ha il suo riquadro:

• Pagamento online: i conti di pagamento con cui i clienti pagano online. Dal piano Pro.
• Stampante per scontrini: una stampante in cucina che stampa ogni nuovo ordine su un foglietto. Dal piano Pro.
• Ordini via e-mail: ogni nuovo ordine va anche a un indirizzo e-mail. In ogni piano.
• App collegate: software che lavora con il tuo locale, per esempio un sistema di cassa. In ogni piano.
• I tuoi webhook per i tuoi sistemi. In ogni piano, solo per il titolare.

Pagamento online#

Nel riquadro «Pagamento online» colleghi il tuo conto di pagamento e lo attivi per i clienti. Il denaro va direttamente sul conto del tuo locale; Flavoso non è mai il beneficiario. Il pagamento online fa parte del piano Pro e superiori.

Come si collega, passo dopo passo, è nel capitolo «Pagamento».

Stampante per scontrini#

Nel riquadro «Stampante per scontrini» configuri una stampante in cucina che stampa ogni nuovo ordine su un foglietto. Serve una stampante di rete che parli Star CloudPRNT oppure Epson Server Direct Print. Dal piano Pro.

La configurazione nel dettaglio è nel capitolo «Display di cucina», alla voce «Una stampante invece di uno schermo».

Ordini via e-mail#

Ogni nuovo ordine va anche a un indirizzo e-mail, per esempio quello della cucina. C'è in ogni piano.

L'indirizzo lo inserisci nel riquadro «Ordini via e-mail», oppure subito nell'assistente di configurazione. Gli ordini pagati online partono solo quando il pagamento è confermato.

Collegare app#

Qualsiasi software può collegarsi al tuo locale tramite l'API aperta di Flavoso, se tu sei d'accordo: un sistema di cassa, un programma per le consegne o uno di contabilità. Se un sistema in particolare lo supporta, te lo dice il suo fornitore.

Il percorso parte dall'altro software, e solo un titolare del locale può collegare un'app. Non c'è nessuna chiave da ricopiare: accedi e dai il tuo consenso.

Un'app si può collegare al tuo locale solo dopo che Flavoso l'ha verificata e approvata. Da quel momento porta «Verificata da Flavoso». Fino ad allora la collega solo il suo sviluppatore, al suo locale di prova e ai locali di cui lui stesso è titolare.

Le app verificate sono nell'elenco delle app: nella dashboard in Impostazioni, scheda Integrazioni, e pubblicamente su flavoso.com/it/integrations. Il collegamento parte comunque dall'app stessa; l'elenco ti porta lì.

Dopo il collegamento tutti i titolari del locale ricevono un'e-mail: quale app, quale fornitore, quali permessi, chi l'ha collegata e quando. Contiene il pulsante «Gestisci le app collegate».

Un'app vede solo il locale a cui l'hai collegata, e solo ciò per cui ha i permessi; l'elenco è sotto i passaggi. Gli ordini non contengono l'indirizzo e-mail del cliente, il telefono solo per asporto e consegna, e l'indirizzo solo per le consegne. Collegando un'app incarichi Flavoso di trasmetterle questi dati. Il fornitore dell'app è responsabile del proprio trattamento dei dati.

1. 1

   Scegliere «Collega con Flavoso»

   Nell'altro software. Dove si trova esattamente te lo dice il suo fornitore.

   Nell'altro software

2. 2

   Accedere

   Con il tuo account Flavoso. Se hai impostato un secondo fattore, ti viene chiesto.

   Su Flavoso

3. 3

   Scegliere il locale

   Il locale con cui l'app deve lavorare. Puoi collegare solo locali di cui sei titolare.

4. 4

   Leggere i permessi

   La schermata mostra logo, nome e sito web dell'app, e in parole chiare che cosa può fare. Le app approvate portano «Verificata da Flavoso».

5. 5

   Collegare

   Un clic su «Collega» e torni nell'altro software. Fatto. «Annulla» non collega nulla.

• Ordini: vederli, oppure accettarli, rifiutarli, farli avanzare e prenderli in carico nel proprio sistema.
• Menu: vederlo, oppure modificarlo: piatti, categorie, opzioni, prezzi ed esauriti.
• Locale: vedere orari, stato e tavoli, oppure mettere in pausa la ricezione degli ordini e cambiare orari e tempi di preparazione.
• Prenotazioni: vederle, oppure crearle, confermarle e modificarle. Questo vale solo dal piano Pro, come le prenotazioni stesse, e la schermata del consenso lo segnala.
• Vendite: vedere fatturato e vendite.

Scollegare#

Un titolare può scollegare in qualsiasi momento: Impostazioni, scheda Integrazioni, riquadro «App collegate», pulsante «Scollega», poi confermare. L'app perde subito ogni accesso.

I titolari ricevono una breve e-mail al riguardo. Collegamenti e scollegamenti restano nel registro.

Anche l'app stessa può chiudere il collegamento. Nell'app per il telefono vedi e scolleghi le app collegate sotto Altro, Impostazioni, Integrazioni.

Webhook personalizzati#

Per i tuoi sistemi o per servizi di automazione ci sono i webhook personalizzati: quando succede qualcosa, per esempio un nuovo ordine, Flavoso invia un messaggio al tuo indirizzo. Stanno sotto Impostazioni, scheda Integrazioni, «I tuoi webhook», solo per i titolari e in ogni piano.

Come sono fatti i messaggi e come il tuo sistema verifica la firma è nella documentazione per sviluppatori su docs.flavoso.com/it/api.

• Fino a cinque indirizzi. Ognuno usa https e deve essere raggiungibile pubblicamente, e per ogni indirizzo scegli gli eventi.
• Ogni invio è firmato (intestazione Flavoso-Signature, HMAC-SHA256). Così il tuo sistema sa che viene davvero da Flavoso.
• Se un invio non riesce, Flavoso riprova: fino a otto tentativi nell'arco di quasi due giorni.
• Se per 24 ore non arriva nulla e falliscono almeno dieci tentativi di fila, l'indirizzo viene disattivato e i titolari ricevono un'e-mail.
• Su ogni indirizzo ci sono il registro degli ultimi invii e il pulsante «Invia evento di prova».

Sviluppare la tua app#

La tua app la crei nella console sviluppatori: su app.flavoso.com/it/developers, oppure nella dashboard dal menu dell'account in alto a destra, voce «Console sviluppatori». Basta un account Flavoso; non servono né un locale tuo né un abbonamento.

Alla prima visita un assistente di configurazione ti accompagna dall'app, passando per un locale di prova gratuito, fino alla prima richiesta. Il locale di prova è un ristorante che serve solo per provare l'API, con un menu di esempio e dei tavoli. Nella console, in «Locale di prova», crei ordini e prenotazioni e li fai avanzare come farebbe la cucina. La tua app riceve ogni modifica come evento, anche via webhook.

Altri locali possono collegare la tua app non appena l'hai inviata per l'approvazione e Flavoso l'ha verificata e approvata. Tutto il resto per gli sviluppatori è nella documentazione per sviluppatori su docs.flavoso.com/it/api.