Документация m.AI
Краткое описание разделов и типовых сценариев. Детальная техническая документация по интеграциям хранится в репозитории проекта (например, docs/instagram-chat-integration.md).
Личный кабинет
- Чаты — общий список диалогов из Telegram и Instagram; выбор чата открывает историю и поле для ответа.
- Чат с агентом — диалог с ИИ для запросов «подключи бота», «дай ссылку на инстаграм», «проверь ботов» и т.д. Агент вызывает инструменты и возвращает ссылки или списки.
- База знаний — раздел для добавления и редактирования материалов, по которым ИИ отвечает клиентам в чатах с включённым автоответом.
- Автоответ — настройка автоответа по чатам (включение/выключение для каждого чата).
Подключение Telegram
- Создайте бота через @BotFather, получите токен.
- В чате с агентом m.AI напишите, что хотите подключить бота, и отправьте токен одной строкой — агент вызовет инструмент подключения.
- Вебхук для бота выставляется автоматически на URL вашего сервера. Проверка вебхука доступна через запрос агенту «проверь бота» или «проверь вебхук».
Подключение Instagram
- В чате с агентом попросите «подключи инстаграм» или «ссылка на подключение инстаграм» — будет выдана ссылка.
- Перейдите по ссылке (нужна авторизация в ЛК), разрешите доступ в окне Instagram (Meta). После этого аккаунт появится в разделе чатов; сообщения из Direct начнут приходить в ЛК.
- Поддерживаются только аккаунты Instagram Business/Creator. Для подключения аккаунтов ваших клиентов нужен Advanced Access в Meta (App Review).
- В настройках приложения в Meta укажите URL вебхука
https://modulai.ru/webhook/instagram, Verify Token из .env, подпишитесь на события messages для Instagram. Чтобы в чате также отображались комментарии к постам (в том же диалоге, что и переписка с этим пользователем), подпишитесь на поле comments для Instagram.
Автоответ и база знаний
- В карточке чата включите «Автоответ» — на новые сообщения клиента ИИ будет отвечать на основе базы знаний.
- Добавляйте в базу знаний ответы на частые вопросы, инструкции, ссылки — ИИ подставляет релевантные фрагменты в контекст и формирует ответ.
Поддержка
Вопросы по использованию и настройке: support@modulai.ru или раздел Поддержка.
