AI-агент, который записывает лиды и заказы в KeyCRM

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

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

Подключение авторизуется API-ключом KeyCRM, который администратор создаёт в разделе Settings → General. В MyChatBot вы вставляете его как Access Token и решаете, с какими сущностями и полями будет работать ассистент. В KeyCRM три типа сущностей: Leads (потенциальные продажи), Orders (продажи в процессе) и Contacts (данные клиента). Для каждой доступны стандартные поля KeyCRM и кастомные поля, которые вы создали в своём аккаунте.

Три поля заполняются автоматически. Status соответствует этапу воронки в KeyCRM. Source получает название канала, из которого пришёл чат, например Telegram или WhatsApp, либо значение AI, если канал не указан. Chat Link добавляется к каждому лиду и заказу и хранится в поле комментария менеджера, поэтому менеджер открывает исходный разговор прямо из записи в CRM.

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

После подключения ассистент получает четыре инструмента. Каждое поле, которое вы отметите в Entities & Data Fields Configuration, становится полем, которое он может заполнить.

• create_crm_lead (создание лида): full_name (обязательно), phone, Status и ваши кастомные поля. Контакт создаётся или находится по номеру телефона, лид привязывается к нему, добавляются ссылка на чат и источник.
• edit_crm_lead (обновление лида): меняет имя, телефон, Status или кастомные поля лида, который уже связан с этим клиентом. Контакт сопоставляется по телефону, ссылка на чат и источник остаются на месте.
• create_crm_deal (создание заказа): full_name и phone (оба обязательны), доставка с полями shipping_address_city и shipping_receive_point (обязательно) и товары, каждый с sku, name, price и quantity (обязательно), плюс кастомные поля. Товары сопоставляются с существующими или создаются, а MyChatBot синхронно ведёт собственную запись заказа.
• add_crm_client_contact (добавление или обновление контакта): full_name и phone, оба обязательны. Если у клиента уже есть лид, он обновляется этим контактом, как и карточка клиента в MyChatBot и связанные заказы.

Называть инструменты в инструкциях не обязательно. Опишите обычным языком, когда создавать лид и какой статус ставить, и ассистент сам выберет нужный инструмент. Если включить панель KeyCRM Products, каталог KeyCRM импортируется и индексируется, так что ассистент может находить и советовать товары прямо в чате, а для сложного подбора есть Agentic Search.

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

Интеграции настраиваются для ассистента, а не для отдельного канала. Лиды и заказы могут приходить из каждого канала, подключённого к ассистенту с KeyCRM: виджет на сайте, WhatsApp Business или привязанный личный номер, Telegram-бот или аккаунт Telegram, Instagram (директ и комментарии), Facebook Messenger, TikTok, Viber, Gmail, SMS, чаты покупателей OLX и Webhooks API для вашей собственной системы сообщений.

Поскольку поле Source содержит название канала, в KeyCRM видно, из какого мессенджера пришёл каждый лид. Для AI-звонков канал Calls поддерживает Post-Call Functions, то есть действия вроде записи лида в CRM после разговора. Они добавляют небольшую фиксированную плату к каждому звонку, в котором действительно выполняются.

Пример: от первого сообщения до заказа в KeyCRM

Вот как типичный чат проходит через интеграцию, если Use Leads и Use Deals включены, панель KeyCRM Products активна, а в инструкциях описано, когда создавать лиды и заказы.

1. Клиент пишет вашему Telegram-боту и спрашивает, есть ли куртка его размера. Ассистент ищет в проиндексированном каталоге KeyCRM Products и предлагает подходящие варианты.
2. Клиент просит связаться с ним и оставляет имя и телефон. Ассистент вызывает create_crm_lead с full_name, phone и статусом из ваших инструкций, например «Новый», если именно так называется этап в воронке KeyCRM. Контакт находится или создаётся по телефону, лид привязывается к нему, Source получает значение Telegram, а ссылка на чат попадает в комментарий менеджера.
3. Клиент уточняет варианты доставки и решает купить. Ассистент вызывает edit_crm_lead и переводит лид на этап, который ваши инструкции отводят этому моменту.
4. Покупка подтверждена. Ассистент собирает город доставки и отделение или адрес получения и вызывает create_crm_deal с shipping_address_city, shipping_receive_point и позицией товара: sku, name, price, quantity.
5. Контакт находится или создаётся по телефону, заказ с данными доставки привязывается к нему, а менеджер открывает заказ, переходит по ссылке на чат и видит весь разговор.

Если на любом шаге нужен человек, Handoff Control позволяет оператору перехватить чат: написать стоп-слово или, при включённой неявной передаче, просто ответить клиенту. Если включена тихая передача (Silent handoff), клиент не получает уведомления о переключении.

Настройка за четыре шага

1. В KeyCRM войдите как администратор, откройте Settings → General, нажмите Create New API Key, а затем Save.
2. В MyChatBot откройте Integrations, выберите ассистента в выпадающем списке вверху страницы, найдите KeyCRM и нажмите Connect.
3. Вставьте ключ в поле Access Token и нажмите Submit. Карточка KeyCRM покажет статус Connected для этого ассистента.
4. В панели Entities & Data Fields Configuration включите Use Leads и/или Use Deals, отметьте стандартные и кастомные поля, выберите воронку для новых лидов и нажмите Apply fields. Затем нажмите Sync statuses, чтобы подтянуть этапы воронки.

В конце добавьте в инструкции ассистента правила обычным языком, отправьте в подключённый канал тестовое сообщение с контактами и проверьте, что лид появился в KeyCRM. Гайд по интеграции KeyCRM проводит через каждый экран.

Требования и ограничения

• Тариф. KeyCRM входит в интеграции CRM и ERP на тарифе Pro ($99 в месяц или $89 в месяц при оплате за год) и на старших тарифах. На Standard или без активного тарифа карточка помечена PRO и недоступна для выбора.
• Статусы должны совпадать точно. Значение Status должно совпадать со статусом в KeyCRM до символа. После изменения воронок или этапов в KeyCRM снова нажмите Sync statuses, иначе при создании и обновлении лидов этап не установится.
• Этапы синхронизируются в одну сторону. Sync statuses копирует этапы из KeyCRM в MyChatBot и ничего не меняет в KeyCRM. Перетаскивание карточки на доске Leads в MyChatBot не перемещает лид в KeyCRM: этап в CRM меняется, когда агент обновляет лид через интеграцию.
• Одна CRM на ассистента. Пока KeyCRM подключена, остальные CRM для этого ассистента неактивны. Каждому ассистенту нужно своё подключение, но его можно скопировать из существующего без повторного ввода ключа.
• Права администратора. API-ключ должен создать администратор аккаунта KeyCRM.