AI-агент, который работает внутри HubSpot

Что даёт подключение HubSpot

Интеграция HubSpot связывает ассистента по продажам MyChatBot с вашим аккаунтом HubSpot. После подключения ассистент ведёт CRM прямо по ходу разговора: создаёт лид, когда человек проявляет интерес, обновляет его по мере диалога, создаёт сделку с товарами и поддерживает контакты в актуальном виде. Никому в команде не нужно вручную переносить имена и телефоны из чата в HubSpot.

Что именно попадает в CRM, решаете вы. После подключения в панели Entities & Data Fields Configuration вы включаете Use Leads и Use Deals, отмечаете стандартные и кастомные поля HubSpot, которые ассистент может заполнять, и выбираете воронку через Select Pipeline. Записываются только поля, которые вы отметили и сохранили кнопкой Apply fields.

Интеграция работает с тремя типами сущностей HubSpot:

• Leads — потенциальные продажи.
• Deals — сделки в работе, при необходимости с товарами в виде line items.
• Contacts — карточки отдельных клиентов, которые создаются или находятся по номеру телефона вместе с лидами и сделками.

Что AI-агент делает в HubSpot

Подключённый ассистент получает четыре CRM-инструмента. Ассистент сам решает, когда их использовать, опираясь на инструкции и разговор.

1. create_crm_lead создаёт лид с полями full_name, phone, Status, hs_pipeline_stage и кастомными полями, которые вы включили. Контакт находится или создаётся по телефону и привязывается.
2. edit_crm_lead обновляет существующий лид: имя, телефон, статус или этап либо любое другое настроенное поле.
3. create_crm_deal создаёт сделку с full_name и phone (оба обязательны), этапом сделки, кастомными полями и products. Каждый товар содержит name, sku, price и quantity. Контакт находится или создаётся, и сделка привязывается к нему.
4. add_crm_client_contact создаёт или обновляет контакт (full_name и phone обязательны). Подходящий лид тоже обновляется, а карточка клиента в MyChatBot остаётся синхронизированной.

Часть полей заполняется автоматически. lead_custom_source получает значение AI- плюс имя ассистента, а deal_source — название канала связи или AI, так что в отчётах HubSpot легко увидеть, какие записи пришли от AI. lead_chat_link и deal_chat_link добавляются к каждому лиду и сделке и открывают именно тот разговор, из которого появилась запись.

Для line items ассистент берёт существующий товар HubSpot, найденный по product_id, line_item_id или названию и SKU, и создаёт новый только тогда, когда совпадения нет, поэтому для новых товаров нужен sku.

Какие каналы передают данные в HubSpot

Интеграция принадлежит ассистенту, а не отдельному каналу. Записью в HubSpot может закончиться разговор в любом канале Sales Platform, подключённом к этому ассистенту: Website Widget, WhatsApp, Telegram-бот или Telegram Account, Instagram, Facebook Messenger, TikTok, Viber-бот или E-Chat Viber, Gmail, SMS, чаты с покупателями OLX, AI-звонки и Webhooks API.

Поскольку deal_source фиксирует канал связи или AI, в отчётах HubSpot проще увидеть, откуда пришли сделки, созданные AI. Контакты находятся или создаются по телефону, поэтому номер, который клиент уже оставлял в другом канале, привязывается к существующему контакту. Включите Lead Phone Required и Deal Phone Required, чтобы ассистент получал телефон до создания записи, и дублей станет меньше.

Пример: от первого сообщения до сделки в HubSpot

Вот как один разговор превращается в записи в CRM, если следовать примерам инструкций из документации. Канал здесь Instagram, но в любом другом подключённом канале всё происходит так же.

1. Первое сообщение. Клиент пишет в Direct и спрашивает о товаре. Ассистент отвечает из базы знаний и просит имя и номер телефона.
2. Лид создан. Клиент оставляет и то и другое. По инструкции вроде «когда клиент проявляет интерес, создай лид со статусом New» ассистент вызывает create_crm_lead. В HubSpot появляется лид, привязанный к контакту с этим номером, с lead_custom_source AI- плюс имя ассистента и lead_chat_link на эту переписку.
3. Обновление статуса. Когда клиент просит перезвонить, ассистент вызывает edit_crm_lead, ставит статус In Progress и записывает удобное время в поле, которое вы включили. Когда интерес подтверждён, статус меняется на Qualified.
4. Сделка создана. Когда клиент подтверждает покупку, ассистент вызывает create_crm_deal с полным именем, телефоном и выбранным товаром в виде line item (название, SKU, цена, количество) и ставит этап Appointment Scheduled. deal_source заполняется автоматически, а deal_chat_link ведёт обратно к разговору.
5. Дальше работает команда. Менеджер открывает сделку в HubSpot и по ссылке на чат читает всю переписку ещё до звонка. Чтобы ответить прямо в чате, он выключает в нём переключатель AI, и чат переходит в режим оператора; параметры передачи человеку настраиваются в Handoff Control.

Настройка в три шага

1. Создайте private app в HubSpot. Войдите как администратор, откройте Settings > Integrations > Private Apps, нажмите Create a private app, задайте название, выберите все scopes (CRM, CMS, Communication preference, Marketing, Settings, Other), нажмите Create App и скопируйте API-ключ.
2. Подключите его в MyChatBot. Откройте Integrations, выберите ассистента в выпадающем списке вверху, найдите HubSpot в разделе CRM Systems, нажмите Connect, вставьте API Key и нажмите Submit. На карточке появится отметка Connected.
3. Выберите сущности и поля. Включите Use Leads и Use Deals, отметьте поля, выберите воронку, нажмите Apply fields и запустите Sync statuses в панели Funnel Status Sync.

Затем обычным языком опишите в инструкциях ассистента, когда действовать: когда создавать лид, какой статус ставить, когда подтверждённая покупка становится сделкой. Названия статусов в инструкциях должны совпадать с воронкой HubSpot. Гайд по настройке HubSpot проводит через каждый экран, а в документации есть полное описание полей (на английском).

Ограничения и требования

• Тариф. На странице тарифов HubSpot указан среди CRM- и ERP-интеграций тарифа Pro, а Multipro и Corporate включают всё, что есть в Pro. На тарифе Standard карточка HubSpot помечена PRO, и выбрать её нельзя.
• Для каждого ассистента отдельно. Подключение действует только для выбранного ассистента; другому нужно собственное или копия через Select Existing Connection.
• Одна CRM на ассистента. Пока HubSpot подключён, остальные инструменты в CRM Systems для этого ассистента неактивны.
• Точные статусы. Значения Status должны точно совпадать с воронкой HubSpot, иначе запись может оказаться не на том этапе. После изменений в воронке снова запустите Sync statuses или указывайте этап по его ID в hs_pipeline_stage.
• Синхронизация этапов в одну сторону. Sync statuses импортирует этапы HubSpot в MyChatBot. Перетаскивание карточки на доске Leads в MyChatBot не перемещает сделку в HubSpot.
• Тесты записывают данные по-настоящему. Инструменты, которые записывают данные, при тестировании действительно выполняются, поэтому проверяйте работу на тестовых данных, которые потом можно удалить.