Webhook: sapere subito che è stato venduto un biglietto

Supponiamo che voglia che il contatore sul Suo sito si muova appena viene venduto un biglietto. Ci sono due modi per riuscirci, e uno è decisamente migliore.

Questo articolo spiega che cos’è un webhook e se Le serve. Come configurarne uno, pulsante per pulsante, è spiegato in Configurare i webhook.

Il mondo al contrario

Senza webhook il Suo sito deve continuare a chiedere. Ogni minuto, tutto il giorno: «è già stato venduto qualcosa?» Quasi sempre la risposta è no. Sono millequattrocento domande al giorno per sentire tre volte sì — e tra una domanda e l’altra il Suo contatore è sbagliato.

Con un webhook si ribalta la cosa. Ci dà un indirizzo sul Suo sito e, appena succede qualcosa, mandiamo lì un breve messaggio. Un solo messaggio, nel momento stesso.

Da qui il nome: un hook è un gancio a cui appendiamo qualcosa appena è il momento.

Che cosa può farci

• far muovere il contatore sul Suo sito appena viene venduto qualcosa;
• ricevere un messaggio nella chat del team per ogni ordine sopra un importo;
• aggiornare l’elenco dei soci quando qualcuno compra un abbonamento;
• mandarsi una mail quando un ordine viene annullato;
• avvisare subito la Sua cassa o contabilità che è entrato del denaro.

Che cosa Le serve

Tre cose, e il Suo webmaster le conosce tutte e tre:

1. Un indirizzo sul Suo sito che possa ricevere messaggi. È una pagina normale che nessuno visita; sta lì solo per ricevere il nostro messaggio. Deve cominciare con https://.
2. Un posto dove inserire quell’indirizzo. Lo fa Lei stesso, in Impostazioni → Accesso API, nella scheda Webhook — veda Configurare i webhook. Se il Suo webmaster preferisce farlo dal proprio programma, gli serve una chiave con il permesso Webhook; veda Creare una chiave API.
3. Il segreto legato a quell’indirizzo. Lo riceve da noi non appena l’indirizzo è configurato, e con quello il Suo sito verifica che un messaggio venga davvero da noi.

La terza è importante. Senza il controllo del segreto, chiunque indovini il Suo indirizzo può far credere al Suo sito che sia stato venduto qualcosa. Con il controllo, no.

Che aspetto ha

Arriva un breve messaggio che dice che cosa è successo e su che cosa. Il Suo sito guarda il segreto, vede che corrisponde e poi ne fa qualcosa: aumentare un contatore, scrivere una riga, mandare una mail.

Che cosa contiene esattamente un messaggio del genere, e come si programma il controllo del segreto, sta nel portale per sviluppatori — è la pagina che inoltra a chi lo costruisce.

Tre cose che vanno spesso storte

Risponda in fretta. Il nostro messaggio aspetta una risposta al massimo dieci secondi, non finché il Suo sito ha finito tutto il suo lavoro. Accetti il messaggio, dica che è arrivato, e faccia il lavoro dopo.

Conti sulle ripetizioni. Se il Suo sito era momentaneamente irraggiungibile riproviamo — fino a sei volte, nell’arco di poco più di un giorno e mezzo. Lo stesso messaggio può quindi arrivare due volte. Faccia in modo che il Suo sito lo sopporti — lo stesso messaggio due volte non deve produrre due volte la stessa mail.

Tenga segreto il segreto. Deve stare nelle impostazioni del Suo server, non in codice che finisce sul Suo sito pubblico.

Le serve davvero?

No. Un webhook è utile quando qualcosa deve succedere subito. Se basta un riepilogo giornaliero, non Le serve — allora è sufficiente recuperare i numeri una volta al giorno.

I webhook appartengono allo stesso piano del resto dell’API. Che cosa c’è in quale piano sta nella pagina dei prezzi di Passavo.

Per saperne di più

• Configurare i webhook — la schermata stessa: aggiungere un indirizzo, inviare un messaggio di prova, leggere il registro dei messaggi.
• Che cos’è un’API, e Le serve?
• Creare una chiave API
• Il portale per sviluppatori — per chi costruisce l’integrazione.