Обзор
Интеграция Kommo CRM позволяет агенту создавать и управлять сделками и контактами прямо в вашем аккаунте Kommo. Это даёт AI-ассистенту возможность выполнять CRM-операции без участия человека, оптимизируя продажи и работу с клиентами.
Создание приложения в Kommo
- Войдите в аккаунт Kommo как администратор
- Перейдите в Settings

- Нажмите Create Integration
- Заполните нужную информацию: Redirect URI = https://app.mychatbot.app/integration?integration=Kommo; Integration name = MyChatBot Integration; загрузите файл виджета (Download widget.zip)

- Нажмите Generate long-lived token, чтобы создать API-токен

- Выберите срок действия, 5 лет

- Скопируйте Long-lived token
Создание интеграции в MyChatBot
- Перейдите на вкладку Integrations в кабинете
- Выберите агента для подключения к Kommo

- Прокрутите до Kommo CRM в списке интеграций
- Нажмите Connect
- Укажите Domain (напр. your-company.kommo.com) и API Key (Secret Key из вашей интеграции Kommo)

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

Включите Use Deals для управления сделками. Для сущности выберите стандартные поля Kommo и кастомные поля, затем нажмите Apply fields. Кнопкой Sync statuses синхронизируйте статусы воронки.
Типы сущностей: Deals и Contacts. Типы полей: Standard и Custom. Специальные поля: Status (должен совпадать со статусами Kommo; обновляется через Sync statuses), Source (автоматически «AI-» + имя ассистента), Chat Link (автоматически как комментарий со ссылкой на разговор). Воронки: выберите воронку в кабинете; агент использует её при создании сделок.
Доступные инструменты
После подключения агент получает два инструмента:
1. edit_crm_deal, обновляет существующие сделки или создаёт новые (full_name обязательно, phone, price опционально, Status, кастомные поля). Контакт автоматически создаётся/находится по телефону, сделка привязывается, добавляется chat link, source идентифицирует AI.
2. add_crm_client_contact, создаёт/обновляет контакты (full_name обязательно, phone обязательно). Если сделка уже существует, обновляется; данные клиента в MyChatBot также обновляются.
Настройка в инструкциях агента
Создание и обновление сделок:
When a customer expresses interest in our services, use edit_crm_deal in Kommo with the following information:
- Use their full name
- Include their phone number
- Set price if provided
- Set status to "New"
- Add any relevant notes to the comments fieldПродвижение сделки:
When a customer completes a payment:
1. Use edit_crm_deal to update the deal stage to "Closed Won"
2. Update the deal amount to match the final purchase value
3. Add payment details to the comments field