Verifica la consegna dei webhook e risolvi gli errori.

Leggere il registro di consegna di un endpoint webhook Notiondesk, comprendere i tentativi di ripetizione e le pause, riprendere un endpoint in pausa e correggere le consegne non riuscite.

5 min di lettura

Ogni endpoint conserva un registro delle richieste Notiondesk inviate. Usalo per vedere cosa ha ricevuto il tuo server, perché una richiesta non è andata a buon fine e quando verrà riprovata.

Percorso rapido: vai su Impostazioni > Sviluppatori > Webhooks , apri un endpoint e scorri fino a Consegne recenti . Fai clic su una riga per visualizzare la risposta e il corpo della richiesta.

Leggi le ultime consegne

  1. Vai su Impostazioni > Sviluppatori > Webhooks .
  1. Fare clic sul punto finale.
  1. Scorri fino a Consegne recenti .

L'elenco mostra le ultime 100 consegne degli ultimi 14 giorni. Ogni riga mostra l'evento, il centro assistenza di provenienza (o Workspace ), il risultato e l'ora.

Icona Stato Cosa significa
Spunta verde Consegnato Il tuo server ha risposto con un codice di stato 2xx
Arancione ornamentale In attesa di Non ancora inviato o in attesa del prossimo tentativo. Un tentativo fallito mostra il risultato seguito da riprova , come 503, riprova.
Croce Rossa Fallito Ogni tentativo è fallito. La riga mostra l'ultimo risultato.
Grigio meno Annullato Non inviato perché l'endpoint è stato messo in pausa o spento, oppure il suo centro assistenza non è più in grado di ricevere eventi, prima del prossimo tentativo.

Apri una consegna

Fai clic su una riga per aprirla:

  • ID di consegna : lo stesso valore dell'intestazione X-ND-Delivery, in modo da poter trovare la richiesta nei log del server.
  • Risposta : il codice di stato o il motivo dell'errore, il tempo impiegato dal server e il numero di tentativi effettuati.
  • Corpo della richiesta : il JSON esatto che è stato inviato. Fai clic su Copia per copiarlo.

Il corpo della risposta non viene memorizzato. Per gli eventi che contengono dati personali, come messaggi di contatto, feedback, membri del team e richieste di adesione, il corpo della richiesta viene rimosso al termine dell'invio.

Tentativi

La consegna fallisce quando il server risponde con un codice di stato diverso da 2xx, reindirizza, non inizia a rispondere entro 5 secondi o impiega più di 10 secondi in totale. Notiondesk quindi riprova:

Tentativo Quando
1 Subito
2 1 minuto dopo il primo tentativo
3 10 minuti dopo il secondo tentativo
4 1 ora dopo il terzo tentativo
5 6 ore dopo il quarto tentativo

Dopo 5 tentativi falliti, la consegna viene contrassegnata come non riuscita . Gli eventi di test e le consegne contrassegnate come "Firma non riuscita" non vengono ritentati.

Quando si verificano molti eventi contemporaneamente, ad esempio durante una sincronizzazione di grandi dimensioni, le consegne possono attendere prima di essere inviate: di solito qualche minuto, e fino a un'ora se il server risponde lentamente. Rimangono in stato "In sospeso" e non vengono scartate.

Quando un endpoint è in pausa

Notiondesk mette in pausa un endpoint quando 10 consegne consecutive falliscono dopo tutti i tentativi, e il primo di questi fallimenti risale ad almeno 24 ore prima. Gli eventi di test non vengono conteggiati.

Quando un endpoint è in pausa:

  • Viene visualizzato lo stato "In pausa" e la ricezione degli eventi viene interrotta. I tentativi già pianificati vengono annullati.
  • Il proprietario dello spazio di lavoro e gli amministratori ricevono un'unica email, "Endpoint Webhook sospeso", contenente il nome dell'endpoint, il suo host e un link alle impostazioni del webhook.
  • Gli eventi relativi al periodo di pausa non vengono inviati in seguito.

Per riassumere:

  1. Risolvi il problema del server. I motivi dell'errore nella sezione "Consegne recenti" indicano cosa è andato storto.
  1. Fai clic su Invia evento di prova e verifica che venga visualizzato come Consegnato .
  1. Fai clic su Riprendi .

L'endpoint ricomincia a ricevere nuovi eventi e il conteggio degli errori riparte da zero.

Se il tuo endpoint è ancora attivo ma le consegne continuano a fallire, la pagina dell'endpoint mostra "Fallimenti a partire da" con la data del primo errore, come avviso prima che il servizio venga messo in pausa.

Risolvi i problemi di consegna non riusciti

Quando il server risponde, la riga mostra il codice di stato. Altrimenti, mostra il motivo.

Motivo Ciò che vedi Quello che è successo Come risolverlo
Stati di errore Il codice di stato, come 500 o 401 Il tuo server ha risposto con un errore Controlla i log del tuo server per quel periodo. Assicurati che l'endpoint accetti richieste POST e che il controllo della firma utilizzi il segreto corretto.
Reindirizzamento rifiutato Un codice di reindirizzamento, come 301 o 302 Il tuo server ha reindirizzato la richiesta Inserisci l'URL finale nelle impostazioni dell'endpoint
Indirizzo bloccato Indirizzo bloccato Il tuo dominio punta a un indirizzo privato o interno Puntare il dominio verso un server pubblico
Connessione fallita Connessione fallita Notiondesk non è riuscito a raggiungere il tuo server Verifica che il dominio sia risolvibile, che il certificato TLS sia valido e che la porta 443 o 8443 sia aperta.
Tempo scaduto Tempo scaduto Il tuo server non ha risposto entro 5 secondi oppure ha impiegato più di 10 secondi. Rispondi prima con 200, poi esegui il lavoro in background
Firma non riuscita Firma non riuscita Notiondesk non è riuscito a firmare la richiesta Questo problema dipende da noi e non verrà rifatto. Invia un evento di prova e contattaci se si ripresenta.

Invia un evento di prova

Fai clic su Invia evento di test nella pagina dell'endpoint per inviare un evento ping a tale endpoint. L'evento viene visualizzato nella parte superiore di Consegne recenti .

  • L'evento di test viene inviato una sola volta, senza possibilità di ripetizione.
  • È possibile inviarlo mentre l'endpoint è in pausa, per verificare la correzione prima di riprendere.
  • Ogni area di lavoro può inviare fino a 20 eventi di test all'ora. Oltre tale limite, viene visualizzato il messaggio "Troppi eventi di test. Riprova più tardi."

Domande frequenti

Posso reinviare una consegna non andata a buon fine?

No. Apri la consegna e fai clic su Copia per ottenere il corpo della richiesta, se devi elaborarla autonomamente.

Perché manca il corpo della richiesta di consegna?

L'evento conteneva dati personali, quindi il suo contenuto è stato rimosso al termine della consegna.

Per quanto tempo vengono conservate le consegne?

14 giorni. Le consegne recenti mostrano le ultime 100.

Un evento di test riuscito riprende un endpoint in pausa?

No. Controlla solo il tuo server. Fai clic su Riprendi per ricominciare a ricevere gli eventi.

Cosa succede agli eventi in coda se elimino un endpoint?

Non vengono inviati e il registro di consegna dell'endpoint viene eliminato insieme ad essi.

Articoli correlati

Questa pagina è stata utile?

Still need help? Ask us