Подключите первый канал, гайд MyChatBot

Обзор

Интеграция 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

Интеграция KeyCRM