Il webhook non viene consegnato correttamente? Confronta log di invio e ricezione prima di ripetere l’evento.
Indice dei contenuti
WooCommerce webhook delivery failed: significato
La richiesta non raggiunge il destinatario o fallisce il controllo TLS. Il destinatario rifiuta la firma o restituisce un errore. Il tempo di risposta supera quello disponibile al mittente.
Sintomi e cause probabili
Sintomi da verificare
- Il messaggio “WooCommerce webhook delivery failed” compare durante un’operazione ripetibile.
- La funzione coinvolta in WooCommerce non raggiunge il risultato previsto.
- Il log dell’area WooCommerce registra un evento nello stesso minuto della prova.
- Il comportamento osservato in WooCommerce cambia in base a utente, rete, file o configurazione.
Cause probabili
- La richiesta non raggiunge il destinatario o fallisce il controllo TLS.
- Il destinatario rifiuta la firma o restituisce un errore.
- Il tempo di risposta supera quello disponibile al mittente.
Diagnosi passo per passo
- Aprire il delivery log del webhook
- Annotare status durata e risposta
- Verificare DNS e TLS dell’endpoint
- Riprodurre con un evento di test
- Controllare log del sistema destinatario
Log e dati da controllare
- WooCommerce > Stato > Log
- note ordine e Action Scheduler
- PHP error_log e DevTools
Correzioni sicure
- Annota URL, orario, stato HTTP e risposta del destinatario.
- Correggi rete, TLS o verifica della firma secondo l’errore; non disattivare i controlli SSL.
- Il ricevente deve acquisire l’evento in modo affidabile prima di confermarlo e gestire consegne duplicate.
- Verifica anche l’elaborazione finale: una risposta accettata dal mittente non prova che l’ordine sia stato aggiornato nel sistema remoto.
Verifica finale
- L’evento arriva e viene elaborato una sola volta dal sistema destinatario.
- Confronta il risultato con la prova iniziale e conserva gli eventuali errori rimasti.
Errori da evitare
- Non disattivare globalmente WAF, ModSecurity, antispam o verifica TLS per aggirare il sintomo
- Non impostare permessi 777 e non cambiare proprietari in modo ricorsivo senza conoscere la struttura dell’account
- Non cancellare database, chiavi Redis, cache o file di sistema senza backup e senza aver identificato l’oggetto coinvolto
- Non ripetere pagamenti, import o webhook reali finché non hai verificato l’idempotenza
Guide Xlogic correlate
- WooCommerce REST API: firma non valida
- WooCommerce Action Scheduler: coda bloccata
- WooCommerce: webhook delivery failed 401
Fonti tecniche
Domande frequenti
Che cosa significa “WooCommerce webhook delivery failed”?
Il webhook non viene consegnato correttamente? Confronta log di invio e ricezione prima di ripetere l’evento.
Da cosa può dipendere “WooCommerce webhook delivery failed”?
La richiesta non raggiunge il destinatario o fallisce il controllo TLS. Il destinatario rifiuta la firma o restituisce un errore. Il tempo di risposta supera quello disponibile al mittente.
Quali controlli eseguire per “WooCommerce webhook delivery failed”?
Annota URL, orario, stato HTTP e risposta del destinatario. Correggi rete, TLS o verifica della firma secondo l’errore; non disattivare i controlli SSL. Il ricevente deve acquisire l’evento in modo affidabile prima di confermarlo e gestire consegne duplicate. Verifica anche l’elaborazione finale: una risposta accettata dal mittente non prova che l’ordine sia stato aggiornato nel sistema remoto.