Configura i webhook
I webhook in resmio sono un meccanismo di attivazione leggero per informare i sistemi esterni in tempo reale sulle modifiche alle prenotazioni e agli ordini online.
Informazioni generali
In parole semplici, i webhook consentono di collegare resmio a sistemi esterni e di informarli automaticamente di determinati eventi.
Esempi di eventi sono le prenotazioni o gli ordini andati a buon fine.
Il webhook è una notifica automatica tramite richiesta HTTP che resmio invia a un URL da te indicato non appena si verifica un determinato evento.
Sono ipotizzabili i seguenti scenari di utilizzo:
- Workflow guidati da eventi (un sistema deve reagire a determinati eventi senza conoscerne i dettagli)
- Notifiche interne (tu o il team ricevete una notifica quando succede qualcosa)
- Conteggi e sincronizzazione dello stato (un’applicazione terza tiene semplicemente il conto degli eventi)
- Monitoraggio e processi tecnici
I destinatari tipici dei webhook di resmio sono piattaforme di automazione come Zapier, Make o n8n, server interni, sistemi di notifica (Slack, Teams) o strumenti di reporting wie Google Sheets, che reagiscono agli eventi senza elaborare i dati di prenotazione o d’ordine.
| Voce | Descrizione |
|---|---|
| Metodo | HTTP POST |
| Autenticazione | Basic Auth |
| Formato | JSON |
| Payload | id, facility_id, action |
| Scopo | Trigger per sistemi esterni |
| Dati dettagliati | Recuperare tramite API |
La configurazione e l’aggiornamento dei webhook sono possibili direttamente dal tuo account resmio.
- Accedi al sistema e vai su
Impostazioni > Integrazioni > Sviluppatori > Webhook - Aggiungi un nuovo webhook cliccando sul pulsante + Aggiungi webhook.
- Per il webhook devono essere fornite le seguenti informazioni:
- un URL di destinazione per la richiesta HTTP
- un nome utente (per l’autorizzazione)
- la password (per l’autorizzazione)
- l’azione/evento desiderato
Impostazioni > Integrazioni > Quando il tuo webhook è salvato in resmio, resmio invia automaticamente una richiesta HTTP POST al tuo URL non appena si verifica l’azione selezionata. La tua applicazione riceve quindi la richiesta e può reagire di conseguenza (ad es. salvando i dati, avviando un processo specifico, ecc.).
L’autenticazione avviene tramite Basic Auth (nome utente e password). Questi dati vengono inviati nell’intestazione HTTP. Il tuo server verifica le credenziali prima dell’elaborazione.
Attualmente in resmio sono disponibili in totale sei azioni webhook.
| Ambito | Trigger | Significato |
|---|---|---|
| Prenotazioni (booking) | booking_created | È stata creata una nuova prenotazione. |
| Prenotazioni (booking) | booking_updated | Una prenotazione esistente è stata modificata (ad es. orario, numero di persone). |
| Prenotazioni (booking) | booking_deleted | Una prenotazione è stata cancellata o eliminata. |
| Ordini online (productorder) | productorder_created | È stato ricevuto un nuovo ordine online. |
| Ordini online (productorder) | productorder_updated | Un ordine esistente è stato modificato. |
| Ordini online (productorder) | productorder_deleted | Un ordine è stato cancellato o eliminato. |
In questo caso, la richiesta del webhook contiene attualmente solo un payload minimo.
Ein Beispiel aus der Praxis:
{
"id": 51918313,
"facility_id": "the-fish",
"action": "BOOKING_CREATED"
}
I campi inclusi sono i seguenti:
id
L’ID interno della prenotazione o dell’ordine assegnato da resmio
facility_id
L’identificatore univoco dell’account resmio (ristorante).
action
L’evento scatenato, vedi la tabella sopra per tutte las azioni webhook.
Il webhook funge principalmente da trigger, non da trasporto dati completo.
