Типовые кейсы использования REST API в CRM и туториалы
Выберите инструмент для разработки с AI-агентом:
- используйте Битрикс24 Вайбкод, чтобы создать приложение для Битрикс24 по описанию задачи без знания языков программирования. Агент напишет код и разместит приложение на сервере без ручной настройки хостинга
- используйте MCP-сервер, чтобы разрабатывать интеграцию через REST API в своем проекте. Агент будет обращаться к официальной REST-документации
Справочник CRM описывает отдельные методы, а туториалы показывают, как собрать из них рабочий сценарий: в каком порядке вызывать методы, какие идентификаторы передавать между запросами и что проверить в результате.
Туториалы сгруппированы по пяти направлениям. Выберите направление по задаче, а внутри — туториал по конкретному случаю. Обзор направлений с таблицей частых сценариев собран на странице CRM: типовые сценарии.
Быстрый переход: все сценарии
Пользовательская документация: Как начать работать с CRM в Битрикс24
Сценарии по направлениям
Добавить данные
Сценарии создают лиды, контакты, компании, сделки, дела, документы и элементы смарт-процессов, а также привязывают к ним реквизиты, адреса и товарные позиции. Основные группы методов: crm.lead.*, crm.contact.*, crm.company.*, crm.deal.*, crm.item.*, дела и реквизиты. Обзор направления — Как добавить данные в CRM: обзор кейсов и сценариев.
|
Если нужно |
Откройте |
|
Принять заявку с формы сайта и создать лид |
|
|
Создать лид по клиенту, который уже обращался |
|
|
Создать контакт по данным с формы сайта |
|
|
Создать компанию по данным с формы сайта |
|
|
Создать сделку и компанию с выбором реквизитов |
|
|
Принять заявку с вложенными файлами |
|
|
Создать контакт вместе с реквизитами и адресом |
|
|
Создать компанию вместе с реквизитами и адресом |
|
|
Завести поставщика для складских документов |
|
|
Создать дело с учетом режима CRM — простого или классического |
Добавить дело в новый лид или сделку в зависимости от режима CRM |
|
Запланировать встречу или событие календаря по клиенту |
|
|
Отправить письмо клиенту от имени сотрудника |
|
|
Собрать документ по шаблону — счет, договор или акт |
|
|
Написать комментарий в таймлайн смарт-процесса |
|
|
Добавить свое поле в смарт-процесс |
|
|
Задать округление числового поля |
Как настроить округление для пользовательского поля типа «Число» |
|
Создать воронку и стадии в смарт-процессе |
|
|
Добавить в объект CRM товары со скидками и налогами |
Редактировать данные
Сценарии обновляют поля карточки, телефоны и email, переносят дела между объектами и записывают дату оплаты в поле сделки. Основные группы методов: crm.item.*, crm.lead.*, crm.contact.*, crm.company.*, crm.deal.* и дела. Обзор направления — Редактирование данных в CRM.
|
Если нужно |
Откройте |
|
Дать сотруднику веб-форму для создания и правки лида |
|
|
Дать веб-форму для создания и правки контакта |
|
|
Дать веб-форму для создания и правки компании |
|
|
Дать веб-форму для сделки с выбором воронки и стадии |
|
|
Изменить или удалить телефон и email клиента |
|
|
Сдвинуть срок и напоминания у запланированного дела |
|
|
Перенести дело в другой элемент того же типа |
|
|
Перенести дело в объект другого типа |
|
|
Перенести дату из платежа в поле сделки |
Получить списки
Сценарии находят дубли, получают дела, стадии, воронки, адреса и поставщиков, фильтруют элементы по стадии. Основные группы методов: crm.duplicate.*, crm.status.*, crm.category.*, crm.item.* и реквизиты. Обзор направления — Получение списков в CRM.
|
Если нужно |
Откройте |
|
Проверить перед созданием, есть ли уже такой клиент в CRM |
|
|
Получить адрес клиента из реквизитов |
|
|
Получить стадии объекта вместе с их семантикой |
|
|
Получить воронки сделок со стадиями |
|
|
Отобрать элементы, которые стоят на нужной стадии |
|
|
Собрать дела по сделкам сотрудника |
|
|
Отобрать контакты и компании с признаком поставщика |
Сквозная аналитика
Сценарии передают источник обращения и маршрут клиента в CRM через UTM-поля, поле TRACE или отдельный трейс. Основные группы методов: CRM-трекинг и методы создания объектов CRM. Обзор направления — Сквозная аналитика в CRM: типовые сценарии.
|
Если нужно |
Откройте |
|
Выбрать способ передачи данных — UTM-поля, |
|
|
Передать источник обращения при создании лида |
|
|
Связать контакт и сделку с одним трейсом |
Виджеты в CRM
Сценарии встраивают интерфейс приложения в карточку CRM — через пользовательское поле или отдельную вкладку. Основные группы методов: виджеты и пользовательские типы полей. Обзор направления — Как встраивать виджеты в CRM.
|
Если нужно |
Откройте |
|
Показать приложение внутри поля карточки лида |
|
|
Добавить в карточку CRM свою вкладку |