Приём заявок по API
Заявка с формы на API попадает в CRM, журнал записи, мессенджер или службу доставки без ручного переноса. Подключается адресом вебхука, без программиста.
Коротко
У API формы нет вообще: заявку отправляет ваш код, будь то сервер сайта, мобильное приложение или бот. Заявку шлёт POST с JSON на адрес вебхука, дальше она проходит тот же путь, что и обычная: разбор полей, защита от повторов, передача в сервис и запись в журнал.
Как это устроено в API
Тело читается как JSON, когда в заголовке Content-Type стоит application/json, иначе разбирается как форма. Ключи объекта становятся именами полей. Вложенные объекты раскладываются в плоский список, а массив пар с подписью и значением превращается в поля с этими подписями. В ответ приходит {"ok": true}. Слать можно и из браузера: заголовки CORS разрешают POST с любого домена.
Отправляйте POST на адрес вебхука из кабинета с JSON-телом: {"Name": "…", "Phone": "…", "Email": "…", "Comment": "…"} и любыми своими полями.
В ответ придёт {"ok": true}. Повторы с одинаковым tranid отбрасываются.
Ошибки настройки видны в списке заявок с причиной.
Ключи JSON — имена полей.
Куда передаём заявки с API
Каждая связка настраивается и оплачивается отдельно. Нажмите, чтобы посмотреть, что именно создаётся в сервисе.
Что здесь обычно ломается
В ответ приходит 404
Ключ в ссылке не совпадает ни с одной интеграцией. Скопируйте адрес из кабинета заново.
Ответ 413 на большом теле
Запрос тяжелее 256 КБ не принимается. Длинные вложения в заявку не кладут.
GET вместо POST
На GET адрес отвечает ok и ничего не создаёт. Так проверяют доступность, но не отправку.
Частые вопросы
Как избежать дублей?
Передавайте свой tranid: запрос с уже принятым номером отбрасывается.
Можно ли проверить настройку без живой заявки?
Да, запрос с единственным полем test записывается как проверочный, наружу он не передаётся.
Что видно, если сервис ответил ошибкой?
Заявка остаётся в кабинете с причиной, и повтор такой отправки не блокируется.
Пошаговая инструкция со скриншотами: настройка API в базе знаний.
Заявки с API без ручного переноса
Подключение бесплатное, черновой режим включён по умолчанию.
Завести кабинет