Ripristinare gli invii webhook dopo un’interruzione

Il recupero del ricevitore richiede due operazioni distinte: riaprire gli invii futuri e decidere quali eventi storici non riusciti debbano essere reinviati. Riattivare un endpoint non svuota la sua coda di eventi già conclusi con errore.

Passaggi

1. Ripristina il ricevitore HTTPS pubblico e verifica che possa convalidare la chiave segreta di firma attuale, salvare un evento in modo persistente e rispondere con 2xx entro il limite di dieci secondi di dosya.
2. In Integrazioni → Webhook, trova l’endpoint. Un incidente prolungato mostra Disattivata automaticamente dopo errori ripetuti, il numero di tentativi non riusciti, l’ora di disattivazione e Riattiva.
3. Mentre l’endpoint è ancora disattivato, scegli Invia un evento di prova. La procedura di test invia una richiesta firmata reale anche quando active è false; apri Invii e attendi che la nuova riga mostri Completato, senza affidarti alla notifica di accodamento.
4. Scegli Riattiva solo dopo questa verifica. L’aggiornamento azzera consecutive_failures e disabled_at, ma non cambia gli invii già contrassegnati Errore.
5. Esamina le righe storiche dalla più recente e scegli Invia di nuovo solo per gli eventi di cui il ricevitore ha ancora bisogno. Ogni reinvio ha un nuovo ID di invio ma conserva ID evento e payload originali, quindi la deduplicazione per ID evento deve essere attiva.
6. Genera un evento controllato tra quelli sottoscritti e verifica il normale stato Completato. Conferma una volta lo stato ripristinato e documenta gli eventuali eventi non riusciti lasciati intenzionalmente senza reinvio.

Un invio riceve al massimo sei tentativi: quello iniziale e poi quelli previsti dopo 30 secondi, 2 minuti, 10 minuti, 1 ora e 6 ore. Quindici tentativi consecutivi non riusciti su un endpoint lo disattivano. Un successivo controllo di stato ogni dieci minuti segna le righe ancora in attesa di quell’endpoint come non riuscite con endpoint auto-disabled after sustained delivery failure. Ogni controllo esamina al massimo 50 endpoint non funzionanti: un incidente esteso può richiedere passaggi successivi prima che tutte le code degli endpoint disattivati raggiungano uno stato finale.

Risultato previsto

Il ricevitore riparato supera un test controllato prima che l’endpoint riprenda il traffico futuro. La riattivazione azzera i contatori dell’incidente e gli eventi storici scelti manualmente vengono recuperati senza modifiche duplicate a valle.

Una riga non riuscita resta tale dopo la riattivazione. È previsto. Usa Invia di nuovo per l’evento specifico dopo averne controllato l’effetto.

Il test riesce ma i nuovi eventi non arrivano. Verifica che la scheda sia Attiva, che gli indicatori degli eventi previsti restino selezionati e che l’azione che li genera sia avvenuta nello stesso spazio di lavoro.

Guide correlate

• Verificare le firme webhook
• Controllare gli invii