Un webhook invia dati a un URL che scegli tu nel momento in cui succede qualcosa, per esempio quando qualcuno si iscrive o vince un premio. Il sistema che li riceve lo configura il tuo sviluppatore. I webhook sono inclusi dal piano Basic in su.
Aggiungi un webhook
Puoi aggiungere webhook a una campagna, nell'editor in Collega > Webhook, oppure per tutto il tuo account in Impostazioni > Webhook.
- Clicca su Aggiungi webhook.
- Inserisci l'URL del payload. Deve usare HTTPS.
- Scegli il Tipo di contenuto: application/json o application/x-www-form-urlencoded.
- Scegli il Metodo: POST o GET. Usa POST, a meno che il tuo sistema non richieda GET, che invia i dati nell'URL.
- Inserisci un Secret per firmare le richieste (consigliato).
- Scegli gli eventi in Quali eventi devono attivare il webhook?:
- "Quando viene creato un nuovo lead" (a livello di account)
- "Ogni volta che un lead partecipa a una campagna"
- "Quando un lead vince un premio"
- Assicurati che Attivo sia attivato e salva.
Nell'editor della campagna puoi anche scegliere Basic Auth in Autenticazione e usare Payload personalizzato per decidere tu i nomi dei campi.
Cosa viene inviato
Il corpo contiene un event e un oggetto data con la campagna (id e nome), i campi del lead, il canale, i consensi con testo, orario e indirizzo IP, le risposte ai quiz e, per i vincitori, il premio con il suo codice. I valori vuoti vengono omessi.
Verifica la firma
Se imposti un secret, ogni richiesta ha un header X-Hub-Signature: sha1= seguito da un HMAC-SHA1 dei dati codificati in JSON, con il tuo secret come chiave. Calcola lo stesso valore dal tuo lato e confrontali, per essere sicuro che la richiesta arrivi da Scratcher.
Consegne e nuovi tentativi
Se il tuo URL non risponde o restituisce un errore, Scratcher riprova altre due volte: dopo 5 secondi e dopo un minuto. Clicca su Mostra consegne (o Vedi consegne) per vedere ogni richiesta e risposta, mostrare solo quelle non riuscite e usare Riprova su una consegna. Le consegne vengono conservate per 60 giorni.
Attiva Registra il corpo della risposta per salvare anche la risposta del tuo sistema, utile per il debug.