Руководство по App HubSpot
OOMOL позволяет один раз подключить HubSpot, а затем сделать авторизованные инструменты HubSpot CRM доступными AI-агентам и повторно используемым Skills, с которыми вы уже работаете. В этом руководстве описано, как добавить App HubSpot, какие разрешения использует OOMOL, что можно делать с HubSpot, как устранять распространённые проблемы и как удалить App.
Предварительные требования
- Аккаунт OOMOL.
- Аккаунт HubSpot, который вам разрешено авторизовать для сторонних apps.
- Доступ к OOMOL Console по адресу https://console.oomol.com/.
- Разрешение в HubSpot авторизовать apps со scopes объектов CRM и схем CRM.
- Тестовые записи контакта, компании и сделки, если вы хотите попробовать инструменты поиска, чтения или обновления.
- Если ваша организация HubSpot ограничивает сторонние apps, администратору HubSpot может потребоваться разрешить App OOMOL до того, как вы сможете её авторизовать.
Добавление App
- Войдите в OOMOL Console.
- Откройте Connectables или перейдите напрямую в Connections.
- Найдите HubSpot.
- Выберите HubSpot, затем выберите Connect.
- OOMOL перенаправит вас в HubSpot. Войдите в HubSpot, если появится запрос.
- Проверьте экран авторизации HubSpot, включая запрашиваемые разрешения CRM.
- Выберите аккаунт HubSpot, который хотите подключить.
- Выберите Connect app или эквивалентное действие авторизации, показанное HubSpot.
- После перенаправления из HubSpot обратно в OOMOL убедитесь, что HubSpot отображается как подключённый в ваших подключениях OOMOL.
Если какой-либо шаг завершился ошибкой, см. Устранение неполадок.
После авторизации OOMOL сохраняет подключение, необходимое для вызова инструментов HubSpot от вашего имени. Затем вы можете использовать инструменты HubSpot из поддерживаемых OOMOL агентов, повторно используемых Skills и workflows.
Использование
Инструменты HubSpot доступны только после подключения аккаунта HubSpot. Точный список инструментов, отображаемый в OOMOL, может меняться при обновлении коннектора, но текущий коннектор HubSpot поддерживает чтение определений свойств CRM, а также поиск, чтение, создание и обновление контактов, компаний и сделок.
Использование инструментов HubSpot с oo-cli
Чтобы сделать подключённые инструменты HubSpot доступными в поддерживаемой среде AI-агента, установите и настройте oo-cli после входа в OOMOL.
- Войдите в OOMOL Console.
- Откройте страницу установки oo-cli.
- Следуйте инструкциям на этой странице. Она предоставляет prompt для копирования в один клик, чтобы установить и настроить
oo-cliв поддерживаемой среде AI-агента. - После настройки
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-maildemo-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
- Войдите в OOMOL Console.
- Откройте Connections.
- Найдите HubSpot среди подключённых apps.
- Откройте сведения подключения HubSpot.
- Выберите Disconnect, Remove или эквивалентное действие удаления, показанное в OOMOL.
- Подтвердите удаление.
Удалить OOMOL из HubSpot
- Войдите в HubSpot.
- Откройте Settings.
- Откройте Integrations, затем Connected Apps.
- Найдите OOMOL.
- Выберите действие, чтобы uninstall, disconnect или remove App.
- Подтвердите удаление.
Что происходит после удаления
- 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 согласно обычному процессу удаления подключения.
- Некоторые журналы, записи поддержки, записи безопасности или записи, связанные с биллингом, могут сохраняться, как описано в политике конфиденциальности.
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
- Страница поддержки: https://oomol.com/ru/support/
Укажите e-mail аккаунта OOMOL, подключённый аккаунт HubSpot или portal ID, если применимо, действие, которое вы пытались выполнить, а также сообщение об ошибке или скриншот.