Интеграции с мессенджерами

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

• Web-widget на сайте (виджет <script> + чат внутри Framix-кабинета) — доступен на всех тарифах;
• Telegram-бот — посетители пишут вашему боту в Telegram (тариф «Профи» и выше);
• VK-сообщество — сообщения в личку сообщества (тариф «Профи» и выше);
• MAX — мессенджер MAX (тариф «Профи» и выше);
• Авито — сообщения в объявлениях (тариф «Бизнес» и выше; требуется платный тариф Авито с доступом к Messenger API).

Какие каналы доступны на вашем тарифе — см. Тарифы и оплата.

Промпт, база знаний, история диалогов, лимиты расходов, захват лидов, 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 админа (нужен для тестового сообщения).

Подключение

/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).

Подключение

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

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

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

MAX

Что нужно

• Заведите бота в MAX через официальный кабинет разработчика мессенджера → получите bot_token.

Подключение

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

1. Введите bot_token.
2. Сохраните.

Framix регистрирует webhook на эндпоинт /api/integrations/max/webhook/<token> — дальше всё работает так же, как в Telegram: тот же промпт, та же история, тот же оператор-takeover.

Канал доступен с тарифа «Профи» и старше.

Авито

Что нужно

• Платный тариф Авито с доступом к Messenger API (обычная бесплатная учётка объявлений сюда не подключится).
• Данные доступа к Messenger API — их выдаёт сама площадка после подключения тарифа.

Подключение

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

1. Введите данные доступа к Messenger API.
2. Сохраните.

Webhook — /api/integrations/avito/webhook/<token>. Бот отвечает на сообщения по объявлениям тем же промптом и той же базой знаний, что и на сайте.

Канал доступен с тарифа «Бизнес» и старше.

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

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

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

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

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

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

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

Захват лидов и продажи в мессенджерах

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

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

Лимиты и rate-limit

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