Webhook - Cosa sono e come utilizzarli

Che cosa sono?

I WebHook sono un meccanismo di comunicazione integrativo a quello delle API che permette ad un sistema terzo di essere notificato di eventi accaduti sul sistema Cassa in Cloud senza fare chiamate periodiche, ma specificando un URL da notificare. L’invio di questo evento da Cassa in Cloud verso un URL permette di generare in quest’ultimo un dato comportamento. I Webhook facilitano la comunicazione tra Cassa in Cloud e sistemi di terze parti come ad esempio siti eCommerce o altri Gestionali.

I Webhook in Cassa in Cloud

I Webhook  ti permettono di avviare degli eventi ogni volta che viene registrato un conto chiuso, uno scontrino, nota di credito, fattura, ddt, ordini, preventivi, movimenti di magazzino, chiusure di cassa, schede anagrafiche per clienti o aziende.

Per gestire con semplicità i webhook abbiamo realizzato una nuova interfaccia, che trovi all’interno del Portale Cloud nella sezione “Impostazioni Account” –> “WebHooks” tramite la quale puoi aggiungerli, modificarli, metterli in pausa o eliminarli.

Per avviare l’attivazione di un Webhook puoi cliccare sul bottone “+Nuovo Webhook“, si aprirà un pop-up che ti permette di definire quale webhook attivare e quale tipologia di evento (creazione, modifica, eliminazione) comunicare all’URL definito. Sarà necessario anche indicare la “Visibilità” del webhook, indicando i punti vendita per il quale deve essere attivo.

Una volta cliccato sul pulsante “Crea“, nella sezione “Webhooks” comparirà una tabella a griglia che mostra il riepilogo di quanto appena attivato.
La griglia è composta da 9 colonne, le quali indicano:

• il Webhook selezionato
• la sua descrizione, che ci aiuta a distinguere l’evento in una possibile lista di più elementi
• icone degli eventi attivati, “+” per la creazione, “matita” per la modifica, “cestino” per l’eliminazione
• l’URL verso cui viene inviato l’evento
• la visibilità, ossia i punti vendita per cui è stato attivato
• le azioni permesse: ripristino, modifica, eliminazione del webhook (Attenzione: cliccare sulle azioni ha effetto immediato sul webhook, la sua eliminazione non ne permette un successivo ripristino)
• infine la data di creazione, sospensione o revoca. In modo da mantenere lo storico dell’attività

Sempre all’interno della sezione “Webhooks” compare anche la tabella dedicata ai Log, ossia l’elenco cronologico delle attività svolte. La tabella è anche filtrabile per “Log falliti“, per un rapido check qualora si presentasse un problema.

Oltre al Tab “Log”, è disponibile anche la scheda di “Utilizzo” dei webhook, nella quale troviamo informazioni in merito ai webhook eseguiti ed eseguibili. Anche qui posso filtrare per “Limiti Superati”, in quanto per motivi di Governance il sistema limita il numero di chiamate fattibili dall’esterno entro un determinato periodo di tempo.

Per maggiori informazioni su come sono esposte le entità puoi trovarne la descrizione all’interno della nostra libreria API.