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.
Leggi le ultime consegne
- Vai su Impostazioni > Sviluppatori > Webhooks .
- Fare clic sul punto finale.
- 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:
- Risolvi il problema del server. I motivi dell'errore nella sezione "Consegne recenti" indicano cosa è andato storto.
- Fai clic su Invia evento di prova e verifica che venga visualizzato come Consegnato .
- 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.