CRMHubSpot

История изменений CLI HubSpot

История изменений CLI для HubSpot: новые возможности, изменения и исправления.

Заметные изменения в @wirecat/hubspot-cli. По одному разделу на версию, новые сверху.

0.4.0 — 19.11.2026

Изменено — может сломать вызовы

  • Ключей deals.write, people.write и organizations.write больше нет. Они останавливали только путь через api, поэтому deals.write: deny все равно пропускал deals update. Запись через api в сделки, контакты или компании теперь проверяет ключ команды, которая делает то же самое (deals.update, people.create), как в amoCRM и b24, а слияние проверяет <group>.update. Так прямая запись в сделку, контакт или компанию идет так же, как ее команда, а удаления по-прежнему спрашивают. Обратите внимание: настройка с одним из трех старых ключей больше ни с чем не совпадает. Задайте вместо нее deals.update, deals.create или ключ группы deals.

Исправлено

  • Чтение, запрещенное для команды CRM, запрещено и через api. config set permissions.people deny останавливал people list, но не api contacts-list, который читал те же контакты. Теперь каждое прямое чтение проверяет ключ команды, которая читает те же записи: people, organizations, deals, leads, activities, users, pipelines, stages и fields. См. разрешения.

0.3.2 — 19.11.2026

0.3.1 — 19.11.2026

Исправлено

  • Заметки, встречи и задачи читаются как чистый текст. HTML-коды вроде &#8217; и &mdash; превращаются в символы, которые они обозначают, а блоки стилей отбрасываются, так что поиск находит слова. Раньше расшифровывались только шесть кодов.
  • Дневной лимит HubSpot на всех путях говорит «не повторять». Команды CRM считали его ошибкой, которую можно повторить, а api нет, и агент мог повторять запрос часами.
  • session start --help больше не говорит, что hubspot ничего не меняет. Запись появилась в 0.2.0.

0.3.0 — 18.11.2026

Изменено — может сломать вызовы

  • Запись в MCP Registry спрашивает, какие профили обслуживать. Раньше она запускала mcp serve --profiles all, и клиент, установивший сервер из реестра, получал доступ ко всем аккаунтам на компьютере, хотя владелец их не выбирал. Теперь --profiles обязателен, с примером personal: клиент спрашивает один профиль, список через запятую или all. Почему: CLI никогда не выбирает аккаунт за владельца (WC-MCP-9). Что учесть: клиент, настроенный по старой записи, сохраняет --profiles all, пока его не настроят заново. Сервер, добавленный вручную или через mcp config, не меняется.

Исправлено

  • mcp serve запускается на компьютере, где еще нет профиля. Он показывает свои инструменты, а каждый вызов отвечает командой, которая настраивает профиль. Раньше сервер останавливался при запуске, и каталог, который проверяет серверы, не мог их перечислить. Из cli-core 0.699.0.

0.2.0 — 17.11.2026

Добавлено

  • deals create, update, move, close и delete меняют сделки в HubSpot, а копия принимает каждый ответ. close переносит сделку на стадию выигрыша или проигрыша ее воронки и сохраняет --reason как причину закрытия в HubSpot. delete архивирует сделку и сначала спрашивает. См. как пользоваться.
  • people create|update и organizations create|update меняют контакты и компании. У контакта одна почта и два номера, у компании один номер и нет почты. Более длинный список отклоняется до того, как что-то отправлено.
  • api предлагает и записи и удаления HubSpot: 66 записей и 33 удаления CRM API версии 2026-03. Каждая запись проверяет api.<command> и <group>.write своей группы, каждое удаление <group>.delete, и оба по умолчанию спрашивают. Запись, которая делает то же, что команда, проверяет и ключ этой команды (deals.update), тело, которое задает стадию сделки, проверяет deals.move и deals.close, а тело, которое задает ответственного, crm.assign-others, который по умолчанию стоит на deny. api contacts-gdpr-delete проверяет еще people.erase, чтобы можно было запретить только стирание. --dry-run называет каждый ключ. См. настройки.
  • Scope на запись необязательны. Настройка и установка перечисляют crm.objects.{deals,contacts,companies}.write. Без них ключ только читает.

Исправлено

  • api отправляет ключ с каждой операцией. Спецификации объектов HubSpot помечают 115 операций как не требующие входа, поэтому в 0.1.0 api deals-get, api contacts-list и другие операции с записями уходили без ключа, и HubSpot отвечал 401. Операции с воронками, свойствами, ответственными и аккаунтом это не затронуло.

0.1.0 — 17.11.2026

Добавлено

  • Начало от @wirecat/cli-template 0.25.0.
  • session start входит в профиль с сервисным ключом HubSpot или токеном приватного приложения. Ключ читается скрытно или из stdin, но никогда не как аргумент, проверяется в аккаунте и хранится в связке ключей вместе с id аккаунта. Второй профиль на тот же аккаунт отклоняется. WCHUBSPOT_TOKEN работает в CI вместе с WCHUBSPOT_ACCOUNT, id аккаунта. См. установку.
  • sync копирует CRM аккаунта в общее хранилище WireCat. Сделки, контакты, компании, лиды (Sales Hub Professional или Enterprise), ответственные, воронки и свойства, а когда включена настройка активностей, еще заметки, звонки, письма, встречи и задачи. После этого deals list, pipelines, changes list и search all отвечают без интернета. Ключ не называет пользователя, поэтому каждый профиль читает всю копию: фильтруйте по owner:<owner id>, а не по owner:me.
  • people, organizations и users читают контакты, компании и ответственных из аккаунта напрямую.
  • api предлагает каждую операцию чтения CRM API HubSpot версии 2026-03 из его 15 спецификаций. Одна команда на операцию, у каждой свой ключ разрешения. Этот выпуск только читает: записи API не предлагаются, и api show для такой операции об этом говорит.
  • Исчерпанный дневной лимит сразу завершает запрос и говорит, когда лимит вернется. HubSpot делит один дневной лимит между всеми приложениями аккаунта. hubspot сообщает hubspot.daily-limit с временем ожидания до полуночи аккаунта и до тех пор не дает ни одному процессу на этом аккаунте спрашивать снова. Десятисекундный лимит выжидается.
  • WCHUBSPOT_ACCOUNT сверяется с WCHUBSPOT_TOKEN до того, как что-то записано. sync с id другого аккаунта останавливается с account.mismatch и называет оба id, поэтому CRM одного аккаунта никогда не попадет под другой. session status --check с одним токеном печатает id, который нужно задать. См. решение проблем.