Огляд
Інтеграція KeyCRM дозволяє агенту створювати та керувати лідами, замовленнями й контактами безпосередньо у вашому акаунті KeyCRM. Це дає AI-асистенту змогу ефективно вести роботу з клієнтами без участі людини, оптимізуючи ваш процес продажів.
Створення застосунку в KeyCRM
- Увійдіть в акаунт KeyCRM як адміністратор
- Перейдіть у Settings → General

- Натисніть Create New API Key

- Натисніть Save, щоб зберегти API-ключ
Створення інтеграції в MyChatBot
- Перейдіть на вкладку Integrations у кабінеті
- Виберіть агента для підключення до KeyCRM

- Прокрутіть до KeyCRM у списку інтеграцій
- Натисніть Connect
- Вкажіть Access Token (ваш API-ключ KeyCRM)

- Натисніть Submit, щоб зберегти інтеграцію
Налаштування сутностей і полів даних
Після підключення налаштуйте, до яких сутностей і полів матиме доступ агент:

Увімкніть Use Leads для керування лідами та Use Deals для керування замовленнями. Для кожної сутності оберіть стандартні поля KeyCRM і кастомні поля, потім натисніть Apply fields. Кнопкою Sync statuses синхронізуйте актуальні статуси воронки.
Типи сутностей: Leads (потенційні можливості), Orders (продажі в процесі), Contacts (дані клієнта). Типи полів: Standard (типові поля KeyCRM) і Custom (ваші специфічні). Спеціальні поля: Status (має точно збігатися зі статусами KeyCRM; оновлюється через Sync statuses), Source (автоматично, канал «Telegram»/«WhatsApp» або «AI»), Chat Link (автоматичне посилання на розмову, зберігається в полі коментаря менеджера). Воронки: виберіть воронку в кабінеті; агент використовує її при створенні лідів, проводячи їх по етапах.
Доступні інструменти
Після підключення агент отримує чотири інструменти:
1. create_crm_lead, створює лідів (параметри: full_name обов'язково, phone, Status і налаштовані кастомні поля). Контакт автоматично створюється/знаходиться за телефоном, лід прив'язується, додається chat link, а source ідентифікує вашого AI-асистента.
2. edit_crm_lead, оновлює наявних лідів (автоматично використовує ліда клієнта; оновлює full_name, phone, Status, кастомні поля) з тією ж логікою контакту/chat-link/source.
3. create_crm_deal, створює замовлення (параметри: full_name обов'язково, phone обов'язково, shipping {shipping_address_city, shipping_receive_point} обов'язково, products [sku, name, price, quantity] обов'язково, кастомні поля). Товари зіставляються або створюються; додається інформація про доставку.
4. add_crm_client_contact, створює/оновлює контакти (full_name обов'язково, phone обов'язково). Якщо лід уже існує, оновлюється; дані клієнта в MyChatBot і пов'язані замовлення також оновлюються.
Налаштування в інструкціях агента
Створення лідів:
When a customer expresses interest in our services, use create_crm_lead to add them to KeyCRM with the following information:
- Use their name as the lead title
- Include their phone number
- Set status to "New"
- Add any relevant information to custom fieldsСтворення замовлень:
When a customer confirms a purchase intention, use create_crm_deal to create an order in KeyCRM:
- Use their full name
- Include their phone number
- Add shipping information (city for delivery; branch or address for самовивіз)
- Add the products they're interested in (name, SKU, price, quantity)Оновлення статусу ліда:
When a customer requests a call back:
1. Use create_crm_lead if they're new
2. Use edit_crm_lead to update status to "Callback Requested"
3. Add the preferred зворотний дзвінок time to comments