--- author: OOMOL author_url: https://oomol.com/ru/about/ title: Руководство по App HubSpot description: Как добавить, использовать, устранять неполадки и удалить app HubSpot в OOMOL. lang: ru canonical_url: https://oomol.com/ru/docs/hubspot/ markdown_url: https://oomol.com/ru/docs/hubspot.md --- # Руководство по App HubSpot OOMOL позволяет один раз подключить HubSpot, а затем сделать авторизованные инструменты HubSpot CRM доступными AI-агентам и повторно используемым Skills, с которыми вы уже работаете. В этом руководстве описано, как добавить App HubSpot, какие разрешения использует OOMOL, что можно делать с HubSpot, как устранять распространённые проблемы и как удалить App. ## Предварительные требования - Аккаунт OOMOL. - Аккаунт HubSpot, который вам разрешено авторизовать для сторонних apps. - Доступ к OOMOL Console по адресу [https://console.oomol.com/](https://console.oomol.com/). - Разрешение в HubSpot авторизовать apps со scopes объектов CRM и схем CRM. - Тестовые записи контакта, компании и сделки, если вы хотите попробовать инструменты поиска, чтения или обновления. - Если ваша организация HubSpot ограничивает сторонние apps, администратору HubSpot может потребоваться разрешить App OOMOL до того, как вы сможете её авторизовать. ## Добавление App 1. Войдите в [OOMOL Console](https://console.oomol.com/). 2. Откройте **Connectables** или перейдите напрямую в [Connections](https://console.oomol.com/connections). 3. Найдите **HubSpot**. 4. Выберите **HubSpot**, затем выберите **Connect**. 5. OOMOL перенаправит вас в HubSpot. Войдите в HubSpot, если появится запрос. 6. Проверьте экран авторизации HubSpot, включая запрашиваемые разрешения CRM. 7. Выберите аккаунт HubSpot, который хотите подключить. 8. Выберите **Connect app** или эквивалентное действие авторизации, показанное HubSpot. 9. После перенаправления из HubSpot обратно в OOMOL убедитесь, что HubSpot отображается как подключённый в ваших подключениях OOMOL. Если какой-либо шаг завершился ошибкой, см. [Устранение неполадок](#устранение-неполадок). После авторизации OOMOL сохраняет подключение, необходимое для вызова инструментов HubSpot от вашего имени. Затем вы можете использовать инструменты HubSpot из поддерживаемых OOMOL агентов, повторно используемых Skills и workflows. ## Использование Инструменты HubSpot доступны только после подключения аккаунта HubSpot. Точный список инструментов, отображаемый в OOMOL, может меняться при обновлении коннектора, но текущий коннектор HubSpot поддерживает чтение определений свойств CRM, а также поиск, чтение, создание и обновление контактов, компаний и сделок. ### Использование инструментов HubSpot с oo-cli Чтобы сделать подключённые инструменты HubSpot доступными в поддерживаемой среде AI-агента, установите и настройте `oo-cli` после входа в OOMOL. 1. Войдите в [OOMOL Console](https://console.oomol.com/). 2. Откройте [страницу установки oo-cli](https://console.oomol.com/install-oo-cli). 3. Следуйте инструкциям на этой странице. Она предоставляет prompt для копирования в один клик, чтобы установить и настроить `oo-cli` в поддерживаемой среде AI-агента. 4. После настройки `oo-cli` и подключения HubSpot в OOMOL попросите агента использовать подключённые инструменты HubSpot CRM с демонстрационными CRM-данными. Точный prompt агента зависит от среды. Например, можно попросить агента создать демонстрационный контакт, найти этот контакт по e-mail, обновить редактируемое поле, например должность, или перечислить свойства HubSpot CRM. ### Используемые разрешения OOMOL использует эти scopes HubSpot, чтобы авторизованный пользователь HubSpot мог подключить HubSpot как App в OOMOL, а затем сделать одобренные инструменты CRM доступными агентам и повторно используемым Skills. Обязательные scopes: | Scope HubSpot | Используется | Почему OOMOL использует его | | --- | --- | --- | | `oauth` | HubSpot OAuth connection | Завершить поток OAuth-авторизации HubSpot и поддерживать авторизованное подключение HubSpot в OOMOL. | | `crm.objects.contacts.read` | Search Contacts, Get Contact | Искать и читать записи контактов HubSpot, когда пользователь или одобренное действие агента запрашивает информацию о контакте. | | `crm.objects.contacts.write` | Create Contact, Update Contact | Создавать или обновлять записи контактов HubSpot, когда пользователь или одобренное действие агента предоставляет необходимые сведения о контакте. | | `crm.objects.companies.read` | Search Companies, Get Company | Искать и читать записи компаний HubSpot, когда пользователь или одобренное действие агента запрашивает информацию о компании. | | `crm.objects.companies.write` | Create Company, Update Company | Создавать или обновлять записи компаний HubSpot, когда пользователь или одобренное действие агента предоставляет необходимые сведения о компании. | | `crm.objects.deals.read` | Search Deals, Get Deal | Искать и читать записи сделок HubSpot, когда пользователь или одобренное действие агента запрашивает информацию о сделке. | | `crm.objects.deals.write` | Create Deal, Update Deal | Создавать или обновлять записи сделок HubSpot, когда пользователь или одобренное действие агента предоставляет необходимые сведения о сделке. | | `crm.schemas.contacts.read` | List Properties, Get Property | Читать определения свойств контактов, чтобы инструменты могли использовать допустимые поля контактов HubSpot. | | `crm.schemas.companies.read` | List Properties, Get Property | Читать определения свойств компаний, чтобы инструменты могли использовать допустимые поля компаний HubSpot. | | `crm.schemas.deals.read` | List Properties, Get Property | Читать определения свойств сделок, чтобы инструменты могли использовать допустимые поля сделок HubSpot. | ### Поддерживаемые инструменты HubSpot | Инструмент | Поддерживаемая функция | Типичный сценарий | Предварительные требования | | --- | --- | --- | --- | | List Properties | Перечисляет определения свойств для контактов, компаний или сделок. | Позволяет агенту понять, какие поля CRM доступны, прежде чем создавать фильтры, записи или обновлять поля. | HubSpot подключён в OOMOL, и подключённый аккаунт имеет доступ к схемам свойств CRM. | | Get Property | Читает одно определение свойства, например свойство `email` у контактов. | Проверить конкретное поле CRM перед использованием в поиске, создании или обновлении. | HubSpot подключён в OOMOL, и запрошенное свойство существует. | | Search Contacts | Ищет контакты по ключевым словам, фильтрам, сортировке и выбранным возвращаемым полям. | Найти нужного человека перед звонком, передачей задачи, задачей поддержки или follow-up. | HubSpot подключён в OOMOL, и подключённый аккаунт может читать контакты. | | Get Contact | Читает один контакт по ID записи HubSpot или пользовательскому уникальному свойству. | Передать сведения о контакте в workflow агента перед следующим шагом. | HubSpot подключён в OOMOL, и запрошенный контакт доступен подключённому аккаунту. | | Create Contact | Создаёт контакт с переданными свойствами и необязательными associations. | Сохранить нового лида, клиента или заинтересованное лицо из информации, которую пользователь передаёт агенту. | HubSpot подключён в OOMOL, и у пользователя есть необходимые сведения о контакте. | | Update Contact | Обновляет свойства контакта по ID записи или пользовательскому уникальному свойству. | Поддерживать запись контакта актуальной после звонка, письма, исследовательской задачи или шага workflow. | HubSpot подключён в OOMOL, контакт можно найти, и пользователь одобрил обновлённые сведения. | | Search Companies | Ищет компании по ключевым словам, фильтрам, сортировке и выбранным возвращаемым полям. | Найти сведения об аккаунте перед подготовкой исследования, outreach или follow-up. | HubSpot подключён в OOMOL, и подключённый аккаунт может читать компании. | | Get Company | Читает одну компанию по ID записи HubSpot или пользовательскому уникальному свойству. | Передать сведения об аккаунте в workflow агента перед созданием заметок, планов или обновлений. | HubSpot подключён в OOMOL, и запрошенная компания доступна подключённому аккаунту. | | Create Company | Создаёт компанию с переданными свойствами и необязательными associations. | Добавить новый аккаунт из информации о компании, предоставленной пользователем. | HubSpot подключён в OOMOL, и у пользователя есть необходимые сведения о компании. | | Update Company | Обновляет свойства компании по ID записи или пользовательскому уникальному свойству. | Поддерживать сведения об аккаунте актуальными после исследования, продажной работы или операционного обзора. | HubSpot подключён в OOMOL, компанию можно найти, и пользователь одобрил обновлённые сведения. | | Search Deals | Ищет сделки по ключевым словам, фильтрам, сортировке и выбранным возвращаемым полям. | Найти нужную opportunity перед обзором pipeline, прогнозом или follow-up. | HubSpot подключён в OOMOL, и подключённый аккаунт может читать сделки. | | Get Deal | Читает одну сделку по ID записи HubSpot или пользовательскому уникальному свойству. | Передать сведения об opportunity в workflow агента перед её резюмированием или обновлением. | HubSpot подключён в OOMOL, и запрошенная сделка доступна подключённому аккаунту. | | Create Deal | Создаёт сделку с переданными свойствами и необязательными associations. | Добавить новую opportunity из продажной информации, предоставленной пользователем. | HubSpot подключён в OOMOL, и у пользователя есть необходимые сведения о сделке. | | Update Deal | Обновляет свойства сделки по ID записи или пользовательскому уникальному свойству. | Поддерживать сведения pipeline актуальными после взаимодействия с клиентом или внутреннего обзора. | HubSpot подключён в OOMOL, сделку можно найти, и пользователь одобрил обновлённые сведения. | ### Поиск и чтение CRM-записей Сценарий: дать агенту возможность найти нужный контакт, компанию или сделку HubSpot перед звонком, передачей задачи, исследованием или follow-up. Предварительные требования: - HubSpot подключён в OOMOL. - Подключённый аккаунт HubSpot имеет разрешение читать запрошенный объект CRM. - У агента или workflow есть ключевое слово поиска, фильтр, ID записи или значение уникального свойства. Что делают инструменты: - Ищут или читают контакты, компании и сделки, доступные подключённому аккаунту HubSpot. - Возвращают поля HubSpot, запрошенные входом инструмента, если они доступны. - Не создают, не обновляют и не удаляют записи во время действий только для чтения. ### Создание CRM-записей Сценарий: дать агенту возможность создать контакт, компанию или сделку HubSpot из информации, предоставленной пользователем, например нового клиента, аккаунт или opportunity. Предварительные требования: - HubSpot подключён в OOMOL. - Подключённый аккаунт HubSpot имеет разрешение создавать запрошенный объект CRM. - У агента или workflow есть обязательные свойства для новой записи. - Если включены associations, связанные записи должны быть действительными и доступными подключённому аккаунту. Что делают инструменты: - Создают контакт, компанию или сделку HubSpot на основе переданных входных данных. - Возвращают информацию о записи, доступную через HubSpot, например ID записи и выбранные свойства. - Не придумывают отсутствующие значения CRM. Обязательные значения должны быть предоставлены пользователем, workflow или подключённым источником данных. ### Обновление CRM-записей Сценарий: дать агенту возможность поддерживать записи HubSpot актуальными, когда пользователь просит изменить поле контакта, компании или сделки. Предварительные требования: - HubSpot подключён в OOMOL. - Подключённый аккаунт HubSpot имеет разрешение обновлять запрошенный объект CRM. - Агент или workflow может найти целевую запись по ID записи HubSpot или пользовательскому уникальному свойству. - Обновлённые значения допустимы для определений свойств HubSpot. Что делают инструменты: - Обновляют поддерживаемые свойства контактов, компаний или сделок HubSpot на основе переданных входных данных. - Возвращают результат обновления, доступный через HubSpot. - Не удаляют записи. ## Тестирование App Вы можете тестировать App HubSpot с любым аккаунтом HubSpot, который вам разрешено авторизовать. Используйте демонстрационные контакты, компании и сделки, чтобы безопасно тестировать поиск, создание и обновление. ### Примеры тестовых prompts - Создай контакт HubSpot с именем `Demo Contact` и e-mail `demo-contact@example.com`. - Найди контакты HubSpot по `demo-contact@example.com`. - Получи контакт HubSpot с e-mail `demo-contact@example.com`. - Обнови контакт HubSpot с e-mail `demo-contact@example.com` и установи должность `Demo Buyer`. - Найди компании HubSpot по `Demo Company`. - Создай компанию HubSpot с именем `Demo Company`. - Найди сделки HubSpot по `Demo Deal`. - Создай сделку HubSpot с именем `Demo Deal` с тестовыми значениями. - Обнови сумму или дату закрытия `Demo Deal`. - Перечисли свойства контактов HubSpot. - Получи определение свойства контакта HubSpot для `email`. Используйте при тестировании только демонстрационные данные. Не используйте реальные данные клиентов в тестовых prompts. ## Устранение неполадок ### Не удаётся добавить App HubSpot - Убедитесь, что вы вошли в правильный аккаунт OOMOL. - Убедитесь, что вы входите в тот аккаунт HubSpot, который хотите подключить. - Подтвердите, что аккаунт HubSpot разрешает запрошенные scopes CRM. - Если аккаунт HubSpot принадлежит организации, спросите администратора HubSpot, требуется ли approval для сторонних apps. - Попробуйте отключить любое неудачное или частичное подключение HubSpot в OOMOL, затем подключите снова. - Если проблема сохраняется, обратитесь в поддержку OOMOL и укажите e-mail аккаунта OOMOL, аккаунт HubSpot или portal ID, время попытки, а также сообщение об ошибке или скриншот. ### Инструмент HubSpot не находит запись - Подтвердите, что подключённый аккаунт HubSpot имеет доступ к запрошенному контакту, компании или сделке. - Подтвердите, что workflow использует правильный ID записи, уникальное свойство, ключевое слово поиска или фильтр. - Проверьте, существует ли запись в аккаунте HubSpot, подключённом к OOMOL. - Если вы недавно изменили разрешения HubSpot, переподключите HubSpot в OOMOL, чтобы обновить состояние авторизации. ### Инструмент HubSpot не может создать запись - Подтвердите, что подключённый аккаунт HubSpot может создать запрошенный контакт, компанию или сделку напрямую в HubSpot. - Проверьте, что включены все обязательные свойства HubSpot. - Проверьте, что переданные значения допустимы для определений свойств HubSpot. - Если включены associations, подтвердите, что связанные записи и типы associations действительны. ### Инструмент HubSpot не может обновить запись - Подтвердите, что подключённый аккаунт HubSpot имеет разрешение обновлять запрошенную запись. - Подтвердите, что workflow использует правильный ID записи HubSpot или пользовательское уникальное свойство. - Проверьте, что обновляемые поля и значения допустимы для HubSpot. - Если свойство только для чтения или ограничено в HubSpot, удалите его из запроса обновления или обновите его напрямую в HubSpot. ## Удаление App Вы можете удалить App HubSpot из OOMOL или HubSpot. Мы рекомендуем удалить её в обоих местах, если вы больше не хотите, чтобы OOMOL имел доступ к HubSpot. ### Удалить HubSpot из OOMOL 1. Войдите в [OOMOL Console](https://console.oomol.com/). 2. Откройте [Connections](https://console.oomol.com/connections). 3. Найдите **HubSpot** среди подключённых apps. 4. Откройте сведения подключения HubSpot. 5. Выберите **Disconnect**, **Remove** или эквивалентное действие удаления, показанное в OOMOL. 6. Подтвердите удаление. ### Удалить OOMOL из HubSpot 1. Войдите в HubSpot. 2. Откройте **Settings**. 3. Откройте **Integrations**, затем **Connected Apps**. 4. Найдите **OOMOL**. 5. Выберите действие, чтобы uninstall, disconnect или remove App. 6. Подтвердите удаление. ## Что происходит после удаления - OOMOL больше не сможет использовать инструменты HubSpot для вашего аккаунта после удаления или деавторизации подключения HubSpot. - Workflows, агенты или Skills, зависящие от HubSpot, могут завершаться ошибкой, пока вы не подключите HubSpot снова. - Существующие записи HubSpot, созданные или обновлённые до удаления, остаются в HubSpot, если вы не измените или не удалите их в HubSpot. - Удаление App не удаляет ваш аккаунт OOMOL. ## Обработка данных OOMOL получает доступ к данным HubSpot только после того, как пользователь HubSpot авторизует App и пользователю или одобренному действию агента требуется HubSpot. OOMOL использует данные HubSpot только для предоставления инструментов HubSpot, запрошенных через поддерживаемых OOMOL агентов, повторно используемые Skills и workflows. - OAuth-токены HubSpot хранятся зашифрованными. - OAuth-токены HubSpot не раскрываются AI-агентам, prompts, файлам проекта или конечным пользователям. - OOMOL может обрабатывать метаданные контактов, компаний, сделок и свойств CRM HubSpot при вызове инструмента HubSpot. - Данные HubSpot могут храниться только по необходимости в видимых пользователю результатах инструментов, записях использования, истории выполнения или операционных записях. - Сохранённые данные шифруются в состоянии хранения и передаются через TLS/SSL. - OOMOL не продаёт ваши данные HubSpot. - OOMOL не использует ваши данные HubSpot для рекламы. - OOMOL не использует приватный клиентский контент для обучения AI-моделей. - Когда вы удаляете или деавторизуете App HubSpot, OOMOL прекращает использовать отозванную авторизацию HubSpot. OOMOL удаляет или инвалидирует сохранённые токены авторизации HubSpot согласно обычному процессу удаления подключения. - Некоторые журналы, записи поддержки, записи безопасности или записи, связанные с биллингом, могут сохраняться, как описано в [политике конфиденциальности](/ru/privacy/). ## FAQ ### OOMOL постоянно синхронизирует данные HubSpot? Нет. OOMOL не синхронизирует и не реплицирует данные HubSpot в фоне постоянно. Доступ к данным HubSpot происходит, когда авторизованный пользователь или одобренное действие агента вызывает инструмент HubSpot. ### Может ли агент автоматически использовать HubSpot после подключения? Подключение HubSpot делает инструменты HubSpot доступными в OOMOL, но использование инструментов всё равно зависит от выбранного агента, workflow, Skill и разрешений. Сервисы на основе аккаунтов по-прежнему требуют вашей авторизации. ### Может ли OOMOL удалять записи HubSpot? Текущий коннектор HubSpot, описанный в этом руководстве, поддерживает поиск, чтение, создание и обновление контактов, компаний и сделок. Инструмента удаления записей в нём нет. ### Можно ли подключить несколько аккаунтов HubSpot? Используйте OOMOL Console, чтобы проверить текущие варианты подключения, доступные вашему аккаунту или workspace. Если нужна помощь с несколькими аккаунтами HubSpot, обратитесь в поддержку. ### Нужен ли платный аккаунт HubSpot? Большинству инструментов OOMOL HubSpot требуется аккаунт HubSpot, который может авторизовать запрошенные scopes CRM. Некоторые функции HubSpot, доступ к объектам, доступ к свойствам или административные настройки могут зависеть от вашего плана HubSpot или настроек организации. ## Связаться с поддержкой Если вам нужна помощь с добавлением, использованием, тестированием или удалением App HubSpot, обратитесь в поддержку OOMOL: - Email: [support@oomol.com](mailto:support@oomol.com) - Страница поддержки: [https://oomol.com/ru/support/](https://oomol.com/ru/support/) Укажите e-mail аккаунта OOMOL, подключённый аккаунт HubSpot или portal ID, если применимо, действие, которое вы пытались выполнить, а также сообщение об ошибке или скриншот.