Огляд
Інтеграція HubSpot CRM дозволяє агенту створювати та керувати лідами, угодами й контактами безпосередньо у вашому акаунті HubSpot. Це дає AI-асистенту змогу виконувати CRM-операції без участі людини, оптимізуючи продажі й роботу з клієнтами.
Створення API-ключа в HubSpot
- Увійдіть як адміністратор
- Перейдіть у Settings > Integrations > Private Apps

- Натисніть Create a private app
- Вкажіть назву (напр. «MyChatBot Integration»)

- Оберіть усі scopes для потрібного доступу: CRM, CMS, Communication preference, Marketing, Settings, Other
- Натисніть Create App, щоб згенерувати API-ключ
- Запишіть API-ключ, він знадобиться в MyChatBot

Створення інтеграції в MyChatBot
- Перейдіть на вкладку Integrations у кабінеті
- Виберіть агента для підключення до HubSpot

- Прокрутіть до HubSpot CRM у списку інтеграцій
- Натисніть Connect
- Вкажіть свій API Key

- Натисніть 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"