Una prenotazione che non arriva al CRM, una pratica creata due volte, un sollecito inviato dopo il pagamento: questi problemi possono dipendere da un'automazione non preparata agli imprevisti. Nel 2026, collegare WordPress, uno strumento di prenotazione e un gestionale non basta. Per una PMI a Nizza o Cannes conta anche un'altra domanda: cosa succede quando la connessione non funziona?

Un webhook è una notifica tra applicazioni

Un webhook permette a un servizio di avvisare un'altra applicazione quando si verifica un evento. Per esempio, una piattaforma di pagamento comunica un incasso al CRM, che aggiorna la scheda del cliente. La notifica arriva generalmente a un indirizzo web predisposto per riceverla.

Il meccanismo sembra semplice. Occorre però distinguere l'evento, la sua consegna e l'azione che attiva. Ricevere una notifica non significa che l'intero processo abbia completato il lavoro.

Confermare la ricezione senza perdere il lavoro da svolgere

A seconda del servizio, una risposta mancante o un errore possono causare un nuovo invio. Tempi e possibilità di recupero variano: nessun comportamento va considerato universale.

Chiedete al vostro fornitore di separare la ricezione dalle operazioni lunghe. Per una notifica valida da elaborare, il sistema dovrebbe prima salvarla in modo persistente e poi confermarne la ricezione secondo le regole del servizio. Una coda può organizzare il lavoro successivo in background. GitHub raccomanda espressamente l'elaborazione asincrona per rispondere rapidamente.

Questa conferma non attesta che il CRM sia stato aggiornato. Se quel passaggio fallisce, il sistema deve conservare l'attività e prevedere un nuovo tentativo. Rispondere immediatamente senza averne garantito il salvataggio rischia di far perdere il lavoro dopo un guasto.

Impedire che una notifica ripetuta crei un duplicato

Shopify documenta l'uso di un identificativo di consegna per riconoscere le notifiche ripetute. Nell'integrazione, scegliete l'identificativo adatto al fornitore e registratene lo stato: ricevuto, in elaborazione, completato o in errore.

Non segnate un'azione come completata appena arriva. Se l'elaborazione si interrompe successivamente, il tentativo seguente potrebbe essere ignorato anche se nulla è stato portato a termine. Richiedete inoltre una protezione contro l'elaborazione simultanea dello stesso evento.

Il comportamento desiderato ha un nome tecnico: idempotenza. Ripetere la stessa operazione deve produrre lo stesso risultato operativo. Una prenotazione già registrata aggiorna quindi la pratica esistente invece di crearne un'altra. Questa protezione deve coprire anche le azioni esterne, come l'invio di un messaggio. Se l'API di destinazione supporta una chiave di idempotenza, usatela secondo la documentazione; altrimenti, prevedete una verifica del risultato prima di ripetere un'azione dall'esito incerto.

Gestire i ritardi e recuperare i dati mancanti

Stripe non garantisce l'ordine di consegna degli eventi. Una vecchia notifica non deve quindi sovrascrivere senza controlli uno stato più recente nel CRM. A seconda dell'API, verificate la versione dei dati oppure consultatene lo stato attuale prima di una modifica delicata.

Shopify raccomanda anche verifiche periodiche tramite API per riconciliare i dati dei due sistemi. Adeguate la frequenza alla vostra attività e ai limiti del servizio. Per esempio, confrontate le prenotazioni confermate con le pratiche presenti nel CRM, poi esaminate le differenze prima di correggerle.

I controlli da richiedere prima della messa in servizio

Testate un'interruzione e il successivo recupero, oltre a una trasmissione riuscita:

  • Inviare nuovamente lo stesso evento senza creare una nuova pratica.
  • Simulare un'indisponibilità del CRM e verificare il recupero.
  • Ricevere un evento vecchio dopo uno più recente.
  • Attivare un avviso quando un'attività rimane bloccata.
  • Verificare l'autenticità delle notifiche con il meccanismo del fornitore, inclusa la firma quando disponibile.

La documentazione GitHub spiega, per esempio, come verificare una firma con un segreto condiviso. I log dovrebbero permettere di ritrovare identificativo, orario, risultato ed eventuale errore, senza copiare inutilmente i dati dei clienti.

Adeguare l'affidabilità alla vostra attività

Un libero professionista a Monaco e un'azienda di prenotazioni nelle Alpi Marittime hanno esigenze diverse. Partite dal flusso il cui fallimento comporterebbe il costo maggiore. NIKAIA.NET può aiutarvi a progettare integrazioni PHP, WordPress e CRM con regole di recupero esplicite e problemi visibili.

Punti da verificare prima della pubblicazione

Rileggere le attuali politiche di consegna e di nuovo tentativo dei fornitori, gli identificativi disponibili, i meccanismi di firma, il supporto delle chiavi di idempotenza e i limiti delle API. Verificare che gli esempi corrispondano ai connettori effettivamente utilizzati.