Для разработчиков
API приёма заявок
Редакция от 23.09.2026
Заявка, отправленная в этот API, становится сделкой в воронке продаж компании. Воронку, источник и ответственного выбирают правила, которые администратор компании настраивает в CRM (Настройки → Формы сайта). Так же работают интеграции через Albato и формы на Тильде.
Ключ
У каждой компании свой ключ. Он в CRM: Настройки → Формы сайта, кнопка «Копировать»
даёт ссылку вида https://api.delovedcrm.ru/api/v1/webforms/<ключ>; ключ — её часть после
/webforms/. Передаётся заголовком:
Authorization: Bearer <ключ>
Вместо заголовка ключ можно поставить в конец адреса: https://api.delovedcrm.ru/api/v1/webforms/<ключ>.
Проверка ключа
GET https://api.delovedcrm.ru/api/v1/webforms
Authorization: Bearer <ключ>
200 {"result": "ok", "company": "Название компании"} Создать заявку
POST https://api.delovedcrm.ru/api/v1/webforms
Authorization: Bearer <ключ>
Content-Type: application/json
{
"name": "Иван Петров",
"phone": "+7 913 123-45-67",
"email": "ivan@example.ru",
"formname": "VK: банкротство",
"tranid": "vk-123456",
"comment": "Долг 800 тыс., 3 кредитора"
}
200 {"result": "ok", "lead_id": 1882} | Поле | Что это |
|---|---|
phone | телефон в любом виде, приводится к +7… |
name | имя, становится названием сделки; нет имени — сделка называется телефоном |
email | почта |
formname | название формы или кампании; по нему правила выбирают воронку и источник |
tranid | id заявки в источнике; повтор с тем же id второй сделки не заводит |
| любое другое | ответы формы; ложатся текстом в ленту сделки |
Тело — плоский JSON или обычная форма (application/x-www-form-urlencoded).
Ответы
- 200 — заявка принята. Даже если сделку собрать не удалось, заявка сохраняется в журнале «Форм сайта» и не теряется.
- 401 — ключа нет или он неверный.
- 403 — доступ компании приостановлен.
- 429 — больше 120 запросов в минуту.
ДелоВед