WooveWoove Connect → API

Приём заявок по API

Заявка с формы на API попадает в CRM, журнал записи, мессенджер или службу доставки без ручного переноса. Подключается адресом вебхука, без программиста.

Завести кабинет 999 ₽ в месяц за связку · проверка бесплатно

Коротко

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

Как это устроено в API

Тело читается как JSON, когда в заголовке Content-Type стоит application/json, иначе разбирается как форма. Ключи объекта становятся именами полей. Вложенные объекты раскладываются в плоский список, а массив пар с подписью и значением превращается в поля с этими подписями. В ответ приходит {"ok": true}. Слать можно и из браузера: заголовки CORS разрешают POST с любого домена.

  1. Отправляйте POST на адрес вебхука из кабинета с JSON-телом: {"Name": "…", "Phone": "…", "Email": "…", "Comment": "…"} и любыми своими полями.

  2. В ответ придёт {"ok": true}. Повторы с одинаковым tranid отбрасываются.

  3. Ошибки настройки видны в списке заявок с причиной.

Ключи JSON — имена полей.

Что здесь обычно ломается

  1. В ответ приходит 404

    Ключ в ссылке не совпадает ни с одной интеграцией. Скопируйте адрес из кабинета заново.

  2. Ответ 413 на большом теле

    Запрос тяжелее 256 КБ не принимается. Длинные вложения в заявку не кладут.

  3. GET вместо POST

    На GET адрес отвечает ok и ничего не создаёт. Так проверяют доступность, но не отправку.

Частые вопросы

Как избежать дублей?

Передавайте свой tranid: запрос с уже принятым номером отбрасывается.

Можно ли проверить настройку без живой заявки?

Да, запрос с единственным полем test записывается как проверочный, наружу он не передаётся.

Что видно, если сервис ответил ошибкой?

Заявка остаётся в кабинете с причиной, и повтор такой отправки не блокируется.

Пошаговая инструкция со скриншотами: настройка API в базе знаний.

Заявки с API без ручного переноса

Подключение бесплатное, черновой режим включён по умолчанию.

Завести кабинет