Как подключить ИИ-агента к Telegram через Chiho

Чтобы подключить ИИ-агента к Telegram, подключите свой аккаунт Telegram в Chiho, добавьте https://api.chiho.ai/mcp в совместимый MCP-клиент и пройдите OAuth в браузере. Затем проверьте аккаунт и область доступа через auth_status, прежде чем просить агента прочитать один выбранный разговор.

Это руководство описывает размещённое подключение Chiho и отдельный вариант с локальной средой выполнения. MCP предоставляет инструменты, а навык — инструкции рабочего процесса. Установка навыка не разрешает доступ к вашему аккаунту Telegram.

Примечание о проверке — 8 сентября 2026: Эти инструкции сверены с текущей реализацией Chiho, локальной справкой команд Codex и документацией клиентов по ссылкам. При этом обновлении не выполнялась новая настройка клиента с авторизацией и не читались разговоры клиентов. Упражнение ниже — контрольный список приёмки, а не отчёт о наблюдаемых результатах аккаунта. Имеющееся изображение в заголовке показывает входящие Chiho, а не проверку настройки OAuth.

Выберите подключение, которым собираетесь пользоваться

Chiho Cloud — размещённый вариант для работы с Telegram и CRM. Ваш ИИ-клиент подключается к удалённому сервису MCP Chiho и предлагает войти и дать согласие в браузере. Изучите справочник по настройке Telegram MCP вместе с этим руководством.

tgchats local — отдельная локальная среда выполнения с открытым исходным кодом в репозитории Telegram для агентов. Если хотите самостоятельно обслуживать локальную среду, следуйте актуальным инструкциям по установке и эксплуатации из этого репозитория. Настройка и обязанности по хранению данных отличаются от размещённого подключения; успешный вход в облако не подтверждает работоспособность локальной среды.

Если вы ещё выбираете тип системы, руководство по CRM для Telegram объясняет процесс работы с отношениями, а статья CRM, боты и общие входящие сравнивает подходы.

Перед подключением: аккаунт, клиент и разговор

Подготовьте аккаунт Chiho с подключённым Telegram, клиент с поддержкой удалённого HTTP MCP и OAuth в браузере и определитесь с личным или командным контекстом. Для первого упражнения выберите один разговор, который вы вправе просматривать. Не начинайте со всех входящих или запроса на отправку сообщений.

Изучите правила обработки данных вашего ИИ-клиента и правила организации, прежде чем разрешать ему получать содержимое разговоров. Chiho хранит размещённую сессию Telegram внутри своего сервиса, но сведения, возвращаемые инструментами, передаются подключённому ИИ-клиенту. Опубликованные условия обработки приведены в политике конфиденциальности Chiho.

Используйте производственный ресурс точно в указанном выше виде. Ресурс staging предназначен для изолированного тестирования перед выпуском; разрешения для production и staging не взаимозаменяемы.

Подключите размещённый сервис MCP

Codex

Выполните эти команды в терминале, где установлен Codex:

codex mcp add chiho --url https://api.chiho.ai/mcp
codex mcp login chiho

Вторая команда запускает авторизацию в браузере. После согласия вернитесь в интерфейс Codex, использующий эту сохранённую конфигурацию, и запросите auth_status. Если сервер не отображается, проверьте, использует ли этот интерфейс ту же конфигурацию, что и терминал. Размещённая конечная точка и контекст настройки описаны в справочнике по настройке клиента Chiho.

Claude Code

Добавьте удалённый HTTP-сервер:

claude mcp add --scope user --transport http chiho https://api.chiho.ai/mcp

В Claude Code откройте /mcp и завершите аутентификацию Chiho. Затем запросите auth_status. Документация MCP Anthropic объясняет настройку удалённого HTTP-подключения и аутентификацию. Клиентские средства контроля и доступные возможности подключения могут различаться; проверьте документацию для используемой версии.

Другие совместимые клиенты

Используйте настройку пользовательского удалённого MCP-подключения в клиенте с тем же производственным URL. Для OAuth-процесса публичного клиента Chiho оставьте необязательные поля идентификатора клиента и секрета пустыми, если служба поддержки не предоставила учётные данные управляемого развёртывания. Пройдите согласие в браузере, вместо того чтобы копировать токен предъявителя в файл конфигурации.

Chiho доступен в каталоге плагинов ChatGPT. Установите плагин в ChatGPT или Codex и пройдите авторизацию в браузере этого клиента. Локальная конфигурация Codex не устанавливает плагин в веб-версию ChatGPT.

Клиент, который может связаться с сервером, не обязательно завершил авторизацию. Не считайте значок подключённого транспорта доказательством доступности нужного аккаунта Telegram.

Рассматривайте экран согласия как решение о доступе

Перед согласием проверьте личность клиента, хост перенаправления, аккаунт Chiho, личную или командную область и полный набор разрешений. Интерактивное разрешение Chiho включает поддерживаемые возможности чтения и записи; начало с запроса только на чтение не превращает само разрешение в разрешение только на чтение.

Командные разрешения ограничивают инструменты аккаунтами и разговорами, доступными команде. Поиск командных сообщений требует конкретного чата, а операции с папками всего личного аккаунта и выход из аккаунта недоступны в командном контексте. Поэтому отсутствие разговора может означать границу доступа, а не неисправность подключения.

Запросы разрешений на инструменты в клиенте и защитные проверки выполнения в Chiho — отдельные средства контроля. Изучите оба, прежде чем переходить от чтения к другим действиям:

• Прямые изменения существуют. Отправка одного сообщения, теги CRM, задачи, правила автоматизации, операции с папками, обновление сводок и выход из аккаунта могут выполняться после применимых клиентских средств контроля и серверных проверок. Инструмент message_send_draft отправляет сообщение; не делайте вывод, что он лишь сохраняет черновик.
• Подтверждение исходящих зависит от операции. Предпросмотры для нескольких получателей требуют подтверждения. Предпросмотр исходящего для одного получателя также требует его, если подключение использует режим постоянного запроса подтверждения.
• Приглашения участников и выход из групп требуют сохранённых предпросмотров и подтверждения перед выполнением.
• Предпросмотр не является отправкой, но он может сохранять состояние подтверждения. Для строго ограниченного чтением приёмочного упражнения такой инструмент не подходит.

Фраза «не отправляй» помогает определить задачу, но не заменяет разрешения инструментов. Аналогично установка навыка рабочего процесса не меняет разрешение доступа. Изучайте любой навык, создающий задачи или обновляющий сводки, как процесс, содержащий изменения.

Проведите одно приёмочное упражнение только с чтением

Используйте этот пример запроса после авторизации. Замените описание своим выбранным разговором, к которому у вас есть разрешённый доступ:

Сначала вызови auth_status и подтверди подключённый аккаунт и личный или командный контекст. Найди выбранный мной разговор и попроси меня разрешить любую неоднозначность совпадения. Прочитай только его недавние сообщения. Перечисли открытые вопросы, явные обязательства и неясности, указав сообщения-источники для каждого пункта. Укажи временной диапазон и ограничения пагинации. Не отправляй сообщения, не создавай задачи, не меняй поля CRM, не обновляй сводки, не запускай синхронизацию и не готовь предпросмотры изменений.

Самостоятельно сверьте результат с разговором:

1. Личность: Возвращённый аккаунт и область доступа соответствуют задуманному контексту. Остановитесь, если это не так.
2. Цель: Выбран правильный разговор. Похожие названия требуют уточнения, а не догадки о получателе.
3. Охват: Агент сообщает, что прочитал. Страница диалогов или сообщений не доказывает полноту истории; продолжайте пагинацию только при необходимости и наличии разрешения.
4. Обоснование: Каждое заявленное обязательство или открытый вопрос подтверждается сообщениями. Недостающие сведения остаются неизвестными и не превращаются в выдуманный срок или ответственного.
5. Последствия: История инструментов содержит только предусмотренные чтения. Полезная текстовая сводка в разговоре с ИИ не требует сохранения сводки в CRM или создания задачи.

Например, в вымышленном разговоре клиент просит предложение, а коллега говорит «Я отправлю его в пятницу». Полезный ответ отделяет вопрос клиента от обязательства коллеги. Он не должен утверждать, что предложение отправлено, без подтверждающего сообщения. Это иллюстративный пример оценки, а не сведения о клиенте или измеренный результат.

Запишите клиент и версию, дату проверки, контекст аккаунта без частных идентификаторов, использованные инструменты и результат пяти проверок: пройдено или нет. Не помещайте токены или личные сообщения в общий протокол проверки. Расширяйте процесс только после того, как это небольшое упражнение работает ожидаемым образом.

Найдите причину сбоя на конкретном шаге

Авторизация не завершается: Перепроверьте точный удалённый URL, завершите согласие в браузере и убедитесь, что входите в нужную среду Chiho. Отозванное подключение требует нового согласия. Удалите учётные данные и личное содержимое, прежде чем передавать ошибку службе поддержки.

Авторизация работает, но разговоры отсутствуют: Проверьте подключение Telegram в Chiho, выбранный аккаунт и командные границы разрешения. Сравнивайте однородные списки: dialogs_list постранично перечисляет диалоги Telegram; crm_dialogs_list — сохранённые записи CRM Chiho. Длина возвращённой страницы не равна общему числу записей аккаунта, и ни один список не является числом контактов адресной книги.

В сводке лишь часть истории: Попросите агента сообщить запрошенный диапазон, возвращённый диапазон и состояние продолжения. Не позволяйте ему описывать частичное чтение как проверку всех входящих.

Telegram просит систему подождать: Соблюдайте возвращённую информацию об ожидании и повторной попытке. Устойчивая синхронизация Chiho может сообщить waiting_for_telegram с временем возобновления. Постоянный перезапуск не снимает ограничения Telegram, и это руководство не обещает неограниченную пропускную способность.

Инструмент отсутствует или изменение отклонено: Проверьте список инструментов после аутентификации, область доступа, клиентские средства контроля и необходимое состояние предпросмотра или подтверждения. Не расширяйте доступ только ради исчезновения ошибки. Вернитесь к минимальному действию, которое действительно требуется вашему процессу.

Отзовите доступ и выберите следующий процесс

Откройте подключённые ИИ-клиенты в Chiho, чтобы проверить клиент и область доступа. Отзовите подключение, когда оно больше не нужно; Chiho аннулирует его токены доступа и обновления, а повторное подключение требует нового согласия. Удаление сервера из конфигурации ИИ-клиента — отдельная обслуживающая операция. Отзыв не может вернуть содержимое, уже переданное клиенту.

Для управляемых заданий без участия пользователя изучите расширенное руководство по служебным токенам. Служебные токены не относятся к обычному интерактивному подключению и не должны попадать в снимки экрана, общие конфигурации или сообщения службе поддержки.

После упражнения только с чтением выберите один ограниченный процесс: выявление обязательств с навыком задач дальнейших действий или организацию разговора с навыком оценки потенциальных клиентов. Перед запуском изучите изменения, выполняемые навыком. Руководство по приоритетным дальнейшим действиям объясняет разные назначения задач и сообщений клиентам.

Подключите Telegram в Chiho, пройдите авторизацию в браузере и проверьте один выбранный разговор, прежде чем поручать агенту более широкую работу.