Интеграции с Telegram и VK

Тот же агент Framix может работать сразу в трёх каналах:

• Web-widget на сайте (виджет <script> + чат внутри Framix-кабинета);
• Telegram-бот — посетители пишут вашему боту в Telegram;
• VK-сообщество — сообщения в личку сообщества.

Промпт, база знаний, история диалогов, лимиты расходов, захват лидов, commerce/services-tools — общие. Меняется только канал и адаптация UI:

• Карусель [[products:...]] в Telegram/VK — нумерованная inline-keyboard вместо горизонтальной карточки.
• Slot-picker — inline-keyboard с callback'ами.
• Кнопка [[pay:...]] — обычная ссылка (embedded YooKassa в Telegram невозможен).

Telegram

Что нужно

• Создайте бота через @BotFather в Telegram → получите bot_token.
• Опционально — узнайте chat_id админа (нужен для тестового сообщения).

Подключение

/account/agents/<id> → вкладка «Интеграции» → блок «Telegram»:

1. Введите bot_token.
2. Опционально — admin_chat_id для тестирования.
3. Сохраните.

Framix регистрирует webhook на эндпоинт /api/integrations/telegram/webhook/<token> — после этого все сообщения боту приходят к вашему агенту, ответ идёт прямо в Telegram.

Тест

В блоке Telegram есть кнопка «Отправить тестовое сообщение» — система пингует Telegram API и присылает «Бот работает» в указанный admin-chat. Если ответ не пришёл — проверьте, что бот не заблокирован, и что в webhook'е Telegram не висит чей-то старый URL.

VK

Что нужно

• Создайте VK-сообщество (если ещё нет).
• В настройках сообщества: Сообщения → включить;
• API → Long Poll API → version: 5.131+;
• API → Группы сообщений → Ключи доступа: создать ключ с правами «Сообщения сообщества». Это будет ваш community_token.
• Узнайте group_id (число в URL'е сообщества vk.com/club12345 → 12345).

Подключение

/account/agents/<id> → вкладка «Интеграции» → блок «ВКонтакте»:

1. Введите community_token.
2. Введите group_id и confirmation_code (VK даст его в настройках callback API).
3. Сохраните.

Endpoint webhook'а — /api/integrations/vk/webhook/<token>. Не забудьте указать его в настройках callback API ВКонтакте.

Сессии и история

Каждая беседа с агентом — это ai_chat_session. Поле channel фиксирует, откуда пришло сообщение: web / telegram / vk. channelMeta хранит платформо-специфичные данные (например, tg_chat_id, tg_message_id для редактирования сообщений со слотами).

В админке /account/agents/<id> → вкладка «Диалоги» все сессии показаны вперемешку — независимо от канала. Около каждой сессии — иконка платформы (🌐 / ✈️ / 🐘).

Подключение оператора в TG/VK

В Telegram/VK операторская takeover работает так же, как в web-виджете:

• Откройте сессию в админке Framix.
• Нажмите «Подключиться к чату» → бот замолкает, ваши сообщения идут в Telegram/VK от имени бота.
• Сообщения оператора помечаются в админке плашкой 👤 Оператор.
• Передача обратно — той же кнопкой.

В Telegram/VK у клиента не видно, что с ним говорит человек, а не бот, — но в админке вы это отслеживаете.

Captura лидов и продажи в TG/VK

captureLeadFromMessage работает одинаково во всех каналах — email/phone из любого сообщения автоматически попадают в CRM. Commerce/services-tools тоже работают:

• search_products → в Telegram рисует нумерованную клавиатуру с фотками товаров (1, 2, 3).
• create_order → сообщение со ссылкой на чекаут (redirect-режим YooKassa).
• book_appointment → бронь создаётся как обычно, в email клиенту приходит cancel-токен.

Лимиты и rate-limit

• Rate-limit на посетителя действует на все каналы. Если у вас на агенте 30/час, то посетитель с одним и тем же (telegram_chat_id | vk_user_id | ip) подпадает под лимит независимо от канала.
• Лимиты расходов (дневной/недельный/месячный) — общие для всех каналов.

Что хранится