Telegram
Last updated
Last updated
Telegram — мессенджер, имеющий веб версию, десктоп версию, а также версию для мобильных устройств. Имеет встроенный функционал чат-ботов.
В первую очередь нужно произвести конфигурацию на стороне Telegram.
Откройте Telegram и авторизуйтесь.
Найдите в поиске бота “BotFather”.
.
Создайте бота в Telegram:
Отправьте боту BotFather команду /newbot.
В ответ на сообщение бота введите желаемое имя вашего бота.
Отправьте желаемый идентификатор бота. Он должен быть уникальным среди всех существующих ботов в Telegram и заканчиваться на “bot”. Например, My_new_telegram_bot_username_bot.
Если отправленный идентификатор бота соответствует требованиям, вы получите сообщение об успешном создании бота. В сообщении будет указана ссылка на вашего бота в Telegram и токен доступа к боту.
Скопируйте в удобное место токен доступа.
Настроить аватар, описание, и прочие параметры бота вы можете через бота BotFather.
На этом конфигурация Бота в Telegram завершена.
Агенту необходимо создать и настроить Канал Проекта с коннектором “Telegram”.
Выберите Telegram.
Канал Проекта будет сохранен и активирован, если:
Агент обучен;
токен в поле Telegram bot token уникален (нет ли активных Канал Проекта того же типа с тем же значением в поле);
будет доступен адрес Канал Проекта;
удастся зарегистрировать вебхук канала.
Канал Проекта будет сохранен, но не активирован, если одно или больше условий не будут выполнены.
Чтобы отредактировать значение в любом поле, кликните по полю и впишите новое значение.
Изменения будут применены, если:
Агент обучен;
токен в поле Telegram bot token уникален (нет ли активных Канал Проекта того же типа с тем же значением в поле);
будет доступен адрес Канал Проекта;
удастся зарегистрировать вебхук канала.
Изменения не будут применены, если одно или больше условий не будут выполнены.
Изменения будут применены и Канал Проекта будет активирован, если:
Агент обучен;
токен в поле Telegram bot token уникален (нет ли активных Канал Проекта того же типа с тем же значением в поле);
будет доступен адрес Канал Проекта;
удастся зарегистрировать вебхук канала.
Изменения будут применены, но Канал Проекта не будет активирован, если одно или больше условий не будут выполнены.
Бот может быть добавлен в групповой чат Telegram и обрабатывать сообщения и события этого чата.
Чтобы Бот обрабатывал все сообщения, отправляемые в группу, необходимо обеспечить ему доступ ко всем сообщениям, выключив настройку Group Privacy:
Перейти в BotFather;
Написать команду /mybots;
Выбрать нужного Бота;
Перейти в Bot Settings → Group Privacy;
Выбрать Turn off.
При включенной настройке Group Privacy, чтобы отправить сообщение, которое будет обработано Агентом и записано в client_message, нужно либо ответить на сообщение Бота (reply), либо написать свое сообщение после символа / .
После каждого обработанного сообщения, в Канальные переменные будут установлены данные участника группы, отправившего сообщение.
Также, Агент обрабатывает события о добавлении в групповой чат новых пользователей. При этом в переменную client_message будет записана строка вида “telegram_chat_new_member: telegram_user_id|telegram_username|telegram_first_name|telegram_last_name” .
При обновлении группы до супергруппы генерируется новый идентификатор группы и Агент не может отправить сообщение.
Пользователь группы телеграм присоединился в группу
Строка: telegram_chat_new_member: {user.id}|{user.first_name}|{user.last_name}
Пользователь группы телеграм покинул в группу
Строка: telegram_member_left_chat: {user.id}|{user.first_name}|{user.last_name}
О том, что такое сервисные сообщения и как активировать их передачу из Конечный канал: Принцип вывода Агента в различные каналы
id
При ответе на сообщение бота в групповом чате, в переменную записывается id ответившего юзера
id
first_name
last_name
username
reply_to_message.text
Если Сообщение собеседника не является ответом (Reply) на сообщение Бота в Telegram, то переменная остается пустой
Да
Формат: channel_visitor_id|telegram
Да
Нет
В мессенджере нет такого функционала
Да
Да
Файл будет передан ссылкой, если он не удовлетворяет требованиям Telegram к файлам данного типа.
Да
Да
Да
В client_message записывается строка вида location:Широта|Долгота, например, location:83.000000|54.000000
Да
Допускаются сообщения до 4096 символов
Да
Нет
Кликните по кнопке настроек Агента.
Нажмите кнопку Add channel.
Откроется панель выбора Конечный канал.
Откроется панель создания Канал Проекта.
По необходимости пропишите заголовок для данного Канал Проекта в поле названия с плейсхолдером New channel.
Вставьте скопированный ранее токен в полеTelegram bot token.
По необходимости переключите тумблер Receive service messages, чтобы получать Сервисные сообщения канала.
Для сохранения Канал Проекта без его активации, нажмите кнопку CREATE.
Для сохранения и активации Канал Проекта, нажмите кнопку CREATE & ACTIVATE.
Для отмены создания Канал Проекта нажмите кнопку CANCEL.
Для редактирования Канал Проекта, необходимо кликнуть по его иконке на карточке Агента.
Чтобы применить изменения к активированному Канал Проекта, нажмите кнопку APPLY.
Чтобы деактивировать Канал Проекта, нажмите кнопку DEACTIVATE.
Чтобы применить изменения к деактивированному Канал Проекта, нажмите кнопку SAVE.
Чтобы применить изменения и активировать Канал Проекта, нажмите кнопку SAVE & ACTIVATE.
Чтобы отменить внесение изменений, нажмите кнопку CANCEL.
Чтобы удалить Канал Проекта, нажмите кнопку DELETE.
При присоединении пользователя к группе Telegram в client_message передается сообщение в соответствии с шаблоном
При выходе пользователя из группы Telegram в client_message передается сообщение в соответствии с шаблоном
При попытке передать изображение в слоте Attachment, если указана ссылка на файл из Telegram, то файл придет в виде ссылки, а не изображения
В client_message записывается строка вида file:Тип файла|ID файла|Ссылка на файл, например, file:photo|HgYjJJGYuxkBAAMNYK1eZR1fbZv-KQ09Omcsz9A8AjwAAsSzMRtug3FJ079jiwXcvo-egdKiLgADAQADAgADeAADE7gCAAEfBA|https://api.telegram.org/file/bot1815753186:AAH_LtRWy_FSDAGFgstlTaQdkHHIFHV3xGI/photos/file_0.jpg . При этом, файл будет доступен по ссылке в течение 24 часов. Для получения файла в дальнейшем потребуется обновить ссылку на файл, используя .
Работает в соответствии с