Вебхуки

Вебхук — найшвидший спосіб передати відповідь форми у вашу систему. Не потрібно постійно питати «чи є щось нове?» — Gatherino викликає ваш ендпоінт одразу після надходження відповіді.

Варто знати: редактор і обліковий запис Gatherino доступні англійською або чеською мовами. Форми, які заповнюють ваші респонденти, можна показувати 18 мовами, зокрема українською.

Типові сценарії

Запис у власну систему

Замовлення одразу до вашого магазину, лід до CRM, заявка до внутрішньої бази даних.

Підключення інструментів автоматизації

Вкажіть вебхук на будь-який сервіс, який приймає вхідні вебхуки, зокрема Zapier, Make або n8n.

Власні сповіщення

Повідомлення у внутрішній чат, SMS-шлюз або вашу власну панель керування.

Як налаштувати

  1. 1

    Підготуйте ендпоінт

    URL на вашому сервері, який приймає HTTPS POST-запит з тілом у форматі JSON.

  2. 2

    Додайте URL до форми

    Вставте URL вебхука в налаштуваннях форми або використайте крок вебхука всередині автоматизації.

  3. 3

    Обробіть дані

    Тіло запиту містить відповідь, зокрема значення полів. Ключі — це ідентифікатори полів форми; їхні назви отримайте з даних про форму через REST API.

  4. 4

    Перевірте роботу

    Надішліть тестову відповідь і переконайтеся, що ваша система отримала та обробила запит.

Приклад приймача (Node.js)

Мінімальний приймач, який зберігає відповідь на вашому боці:

app.post('/gatherino-hook', express.json(), (req, res) => {
  const submission = req.body;
  // submission.data holds the form field values
  saveToDatabase(submission);
  res.sendStatus(200);   // respond fast, do the work in the background
});

Безпека: вебхуки надсилаються лише на публічні HTTPS-адреси. Виклики до внутрішніх і приватних діапазонів IP блокуються, тож вебхук не можна використати для сканування вашої внутрішньої мережі. Захистіть ендпоінт секретним токеном у URL і перевіряйте, чи відповідають дані запиту очікуваній структурі.

Часті питання

У якому форматі передаються дані?

JSON із описом відповіді: ідентифікатор, мітка часу, статус і об’єкт зі значеннями полів.

Що робити, якщо мій сервер тимчасово недоступний?

Швидко приймайте запит і передавайте обробку у фонове завдання. Дані завжди можна дозавантажити через REST API.

Чи можна мати кілька вебхуків?

Так. Окрім вебхука на рівні форми, ви можете додавати кроки вебхука в автоматизаціях з умовами.

Чи працює це із Zapier або Make?

Так, просто вставте у форму вхідний URL вебхука, який згенерують ці сервіси.

Схожі матеріали

Спробуйте Gatherino безкоштовно

Безкоштовний тариф: 3 форми та 100 відповідей на місяць. Банківська картка не потрібна, дані зберігаються в ЄС.

Почніть безкоштовно →