Webhook pošle data na URL, kterou si zvolíte, ve chvíli, kdy se něco stane, například když se někdo zaregistruje nebo získá výhru. Systém, který data přijímá, nastaví váš vývojář. Webhooky jsou součástí tarifu Basic a vyšších.
Přidání webhooku
Webhooky můžete přidat ke kampani, v editoru pod Připojit > Webhooky, nebo pro celý účet v Nastavení > Webhooky.
- Klikněte na Přidat webhook.
- Zadejte URL pro payload. Musí používat HTTPS.
- Zvolte Typ obsahu: application/json nebo application/x-www-form-urlencoded.
- Zvolte Metoda: POST nebo GET. Používejte POST, pokud váš systém nepotřebuje GET, který posílá data v URL.
- Zadejte Tajný klíč pro podepisování požadavků (doporučeno).
- V části Které události mají spustit webhook? zvolte události:
- „Když je vytvořen nový lead“ (na úrovni účtu)
- „Pokaždé, když se lead zúčastní kampaně“
- „Když lead získá výhru“
- Ujistěte se, že je zapnuté Aktivní, a uložte.
V editoru kampaně můžete také v části Ověření zvolit Basic Auth a pomocí Vlastní payload si sami určit názvy polí.
Co se odesílá
Tělo obsahuje event a objekt data s kampaní (id a název), poli leadu, kanálem, souhlasy s textem, časem a IP adresou, odpověďmi v kvízu a u výherců s výhrou a jejím kódem. Prázdné hodnoty se vynechávají.
Ověření podpisu
Pokud nastavíte tajný klíč, má každý požadavek hlavičku X-Hub-Signature: sha1= a za ním HMAC-SHA1 dat zakódovaných do JSON, s vaším tajným klíčem jako klíčem. Spočítejte totéž na své straně a porovnejte, abyste měli jistotu, že požadavek přišel ze Scratcheru.
Doručení a opakované pokusy
Pokud vaše URL neodpoví nebo vrátí chybu, Scratcher to zkusí ještě dvakrát: po 5 sekundách a po minutě. Kliknutím na Zobrazit doručení uvidíte každý požadavek a odpověď, můžete zobrazit jen neúspěšné a doručení zopakovat pomocí Zkusit znovu. Doručení se uchovávají 60 dní.
Zapněte Zaznamenávat tělo odpovědi, aby se ukládalo i to, co váš systém odpověděl. To pomáhá při ladění.