Справочник портала Битрикс24: users (id, name, email, active), categories — воронки сделок (id, name, is_default) со stages (id вида C1:NEW, name, semantics: open/won/lost). Вызывайте первым в разговоре: id воронок, стадий и сотрудников нужны фильтрам b24_search_deals, b24_tasks, b24_pipeline_report и записи в b24_create_deal / b24_update_deal. Результат кэшируется на 10 минут. Требует BITRIX24_WEBHOOK_URL (входящий вебхук с правами crm, task, user); лимит 2 запроса/с соблюдается автоматически. Только чтение.

Ищет сделки по подстроке в названии и фильтрам: воронка (category_id), стадия (stage_id), ответственный, результат (open/won/lost), период создания. Возвращает count, total_amount и deals (id, title, amount, category, stage, result, responsible, contact_id, даты), свежие изменения первыми. Полная карточка с контактом, задачами и комментариями — b24_get_deal; сводная аналитика — b24_pipeline_report; зависшие сделки — b24_stale_deals. Требует BITRIX24_WEBHOOK_URL (входящий вебхук с правами crm, task, user); лимит 2 запроса/с соблюдается автоматически. Только чтение.

Полная карточка одной сделки по id: всё из b24_search_deals плюс comments сделки, contacts (телефоны, e-mail, должность), company, open_tasks (со сроком и флагом overdue) и последние комментарии таймлайна. Используйте перед звонком или письмом клиенту; id берите из b24_search_deals или b24_find_contact. Несуществующий id вернёт ошибку «не найдена». Делает 4–6 запросов. Требует BITRIX24_WEBHOOK_URL (входящий вебхук с правами crm, task, user); лимит 2 запроса/с соблюдается автоматически. Только чтение.

Создаёт сделку в Битрикс24, при необходимости вместе с новым контактом (contact_name + phone/email) или привязывает существующий contact_id. Возвращает deal_id и contact_id. Воронку и стадию берите из b24_portal; без них сделка попадёт в первую стадию общей воронки. Перед созданием проверьте b24_find_contact, чтобы не плодить дубли контактов. Изменяет данные в Битрикс24: покажите пользователю, что будет записано, и получите согласие. Требует BITRIX24_WEBHOOK_URL (входящий вебхук с правами crm, task, user); лимит 2 запроса/с соблюдается автоматически.

Меняет сделку: стадию (перевод по воронке), сумму, ответственного, название или описание. Передавайте только то, что меняется; без полей — ошибка. Для закрытия сделки выберите стадию с semantics won/lost из b24_portal. Повторный вызов с теми же данными ничего не меняет. Изменяет данные в Битрикс24: покажите пользователю, что будет записано, и получите согласие. Требует BITRIX24_WEBHOOK_URL (входящий вебхук с правами crm, task, user); лимит 2 запроса/с соблюдается автоматически.

Находит контакты по телефону, e-mail или имени/фамилии. Телефон и e-mail ищутся через поиск дублей Битрикс24 (формат номера не важен), имя — по подстроке. Возвращает contacts (id, name, phones, emails, post, company_id, responsible) и deals — открытые сделки найденных контактов. Используйте перед звонком и перед созданием сделки. Требует BITRIX24_WEBHOOK_URL (входящий вебхук с правами crm, task, user); лимит 2 запроса/с соблюдается автоматически. Только чтение.

Создаёт лид (входящую заявку) в Битрикс24: название, имя, телефон, e-mail, сумма, источник, комментарий. Возвращает lead_id. Используйте для заявок, которые ещё не квалифицированы; для подтверждённой продажи — b24_create_deal. Изменяет данные в Битрикс24: покажите пользователю, что будет записано, и получите согласие. Требует BITRIX24_WEBHOOK_URL (входящий вебхук с правами crm, task, user); лимит 2 запроса/с соблюдается автоматически.

Добавляет комментарий в таймлайн сделки, лида, контакта или компании — итог звонка, договорённости, заметка. Возвращает comment_id. Каждый вызов добавляет новый комментарий. Изменяет данные в Битрикс24: покажите пользователю, что будет записано, и получите согласие. Требует BITRIX24_WEBHOOK_URL (входящий вебхук с правами crm, task, user); лимит 2 запроса/с соблюдается автоматически.

Список незакрытых задач: scope=overdue — просроченные, today — со сроком сегодня, open — все открытые. Фильтр по ответственному. Возвращает count, by_responsible (сколько у кого, из них просрочено) и tasks (id, title, responsible, deadline, overdue, crm-привязки вида D_123). Отвечает на «что просрочено у менеджеров» и «какие задачи на сегодня». Требует BITRIX24_WEBHOOK_URL (входящий вебхук с правами crm, task, user); лимит 2 запроса/с соблюдается автоматически. Только чтение.

Ставит задачу сотруднику, при желании привязывает к сделке, лиду или контакту (появится в карточке CRM). Возвращает task_id. Если ответственный не указан, задача ставится владельцу вебхука. Изменяет данные в Битрикс24: покажите пользователю, что будет записано, и получите согласие. Требует BITRIX24_WEBHOOK_URL (входящий вебхук с правами crm, task, user); лимит 2 запроса/с соблюдается автоматически.

Отмечает задачу выполненной, при желании с комментарием-результатом. Повторный вызов для уже закрытой задачи не меняет данные. Изменяет данные в Битрикс24: покажите пользователю, что будет записано, и получите согласие. Требует BITRIX24_WEBHOOK_URL (входящий вебхук с правами crm, task, user); лимит 2 запроса/с соблюдается автоматически.

Сводка отдела продаж за период по сделкам, созданным в нём: deals, amount, open/won/lost (количество и сумма), win_rate_pct (выиграно / закрыто), avg_cycle_days (от создания до выигрыша), stages — открытые сделки по стадиям, managers — по каждому менеджеру сделки, выиграно, сумма выигранного и конверсия. Отвечает на «как идут продажи в этом месяце» и «кто из менеджеров лучше закрывает». Без дат — все сделки (до 2000). Требует BITRIX24_WEBHOOK_URL (входящий вебхук с правами crm, task, user); лимит 2 запроса/с соблюдается автоматически. Только чтение.

Открытые сделки без движения: не менялись больше days дней и/или без открытых задач. Возвращает count, amount_at_risk и deals с reasons («нет изменений N дней», «нет открытых задач»), самые крупные первыми. Отвечает на «что у нас зависло» и «где теряем деньги». Требует BITRIX24_WEBHOOK_URL (входящий вебхук с правами crm, task, user); лимит 2 запроса/с соблюдается автоматически. Только чтение.