API и Woove Connect: заявки с форм в CRM и мессенджеры

API: как отправлять заявки в amoCRM, Битрикс24, Telegram, GetCourse и другие сервисы через Woove

API Woove Connect — это приём заявок POST-запросом с JSON из вашего кода: сервер, мобильное приложение, чат-бот. Заявка проходит тот же путь, что и с формы: разбор полей, защита от повторов, передача в сервис и журнал.

Как это работает

У каждой интеграции в кабинете свой адрес вебхука. Платформа отправляет на него данные формы, Woove разбирает поля и передаёт заявку в сервис. Ответ сервиса виден в заявке.

Адрес выглядит так: https://woove.ru/hook/<платформа>/<ваш ключ>. Ключ в нём секретный.

Настройка в API

1. В кабинете откройте «Connect» и нажмите «Открыть» у нужной интеграции. Если её ещё нет, нажмите «Подключить».
2. На вкладке «Настройка» в поле «Источник заявок» выберите «API» и нажмите «Скопировать».
3. Отправляйте POST на адрес вебхука из кабинета с JSON-телом: {"Name": "…", "Phone": "…", "Email": "…", "Comment": "…"} и любыми своими полями.
4. В ответ придёт {"ok": true}. Повторы с одинаковым tranid отбрасываются.
5. Заявка с ошибкой настройки появится на вкладке «Заявки» со статусом «Не разобрано» и причиной.

Пример запроса

curl -X POST https://woove.ru/hook/<платформа>/<ваш ключ> \
  -H 'Content-Type: application/json' \
  -d '{"Name":"Иван Петров","Phone":"+7 999 123-45-67","Email":"ivan@example.com","Comment":"Перезвоните после 18","tranid":"order-1001"}'

Коды ответа и разбор JSON

Тело читается как JSON, если в заголовке Content-Type указан application/json. Иначе Woove разбирает его как форму.

Вложенный JSON разворачивается в плоские поля. Массив пар с подписью и значением превращается в поля с этими подписями.

Запрос можно отправлять из браузера: заголовки CORS разрешают POST с любого домена.

Поля _redirect, _thanks, _source и _gotcha служебные, в заявку они не попадают. Запрос с одним полем test записывается как проверочный и в сервис не уходит.

• 200 {"ok":true} — заявка принята
• 404 unknown hook — ключа из адреса нет ни у одной интеграции
• 413 too large — тело запроса больше 256 КБ
• GET на адрес вебхука — отвечает ok, заявку не создаёт

Поля заявки

Имя, телефон, почту и комментарий мы находим по именам name, phone, email, comment и их русским подписям. Поле с другим именем впишите в «Поля формы» в настройках интеграции. Остальные поля приходят как есть.

Как проверить

Отправьте заявку с формы и откройте интеграцию в «Connect», вкладку «Заявки». Пока включён черновой режим, разобранная заявка получает статус «Черновик» и в сервис не уходит. При статусе «Не разобрано» причина указана в карточке заявки.

Новая интеграция начинает работу в черновом режиме. Чтобы заявки уходили в сервис, на вкладке «Настройка» в блоке «Проверка и запуск» выключите «Черновой режим» и нажмите «Сохранить». Выключить его можно в 14 пробных дней после подключения или после оплаты.

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