adsquiz

Webhook

Налаштування інтеграції через Webhook в AdsQuiz

Вебхук – це технологія яка дозволяє автоматично передавати дані з однієї системи до іншої в момент виникнення певної події. Простими словами – це спосіб передати дані з точки А в точку Б без ручного втручання. У випадку з AdsQuiz вебхук спрацьовує щоразу коли користувач відправляє заявку у квізі і автоматично передає всі дані до вказаного сервісу.

Вебхук – це універсальний інструмент який підходить для підключення до будь-якого сервісу що підтримує прийом даних через URL. Якщо потрібного сервісу немає в стандартному списку прямих інтеграцій AdsQuiz – вебхук вирішує цю задачу.

Що передається через вебхук

При кожному отриманні ліда через вебхук автоматично надсилаються:

  • ім’я користувача
  • номер телефону
  • email
  • відповіді на всі питання квіза
  • UTM-мітки для відстеження джерела трафіку

Метод відправки – POST.

📌 Приклад: передача сповіщень про нові ліди до Slack через вебхук

Розберемо налаштування на конкретному прикладі – автоматичне надсилання сповіщень про нові заявки з квіза до каналу Slack. Це зручно якщо команда менеджерів використовує Slack і хоче миттєво отримувати повідомлення про нові ліди без перевірки CRM або пошти. За таким самим принципом можна налаштувати передачу до будь-якого іншого сервісу який підтримує Incoming Webhooks.

⚙️ Крок 1. Відкрийте налаштування інтеграції в AdsQuiz

Перейдіть до: Налаштування квіза → Інтеграції → Webhook.

У полі інтеграції потрібно вставити URL вебхука який ви отримаєте в Slack.

⚙️ Крок 2. Створіть Incoming Webhook в Slack

Відкрийте свій акаунт Slack і перейдіть до налаштувань вашого воркспейсу. Знайдіть розділ Apps і відкрийте «Incoming Webhooks». Якщо додаток ще не підключений – додайте його до вашого воркспейсу.

Після підключення натисніть «Add New Webhook to Workspace». Оберіть канал до якого будуть надходити сповіщення про нові ліди – наприклад #нові-заявки або #ліди-з-квіза.

💡 Порада: Створіть окремий канал в Slack спеціально для сповіщень з квіза – наприклад #leads-quiz. Це дозволить менеджерам бачити нові заявки одразу і не змішувати їх з іншими повідомленнями.

Після підтвердження Slack згенерує унікальний URL вебхука – скопіюйте його.

⚙️ Крок 3. Вставте URL вебхука в AdsQuiz

Поверніться до налаштувань інтеграції в AdsQuiz і вставте скопійований URL вебхука у відповідне поле. Натисніть «Зберегти» і активуйте інтеграцію.

⚙️ Крок 4. Перевірте підключення

У налаштуваннях інтеграції в AdsQuiz натисніть кнопку «Тест» – система повторно надішле одну з останніх 10 заявок до Slack без необхідності проходити квіз заново. Після цього перейдіть до каналу Slack який ви вказали при налаштуванні вебхука і перевірте чи з’явилося повідомлення з даними ліда.

Якщо повідомлення надійшло коректно – інтеграція працює і всі нові заявки з квіза автоматично надсилатимуться до Slack.

💡 Важливо: тестові відправки через кнопку «Тест» не списують баланс лідів – використовуйте цю функцію для перевірки і налагодження інтеграції без обмежень.

⚙️ Крок 5. Налаштуйте формат повідомлення (за потреби)

За замовчуванням Slack отримує дані у стандартному форматі. Якщо потрібно налаштувати більш зручний і читабельний формат повідомлення – наприклад виділити ім’я і телефон жирним або додати emoji для зручності – це можна зробити через налаштування Incoming Webhook в Slack використовуючи Block Kit Builder.

💡 Порада: Навіть базове форматування повідомлення значно спрощує роботу менеджерів. Наприклад можна додати заголовок «Нова заявка з квіза» і виділити контактні дані окремим блоком – так повідомлення читається за секунду.

❓ Поширені питання

Чи можна через один вебхук передавати дані до кількох сервісів одночасно?
Ні – один URL вебхука веде до одного сервісу. Якщо потрібно передавати дані одночасно до кількох сервісів – використовуйте сервіс-конектор як Make або Zapier. Детальніше: Налаштування Make

Які дані передаються через вебхук?
Через вебхук передаються всі дані які користувач залишив у квізі – ім’я, телефон, email, відповіді на всі питання і UTM-мітки. Метод відправки – POST.

Чи потрібні технічні знання для налаштування вебхука?
Базове налаштування – вставити URL і зберегти – не потребує технічних знань. 

Чи безпечно передавати дані лідів через вебхук?
Так. Передача відбувається через захищений HTTPS-протокол. Рекомендуємо не передавати URL вебхука стороннім особам і регулярно оновлювати його якщо є підозра на компрометацію.