Che cos'è un webhook e perché è più comodo di interrogare?
Con un'API il tuo sistema chiede: quel messaggio è già arrivato? Con un webhook la cosa si inverte — viene segnalato a te non appena qualcosa cambia.
Perché è meglio
Senza webhook devi continuare a chiedere. Se chiedi ogni minuto, fai centinaia di chiamate inutili per ognuna che produce qualcosa. Se chiedi ogni ora, lo sai troppo tardi.
Che cosa ti serve
Un indirizzo sul tuo server che possa ricevere un messaggio e che sia sempre raggiungibile. È quest'ultimo punto a essere sottovalutato: se il tuo server è spento un momento, perdi la notifica.
Due cose da fare subito bene
Rispondi in fretta — elabora il messaggio dopo, non prima. Una conferma lenta porta a tentativi ripetuti.
Aspettati dei duplicati. In caso di problema di rete la stessa notifica può arrivare due volte. Fai in modo che la tua elaborazione lo regga, ad esempio memorizzando l'id del messaggio.
A che cosa servono
Stati di recapito e risposte in entrata. Esattamente le due cose che vuoi sapere non appena accadono.