Risolvere i problemi di consegna del webhook
Diagnostica le differenze tra test e raccolta, errori di autenticazione, timeout e lavoro duplicato.
Aggiornato
In questa pagina
Il test funziona ma la raccolta reale no
La dashboard invia una busta webhook.test firmata. L'attuale servizio di raccolta invia X-Webhook-Secret e un corpo diverso, senza le intestazioni HMAC. Un destinatario che accetta solo il formato dashboard rifiuterà le richieste di ritiro.
Esamina le intestazioni e il corpo effettivi della richiesta nella cronologia delle richieste private del destinatario. Configurare l'autenticazione e la mappatura dei campi appropriate per ciascun formato supportato. I campi di raccolta possono trovarsi al livello più alto o all'interno di un oggetto testimoniale. Non pubblicare campi cliente privato durante il debug.
Nessuna richiesta raggiunge il tuo destinatario
- Verifica che l'URL del webhook sia stato salvato nello spazio corretto e che il piano del proprietario includa i webhook.
- Utilizza un endpoint pubblico HTTPS che accetta POST. Controlla le regole del firewall, i requisiti di accesso e l'ortografia dell'URL.
- Scegli Invia evento di prova e controlla la cronologia del ricevitore. Una richiesta consegnata con un passaggio successivo del flusso di lavoro non riuscito è un problema diverso dall'assenza di richiesta in arrivo.
- Restituisci tempestivamente una risposta 2xx. Il mittente del dashboard firmato scade dopo 10 secondi ed effettua fino a tre tentativi totali. Le richieste di raccolta attualmente non utilizzano lo stesso ciclo di tentativi.
L'autenticazione fallisce
Per gli eventi firmati, verifica i byte della richiesta non elaborata prima di analizzare JSON, utilizza HMAC SHA-256, controlla il segreto corrente e convalida il timestamp. Un segreto ruotato o un orologio del server errato possono interrompere la verifica.
Per le richieste di raccolta, convalidare X-Webhook-Secret rispetto al segreto attualmente configurato. Non provare a trovare Socialjuice-Signature in questo formato e non disabilitare mai l'autenticazione per far funzionare un'automazione.
Lavoro ripetuto o mancante
Deduplica le richieste firmate con Socialjuice-Delivery o l'ID busta. Le richieste di ritiro necessitano di un identificatore di testimonianza stabile, come uuid, ove disponibile. Conferma che l'automazione non sia in esecuzione una volta per il test di connessione e un'altra per un invio reale.
Nessuno dei due percorsi di consegna rappresenta una coda illimitata o una garanzia di eventuale consegna. Dopo aver corretto il ricevitore, invia un altro test del dashboard e controlla separatamente il formato appropriato. Le recensioni importate e altri percorsi di creazione potrebbero non emettere lo stesso evento; ispezionare il percorso specifico piuttosto che assumere una copertura universale.
Chiedi aiuto con le prove oscurate
Invia al supporto l'ora approssimativa, lo spazio interessato, il formato di consegna, lo stato della risposta e un messaggio di errore oscurato. Includi un ID di consegna per gli eventi firmati, se disponibile. Non includere mai il segreto di firma, il valore X-Webhook-Secret, i token di accesso o i dettagli di contatto privati del cliente.