Все гайды
Интеграции Продвинутый уровень 9 мин чтения

Интеграция HubSpot CRM

Создавайте и управляйте лидами, сделками и контактами прямо в вашем аккаунте HubSpot.

Обзор

Интеграция HubSpot CRM позволяет агенту создавать и управлять лидами, сделками и контактами прямо в вашем аккаунте HubSpot. Это даёт AI-ассистенту возможность выполнять CRM-операции без участия человека, оптимизируя продажи и работу с клиентами.

Создание API-ключа в HubSpot

  1. Войдите как администратор
  2. Перейдите в Settings > Integrations > Private Apps
Private Apps
  1. Нажмите Create a private app
  2. Укажите название (напр. «MyChatBot Integration»)
Название приложения
  1. Выберите все scopes для нужного доступа: CRM, CMS, Communication preference, Marketing, Settings, Other
  2. Нажмите Create App, чтобы сгенерировать API-ключ
  3. Запишите API-ключ, он понадобится в MyChatBot
Копирование токена

Создание интеграции в MyChatBot

  1. Перейдите на вкладку Integrations в кабинете
  2. Выберите агента для подключения к HubSpot
Выбор агента
  1. Прокрутите до HubSpot CRM в списке интеграций
  2. Нажмите Connect
  3. Укажите свой API Key
Ввод токена
  1. Нажмите Submit, чтобы сохранить интеграцию

Настройка сущностей и полей данных

После подключения настройте, к каким сущностям и полям будет иметь доступ агент:

Настройка сущностей

Включите Use Leads и Use Deals. Для каждой сущности выберите стандартные поля HubSpot и кастомные поля, затем нажмите Apply fields. Кнопкой Sync statuses синхронизируйте этапы воронки.

Типы сущностей: Leads, Deals, Contacts. Типы полей: Standard и Custom. Специальные поля: Status (значения «New», «In Progress», «Qualified», «Disqualified»; должен совпадать с HubSpot), hs_pipeline_stage (уникальный ID этапа, альтернатива Status), lead_custom_source (автоматически «AI-» + имя ассистента), deal_source (автоматически канал или «AI»), lead_chat_link и deal_chat_link (автоматические ссылки на разговор). Товары: сделки могут содержать товары как line items через параметр products, каждый с name, sku (обязательно при создании нового), price, quantity; ссылка через product_id, line_item_id или name+sku.

Доступные инструменты

После подключения агент получает четыре инструмента:

1. create_crm_lead, создаёт лидов (full_name, phone, Status, hs_pipeline_stage, кастомные поля). Контакт автоматически создаётся/находится по телефону, лид привязывается, добавляется chat link, source идентифицирует AI.

2. edit_crm_lead, обновляет существующих лидов (full_name, phone, Status, hs_pipeline_stage, кастомные поля).

3. create_crm_deal, создаёт сделки (full_name обязательно, phone обязательно, products [name, sku, price, quantity], Deal Stage, кастомные поля). Контакт автоматически создаётся, сделка привязывается, товары добавляются, chat link добавляется.

4. add_crm_client_contact, создаёт/обновляет контакты (full_name обязательно, phone обязательно). Обновляет существующего лида и данные клиента в MyChatBot.

Настройка в инструкциях агента

Создание сделок:

When a customer confirms a purchase intention, use create_crm_deal in Hubspot:
- Use their full name
- Include their phone number
- Add products they're interested in:
  [ { "name": "Product Name", "sku": "SKU123", "price": "99.99", "quantity": 1 } ]
- Set Deal Stage to "Appointment Scheduled"

Обновление статуса лида:

When a customer requests a call back:
1. Use edit_crm_lead to update the lead status to "In Progress"

When a customer confirms interest:
1. Use edit_crm_lead to update the lead status to "Qualified"