Telegram bot API - разбор документации с примерами

Публикация № 1217332 06.04.20

Интеграция - Мессенджеры и боты

telegram

Перевод документации на язык 1С.

Хоть и с большим запозданием, публикую шпаргалку по telegram bot api, может, будет полезна.

Прикладываю официальную документацию, и готовый набор методов для работы с telegram. Обработку тестировал на 8.3.15.1747.

Ссылки:

Официальная документация

Документация с частичным переводом (документация не полная, но рабочая)

В тексте я буду давать ссылки на вторую документацию т.к. для ее просмотра не нужны премудрости для обхода блокировок.

 

 
 Создание бота

 

Соединение

В документации написано:

Все запросы к Telegram Bot API должны осуществляться через HTTPS в следующем виде: https://api.telegram.org/bot<token>/НАЗВАНИЕ_МЕТОДА

Подчеркнуто, что соединение именно HTTPS, а значит не забываем указывать порт 443 и создать объект ЗащищенноеСоединениеOpenSSL

Код создания соединения :


АдресTelegramAPI = "api.telegram.org";
ПроксиАдрес = "159.138.22.170";
ПрокcиПорт = 3128;

Прокси = Новый ИнтернетПрокси;
Прокси.Установить("https", ПроксиАдрес, ПроксиПорт);
Прокси.Установить("http", ПроксиАдрес, ПроксиПорт);

СоединениеHTTP  =  Новый HTTPСоединение(АдресTelegramAPI,443,,,Прокси,,Новый ЗащищенноеСоединениеOpenSSL());

 

Прокси

Прокси нужен для обхода блокировок РосКомНадзора, если у вас провайдер не блокирует сайт telegram.org, то прокси можно не создавать.

Есть огромное количество сайтов предоставляющий список таких бесплатных прокси, я использую https://free.proxy-sale.com/https/ т.к. там есть возможность скачать списков нужном мне формате для автоматической загрузки.

Я реализовал у себя регистр сведений, где храню флаг доступности, ip и порт прокси. Флаг доступности актуализируется регламентным заданием

Проверка соединения

Для проверки соединения или проверки работает прокси или нет реализован специальный GET-метод getMe

Я специально буду повторять блоки кода, дабы Вы копировали сразу рабочий вариант, конечно это все нужно обернуть в функции и процедуры


МойToken = "123456:ABC-DEF1234ghIkl-zyx57W2v1u123ew11";
АдресTelegramAPI = "api.telegram.org";
ПроксиАдрес = "159.138.22.170";
ПроксиПорт = 3128;
ТаймаутСоединения = 2;//Ставим таймаут в пару секунд, чтобы долго не ждать исключения при неудачной проверке соединения

Прокси = Новый ИнтернетПрокси;
Прокси.Установить("https", ПроксиАдрес, ПроксиПорт);
Прокси.Установить("http", ПроксиАдрес, ПроксиПорт);

СоединениеHTTP  =  Новый HTTPСоединение(АдресTelegramAPI,443,,,Прокси,ТаймаутСоединения,Новый ЗащищенноеСоединениеOpenSSL());

АдресЗапроса = "bot" + МойToken.token + "/getMe";
ЗапросHTTP = Новый HTTPЗапрос(АдресЗапроса);
Попытка
    ОтветHTTP = СоединениеHTTP.Получить(ЗапросHTTP);
    ПроксиДоступен = Истина;
Исключение
    ПроксиДоступен = Ложь;
КонецПопытки;

Сообщить("Прокси доступен - " + ПроксиДоступен);

 

Метод getMe вернет в теле ответа JSON структуру

{
    "ok": true,
    "result": {
        "id": 12345678912,
        "is_bot": true,
        "first_name": "Представление имени моего бота",
        "username": "unikalnoe_imya_bot",
        "can_join_groups": true,
        "can_read_all_group_messages": false,
        "supports_inline_queries": true
    }
}

"ok":true - Означает, что авторизация прошла успешно и Ваш токен валидный.

 

Получение сообщений

Для получения сообщений существуют 2 совершенно разных способа

  1. Через HTTP-запросы к методу getUpdates
  2. Через Webhook

 

Запрос к методу getUpdates инициирует 1С, и есть 2 варианта использования

 

Short polling - это классическая схема, когда отправляя запрос мы сразу получаем результат его выполнения.

В случае с getUpdates мы сразу получаем ответ, где в поле result будет массив объектов с типом Update

 
Примитивный запрос на получение всех сообщений

Данный запрос каждый раз будет возвращать повторяющиеся данные и отслеживание новых сообщений ложится на 1С

т.е. вы заводите РС с обработанными update_id и каждый раз анализируете - обработан полученный id или нет. Можно завести константу с последним обработанным update_id и сравнивать ее на < или > с полученным

МойToken = "123456:ABC-DEF1234ghIkl-zyx57W2v1u123ew11";
АдресTelegramAPI = "api.telegram.org";
ПроксиАдрес = "159.138.22.170";
ПроксиПорт = 3128;

Прокси = Новый ИнтернетПрокси;
Прокси.Установить("https", ПроксиАдрес, ПроксиПорт);
Прокси.Установить("http", ПроксиАдрес, ПроксиПорт);

СоединениеHTTP = Новый HTTPСоединение(АдресTelegramAPI,443,,,Прокси,,Новый ЗащищенноеСоединениеOpenSSL());

АдресЗапроса = "bot" + МойToken + "/getUpdates";
ЗапросHTTP = Новый HTTPЗапрос(АдресЗапроса);
Попытка
   ОтветHTTP = СоединениеHTTP.Получить(ЗапросHTTP);
   Сообщить(ОтветHTTP.ПолучитьТелоКакСтроку());
Исключение
   ВызватьИсключение "Ошибка получения запроса";
КонецПопытки;

 

Пример ответа:

{
	"ok": true,
	"result": [
		{
			"update_id": 910197276,
			"message": {
				"message_id": 55,
				"from": {
					"id": 882646417,
					"is_bot": false,
					"first_name": "Александр",
					"last_name": "Леонов",
					"username": "Rentgengl",
					"language_code": "ru"
				},
				"chat": {
					"id": 882646417,
					"first_name": "Александр",
					"last_name": "Леонов",
					"username": "Rentgengl",
					"type": "private"
				},
				"date": 1585628272,
				"text": "Привет"
			}
		}
	]
}

 

 
 Запрос на получение новых сообщений после последнего запроса

 

Long polling - это схема, когда сервер возвращает ответ на запрос не сразу, а в момент появления данных. Проще говоря ваше HTTP соединение висит пока не появятся новые сообщения или не закончится таймаут.

Для работы в такой схеме необходимо договориться с сервером - какой таймаут считать допустимым, для этого у метода getUpdates есть параметр timeout, для удобства еще будем отправлять номер начального сообщения (offset)

 
 Запрос на ожидание получения новых сообщений

 

Получение сообщений через Webhook

Данные способ подразумевает наличие опубликованного наружу HTTP-сервиса, куда и будут приходить запросы от telegram с новыми сообщениями

Следует отметить 2 важные детали - сервис должен быть HTTPS и обрабатывать POST-запросы

Для переключения режима обмена на вебхуки существует метод setWebhook

Основной плюс данного метода - отсутствие необходимости в рег.заданиях, которые с определенным интервалом опрашивают или ждут ответа от сервера telegram. Новые сообщения приходят в режиме реального времени, причем если ваш сервис будет недоступен, то запрос будет повторен (сколько раз и с каким интервалом не понятно)

 

Обработка входящих сообщений

Сообщения, полученные от сервера telegram это массив объектов с типом Update. У данного типа есть обязательное поле update_id и ряд опциональных, зависящих от типа входящего сообщения. Основное доп.поле - message с типом Message заполнено у входящих текстовых сообщениях, входящих файлах, фотографиях, аудио сообщениях, входящем сообщении с контактом, георасположением, видео и стикеры.

Второе доп.поле - callback_query с типом CallbackQuery - это результат нажатия на кнопку клавиатуры InlineKeyboardMarkup

Примеры сообщений с типом Message

 
 Сообщение
 
 Фото
 
 Документ
 
 Аудио сообщение
 
 Геоданные
 
 Опрос
 
 Контакт
 
 Музыка
 
 Нажатие на кнопку ReplyKeyboard

Пример сообщения с типом CallbackQuery

 
 Нажатие на кнопку InlineKeyboard

 

Загрузка полученных файлов

Т.к. в сообщении приходит только идентификатор файла, то необходимо его как то получить.

Для этого существует GET-метод getFile, у которого есть один обязательный параметр file_id

Метод возвращает объект типа File, это еще не файл, но он уже доступен по ссылке, которую необходимо собрать из полученных данных.

Ссылка имеет вид https://api.telegram.org/file/bot<token>/<file_path>, где file_path - это свойство объекта File

 
 Пример загрузки файла

 

Отправка сообщения

Для отправки сообщения используется GET-метод sendMessage, обязательных параметров всего два chat_id и text

chat_id можно взять из полученных сообщений

 
 Отправка простого сообщения

 

У метода sendMessage есть еще ряд необязательных параметров, один из них это parse_mode, который включает нужный синтаксис оформления текста сообщения. Таких режимов два - HTML и Markdown

Проще говоря, этот параметр говорит по каким правилам должно оформляться сообщение

Я приведу пример отправки сообщения в синтаксисе HTML

 
 Отправка оформленного сообщения

В чат при этом запросе прилетит вот такое сообщение

Показ привью отправленной ссылки можно отключить с помощью параметра disable_web_page_preview

Для этого нужно к запросу добавить строку &disable_web_page_preview=true

Также у метода есть параметр reply_to_message_id, который принимает идентификатор сообщения, на которое делается ответ.

 

Кнопки (клавиатуры)

У метода sendMessage есть еще один очень интересный параметр - reply_markup, который отвечает за быстрые ответы.

Типов таких быстрых ответов на данный момент 4: InlineKeyboardMarkup, ReplyKeyboardMarkup, ReplyKeyboardHide и ForceReply.

 

InlineKeyboardMarkup

Это клавиатура, которая привязана к сообщению. У этого объекта всего одно поле inline_keyboard, которое содержит массив строк с массивами кнопок (2 мерный массив кнопок или массив массивов с кнопками)

Кнопка - это объект InlineKeyboardButton, у которого только одно обязательное поле - text

Есть еще ряд полей, основное из которых - callback_data. Это данные, которые будут отправлены после нажатия кнопки пользователем. Сюда можно записывать идентификаторы из 1С (документа или справочника), числа и т.д. для последующей обработки.

Второй полезный параметр - url, в котором указывается ссылка, которая будет открыта при нажатии на кнопку

 
 Пример отправки InlineKeyboardMarkup

 

ReplyKeyboardMarkup

Набор кнопок, которые не привязаны к конкретному сообщению а закреплены внизу окна диалога.

Объект имеет одно обязательное поле keyboard, которое содержит массив массивов кнопок с более простым типом нежели InlineKeyboard - KeyboardButton с основным полем text, данный объект можно не использовать и сразу формировать массив строк.

Еще один важный параметр клавиатуры, но не обязательным, является resize_keyboard, который отвечает за "авто высоту" кнопок.

По умолчанию данный параметр установлен в false и клавиатура растягивается на высоту основной клавиатуры, что выглядит громоздко (см. скрин в примере).

Еще один опциональный параметр - one_time_keyboard, который при установке в true скрывает клавиатуру после нажатия кнопки.

 
 Пример отправки ReplyKeyboardMarkup

 

ReplyKeyboardHide - Своего рода команда управления видимостью для клавиатуры ReplyKeyboardMarkup 

ForceReply - команда инициирующая цитату на отправляемое сообщение

 

Отправка контактов

GET-метод sendContact позволяет отправить контакт пользователю спец.сообщением.

Метод похож на sendMessage за исключением нескольких обязательных полей:

phone_number - строковое представление телефонного номера

first_name - Имя контакта

 
 Пример отправки контакта

 

Отправка документов (файлов)

За отправку файлов отвечает POST-метод sendDocument, у которого 2 обязательных поля - chat_id и document.

Поле document может иметь тип строки, это нужно тогда, когда мы переотправляем уже полученный файл и в этом случае указываем идентификатор файла.

Второй тип, который может содержать поле document - это сам отправляемый файл в формате multipart/form-data

Сам формат multipart/form-data достаточно простой, его цель - оправить серверу ряд разнородных данных (файлы, строки и т.д.) в одном сообщении (файле). Это своего рода zip-архив без сжатия, где не только файлы, но и другие данные.

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

Вернемся к нашему методу sendDocument, которому необходимо передать 2 параметра - строковый chat_id и файл document

Шаблон тела запроса будет выглядеть следующим образом:

--%Разделитель%
Content-Disposition: form-data; name="chat_id"

%ЧатID%
--%Разделитель%
Content-Disposition: form-data; name="document"; filename="%ИмяФайла%"

%СодержимоеФайла%
--%Разделитель%--

Со строковыми значениями вопросов не возникает - делаем СтрЗаменить и все, но есть еще и содержимое файла, которое нужно в итоговый запрос подсунуть.

Для решения этой проблемы у 1С есть метод ОбъединитьФайлы, который объединяет переданный в него массив файлов в один.

Разделим шаблон на части - певая это текст до %СодержимоеФайла%, а вторая это текст после %СодержимоеФайла%. Запишем эти 2 текста в файлы и используем ОбъединитьФайлы подсунув между текстовиками отправляемый файл.

 
Пример отправки файла

 

Скачать файлы

Наименование Файл Версия Размер
Документация Telegram Bot API ver.4.7

.pdf 616,12Kb
56
.pdf 616,12Kb 56 Скачать
Telegram bot API Библиотека методов

.epf 7,28Kb
113
.epf 7,28Kb 113 Скачать

Специальные предложения

Вознаграждение за ответ
Показать полностью
Комментарии
В избранное Подписаться на ответы Сортировка: Древо развёрнутое
Свернуть все
1. serg-lom89 70 06.04.20 10:39 Сейчас в теме
тема хоть и "заезженная" но тем не менее почитал с удовольствием,вспомнил как сам разбирался с API_)
Totoro; TreeDogNight; +2 Ответить
2. feva 494 06.04.20 13:52 Сейчас в теме
Хорошее развитие темы ботов телеги и 1с) Грамотно написано! Однозначно луцк!
3. CyberCerber 977 06.04.20 14:13 Сейчас в теме
(2) Кажется, это уже правило Инфостарта. В комментах к любой статье появится автор другой статьи на эту тему, и порекламирует себя.
savauu; Lacoste4life; simuljakr; izidakg; leongl; +5 2 Ответить
4. feva 494 06.04.20 14:22 Сейчас в теме
(3) ну тема на самом дела не одинаковая. Тут глубже развернуты команды бота телеги, с примерами. А расширение информационного поля полезно всем - как автору, так и читателю и журналу
Lacoste4life; cleaner_it; Evg-Lylyk; +3 Ответить
5. Nikola23 667 06.04.20 15:04 Сейчас в теме
(3) рынок диктует свои правила. Вам не нравится что-то конкретное в его поведении?
6. CyberCerber 977 06.04.20 15:21 Сейчас в теме
(5) Вообще такая откровенная самореклама не очень нравится. Комменты к этой статье посвящены именно этой публикации, а не всем на эту тему. Найти интересные мне статьи я и сам смогу.
Конкретно в этой фразе не понравилось "Хорошее развитие темы...". Какое развитие? Как будто автор взял именно его статью как эталон и что-то дополнил... Здесь подробный разбор функционала API, там - просто краткий пример базовой возможности.
BiLBelarus; softgarant; +2 Ответить
7. Nikola23 667 07.04.20 09:21 Сейчас в теме
(6) "Комменты к этой статье посвящены именно этой публикации". Ну это правило вы сами придумали.

ИМХО, вы придираетесь. В каждом форуме с момента появления такого понятия, есть темы и есть админы.
Да, принято писать "по теме", но не запрещено (по умолчанию). На инфостарте - не запрещено.
Админы принимают решение что и где писать, а не пользователи.

Выбор за вами - адаптироваться или нет.
Кстати и вы и я сейчас пишем совсем не по теме, но никто же не возмущается :)
Fox-trot; +1 Ответить
8. izidakg 167 07.04.20 16:23 Сейчас в теме
(3) когда статья не то что хуже, но существенно менее информативна, это наверное и не плохо
но в данном случае эта статья более полная, а значит лучше
9. Anton64 208 08.04.20 09:53 Сейчас в теме
Вы только в тексте статьи описания клавиатур делаете обычным текстом? или в обработке так же?
Непонятно как вы динамически собираетесь при таком подходе формировать клавиатуры.
10. leongl 491 08.04.20 10:44 Сейчас в теме
(9)В тексте не стал делать динамически для прозрачности.
В обработке 2 экспортных метода
ПрикрепитьКнопки(Получатель, ТекстСообщения, МассивМассивовКнопок, ЭтоФорматированноеСообщение = Ложь)
ОтправитьСообщениеСКнопками(Получатель, ТекстСообщения, МассивМассивовInlineКнопок, ЭтоФорматированноеСообщение = Ложь)
и обертка для получения описания inlineКнопки
ПолучитьКнопкуInline(Заголовок, ДанныеДляВозврата = Неопределено, СсылкаURL = Неопределено)

Использование простое - для прикрепления кнопки делаете 2мерный массив строк и скармливаете ПрикрепитьКнопки
Для inlineКлавиатуры делаете 2мерный массив из результатов функции ПолучитьКнопкуInline(
cleaner_it; CyberCerber; +2 Ответить
11. Anton64 208 08.04.20 11:50 Сейчас в теме
(10) Тогда понятно)) а то в публикации как-то слишком странно выглядело
73. cleaner_it 216 27.02.22 18:20 Сейчас в теме
(10)
ми(Получатель, ТекстСообщения, МассивМассивовInlineКнопок, ЭтоФорматированноеСообщение = Ложь)
и обертка для получения описания inlineКнопки
ПолучитьКнопкуInline(Заголовок, ДанныеДляВозврата = Неопределено, СсылкаURL = Неопределено)

Использование простое - для прикрепления кнопки делаете 2мерный массив строк и скармливаете ПрикрепитьКнопки
Для inlineКлавиатуры делаете 2мерный массив из резу


Спасибо) Как раз ищу, как сделать кнопки, и задался этим же вопросом)
12. nestokay 59 10.04.20 08:26 Сейчас в теме
Воооот, отличная статья, спасибо!!!
13. hardcodder2020 13.04.20 11:38 Сейчас в теме
Статья крутейшая! Автору респектую!
14. Pixar0000 13.04.20 18:46 Сейчас в теме
А отправка смайликов - не раскрыта вообще, если добавить, то настольное руководство на связке 1С + Тележка
Автору респект!
72. METAL 273 27.01.22 23:17 Сейчас в теме
(14) Вот да, тоже интересно! Помню раньше были с этим проблемы, а сейчас как? Доступны ли для отправки из 1С большинство смайликов(эмодзи), что есть на айфоне?
15. AlexK_2012 14.04.20 17:29 Сейчас в теме
а обработка запускабельна?
16. leongl 491 14.04.20 18:11 Сейчас в теме
17. leongl 491 14.04.20 18:13 Сейчас в теме
(15)Запускабельны примеры из статьи
18. AlexK_2012 15.04.20 12:38 Сейчас в теме
(17) Добрый день! Большая просьба добавить пример разбора полученных сообщений, вижу только примеры получаемых данных
19. leongl 491 15.04.20 16:55 Сейчас в теме
(18)Это немного выходит за рамки статьи, но я могу посоветовать:
1. Получив ОтветHTTP проверить его свойство КодСостояния, при удачном выполнении он должен быть равен 200
2. Получить тело ответа через метод ПолучитьТелоКакСтроку и преобразовать его из JSON в объект 1С через Новый ЧтениеJSON
3. Проверить получившийся объект 1С на наличие поля "ok" и его значение = Истина
4. Обработать свойство result объекта
В обработке с библиотекой методов есть экспортный метод ПолучитьИОбработатьСообщения() там есть и получение сообщений и их обработка.
Merkalov; softgarant; semagin@gmail.com; igormiro; Terve!R; AlexK_2012; CyberCerber; +7 Ответить
20. mvgfirst 6 17.04.20 16:00 Сейчас в теме
Не то что бы я придирался
но вот есть кусочек
где ошибка:

ЗапросHTTP = Новый HTTPЗапрос(АдресЗапроса);
Попытка
   ОтветHTTP = СоединениеHTTP.Получить(HTTPЗапрос);
   Сообщить(ОтветHTTP.ПолучитьТелоКакСтроку())
21. leongl 491 17.04.20 21:37 Сейчас в теме
22. igormiro 713 28.04.20 09:41 Сейчас в теме
Хорошая статья.
Есть вопрос бот работает, у некоторых пользователей вот перестаёт реагировать на все команды.
Что делать в таких случаях?
23. leongl 491 28.04.20 11:11 Сейчас в теме
(22) Команды от пользователя приходят в сообщениях?
24. igormiro 713 28.04.20 11:46 Сейчас в теме
25. igormiro 713 28.04.20 11:49 Сейчас в теме
Уже было такое пришлось пересоздать бот. Тогда все ок.
26. doctordre 30.04.20 21:55 Сейчас в теме
ошибочка в адресе запроса для получения файла. там не bot a /file/bot
поправьте пожалуйста
27. leongl 491 06.05.20 11:55 Сейчас в теме
28. uno-c 214 18.06.20 20:24 Сейчас в теме
для ее просмотра не нужны премудрости для обхода блокировок.

Случайно обнаружил, что теперь справка https://core.telegram.org/bots/api открывается без премудростей. Да и https://api.telegram.org/botXXX/getMe тоже отвечает - прямо в браузере без VPN и прокси. Это у всех теперь так в нашей стране?
29. dvk09 1 19.06.20 07:21 Сейчас в теме
30. vladnet 356 10.07.20 09:48 Сейчас в теме
Подскажите sendDocument посылается через multipart/form-data. Все нормально работает, но кроме основных параметров существуют еще параметры:

reply_markup
reply_to_message_id
reply_markup

Как их правильно засунуть в запрос?
31. leongl 491 10.07.20 13:11 Сейчас в теме
(30)
НачальныеДанные = "--%Разделитель%
|Content-Disposition: form-data; name=""chat_id""
|
|%ЧатID%
|--%Разделитель%
|Content-Disposition: form-data; name=""reply_markup""
|
|%ДанныеReply_markup%
|--%Разделитель%
|Content-Disposition: form-data; name=""document""; filename=""%ИмяФайла%""
|";
НачальныеДанные = СтрЗаменить(НачальныеДанные,"%Разделитель%",Boundary);
НачальныеДанные = СтрЗаменить(НачальныеДанные,"%ЧатID%",ЧатID);
НачальныеДанные = СтрЗаменить(НачальныеДанные,"%ДанныеReply_markup%", ДанныеReply_markup);
НачальныеДанные = СтрЗаменить(НачальныеДанные,"%ИмяФайла%",Файл.Имя);
Показать
tuzmich007; +1 Ответить
32. vladnet 356 10.07.20 16:42 Сейчас в теме
(31) Спасибо! Основную суть ухватил, остался вопрос, а как должна выглядеть переменная ДанныеReply_markup? Это ведь структура, к примеру в ней может быть:
{
"inline_keyboard": [
{"text": "123", "callback_data", "333"}
]
}
tuzmich007; +1 Ответить
33. vladnet 356 10.07.20 18:23 Сейчас в теме
(32) Нашел, записывается обычным JSON )
34. ROM_1C 691 12.07.20 21:04 Сейчас в теме
А отложение сообщения можно отправить по апи или нет такой функции?
В документации что-то не нашел((
Спасибо.
35. leongl 491 13.07.20 06:53 Сейчас в теме
(34)Скорее всего это только фишка приложения.
36. ROM_1C 691 13.07.20 10:16 Сейчас в теме
(35) точно нет, экспортируется на все устройства, и уведомления прийдет даже если устройства будут выключены
37. maksa2005 403 23.07.20 13:11 Сейчас в теме
АдресЗапроса = "bot" + МойToken.token + "/getUpdates";


исправьте на

АдресЗапроса = "bot" + МойToken+ "/getUpdates";
38. leongl 491 24.07.20 07:38 Сейчас в теме
39. maksa2005 403 24.07.20 09:43 Сейчас в теме
Скажите, а можно отправить команду в телеграмм не через телефон для регистрации бота?
Для чего это? суть такова что нужно сделать 40 ботов для 40 людей и каждому их настроить. Чтобы у каждого не брать телефоны и настраивать, а прописать команду и получить от него токен.
40. leongl 491 24.07.20 13:31 Сейчас в теме
(39)На самом деле телега дает возможность реализовать свой кастомный клиент, по этому вполне реально реализовать автоматизацию по созданию ботов)
Почитайте тут https://core.telegram.org/api#telegram-api
41. rinik88 31 28.07.20 15:27 Сейчас в теме
добрый день. А отправка фото-картинки такая же как и файла? хотя наверное необходимо использовать /sendPhoto...
42. leongl 491 29.07.20 09:00 Сейчас в теме
(41)Добрый день. Можно использовать sendDocument и sendPhoto. У меня работало и то и то
43. rinik88 31 29.07.20 09:25 Сейчас в теме
(42) если в статью добавите пример по отправке фото не как вложения, было бы замечательно)
44. umni4ka 46 27.08.20 22:51 Сейчас в теме
Крутая статья, спасибо!
Velement; +1 Ответить
45. CAIN 16 20.10.20 23:09 Сейчас в теме
Как отправить просто фото, это даже нужнее чем просто файл вложение
46. leongl 491 21.10.20 07:46 Сейчас в теме
(45)Можно использовать вместо sendDocument - sendPhoto. У меня работало и то и то
47. oneman@yandex.ru 20.11.20 17:25 Сейчас в теме
Внимание, вопрос! Как запросом бота получить обратно сообщения, отправленные этим же ботом ?
В методе "getUpdates" возвращаются сообщения, отправленные только прочими пользователями чата.
tuzmich007; +1 Ответить
66. gubanoff 62 08.07.21 15:20 Сейчас в теме
(47)
запросом бота получить обратно сообщения, отправленные этим же ботом ?

Когда отправляете сообщение от бота, то приходит ответ. Вот этот ответ и есть сообщение, отправленное ботом. По другому я не нашел варианта.
48. maksa2005 403 25.11.20 20:44 Сейчас в теме
Скажите, а что делать если кол-во запросов превысело 100. он не обновляет. Как быть?
49. user1524956 17.01.21 08:56 Сейчас в теме
здравствуйте! у меня вопрос был такой. я создал инлайн кнопки, т.е. эти кнопки ссылаются на мои телеграм каналы. вот я сделал 3 инлайн кнопки, а потом хочу сделать кнопку 4ую, т.е. кнопка на проверку подписался ли на эти каналы или нет. помогите пжл.
50. Oleg_nsk 264 29.01.21 13:30 Сейчас в теме
Кто-нибудь смог реализовать метод sendMediaGroup? Никак не могу понять как в параметр media закинуть массив объектов, включающий двоичные данные
51. leongl 491 01.02.21 08:18 Сейчас в теме
(50) Судя по документации закидываете в media JSON сериализованный массив объектов InputMedia
Сам объект довольно прост и состоит из двух полей - это тип и файл (ссылка, айди или имя параметра multipart/form-data)
как пример значения:
[{"type": "photo", "media":"attach://document"},
{"type": "video", "media":"https://infostart.ru/МоеВидео.avi"}]
52. Oleg_nsk 264 01.02.21 10:12 Сейчас в теме
(51)
Сам объект довольно прост и состоит из двух полей - это тип и файл (ссылка, айди или имя параметра multipart/form-data)

С ссылкой и айди все понятно, но как передать здесь двоичные данные?
"media":"attach://document".... Вот здесь вместо document что? Двоичные данные?
53. leongl 491 01.02.21 10:30 Сейчас в теме
(52) document это имя параметра в блоке multipart/form-data
Content-Disposition: form-data; name=""document""; filename=""%ИмяФайла%""
Как закинуть туда файл - см. отправку документа.
54. Oleg_nsk 264 01.02.21 11:03 Сейчас в теме
(53)

(52) document это имя параметра в блоке multipart/form-data
Content-Disposition: form-data; name=""document""; filename=""%ИмяФайла%""
Как закинуть туда файл - см. отправку документа.

Как отправлять документ мне известно. Но здесь получается что тип контента у нас JSON, следовательно внутри JSON в поле media я запишу attach://document, но как мне передавать это сообщение одновременно и как "multipart/form-data" и как "JSON"?
56. leongl 491 01.02.21 11:23 Сейчас в теме
55. leongl 491 01.02.21 11:22 Сейчас в теме
JSON это не тип, в любом случае тип будет строка.
Что вам мешает закинуть строку в запрос?

НачальныеДанные = "--%Разделитель%
|Content-Disposition: form-data; name=""chat_id""
|
|%ЧатID%
|--%Разделитель%
|Content-Disposition: form-data; name=""media""
|
|%ВашJSON%
|--%Разделитель%
|Content-Disposition: form-data; name=""document""; filename=""%ИмяФайла%""
|";
Показать
57. Oleg_nsk 264 01.02.21 11:57 Сейчас в теме
(55)
НачальныеДанные = "--%Разделитель%
|Content-Disposition: form-data; name=""chat_id""
|
|%ЧатID%
|--%Разделитель%
|Content-Disposition: form-data; name=""media""
|
|%ВашJSON%
|--%Разделитель%
|Content-Disposition: form-data; name=""document""; filename=""%ИмяФайла%""
|";


Я говорил про тип контента, а не про тип. И для типа контента (content-type) JSON является валидным значением. Но не в этом дело.
Т.е. вы предлагаете значение content-type в запросе установить multipart/form-data, а весь текст json запроса вставить как отдельный параметр внутри multipart/form-data, а сами двоичные данные добавить внизу отдельными параметрами, имена которых будут следовать после attach:// в теле json? Так делать я еще не пробовал. Если получится отпишусь.
58. Oleg_nsk 264 02.02.21 11:50 Сейчас в теме
(55)Попробовал ваш способ. Не получается.
Записал два параметра мультипарт:
chat_id и media =
{
"chat_id": мой_ид,
"media": [
{
"type": "document",
"media": "attach://txt1"
},
{
"type": "document",
"media": "attach://txt2"
}
]
}
Показать

Потом прикрепил два файла txt1 и txt2 и в результате ошибка:

{"ok":false,"error_code":400,"description":"Bad Request: expected an Array of InputMedia"}


PS
У меня получилось. Оказывается в attach надо писать не то что в filename, а то что в name и в media надо передавать сериализованный массив, а не всю структуру. В любом случае спасибо вам большое за помощь!
146323; zFire; leongl; +3 Ответить
64. zFire 23.06.21 13:06 Сейчас в теме
(58)

Скажите, а Вы бы не могли прислать пример заголовка отправки файлов sendMediaGroup?
Не могу понять, почему у меня сервер не отвечает на попытку отправить хоть какой-то файл
59. IvanPoh 23 16.02.21 19:28 Сейчас в теме
А вот как отправить сообщение в группу от бота, но конкретному пользователю через @, такое возможно?
60. bulpi 209 16.03.21 15:19 Сейчас в теме
Вопрос :
Я отправил в бот сообщение с файлом. Можно как-то узнать, скачали его, или нет ?
61. simuljakr 199 02.05.21 15:19 Сейчас в теме
Здравствуйте!

Подскажите пожалуйста - а как удалить клавиатуру с кнопками (любую и InlineKeyboardMarkup, ReplyKeyboardMarkup) ?

Нужно сделать чтобы после того, как пользователь нажал одну из кнопок - клавиатура исчезала.
В случае с ReplyKeyboardMarkup есть признак one_time_keyboard - но установка этого признака - лишь скрывает кнопки - а хочется именно удалить - чтобы не было возможности повторно их нажимать....
viktor3d; +1 Ответить
62. simuljakr 199 02.05.21 15:24 Сейчас в теме
Столкнулся со странным ограничением - при использовании InlineKeyboardMarkup: поле callback_data позволяет передавать в него только до 32 символов.... Как-то совсем мало... Причем сам заголовок кнопки (поле text) такого ограничения не имеет.... КТо сталкивался с этим ограничением ? Как решили проблему?
63. zFire 23.06.21 12:43 Сейчас в теме
я не могу понять почему у меня не работает в выходном файле вот так:

-----8d936432d8e4243
Content-Disposition: form-data; name="chat_id"

<мой чат ИД>
-----8d936432d8e4243
Content-Disposition: form-data; name="media"

[{"type": "document", "media": "attach://file"}]
-----8d936432d8e4243
Content-Disposition: form-data; name="file" filename="Right.pdf"
Content-Type: multipart/form-data
Content-Type: application/pdf
Content-Transfer-Encoding: binary

Здесь бинарные данные
-----8d936432d8e4243--

При этом происходит соединение и вываливается по таймауту, сервер ничего не присылает
Пробовал sendDocument за место sendMediaGroup тот же эффект.
Помогите разобраться пожалуйста. При этом отправка сообщений проходит на ура
65. пользователь 07.07.21 18:26
Сообщение было скрыто модератором.
...
67. gubanoff 62 08.07.21 17:37 Сейчас в теме
(0) Большое спасибо за качественный материал! Все очень подробно, аккуратно и со смыслом написано, структурировано и изложено.
68. Oleg_nsk 264 30.07.21 08:22 Сейчас в теме
С long polling возникает странная проблема. Запускаю фоновое задание, где в бесконечном цикле идет опрос с таймаутом 10 минут. Однако, через 3-4 дня бот перестает отвечать на команды. Причем, что интересно, фоновое задание в 1с определяется как активное. Спасает только сброс фонового задания и его перезапуск. Если кто-то знает как решить отпишитесь, пожалуйста.
71. nkp14108 94 21.12.21 17:04 Сейчас в теме
(68) Подскажи как формировать структуру исходящего опроса(генерировать опрос в 1с и посылать боту)? Текстовое представление запроса можно.
69. Snus71 225 18.10.21 11:54 Сейчас в теме
Не раскрыта тема: а можно ли добавить в существующий приватный канал юзера? Не прислать ссылку-инвайт, что понятно как реализуется, а именно добавить без участия того самого пользователя
70. nkp14108 94 09.12.21 17:26 Сейчас в теме
Подскажите, можно ли присвоить уникальный ID исходящего сообщения с КНОПКАМИ(например посылаю 2 кнопки(согласовать/не согласовать), по нажатию одной из кнопок, что бы при переборе всех входящих я мог определить, что это именно от нужной кнопки).
Решаю задачу - посылаю сообщения с КНОПКАМИ с привязкой к документу(файлу) и их в ленте несколько. По косвенным признакам могу, но хочется однозначный вариант.
74. user1478951 12.04.22 17:30 Сейчас в теме
Подскажите как отправить кнопки(клавиатурные) с галочками для выбора нескольких вариантов и как их потом обработать (ответ)
75. gigapevt 23 03.07.22 12:38 Сейчас в теме
Отлично написанная статья! Благодарность автору за его труд. Очень помогла статья при разработке бота + http-сервиса.
76. UPKA 15.07.22 07:33 Сейчас в теме
Подскажите пожалуйста, как удалять системные сообщения?
77. mrfills 19.07.22 14:42 Сейчас в теме
А как отправить одновременно 2 клавиатуры? под сообщением и внизу кнопки
78. user1861964 19.10.22 21:53 Сейчас в теме
(77) так нельзя, к одному сообщению - одну клавиатуру
79. chupetkiniv 10.11.22 13:41 Сейчас в теме
можно 2 sendMessage вызвать с inline keyboard и replykeyboard
Оставьте свое сообщение

См. также

Выбираем российского провайдера для интеграции с WhatsApp

Мессенджеры и боты Платформа 1С v8.3 Россия Абонемент ($m)

Собственно, почему выбираем именно провайдера и почему российского? WhatsApp, создавая свое API, преследовал две цели - делать деньги и минимизировать спам. И чтобы убить сразу двух зайцев, было принято решение предлагать API исключительно через партнеров. Ну а вопрос по поводу российского партнера скорее уже риторический. И не только из-за курса рубля, но и из-за таланта работать с российскими телефонными номерами, коим одарены далеко не все провайдеры. Между тем статья не претендует на всесторонний анализ всех возможностей всех провайдеров. Мы копнем лишь верхушку айсберга этого немаленького рынка.

1 стартмани

19.05.2020    11301    andrew_shamin    8    

37

Вебхук. Путь Телеграма

Мессенджеры и боты Платформа 1С v8.3 Абонемент ($m)

Долгое (на самом деле нет) и нелегкое путешествие телеграма к неведомым (из за РКН) конфигурациям 1С. Памятка себе.

1 стартмани

03.10.2019    30387    platonov.e    27    

93

Телеграм + 1С + Вебхуки + Апач + Самоподписанный сертификат

Мессенджеры и боты Платформа 1С v8.3 Абонемент ($m)

Много строк исписано про интеграцию Телеграма и 1С. Но нигде не увидел полной инструкции по установке и настройке вебхуков. Попробую её написать.

1 стартмани

26.02.2019    23805    alexlx    42    

74

Связка 1С и Telegram. Отправка стикеров

Мессенджеры и боты Платформа 1С v8.3 Управляемые формы Конфигурации 1cv8 Абонемент ($m)

В качестве факультатива сейчас изучаю возможности связки 1С и мессенджера Telegram. И возник вопрос, как помимо сообщений, посылать в ответ на действия пользователя произвольный стикер? Решению этой мини задачи и посвящена данная статья.

1 стартмани

31.07.2018    14740    Skin123    5    

42