Вебхук и Woove Site: заявки с сайта в любую систему

JSON с заявкой на ваш адрес: Make, Zapier, Albato, n8n, Google Apps Script, своя разработка

Вебхук с сайта на Woove Site — это HTTP-запрос с данными заявки, записи, заказа или оплаты на любой адрес, который вы укажете. Так сайт подключается к сервисам автоматизации (Make, Zapier, Albato, n8n), к Google Таблицам через Apps Script и к вашей собственной системе без готового коннектора.

Что даёт интеграция

Данные уходят как JSON или как обычная форма, секрет для проверки — в заголовке X-Woove-Secret.

• Заявка с формы — {"event":"lead", name, phone, email, comment, fields, text, page, site}.
• Онлайн-запись — {"event":"booking", booking:{date,time,service,specialist}, …}.
• Новый заказ — {"event":"order", order:{number, sum, items[], delivery, contact}}.
• Оплаченный заказ — {"event":"paid", order:{…, pay_status:"paid"}}.
• Изменение каталога — {"event":"catalog"} при изменении каталога — сигнал забрать фид.

Где взять доступ в Вебхук

1. Make / Zapier / Albato / n8n: создайте сценарий с триггером «Webhook» (Custom webhook) и скопируйте выданный адрес
2. Google Таблицы: Расширения → Apps Script → функция doPost(e) с разбором JSON → «Развернуть как веб-приложение» с доступом «все» → скопируйте адрес
3. Своя система: любой адрес, принимающий POST; проверяйте заголовок X-Woove-Secret
4. Придумайте секрет и вставьте его в карточку — он уйдёт с каждым запросом

Настройка в Woove Site

1. Откройте «Site» в левой панели кабинета и нажмите «Редактировать» у нужного сайта.
2. В панели слева перейдите на вкладку «Сайт» и выберите «Интеграции». Найдите «Вебхук» поиском и нажмите на плитку: под ней раскроется карточка.
3. Включите переключатель и заполните поля из таблицы ниже.
4. В блоке «Когда отправлять» отметьте события и нажмите «Проверить доступ». Под кнопками появится «Доступ есть».
5. Нажмите «Тестовая заявка»: в сервисе появится проверочная заявка Ивана Петрова.
6. Дальше события уходят сами, отправки видны по кнопке «Журнал». Неудачные ждут там же в блоке «Очередь»: мы повторяем их ещё шесть раз за полтора суток, кнопка «Повторить» отправляет сразу. Если ключ не подходит, повтора нет: на почту аккаунта приходит письмо.

• Адрес (https://…) — Полный адрес, который принимает POST-запросы.
• Секрет — Уходит в заголовке X-Woove-Secret: по нему принимающая сторона проверяет запрос. Хранится скрыто, после сохранения показывается точками.
• Формат — Варианты: JSON / form-urlencoded (плоские поля). По умолчанию: «JSON».

Что попадает в Вебхук

В формате JSON приходит объект с полями event, at, site, page, form, name, phone, email, comment. Ещё в нём fields (все поля формы как есть), text (готовый текст), order и booking, если есть. В формате form-urlencoded — плоские поля name, phone, email, comment, page, form, text, field_<имя поля>, order_number, order_sum. Ответ 2xx считается успехом, всё остальное попадает в журнал как ошибка.

«Проверить доступ» отправляет пробный запрос {"event":"test"} и ждёт ответ 2xx. «Тестовая заявка» шлёт заявку про Ивана Петрова со всеми полями.

Если не работает