Configura webhook di testimonianze in uscita
Connetti un endpoint di ricezione e comprendi gli attuali formati di consegna di test e raccolta.
Aggiornato
Dashboard Socialjuice attuale con dati di esempio. Le etichette seguono la lingua della dashboard.
In questa pagina
Preparare un endpoint di ricezione
I webhook inviano informazioni sulle nuove testimonianze dai percorsi di creazione supportati a un altro servizio. Hai bisogno di un piano con webhook, autorizzazione per modificare lo spazio e un ricevitore HTTPS raggiungibile pubblicamente. L'host locale, i nomi host locali e gli indirizzi di rete privata non sono supportati dalla convalida dell'URL del dashboard.
Per Zapier o Make, crea prima un trigger webhook di ricezione e copia il relativo URL HTTPS. Non connettere un'automazione rivolta al cliente finché non avrai controllato il carico utile reale e le intestazioni di autenticazione che riceverà.
Salva e prova la connessione
- Apri Webhook nella barra laterale. Si apre Impostazioni area di lavoro → Avanzate.
- Inserisci l'URL del webhook e scegli Salva impostazioni webhook. Archivia il segreto di firma generato in modo sicuro sul tuo server ricevente. Non inserirlo mai nel codice del browser, negli screenshot o nei registri pubblici.
- Scegli Invia evento di prova. Il dashboard invia un evento webhook.test firmato. Verificare che il ricevitore restituisca una risposta 2xx.
- Esaminare la richiesta prima di mappare i campi. Un test del dashboard riuscito verifica la richiesta di test firmata; Le consegne tramite modulo di ritiro attualmente utilizzano un formato diverso, descritto di seguito.
Comprendere i due formati di consegna attuali
Gli eventi di test del dashboard utilizzano una busta firmata HMAC con i campi ID, tipo, creato e dati. Le intestazioni includono Socialjuice-Event, Socialjuice-Delivery, Socialjuice-Timestamp e Socialjuice-Signature. Un evento di creazione firmato utilizza testimonial.created; il test del dashboard utilizza webhook.test.
Il servizio di raccolta corrente invia il segreto configurato in X-Webhook-Secret su HTTPS. Non allega le intestazioni HMAC o la busta firmata. I payload di raccolta possono contenere campi testimonianza direttamente o all'interno di un oggetto testimonianza, a seconda del percorso di raccolta. Ispeziona una richiesta effettiva prima di mappare nome, email, uuid e contenuto della testimonianza. Non dare per scontato che il payload del test del dashboard corrisponda a una raccolta reale.
Autentica e gestisci entrambi i formati
Per le richieste firmate, verifica HMAC SHA-256 su <timestamp>.<raw_request_body>, confronta il digest in tempo costante e rifiuta i timestamp obsoleti. Per le richieste di raccolta, confronta X-Webhook-Secret con il segreto configurato sul tuo server. Rifiuta una richiesta che non supera l'autenticazione richiesta per il suo formato.
Il formato segreto condiviso non fornisce il timestamp e la protezione dalla riproduzione dell'ID di consegna degli eventi firmati. Deduplica le richieste di ritiro con il testimonial uuid nel contesto dello spazio corretto quando disponibile. Per gli eventi firmati, utilizzare Socialjuice-Delivery o l'ID della busta. Passa solo i campi cliente necessari per il tuo flusso di lavoro a valle.
Limiti di consegna e risoluzione dei problemi
Restituisci tempestivamente una risposta 2xx. Il mittente del dashboard firmato effettua fino a tre tentativi totali, con un timeout di 10 secondi per tentativo. Il mittente della raccolta corrente effettua una singola richiesta senza quel ciclo di tentativi. Non dare per scontato che i tentativi firmati del mittente si applichino alle consegne tramite modulo di ritiro.
Se lo strumento di ricezione non è in grado di convalidare l'intestazione richiesta, esegui un passaggio di verifica sul tuo server prima di attivare azioni sensibili. Un webhook indica la creazione, non una nuova concessione del consenso alla pubblicazione. Esamina la visibilità pubblica e il consenso separatamente.
Ruota o disabilita la connessione
Se il segreto viene esposto, utilizza Ruota segreto e aggiorna immediatamente tutti i ricevitori. Ciò modifica il segreto utilizzato da entrambi i formati di consegna. Per disabilitare la consegna, cancella l'URL del webhook e salva. Mantieni il vecchio segreto fuori dai registri e dagli screenshot pubblici.