Коротко: бесплатный Bitrix read kit отделяет просроченные CRM-дела от дел без срока и от неполного чтения. Начнём с пяти вымышленных сделок: запустим локальный расчёт, сверим каждый вывод с JSON и намеренно испортим полноту одного чтения. Доступ к Битрикс24 для этого не нужен.
Руководителю важно понять, что именно проверить в сделке. Просроченный звонок существует, но его срок прошёл. Дело без срока требует уточнения даты. А пустой ответ при неполном чтении вообще не позволяет утверждать, что дел нет. Эти ситуации нельзя превращать в один список «менеджеры забыли клиентов».
В этой практике ИИ помогает запустить инструмент и объяснить результат. Числа и признаки считает локальная программа. Это позволяет проверить ответ агента по исходному файлу, прежде чем обсуждать работу людей.
1. Скачайте комплект и выполните учебный запуск
Скачать Bitrix read kit ZIP Учебные результаты и контрольный пример
Основной архив содержит код, документацию и вымышленные данные. Второй — исходный JSON, фактические отчёты, изменённый пример и промпт. Регистрация, ключи и покупка системы не требуются. Нужен установленный Python 3.9 или новее; сторонних библиотек нет. Распакуйте основной архив и откройте терминал в папке bitrix-read-kit-0.1.0.
python3 -B bitrix_read_kit.py doctor
python3 -B bitrix_read_kit.py demo
python3 -B bitrix_read_kit.py validate --input examples/synthetic-snapshot.json
python3 -B bitrix_read_kit.py audit --input examples/synthetic-snapshot.json --as-of 2026-10-10T10:00:00+03:00Команды повторены 13 октября 2026 года на macOS с Python 3.9.6. Проверка doctor работает без сети; отсутствие webhook для учебного запуска нормально. demo использует фиксированное учебное время — 10 октября, 10:00 МСК. Это позволяет получить тот же результат в другой день. Для Windows используйте python, если интерпретатор называется так; отдельный Windows-прогон этой статьи не выполнялся.
2. Сверьте пять сделок с исходными данными
Откройте examples/synthetic-snapshot.json. В deals лежат сделки, в activity_reads — полученные дела и признак полноты чтения для каждой сделки. Все ID в примере вымышлены.
| Сделка | Что есть в JSON | Правильный вывод |
|---|---|---|
| 101 | complete: true, список дел пуст | В полностью прочитанной доступной выборке нет незавершённого CRM-дела. |
| 102 | Незавершённое дело 201, 10.10 в 12:00 МСК | Дело запланировано позже учебного времени анализа. |
| 103 | Незавершённое дело 202, 09.10 в 15:00 МСК | Срок прошёл: дело просрочено. |
| 104 | Дело 203 с датой 9999-12-31; дело 204 завершено | Одно незавершённое дело без срока. Завершённое в этот счётчик не входит. |
| 105 | complete: false, список пуст | Чтение неполное. Утверждать отсутствие дел нельзя. |
Итого: 5 видимых открытых сделок и 3 уникальных незавершённых дела. Счётчики «нет видимого дела», «запланировано», «просрочено», «без срока», «чтение неполное» равны одному. Поле all_selected_activity_pages_complete равно false. На других данных признаки могут пересекаться, поэтому их сумму нельзя автоматически считать числом сделок.
Дата 9999-12-31 обозначает отсутствие срока в примере API Битрикс24. Её не нужно читать как встречу в далёком будущем. Такой случай описан в официальном разборе получения дел.
3. Проверьте, не делает ли программа вывод из неполных данных
Второй архив содержит incomplete-snapshot.json. Он отличается от исходного одним полем: у сделки 101 complete заменено с true на false. Перенесите этот файл в папку инструмента и запустите:
python3 -B bitrix_read_kit.py audit --input incomplete-snapshot.json --as-of 2026-10-10T10:00:00+03:00Ожидаемый результат: по-прежнему 5 сделок и 3 незавершённых дела; no_visible_open_activity теперь 0, а activity_coverage_incomplete — 2. Сделка 101 перестала быть доказательством отсутствия дела. Остальные признаки не изменились.
Ещё одна полезная ошибка: уберите часовой пояс из --as-of. Значение 2026-10-10T10:00:00 отвергается с invalid_timestamp. Без часового пояса программа не должна угадывать, наступил ли срок. Эти два контрольных запуска выполнены; их вывод сохранён в учебном архиве. Также повторены 95 тестов пакета. Это проверка локального поведения, а не подтверждение подключения к рабочей CRM.
4. Попросите агента объяснить доказательства
Откройте распакованную папку в Codex или Claude Code. Агенту нужны доступ к этой папке и возможность выполнить локальный Python. Скопируйте запрос или скачайте его отдельным файлом:
Прочитай README.ru.md, AGENTS.md и skills/bitrix-read-kit/SKILL.md из архива Bitrix read kit 0.1.0. Работай только с учебными файлами; к настоящему порталу не подключайся.
Запусти doctor, demo, validate и audit; для audit используй --as-of 2026-10-10T10:00:00+03:00. Сверь каждую из пяти сделок с examples/synthetic-snapshot.json. Отдельно объясни просрочку, отсутствие видимого незавершённого дела, дело без срока и неполное чтение.
Не объявляй отсутствие дела отсутствием договорённости или потерянной продажей. Затем в копии JSON поменяй только complete у activity_reads сделки 101 с true на false и повтори audit. Докажи, что no_visible_open_activity исчез, activity_coverage_incomplete вырос до двух. Сохрани отчёты раздельно.
Не выдумывай доступ к CRM и не меняй системные настройки. Если запуск не удался, покажи точную ошибку.Принимайте объяснение, если в нём есть конкретные ID, время анализа и ограничение полноты. Формулировку «пять проблемных клиентов» отклоните: она не следует из примера. Наличие незавершённого дела тоже само по себе не доказывает согласованный следующий шаг.
5. Подключение своего портала — отдельный этап
Для настоящего чтения потребуется разрешённый входящий webhook с доступом к CRM и нужные права его пользователя. Сначала проверьте доступность REST API на вашем портале и официальную инструкцию создания webhook. Учебная часть не требует менять тариф, покупать доступ или подключать портал.
Полный URL webhook — секрет. Не вставляйте его в промпт, публичный код, комментарии или снимок экрана. Модуль принимает его через переменную окружения B24_WEBHOOK_URL. Ниже пример для интерактивного bash на macOS/Linux; сначала перейдите в распакованную папку. После первой команды вставьте URL без отображения на экране и нажмите Enter.
read -r -s B24_WEBHOOK_URL
export B24_WEBHOOK_URL
python3 -B bitrix_read_kit.py doctor
python3 -B bitrix_read_kit.py capture --out ./private-crm-snapshot.json --max-deal-pages 2 --max-activity-pages 2
unset B24_WEBHOOK_URLcapture создаёт новый файл, не перезаписывая существующий. Продолжайте только после успешной квитанции. Для реального анализа укажите фактическое время с часовым поясом, а не учебную дату из этой статьи. Реальный capture при подготовке статьи не выполнялся.
- Модуль поддерживает облачные адреса
.bitrix24.ruи.bitrix24.com. OAuth, собственный домен и коробочная версия в этот пакет не входят. - Читает только доступные пользователю сделки в работе и незавершённые CRM-дела через crm.item.list и crm.activity.list. Записи CRM он не изменяет; это CLI, а не MCP-сервер.
- Лимит страниц дел применяется отдельно к каждой выбранной сделке. Достигнутый предел отмечается как неполнота. Сбор последовательный: данные могут измениться между запросами.
- Имена, контакты, названия и суммы сделок не сохраняются. Но реальные внутренние ID остаются связуемыми данными: это не обезличивание. Снимок и отчёт храните приватно; доступ агенту предоставляйте только в согласованном контуре.
Что сделать с результатом
Выберите несколько отмеченных сделок и откройте их карточки. Для просрочки выясните, действие не выполнено или результат не внесён. Для дела без срока уточните, нужна ли дата. Для полного пустого чтения сопоставьте CRM с фактической перепиской. При неполноте сначала разберитесь с доступом и страницами.
Если хотите повторить такую проверку на своей задаче, обсудим процесс работы с CRM: какие записи доступны, что проверяем и какое действие должен выполнить человек после отчёта. Учебная проверка не обещает возврата потерянной выручки.
Подготовил Дмитрий Лукашов, 13 октября 2026. Использован публичный релиз Bitrix read kit 0.1.0; инструкция и границы и первоисточники Битрикс24 повторно сверены в день подготовки. Все показанные данные вымышлены, реальный портал и финансовый эффект не проверялись.