Bitrix24 · Рабочие сценарии
CRM, поля и отчёты
Начните с accounts_list и account_capabilities, получите справочники выбранного портала, затем прочитайте нужные источники и вызовите конкретную рабочую операцию. При нескольких порталах передавайте account_id.
Лиды, сделки, контакты, компании и смарт-процессы имеют отдельные инструменты. В простом режиме CRM лиды недоступны. Перед запросом получите режим CRM, типы объектов, поля, воронки и стадии конкретного портала.
Для пользовательских полей используйте оригинальное имя UF_*. Неоднозначная подпись требует выбора кода. Перечисления принимают ID вариантов, множественные поля — массив. Неизвестные поля и неподдерживаемые условия отклоняются.
История входа в этап включает повторные входы за [since, until); текущая стадия не ограничивает историческую выборку. Выручка группируется отдельно по валютам, без умножения суммы на число контактов. Проверяйте is_complete, truncated и границы доступа. Стадия сделки выбирается вместе с воронкой: categoryId и stageId. У лидов воронок нет — передавайте stageId без categoryId. Массовые операции возвращают результат каждого элемента; неизвестный результат записи сначала проверяйте по карточке.
Пример запроса
Покажи, какие сделки входили в этап согласования за прошлый месяц, включая повторные входы. Сначала проверь справочники портала и покажи полноту выборки.
Инструменты раздела · 70
Доступность операции зависит от возможностей портала, разрешений приложения и прав сотрудника.
accounts_list— Разрешённые порталы Bitrix24 и account_id. Чтение.account_get— Информация о подключённом портале и текущем пользователе. Чтение.account_capabilities— Сначала получите режим CRM, scopes и доступные методы портала. Чтение.account_list_users— Список сотрудников, доступных авторизованному пользователю. Чтение.users_map— Справочник сотрудников и идентификаторов. Чтение.crm_types_list— Системные типы и настроенные смарт-процессы. Чтение.crm_fields_list— Метаданные полей выбранного типа. Сначала получите поля, затем стройте фильтр или запись. Чтение.pipelines_list— Воронки выбранного типа CRM. Чтение.stages_list— Стадии типа CRM и выбранной воронки. Чтение.leads_list— list: leads Bitrix24. Лиды и сделки являются разными сущностями. Для смарт-процессов передайте entity_type_id. Чтение.leads_get— get: leads Bitrix24. Лиды и сделки являются разными сущностями. Для смарт-процессов передайте entity_type_id. Чтение.leads_create— create: leads Bitrix24. Лиды и сделки являются разными сущностями. Для смарт-процессов передайте entity_type_id. Операция записи.leads_update— update: leads Bitrix24. Лиды и сделки являются разными сущностями. Для смарт-процессов передайте entity_type_id. Операция записи.leads_search— Поиск leads по имени/названию. Телефон/email ищите через duplicates_find. Чтение.deals_list— list: deals Bitrix24. Лиды и сделки являются разными сущностями. Для смарт-процессов передайте entity_type_id. Чтение.deals_get— get: deals Bitrix24. Лиды и сделки являются разными сущностями. Для смарт-процессов передайте entity_type_id. Чтение.deals_create— create: deals Bitrix24. Лиды и сделки являются разными сущностями. Для смарт-процессов передайте entity_type_id. Операция записи.deals_update— update: deals Bitrix24. Лиды и сделки являются разными сущностями. Для смарт-процессов передайте entity_type_id. Операция записи.deals_search— Поиск deals по имени/названию. Телефон/email ищите через duplicates_find. Чтение.contacts_list— list: contacts Bitrix24. Лиды и сделки являются разными сущностями. Для смарт-процессов передайте entity_type_id. Чтение.contacts_get— get: contacts Bitrix24. Лиды и сделки являются разными сущностями. Для смарт-процессов передайте entity_type_id. Чтение.contacts_create— create: contacts Bitrix24. Лиды и сделки являются разными сущностями. Для смарт-процессов передайте entity_type_id. Операция записи.contacts_update— update: contacts Bitrix24. Лиды и сделки являются разными сущностями. Для смарт-процессов передайте entity_type_id. Операция записи.contacts_search— Поиск contacts по имени/названию. Телефон/email ищите через duplicates_find. Чтение.companies_list— list: companies Bitrix24. Лиды и сделки являются разными сущностями. Для смарт-процессов передайте entity_type_id. Чтение.companies_get— get: companies Bitrix24. Лиды и сделки являются разными сущностями. Для смарт-процессов передайте entity_type_id. Чтение.companies_create— create: companies Bitrix24. Лиды и сделки являются разными сущностями. Для смарт-процессов передайте entity_type_id. Операция записи.companies_update— update: companies Bitrix24. Лиды и сделки являются разными сущностями. Для смарт-процессов передайте entity_type_id. Операция записи.companies_search— Поиск companies по имени/названию. Телефон/email ищите через duplicates_find. Чтение.crm_items_list— list: crm_items Bitrix24. Лиды и сделки являются разными сущностями. Для смарт-процессов передайте entity_type_id. Чтение.crm_items_get— get: crm_items Bitrix24. Лиды и сделки являются разными сущностями. Для смарт-процессов передайте entity_type_id. Чтение.crm_items_create— create: crm_items Bitrix24. Лиды и сделки являются разными сущностями. Для смарт-процессов передайте entity_type_id. Операция записи.crm_items_update— update: crm_items Bitrix24. Лиды и сделки являются разными сущностями. Для смарт-процессов передайте entity_type_id. Операция записи.activities_list— list: activities. Дела CRM, задачи и комментарии таймлайна имеют отдельные поля и связи. Чтение.activities_get— get: activities. Дела CRM, задачи и комментарии таймлайна имеют отдельные поля и связи. Чтение.activities_create— create: activities. Дела CRM, задачи и комментарии таймлайна имеют отдельные поля и связи. Операция записи.activities_update— update: activities. Дела CRM, задачи и комментарии таймлайна имеют отдельные поля и связи. Операция записи.activities_complete— Завершить activities по ID. Операция записи.timeline_comments_list— list: timeline_comments. Дела CRM, задачи и комментарии таймлайна имеют отдельные поля и связи. Чтение.timeline_comments_get— get: timeline_comments. Дела CRM, задачи и комментарии таймлайна имеют отдельные поля и связи. Чтение.timeline_comments_create— create: timeline_comments. Дела CRM, задачи и комментарии таймлайна имеют отдельные поля и связи. Операция записи.timeline_comments_update— update: timeline_comments. Дела CRM, задачи и комментарии таймлайна имеют отдельные поля и связи. Операция записи.crm_entities_query— Выборка CRM с проверяемым AND/OR, проекцией полей и ограниченной автопагинацией. Чтение.entities_enrich— Карточки выбранных объектов и их связи, до 50 ID. Чтение.batch_create_entities— Создать до 50 объектов после предварительной проверки всех полей. Операция записи.batch_update_entities— Изменить до 50 объектов; отдельный результат каждого элемента. Операция записи.batch_change_stage— Сменить стадию: для лидов fields содержит stageId; для сделок и смарт-процессов — categoryId и stageId вместе. Операция записи.batch_assign_responsible— Назначить ответственного: fields должны содержать assignedById. Операция записи.entities_link— Добавить связи CRM, сохраняя существующие контакты; companyId является одиночной связью. Операция записи.deal_product_rows_get— Товарные позиции сделки. Чтение.deal_product_rows_set— Заменить товарные позиции сделки указанным списком. Операция записи.stage_history_list— История попаданий в стадию за полуоткрытый период [since, until). Чтение.deals_stage_funnel_report— Уникальные сделки, исторически вошедшие в этап; текущая стадия не ограничивает выборку. Чтение.revenue_ranking_report— Рейтинг выигранных сделок с точными суммами, отдельно по каждой валюте. Чтение.sales_health_report— Сводка открытых/успешных/проигранных сделок и просроченных дел CRM. Чтение.entities_activity_digest— Ограниченная сводка дел CRM, задач, комментариев и доступных коммуникаций выбранных объектов. Общий scan_limit1000; период по умолчанию с1970 до текущего времени, для почты нужны mailbox_ids. Чтение.duplicates_find— Поиск дубликатов по телефону/email без изменения данных. Чтение.calls_list— Звонки из CRM-дел; без получения записи и управления телефонией. Чтение.audit_list— Журнал вызовов текущего AI-подключения Bitrix24. Чтение.custom_fields_list— Определения пользовательских полей лидов/сделок/контактов/компаний. Создание/изменение требует CRM-администратора; удаления и изменения типа нет. Запись требует request_id. Чтение.custom_fields_get— Определения пользовательских полей лидов/сделок/контактов/компаний. Создание/изменение требует CRM-администратора; удаления и изменения типа нет. Запись требует request_id. Чтение.custom_fields_create— Определения пользовательских полей лидов/сделок/контактов/компаний. Создание/изменение требует CRM-администратора; удаления и изменения типа нет. Запись требует request_id. Операция записи.custom_fields_update— Определения пользовательских полей лидов/сделок/контактов/компаний. Создание/изменение требует CRM-администратора; удаления и изменения типа нет. Запись требует request_id. Операция записи.analytics_capabilities— Read-only аналитика разрешённых сделок. Сначала analytics_capabilities; неполная история означает partial/insufficient_data. Денежные суммы отдельно по валютам. Чтение.analytics_query— Read-only аналитика разрешённых сделок. Сначала analytics_capabilities; неполная история означает partial/insufficient_data. Денежные суммы отдельно по валютам. Чтение.analytics_report— Read-only аналитика разрешённых сделок. Сначала analytics_capabilities; неполная история означает partial/insufficient_data. Денежные суммы отдельно по валютам. Чтение.analytics_result_get— Read-only аналитика разрешённых сделок. Сначала analytics_capabilities; неполная история означает partial/insufficient_data. Денежные суммы отдельно по валютам. Чтение.team_workload_report— Загрузка выбранных сотрудников: текущие открытые/просроченные задачи и CRM-дела, встречи за период. Проекты ограничивают задачи; недоступные связи дел/встреч с проектами обозначены явно. Чтение.customer_context_get— Контекст клиента и связанные карточки: дела, задачи, комментарии, звонки, доступные открытые линии и письма за явный период. Общий scan_limit1000, до200 событий ответа; недоступные источники обозначены. Чтение.customer_communications_report— Фактическая сводка звонков, клиентских диалогов и писем: звонки объединяются с CRM-делом по CRM_ACTIVITY_ID. Для почты выберите mailbox_ids; связь по email явно отмечена. Чтение.