Подключение Telegram

EasyChat принимает сообщения из Telegram-бота в общий список диалогов. Оператор отвечает из админки или Android-приложения, а клиент получает ответ в том же Telegram-чате.

Что Подготовить

• Telegram-бот, созданный в @BotFather.
• Ключ бота из BotFather.
• Доступ администратора EasyChat.
• Рабочий сайт по HTTPS.

Ключ бота храните как пароль: не вставляйте его в скриншоты, переписки и публичные инструкции.

Создать Или Найти Бота

В Telegram откройте @BotFather.

• Для нового бота используйте /newbot.
• Для существующего бота используйте /mybots и выберите нужного бота.

Скопируйте ключ полностью.

Подключить В EasyChat

Откройте EasyChat → Интеграции → Telegram.

1. Вставьте ключ в поле Bot Token.
2. Дождитесь автоматической проверки.
3. Если нужно, нажмите Проверить и подключить.
4. Убедитесь, что карточка показывает статус Подключено.

Проверить Первый Диалог

1. Откройте бота в Telegram как обычный пользователь.
2. Нажмите Start или отправьте сообщение.
3. В EasyChat должен появиться диалог с источником Telegram.
4. Ответьте из EasyChat.
5. Проверьте, что ответ пришел пользователю в Telegram.

Затем удерживайте кнопку микрофона и отправьте боту короткое голосовое. В диалоге EasyChat появится плеер, а под ним — автоматически подготовленный текст. Голосовое можно слушать на скорости 1×, 1,5× или 2×, перематывать и копировать расшифровку. Поддерживаются сообщения до 20 МБ и 15 минут.

Пересланные Сообщения И Фото

Если пользователь пересылает боту текст или фотографию из другого диалога, EasyChat сохраняет вложение в обычной истории и показывает над ним отметку Переслано. Когда Telegram разрешает раскрыть источник, рядом отображается имя пользователя, группы или канала. Для скрытого автора EasyChat использует безопасную подпись, которую передал сам Telegram, и не показывает внутренние идентификаторы исходной переписки.

Для проверки перешлите боту фотографию из другого чата. В EasyChat должны появиться сама фотография, подпись при наличии и отметка пересылки.

Если Сообщения Не Приходят

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

Если Проверка Показывает cURL 7 Или 28

Это ошибки сетевого маршрута, а не ключа Telegram:

• cURL 7 — сервер не смог подключиться к адресу или порту proxy;
• cURL 28 — proxy или внешний сервис не ответил за отведенное время.

Откройте Параметры и диагностика → Proxy, проверьте host, port, тип proxy и логин. Убедитесь, что для Telegram выбран нужный маршрут, сохраните настройки и повторите проверку. Если прямой маршрут работает, а proxy дает 7 или 28, замените proxy: Telegram-бот и его ключ здесь ни при чем.

Частые Ситуации

• EasyChat пишет, что ключ неверный. Скопируйте ключ из BotFather заново.
• Бот подключен, но сообщений нет. Проверьте HTTPS сайта и фоновые задачи.
• После замены ключа старый бот не отвечает. Нажмите Проверить и подключить еще раз.
• Нужна поддержка. Отправьте скриншот статуса без ключа и личных сообщений.

Мини-Чеклист

• Бот создан в BotFather.
• Ключ вставлен в EasyChat.
• Статус подключения зеленый.
• Тестовое сообщение появилось в EasyChat.
• Оператор отправил ответ.
• Голосовое воспроизводится и получило расшифровку.
• Пересланная фотография появилась с отметкой Переслано.