Collegare altre app — API e webhook

Le tue altre app possono lavorare con BiteTheMenu. Un foglio di calcolo, uno schermo in cucina o uno strumento di automazione possono leggere il tuo locale. Possono anche sapere di un nuovo ordine nel momento in cui arriva.

La regola

Le tue app possono fare solo quello che la chiave permette. Una modifica aspetta sempre che una persona la approvi.

Come funziona

Ci sono due parti. Tutte e due sono in AI → API e connettori.

L’API. Fai una chiave in Collega la tua AI. La tua altra app usa la stessa chiave. Chiede dei dati, per esempio il tuo menu, e li riceve. La scheda Collega altre app mostra l’indirizzo e un esempio.
I webhook. Premi Aggiungi un webhook. Scrivi l’indirizzo della tua app e scegli gli eventi, per esempio New order. Copia il segreto di firma. Lo vedi una volta sola.
Premi Manda una prova per controllare che la tua app riceve il messaggio. Ultimi messaggi mostra se ogni messaggio è arrivato.

Buono a sapersi

Nei piani Essential e Plus. Con un piano più basso, le tue chiavi e i tuoi webhook restano, ma non funzionano. Funzionano di nuovo quando passi a un piano più alto.
Per un’app usa una chiave del locale. Un titolare può fare una chiave che agisce come un ruolo, come Il locale, come Manager. Non si ferma quando se ne va la persona che l’ha fatta.
Usa l’API da un server, mai da una pagina web. In una pagina web chiunque può leggere una chiave.
Gli stessi limiti. Una chiave può fare 30 chiamate al minuto e 1.000 al giorno. L’API e il tuo agente AI li dividono.
Un messaggio ha i dettagli in campi separati. Una richiesta di prenotazione ha la data, il numero di persone e l’email dell’ospite. La tua app non deve leggere il testo.
Puoi fare un nuovo segreto. Premi Nuovo segreto sul webhook. Per 24 ore ogni messaggio è firmato con il segreto nuovo e con quello vecchio. In questo tempo la tua app può passare al segreto nuovo. Premi Ferma subito il segreto vecchio se il segreto vecchio è perso o rubato.
Ogni messaggio è firmato. La tua app controlla la firma con il segreto, così sa che il messaggio arriva da noi.
Proviamo di nuovo. Quando la tua app non risponde, proviamo altre 5 volte in circa 10 ore. Dopo 10 messaggi falliti di seguito, il webhook si spegne. Premi Accendi quando la tua app è a posto.
I dati degli ospiti restano protetti. Solo i titolari e i manager possono mandare eventi con il nome e il telefono di un ospite, come una richiesta di prenotazione.

Funzioni collegate

Il tuo agente AI — le chiavi, i loro permessi e i loro limiti.
Telegram — gli stessi eventi, mandati alle persone invece che alle app.