Что такое подключение
Канал клиента, инструмент агента и marketplace-карточка — три разные сущности. Как их различать и где какой настраивать.
Три типа подключений
В AGONTS термин «подключение» накрывает три разные вещи. Чтобы не путаться, запомните:
Канал связи с клиентом
Куда клиент пишет / звонит. Сайт, мессенджер, почта, телефон.
Инструмент AI-сотрудника
Чем агент пользуется во время ответа. CRM, база, календарь, поиск.
Карточка в каталоге
Унифицированная настройка. Может быть каналом, инструментом или и тем и другим.
Канал связи
Внешний клиент пишет AGONTS, система создаёт сессию, вызывает AI-сотрудника, при необходимости передаёт оператору. Здесь живут вещи вроде:
- виджет на сайте
- Telegram-бот
- email inbox
- голосовой канал по SIP
- Avito/мессенджеры маркетплейсов
Канал отвечает за: входящий webhook или polling, маппинг внешнего идентификатора клиента, lifecycle сессии, политику передачи оператору и расписание работы.
Не все каналы готовы. Telegram, WhatsApp и email-inbox в активной разработке — на странице каждого канала указан текущий статус.
Инструмент агента
AI-сотрудник вызывает инструмент, чтобы посмотреть данные или совершить действие во время ответа. Примеры:
- поиск по документам (RAG)
- SQL-запрос к корпоративной базе
- POST в CRM (создать лид, обновить сделку)
- запрос к 1C OData
- календарь, отправка email
- собственный API через MCP
Инструмент привязывается к конкретному AI-сотруднику или ко всем сразу. Включается в его конфигурации (Агенты → … → Инструменты).
Карточка в каталоге
Каталог Подключения — это унифицированная UX-карточка. Одна карточка может одновременно создавать канал и инструмент. Например:
- Bitrix24: инструмент (создать лид через API) + канал (открытые линии — в работе).
- Email: инструмент (
send_email) + канал (IMAP inbox — roadmap).
Карточка проводит вас по wizard: выбор метода → ввод credentials → проверка → привязка к AI-сотруднику или сценарию → отправка тестового события.
Как выбрать
| Что вам нужно | Где настраивать |
|---|---|
| Клиент пишет в виджет на сайте → отвечает AI | Канал «Сайт» |
| Клиент пишет в Telegram → отвечает AI | Канал «Telegram» (по мере готовности) |
| AI должен искать ответ в ваших документах | Документы + база знаний |
| AI должен класть лида в CRM | Инструмент «Bitrix24» / «amoCRM» |
| AI должен дёргать ваш API | Инструмент «Свой MCP» или «Custom API» |