Webhook для заявок с сайта подходит в тех случаях, когда вы не хотите зависеть от CMS-плагина или у вас кастомная форма. Такой вариант удобен для React, Vue, Tilda, Bitrix, мобильных приложений и серверных интеграций: главное, чтобы клиент умел отправлять POST-запрос с JSON.

Если говорить проще, webhook позволяет передавать лиды с сайта напрямую в Ordercore по HTTP. Это хороший выбор для разработчиков, которым нужен контроль над структурой данных, дополнительной валидацией, UTM-метками и собственными бизнес-правилами.

Когда webhook лучше плагина

Webhook особенно полезен, если:

• сайт не на WordPress
• форма собирается на фронтенде и отправляется через JavaScript
• логика обработки идет через собственный бэкенд
• нужно добавлять дополнительные поля: источник трафика, страница заявки, продукт, менеджер, теги

Для WordPress-сайтов с типовыми формами быстрее бывает подключить плагин, но для нестандартных проектов webhook почти всегда гибче.

URL и формат запроса

В личном кабинете вы получаете персональный URL вида `https://api.ordercore.ru/webhook/ВАШ_КЛЮЧ`. Актуальный хост и требования лучше сверять с текущей документацией проекта. Базовая схема запроса такая:

• метод **POST**
• заголовок `Content-Type: application/json`
• тело запроса в формате JSON

Какие поля передавать в JSON

Минимальный полезный набор для обработки лидов обычно включает:

• **name**
• **phone**
• **email**
• **message**

Дополнительно стоит передавать технические и маркетинговые данные: страницу отправки, UTM-метки, название услуги, идентификатор формы, источник трафика. Это помогает менеджерам быстрее понимать контекст заявки и строить отчеты по рекламе.

Пример отправки webhook на JavaScript

fetch("https://api.ordercore.ru/webhook/YOUR_KEY", {
  method: "POST",
  headers: { "Content-Type": "application/json" },
  body: JSON.stringify({
    name: "Иван Иванов",
    phone: "+7 999 123-45-67",
    email: "ivan@example.com",
    message: "Хочу узнать о ваших услугах",
    source: "landing-page",
  }),
});

Как сделать интеграцию безопаснее

Если форма отправляется прямо из браузера, следите за тем, чтобы ключ и домен использовались корректно. Во многих проектах надежнее отправлять заявку не напрямую с client-side кода, а через собственный бэкенд, где можно добавить проверку данных, защиту от спама и логирование.

Сервер Ordercore сопоставляет домен запроса с доменом, указанным в настройках ключа. Поэтому важно добавить именно тот origin, с которого реально уходит форма или серверный запрос.

Что проверить, если заявки не доходят

• правильный ли URL webhook используется на сайте
• совпадает ли домен с разрешенным в настройках ключа
• не режет ли запросы хостинг, firewall или CORS-настройка
• приходит ли JSON в ожидаемом формате
• нет ли ошибок в браузерной консоли или серверных логах

FAQ по webhook

Можно ли использовать webhook для формы обратной связи?

Да, это один из самых частых сценариев.

Подойдет ли для Tilda или кастомного лендинга?

Да, если можно отправить HTTP POST с нужными полями.

Что лучше для SEO и скорости обработки лидов: почта или webhook?

Для индексации сайта это не влияет напрямую, но webhook помогает быстрее принимать и обрабатывать лиды, а значит улучшает бизнес-эффект от поискового трафика.

См. также

• [Почему заявкам нужен отдельный канал](vydeleyte-kanal-dlya-zayavok)
• [Как ускорить уведомления о новой заявке](push-uvedomleniya-v-realnom-vremeni)