Подключите бота, которому пишут ваши клиенты. Входящие сообщения появятся в «Диалогах», а ответы операторов уйдут клиентам от имени этого бота.
Это клиентский канал. Telegram desk — отдельное подключение для работы операторов из Telegram.
Получите токен бота
Откройте @BotFather в Telegram. Создайте бота командой /newbot или через мини-приложение: задайте название и username с окончанием bot. Затем скопируйте выданный токен.
Если бот уже создан, выберите его в «My bots» в BotFather и скопируйте токен. Он даёт управление ботом: передавайте его только тем, кто настраивает подключение.
Подключите бота в Tygy
В нужном проекте откройте «Настройки» → «Каналы» → «Telegram». Вставьте токен в поле «Токен бота» и нажмите «Подключить».
Для подключения нужно право управлять Telegram-интеграциями. После подключения в настройках появятся имя бота, его статус и ссылка «Открыть в Telegram».
Если бот уже работал в другом сервисе
Подключение переключит доставку новых сообщений на Tygy. Если этот же бот был подключён к другому проекту Tygy, он перейдёт в текущий проект. Используйте отдельного бота, если прежнее подключение должно продолжить работу.
Проверьте канал
В настройках подключённого бота нажмите «Проверить связь». Проверка покажет, отвечает ли бот и направляет ли Telegram сообщения в Tygy.
Чтобы проверить обмен в обе стороны, откройте бота в Telegram, нажмите «Начать» и отправьте сообщение. Ответьте на него из «Диалогов» в Tygy — ответ должен прийти в тот же чат Telegram.
Сообщения из групп
По умолчанию сообщения из групп и супергрупп не принимаются. Для них есть отдельная настройка «Принимать сообщения из групп и супергрупп». Приём также зависит от прав бота и режима конфиденциальности в Telegram.
Подробнее о создании бота и токенах — в документации Telegram.
Что приходит от клиента
Фото, видео, голосовые, кружки, живые фото, документы и стикеры приходят оператору файлами. Геопозиция, место, пересланный контакт, опрос и список задач приходят понятным текстом — например, геопозиция со ссылкой на карту.
Если файл не удалось загрузить — например, он больше 20 МБ, — оператор увидит пометку «Откройте чат в Telegram». Такая же пометка приходит вместо сообщения, которое Tygy пока не умеет показывать.
Как выглядят сообщения клиенту
Кнопки сообщений сценария — варианты ответа, «Оценка оператора», выбор темы — стоят прямо внутри сообщения бота, оформление текста при этом сохраняется. Как оформлены ответы AI-оператора, описано в статье Настройка AI-оператора.
