Posted in: Авто

Бот телеграмм для проверки авто: каталог ботов для проверки авто

Содержание

каталог ботов для проверки авто

Зачем устанавливать автобот в Телеграмм, как он может пригодиться рядовому автолюбителю? Расскажем, что представляют собой сервисы и как они работают, рассмотрим несколько классных программ и научимся ими пользоваться. Поверьте, от такой информации отказываться не стоит!

Зачем нужны автоботы

Хотите пробить автомобиль – бот в Телеграмм придет на помощь! Но не все пользователи понимают, зачем нужен подобный сервис. Попробуем разъяснить просто и доступно.

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

  • Осуществляют поиск по нескольким крупным базам – некоторые составляются водителями, другие принадлежат ГИБДД/судебным приставам/иным государственным органам;
  • Для проверки автоботом достаточно государственного номерного знака или вин-номера.

Пользоваться сервисами Телеграмма могут как рядовые пользователи-автолюбители, так и профессионалы – подборщики, дилеры, салоны, перекупщики.

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

Есть и другие сервисы – специально созданные для помощи автомобилистам. Совместными усилиями достигаются такие результаты:

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

Посмотрим, как автобот работает на практике в Телеграмме?

Как пользоваться

Сначала расскажем о том, как работает Телеграм бот для проверки гос.номера авто @AvinfoBot. Это один из самых популярных автоботов среди владельцев машин – благодаря широчайшему функционалу и множеству возможностей!

  • Помогает проверять благонадежность продавца;
  • Вы сможете выявить перекупщика;
  • Увидите историю продажи автомобиля.

Чтобы получить доступ к описанным выше опциям автобота в Телеграмме:

  • Введите название робота в поисковую строку, выберите нужного;

  • Нажмите на кнопку «Запустить» на нижней панели;

  • Появится приветственное сообщение – чтобы начать проверку, необходимо ввести исходные данные;
  • Для проверки машины или владельца введите госномер или VIN/телефонный номер/ФИО автолюбителя, или загрузите фотографию номера/гиперссылку на объявление о продаже;

  • Ответным сообщением вы получите доступ к меню.

Обратите внимание – Телеграмм бот проверки авто платный. Для осуществления некоторых действий придется оплатить подписку!

Пользователям доступны такие возможности:

  • Проверка ОСАГО;
  • Проверка работы в такси;
  • Диагностическая карта;
  • Пройденные ТО;
  • Данные о пробеге;
  • Судебные решения;
  • Полный/комплексный отчеты, включающие в себя все перечисленное.

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

  • ФИО и номер телефона;
  • Историю выкладываемых объявлений.

А также данные по машине:

  • История продаж;
  • История штрафов и угонов;
  • Проверка на арест.

Управление автоботом в Телеграмме интуитивно простое и понятное, просто нажимайте на нужные иконки в меню.

Другие боты для авто

Следуем дальше? Подготовили небольшую подборку ботов для авто в Телеграмме – все ресурсы проверены лично нами!

  • @avtocodbot – достаточно знать вин или госномер, чтобы за пять минут проверить ДТП и залоги, пробеги и ограничения, штрафы и поездки в такси, посмотреть расчет ремонтных работ и историю рег/действий. Автобот использует более 13 официальных источников;

  • @Avtobotoff_bot – это Телеграм бот поиска владельца по номеру авто. Достаточно ввести госномер, чтобы связаться с пользователем в мессенджере – пригодится, если вы стали свидетелем ДТП или вам перекрыли проезд;

  • @AntiParkonBot. Этот автобот нужен тем, кто хочет предупредить другого автомобилиста об эвакуации или оповестить о нарушителе правил дорожного движения. Также позволяет найти помощь на дороге в огромной базе водителей;

  • @dps_controlbot – автобот позволяет получать/сообщать информацию о местонахождении сотрудников ДПС на дороге, поможет найти попутчика или помощь в сложной ситуации;

  • @avtonomerbot – Телеграм бот, по номеру авто ищущий фотографию машины. Узнать данные владельца нельзя, но можно увидеть галерею, загружаемую пользователем.

Авто боты для Telegram – незаменимые помощники не только автолюбителей! Они могут пригодиться каждому, ведь ситуации бывают разными. Помните, что под рукой всегда есть надежные, проверенные сервисы, которые придут на помощь и помогут разрешить возникшие затруднения. А уж для профессионалов автобот в Телеграмме – неотъемлемая часть рабочего процесса, полноценный инструмент.

Проверить автомобиль (АВТО) по ВИН или ГОСномеру

Для получения подписки Вам необходимо авторизоваться в системе AVinfo

+7

Отправить

Полная и проверка автомобилей. Без ограничений История владения, ДТП, залоги, работа в такси, фотографии, штрафы, и многое другое.

Поиск странички ВКонтакте по фотографии или по номеру телефона.

Проверка физических лиц. Задолженности, зарегистрированные организации, сведения о банкротстве.

Мгновенное отображение объявлений со всех автомобильных сайтов РФ.

Уведомления о появлении автомобилей в продаже на любом подключенном сайте на E-mail или в Telegram.

Проверка телефона продавца. телефонные розыгрыши, анонимные звонки.

как проверить машину и узнать владельца и его телефон

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

СОДЕРЖАНИЕ СТАТЬИ:

Какие автоботы бывают

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

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

Avtocodbot

Проверка истории владения автомобилем не займет много времени, если обратиться за помощью к Avtocodbot – роботу, который обещает предоставить необходимую информацию за 5 минут. После нажатия кнопки «Старт» пользователю будет отправлено сообщение с приветствием и станут доступны две команды – предложение проверить автомобиль и «Справка». Для того чтобы получить желаемые данные, нужно знать автономера. Они вводятся в поле, которое появляется после нажатия на кнопку «Проверка».

Робот предлагает два варианта – VIN и гос. номер. К каждому из них прилагается образец, на который необходимо посмотреть, прежде чем приступить к работе. В первом случае буквы пишутся латиницей, во втором – кириллицей. Часть услуг программа предоставляет бесплатно, среди них – краткий отчет. Для того чтобы получить больше информации, нужно воспользоваться платной опцией и кликнуть «Купить».

Avinfobot

AVinfoBot предлагает воспользоваться большим количеством функций, однако работать с ними немного сложнее. Например, стандартный поиск автомобиля может вызвать некоторые трудности, ведь для него нужен не только номер, но и данные о владельце. Это телефонный номер, ФИО, а также фотография авто и ссылка на объявление о его продаже. У человека, который знает только часть этих данных, вряд ли получится воспользоваться услугами робота, поэтому прежде, чем пробить машину, стоит познакомиться с ее хозяином.

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

Антипаркон

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

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

Как найти человека по номеру машины в Телеграме с помощью бота

Для того чтобы найти человека по гос. номеру, необходимо набрать в поисковой строке «Avtocodbot», открыть программу и нажать кнопку «Старт». Следующий шаг – «Проверить автомобиль». Далее – «Проверить по VIN» или «Проверить по гос. номеру».

После этого робот пришлет образец, в соответствии с которым вводятся цифры и буквы – 17 знаков для первого варианта и 8 для второго.

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

Как добавить номер машины в авто инфобот для Telegram

Для работы с AVinfoBot необходимо нажать «Старт» и отправить сообщение с номером в восьмизначном формате. После этого робот пришлет сообщение, в котором расскажет о том, в каком субъекте РФ зарегистрирован автомобиль. Также доступен небольшой фотоотчет – подборка из нескольких фотографий, на которых запечатлена машина. Две из них – статичные, сделанные во дворе, третья – в движении, снятая во время одной из поездок.

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

Бот телеграм для проверки машин

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

С помощью таких программ, как Антипаркон или avinfobot можно пробить инфу о машине и ее владельце.

Например, узнать по гос номеру авто адрес проживания или найти телефонный стационарный номер.

Антипаркон бот, antiparkon_bot

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

Проверка авто телеграм бот avifobot

Это более усовершенствованная программа, которая осуществляет расширенный поиск и ищет подробную информацию о владельце. Правда некоторые услуги данного робота по проверке авто – платные.

Сервис умеет:
  • определять владельца;
  • выявлять vin;
  • проверять историю автомобиля и др.

Avtonomer, avtonomerbot: фотографии автомобиля в телеграм

Робот работает с фотографиями по своей базе и в сети интернет. Клиенты имеют возможность самостоятельно загружать фотки ТС (транспортного средства) на портал для покупателей. Достаточно ввести гос регистрационные данные и получить инфу с фото.

Поиск сведений об автовладельце с помощью бота в телеграм

Узнать номер сотового или стационарного телефона по гос номеру машины в телеграм не сложно.

Телефон автовладельца по номеру машины

  1. Найти приложение робота для проверки авто в телеграм и установить его.
  2. Зарегистрироваться.
  3. Запустить программу и начать общение: задать регистрационные данные машины (номер).
  4. Сервис проанализирует запрос и выдаст результат по проверке авто телеграм.

Как добавить номер машины в авто инфобот для telegram

  1. Устанавливаем приложение на ПК или смартфоне.
  2. Заходим в мессенджер и добавляем из списка программу.
  3. В открывшемся чате кликаем на Старт.
  4. Вводим данные в соответствующее поле.

Бот по машинам в телеграм

Сервис разработан специально для telegram проверки авто.

Запустив робота, вы сможете через телеграм робот узнать номер мобильного по гос номеру авто.

Где взять ботов для авто

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

Avtocodbot

Помогает получить информацию об истории эксплуатации транспортного средства и выдает сведения о бывших и нынешних владельцах. Запрос составляется по рег. данным, либо по Vin-коду.

Avinfobot

Отличная, можно сказать – уникальная программа для поиска.

Применяет расширенный поиск и позволяет узнать подробную информацию о ТС и его хозяине.

Антипаркон

Неплохая программа, которой легко пользоваться. Имеет большую собственную клиентскую базу.

Как в телеграме пробить номер машины с помощью бота

Пользуясь сервисами telegram, узнать все о транспортном средстве, принадлежащем пользователю, не проблема.

Возможно не отобразятся персональные данные хозяина машины, но в истории присутствуют данные регистрации ТС.

Как в телеграме найти автобота

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

Как добавить номер машины в авто инфо бот для telegram

  1. Устанавливаем приложение.
  2. Заходим в мессенджер и запускаем авто-робота.
  3. Нажимаем на Старт.
  4. Вводим данные о ТС и владельце.

Теперь вы знаете, как пользоваться программами. Согласитесь, узнать номер сотового или стационарного телефона по госномеру машины в telegram не сложно. Устанавливайте приложение и используйте все возможности робота.

 

Авто-каналы и боты в Telegram: новости, поиск по номеру

В Telegram авто и машины — это отдельная тематика, для которой создаются отличные каналы и боты. Благодаря этому, можно с уверенностью сказать, что сейчас прекрасное время для автолюбителей. Собственный автомобиль — мечта большинства людей.

Ведь эта покупка не только говорит о статусе владельца, но и открывает перед Вами целый новый мир. Ведь существует такое количество полезного контента и удобных сервисов. И все это — в одном мессенджере.

Лучшие каналы про авто в Telegram: новости, обзоры, статьи

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

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

AUTO_мания

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

Блог постоянно обновляется и пополняется свежим контентом, поэтому заскучать у вас не получится.

Беспредел на дороге🚦

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

Канал перестал обновляться. Теперь контент будет публиковаться в блоге АвтоМир, который принадлежит создателю Беспредел на дороге🚦.

Автодайджест

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

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

Автодром

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

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

Drive_Insider

Все мы любим инсайды от работников индустрии, верно? Ведь таким образом можно узнать обо всех изменениях и новостях заранее. И этот канал удовлетворяет этот запрос более чем полностью.

Здесь есть все, что нужно знать любому автомобилисту — обзоры новых моделей автомобилей, новинки в дизайне и тюнинге, видео краш-тестов, реальные истории из жизни водителей, лайфхаки и советы касательно ремонта или совершенствования своей машины. Кроме того, именно отсюда можно узнать обо всех новостях из мира автопрома раньше остальных.

Time Of Speed

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

Будет идеально тем, кто хочет научиться заботиться о своем автомобиле и нуждается в советах или лайфхаках. Плюс, здесь часто можно встретить обзоры и сравнения новых моделей авто, что может быть полезно людям, которые интересуются новинками автопрома.

No car — no life

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

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

Oldschool Garage

Не поспоришь с тем, что когда-то автомобили были настоящими произведениями искусства. Великолепный дизайн, идеальные формы и запоминающиеся детали. А на канале Oldschool Garage собрана классика советского и зарубежного автопрома. Здесь можно полюбоваться эстетикой автомобилей, которые уже не выпускают и всей красотой ретро-машин.

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

Канал перестал обновляться.

Гараж

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

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

Я знаю ПДД

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

А на этом канале можно проверить свои знания правил дорожного движения или подтянуть их. Здесь ежедневно проводят опросы касательно ПДД: ситуации на дороге, непредсказуемые действия участников дорожного движения и многое другое. Для этого, Вам дают несколько вариантов ответа, а позже публикуют правильный вариант.

Боты в Telegram для проверки и поиска авто по номеру

Покупка новой машины — это всегда непросто, особенно если автомобиль взят не из первых рук. Никому не хочется стать жертвой мошенников и покупать товар, который, возможно, был украден или становился участником дорожных происшествий. Всем хочется себя обезопасить, и поэтому любому будет полезно пробить свеженький автомобиль по базам данных. С этим могут помочь виртуальные сервисы. В этой подборке мы соберем для Вас лучших ботов для проверки и поиска авто по номеру в Telegram.

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

Если нужно пробить номер авто по базе данных: AVinfoBot в Telegram

Перед покупкой, стоит проверить автомобиль по номеру. AVinfoBot в Telegram поможет пробить авто и узнать по его индивидуальному номеру кучу полезной информации: кто владелец, где она была создана, проверить автомобиль на участие в ДТП, проверить историю продажи и многое другое.

Чтобы проверить автомобиль или его владельца отправьте боту:

  1. телефонный номер в любом формате
  2. госномер автомобиля или его VIN
  3. фотографию автомобиля с хорошо читаемым госномером
  4. гиперссылку на объявление о продаже автомобиля
  5. полное ФИО человека.

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

Узнать номер телефона по авто и связаться с владельцем: Avtobotoff в Telegram

Позволяет этот Телеграм-бот по номеру автомобиля связаться с владельцем машины. Что делать, если Вы попали в неприятную ситуацию на дороге или парковке, и хотите сообщить другому водителю о том, что он перекрыл Вам проезд, поцарапал Вашу машину или скрылся с места ДТП?

Этот бот поможет Вам узнать номер телефона владельца по авто, и поможет связаться с ним в Telegram. Все, что нужно — это ввести госномер нужной машины, и сразу можно написать ее хозяину.

Поиск фотографий машины по номеру: avtonomer в Telegram

Этот бот позволяет выполнить поиск фотографий конкретной машины по его индивидуальному номеру в Telegram. Все просто: нужно лишь ввести комбинацию букв и цифр, которые соответствуют зарегистрированному номеру необходимого автомобиля.

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

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

Tg-gram.com | Проверить авто через бот, проверка машины в Телеграмме

Бот по машинам в Телеграмм

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

Чем полезны боты

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

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

Популярные приложения, чтобы пробить номер авто

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

  • Avtocod Bot — используют этот бот в Телеграмме для авто, чтобы узнать номер машины, так как только по нему программа предоставляет информацию. Она отображает все данные об автомобиле, учитывая историю продаж и ДТП. Если у вас есть этот Телеграм бот, пробить номер автомобиля и всю соответствующую информацию не составит проблем.

  • AVinfo Bot — позволяет Телеграм бот узнать по номеру авто о его продавце. Также он предоставляет полную историю продаж машины. Для получения данных можно использовать не только госномер, но и заводской VIN-код.

  • Изи ВИН — данный Телеграм бот поиск по номеру авто выполняет в считанные минуты и составляет серьезную конкуренцию специальным сервисам с аналогичными функциями. Если вы используете этот Телеграмм бот, проверка автомобиля может быть выполнена как по госномеру, так и по VIN-коду.

Таким образом, имея Телеграмм бот, автомобили можно легко по их госномеру идентифицировать.

Другие популярные скрипты для проверки авто

Но не только позволяет бот Телеграмма пробить по номеру машины. Большим спросом пользуются и другие приложения:

  • Avtobotoff — чтобы использовать это Телеграмм, бот номера машин достаточно знать, чтобы связаться с другим владельцем транспорта. Особенность этой программы заключается в том, что она привязывает номер автомобиля к юзернейму пользователя Телеграмм. Если человек имеет аналогичное приложение в своем мессенджере и привязал номер машины к юзернейму, используя Avtobotoff бот Телеграмма, поиск по номеру не составит проблем.

  • LEEBOTS — такая программа и другие подобные боты автопродаж в Телеграмме позволят быстро и выгодно продать свою машину. Сегодня посредством мессенджера ведется торговля на корпоративном уровне, а потому такие приложения умеют принимать оплату от других пользователей Телеграм.

  • Shtrafy bot — используя этот бот Телеграм, проверка штрафов будет минутным делом, так как сделать это можно прямо со своего мессенджера. Кроме того, программа автоматически сообщает о штрафах и присылает ссылку на их оплату.

  • Shtrafgibdd_bot — особенность приложения заключается в том, что этот Телеграмм бот штрафы присылает вместе с фотографией, зафиксировавшей нарушение на дороге.

  • Gtshopparts bot — полезная программа, позволяющая найти в интернете необходимые запчасти и комплектующие к машине;

  • Moymotor_bot — от известного интернет-журнала “Мой мотор” будет полезен для тех, кто интересуется автострахованием, отслеживает изменения в ПДД, а также мониторит самые свежие новости про авто.

Где взять ботов для авто

Таким образом, независимо от задач, для которых предназначен бот Телеграмм (проверка номера телефона или получение другой полезной информации), эти программы не будут лишними в мессенджере каждого, кто владеет личным транспортом.

В каталоге нашего сервиса программы распределены по группам. В категории “Авто” можно найти полезные приложения для автомобилистов или тех, кто только собирается покупать транспорт. Каталог регулярно пополняется новыми программами, а потому пользователи мессенджера Телеграмм могут решать больше вопросов, связанных со своим автомобилем, дистанционно.

Ботов: Введение для разработчиков

Боты — это сторонние приложения, которые работают внутри Telegram. Пользователи могут взаимодействовать с ботами, отправляя им сообщения, команды и встроенные запросы. Вы управляете своими ботами с помощью HTTPS-запросов к нашему Bot API.

1. Что можно делать с ботами?

Чтобы назвать несколько вещей, вы можете использовать ботов для:

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

  • Интеграция с другими сервисами . Бот может дополнять чаты Telegram контентом из внешних сервисов.
    Gmail Бот , GIF-бот , IMDB-бот , Wiki-бот , Музыкальный бот , Youtube-бот , GitHub-бот

  • Принимать платежи от пользователей Telegram . Бот может предлагать платные услуги или работать как виртуальная витрина. Подробнее »
    Demo Shop Bot

  • Создание собственных инструментов .Бот может предоставлять вам оповещения, прогнозы погоды, переводы, форматирование или другие услуги.
    Бот для Markdown , Бот для стикеров , Голосовать за бот , Как бот

  • Создание однопользовательских и многопользовательских игр . Бот может предложить богатые возможности HTML5, от простых аркад и головоломок до 3D-шутеров и стратегических игр в реальном времени.
    GameBot , Gamee

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

  • Практически все остальное . Кроме посуды — боты плохо мыть посуду.

2. Как работают боты?

По сути, боты Telegram — это особые учетные записи, для которых не требуется дополнительный номер телефона. Пользователи могут взаимодействовать с ботами двумя способами:

  • Отправляйте сообщения и команды ботам, открывая с ними чат или добавляя их в группы.
  • Отправляйте запросы прямо из поля ввода, вводя @username бота и запрос. Это позволяет отправлять контент от встроенных ботов прямо в любой чат, группу или канал.

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

Подробное описание Bot API доступно на этой странице »

3. Как создать бота?

Для этого есть… бот. Просто поговорите с BotFather (описанным ниже) и выполните несколько простых шагов. После того, как вы создали бота и получили токен авторизации, перейдите к руководству по API бота, чтобы узнать, чему вы можете научить своего бота.

Вы также можете ознакомиться с некоторыми примерами кода здесь »

4.Чем боты отличаются от людей?

  • У ботов нет онлайн-статуса и отметок времени последнего посещения, вместо этого в интерфейсе отображается метка «бот» .
  • Боты имеют ограниченное облачное хранилище — более старые сообщения могут быть удалены сервером вскоре после их обработки.
  • Боты не могут инициировать разговоры с пользователями. Пользователь должен либо добавить их в группу, либо сначала отправить им сообщение. Люди могут использовать t.me/ ссылок или поиск по имени пользователя, чтобы найти вашего бота.
  • Имена пользователей ботов всегда заканчиваются на «бот» (например, @TriviaBot, @GitHub_bot).
  • При добавлении в группу боты по умолчанию не получают все сообщения (см. Режим конфиденциальности).
  • Боты никогда не едят, не спят и не жалуются (если специально не запрограммировано иное).

5. Бонусы для ботов

Боты

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

Встроенный режим

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

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

Посетите этот блог, чтобы увидеть в действии пример встроенного бота. Вы также можете попробовать ботов @sticker и @music, чтобы убедиться в этом сами.

\

Мы также реализовали простой способ для вашего бота переключаться между встроенным режимом и режимом PM.

Подробнее о встроенном режиме »

Платежная платформа

Вы можете использовать ботов для приема платежей от пользователей Telegram по всему миру.

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

Пользователь вводит необходимую информацию, выбирает одну из своих сохраненных карт или вводит новую (Telegram также поддерживает Apple Pay и Android Pay) — и оплачивает ваш продукт. Вот как может выглядеть процесс:

Подробнее о Платежной платформе »

Игровая платформа

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

\

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

Вы также можете проверить бота @gamee , у которого более 20 игр.

Подробнее об игровой платформе »

Клавиатуры

Традиционных чат-ботов, конечно, можно научить понимать человеческий язык. Но иногда вам требуется более формальный ввод от пользователя — и именно здесь пользовательские клавиатуры могут стать чрезвычайно полезными.

Всякий раз, когда ваш бот отправляет сообщение, он может передать специальную клавиатуру с предопределенными параметрами ответа (см. ReplyKeyboardMarkup). Приложения Telegram, которые получают сообщение, будут отображать вашу клавиатуру для пользователя.Нажатие любой из кнопок немедленно отправит соответствующую команду. Таким образом вы можете значительно упростить взаимодействие пользователя с вашим ботом.

В настоящее время мы поддерживаем текст и эмодзи для ваших кнопок. Вот несколько примеров пользовательской клавиатуры:

Для получения дополнительной технической информации о настраиваемых клавиатурах обратитесь к руководству по Bot API (см. SendMessage).

Встроенные клавиатуры и обновление на лету

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

В отличие от настраиваемых клавиатур для ответов, нажатие кнопок на встроенных клавиатурах не приводит к отправке сообщений в чат. Вместо этого встроенные клавиатуры поддерживают кнопки, которые работают за кулисами: кнопки обратного вызова, кнопки URL и переключение на встроенные кнопки.

Когда используются кнопки обратного вызова, ваш бот может обновлять свои существующие сообщения (или только свои клавиатуры), чтобы чат оставался аккуратным.Ознакомьтесь с этими примерами ботов, чтобы увидеть встроенные клавиатуры в действии: @music, @vote, @like.

Подробнее о встроенных клавиатурах и редактировании «на лету» »

Команды
Команды

представляют собой более гибкий способ связи с вашим ботом. Может использоваться следующий синтаксис:

  / команда  

Команда всегда должна начинаться с символа «/» и не может быть длиннее 32 символов. Команды могут использовать латинские буквы, цифры и символы подчеркивания.Вот несколько примеров:

  / get_messages_stats
/ set_timer 10мин Тревога!
/ get_timezone Лондон, Великобритания  

Сообщения, начинающиеся с косой черты, всегда передаются боту (вместе с ответами на его сообщения и сообщениями, которые @ упоминают бота по имени пользователя). Приложения Telegram будут:

  • Предложите список поддерживаемых команд с описанием, когда пользователь вводит ‘/’ (для того, чтобы это работало, вы должны предоставить список команд для BotFather). При нажатии на команду в списке немедленно отправляется команда.
  • Показать дополнительную кнопку (/) в поле ввода во всех чатах с ботами. При нажатии на нее набирается ‘/’ и отображается список команд.
  • Выделите / команды в сообщениях. Когда пользователь нажимает выделенную команду, команда отправляется сразу.

Если в группе несколько ботов, можно добавить имена пользователей ботов в команды, чтобы избежать путаницы:

  / start @ TriviaBot
/ start @ ApocalypseBot  

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

Глобальные команды

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

  • / начало — начинает взаимодействие с пользователем, например, отправляя приветственное сообщение. Эту команду также можно использовать для передачи боту дополнительных параметров (см. Глубинные ссылки)
  • / help — возвращает справочное сообщение.Это может быть краткий текст о том, что может делать ваш бот, и список команд.
  • / settings — (если применимо) возвращает настройки бота для этого пользователя и предлагает команды для редактирования этих настроек.

Пользователи увидят кнопку Start , когда они впервые начнут беседу с вашим ботом. Справка и Настройки Ссылки будут доступны в меню на странице профиля бота.

\
Форматирование: полужирный, курсив, текст фиксированной ширины и встроенные ссылки

Вы можете использовать полужирный, курсив или текст фиксированной ширины, а также встроенные ссылки в сообщениях ваших ботов.Клиенты Telegram будут отображать их соответственно.

Подробнее читайте в руководстве по Bot API »

Режим конфиденциальности

Ботов часто добавляют в группы, чтобы улучшить общение между пользователями-людьми, например путем предоставления новостей, уведомлений от внешних служб или дополнительных функций поиска. Это особенно актуально для групп, связанных с работой. Теперь, когда вы делите группу с ботом, вы склонны спрашивать себя: «Как я могу быть уверен, что этот маленький негодяй не продает мою историю чата моим конкурентам?» Ответ — приватный режим .

Бот, работающий в режиме конфиденциальности, не будет получать все сообщения, которые люди отправляют группе. Вместо этого он получит только:

  • Сообщения, начинающиеся с косой черты ‘/’ (см. Команды выше)
  • Ответы на собственные сообщения бота
  • Служебные сообщения (люди добавлены или удалены из группы и т. Д.)
  • Сообщения из каналов, в которых он участвует

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

Режим конфиденциальности включен по умолчанию для всех ботов, кроме ботов, которые были добавлены в группу как администраторы (админы ботов всегда получают все сообщения). Его можно отключить, чтобы бот получал все сообщения как обычный пользователь (боту нужно будет повторно добавить в группу, чтобы это изменение вступило в силу). Мы рекомендуем делать это только в тех случаях, когда для работы вашего бота это абсолютно необходимо — пользователи всегда могут видеть текущие настройки конфиденциальности бота в списке участников группы.В большинстве случаев использования опции принудительного ответа для сообщений бота более чем достаточно.

Итак, какие именно сообщения будет получать мой бот? »

Глубокие ссылки

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

У каждого бота есть ссылка, открывающая с ним беседу в Telegram — https: // t.я / <имя пользователя бота> . К этой ссылке можно добавить параметры start или startgroup со значениями длиной до 64 символов. Например:

  https://t.me/triviabot?startgroup=test  

A-Z , a-z , 0-9 , _ и - разрешены. Мы рекомендуем использовать base64url для кодирования параметров с двоичными и другими типами содержимого.

Переход по ссылке с параметром start откроет индивидуальный диалог с ботом, показывая кнопку СТАРТ вместо поля ввода.Если используется параметр startgroup , пользователю предлагается выбрать группу для добавления бота. Как только пользователь подтверждает действие (нажимает кнопку СТАРТ в своем приложении или выбирает группу для добавления бота), ваш бот получит сообщение от этого пользователя в следующем формате:

  / начало PAYLOAD  

PAYLOAD обозначает значение параметра start или startgroup , которое было передано в ссылке.

Пример глубокой ссылки

Предположим, на примере веб-сайта.com хочет отправлять уведомления своим пользователям через бота Telegram. Вот что они могут сделать, чтобы включить уведомления для пользователя с идентификатором 123 .

  1. Создайте бота с подходящим именем пользователя, например @ExampleComBot
  2. Настроить веб-перехватчик входящих сообщений
  3. Сгенерировать случайную строку достаточной длины, например $ memcache_key = "vCh2vGWJxfSeofSAs0K5PA"
  4. Поместите значение 123 с ключом $ memcache_key в Memcache на 3600 секунд (один час)
  5. Покажем нашему пользователю кнопку https: // t.меня / ExampleComBot? start = vCh2vGWJxfSeofSAs0K5PA
  6. Настройте процессор веб-перехватчиков для запроса Memcached с параметром, который передается во входящих сообщениях, начиная с / start . Если ключ существует, запишите chat_id, переданный веб-перехватчику, как telegram_chat_id для пользователя 123 . Удалите ключ из Memcache.
  7. Теперь, когда мы хотим отправить уведомление пользователю 123 , проверьте, есть ли у него поле telegram_chat_id .Если да, используйте метод sendMessage в API ботов, чтобы отправить им сообщение в Telegram.
Расположение и номер

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

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

\

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

Руководство: Цифровые и позиционные кнопки »


6. BotFather

В начало, чтобы узнать все о ботах Telegram »

BotFather — единственный бот, который правит ими всеми. Это поможет вам создать новых ботов и изменить настройки существующих.

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

Используйте команду / newbot для создания нового бота. BotFather запросит у вас имя и имя пользователя, а затем сгенерирует токен авторизации для вашего нового бота.

Имя вашего бота отображается в контактных данных и в других местах.

Имя пользователя — это короткое имя, которое используется в упоминаниях и ссылках на t.me. Имена пользователей состоят из 5-32 символов и нечувствительны к регистру, но могут включать только латинские символы, числа и символы подчеркивания.Имя пользователя вашего бота должно заканчиваться на на «бот», например tetris_bot или TetrisBot.

Токен — это строка, соответствующая строкам 110201543: AAHdqTcvCh2vGWJxfSeofSAs0K5PALDsaw , которая требуется для авторизации бота и отправки запросов в API бота. Держите свой токен в безопасности и храните его, он может использоваться кем угодно для управления вашим ботом.

Создание токена авторизации

Если ваш существующий токен скомпрометирован или вы потеряли его по какой-либо причине, используйте команду / token для создания нового.

Botfather командует

Остальные команды говорят сами за себя:

  • / mybots — возвращает список ваших ботов с удобными элементами управления для редактирования их настроек
  • / mygames — делает то же самое для ваших игр

Редактировать ботов

  • / setname — измените имя вашего бота.
  • / setdescription — изменить описание бота , короткий текст до 512 символов, описывающий вашего бота.Пользователи увидят этот текст в начале разговора с ботом под названием «Что умеет этот бот?».
  • / setabouttext — изменить бота на информацию , еще более короткий текст до 120 символов. Пользователи увидят этот текст на странице профиля бота. Когда они делятся вашим ботом с кем-то, этот текст отправляется вместе со ссылкой.
  • / setuserpic — изменить фото профиля бота. Всегда приятно поменять имя на лицо.
  • / setcommands — изменить список команд, поддерживаемых вашим ботом.Пользователи будут видеть эти команды как предложения, когда они набирают / в чате с вашим ботом. У каждой команды есть имя (должно начинаться с косой черты ‘/’, буквенно-цифровые символы плюс подчеркивание, не более 32 символов, без учета регистра), параметры и текстовое описание. Пользователи будут видеть список команд всякий раз, когда они набирают ‘/’ в разговоре с вашим ботом.
  • / deletebot — удалите своего бота и освободите его логин.

Изменить настройки

  • / setinline — переключить встроенный режим для вашего бота.
  • / setinlinegeo — запросить данные о местоположении для предоставления встроенных результатов на основе местоположения.
  • / setjoingroups — переключить, можно ли добавлять вашего бота в группы или нет. Любой бот должен иметь возможность обрабатывать личные сообщения, но если ваш бот не предназначен для работы в группах, вы можете отключить это.
  • / setprivacy — укажите, какие сообщения будет получать ваш бот при добавлении в группу. Если режим конфиденциальности отключен, бот будет получать все сообщения.Мы рекомендуем оставить режим конфиденциальности включенным. Вам нужно будет повторно добавить бота в существующие группы, чтобы это изменение вступило в силу.

Управление играми

  • / newgame — создать новую игру.
  • / listgames — получите список своих игр.
  • / editgame — редактировать игру.
  • / deletegame — удалить существующую игру.

Обратите внимание, что может потребоваться несколько минут , чтобы изменения вступили в силу.

Предупреждения о состоянии

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

Мы будем проверять количество ответов и коэффициент конверсии запросов / ответов для популярных ботов (~ 300 запросов в минуту: но не записывайте это, так как значение может измениться в будущем).Если мы получим аномально низкие значения, вы получите уведомление от Botfather.

Реагирование на предупреждения

По умолчанию вы будете получать только одно предупреждение на одного бота в час. Каждое предупреждение имеет следующие кнопки:

  • Фиксированный. Используйте это, если вы обнаружили проблему с вашим ботом и исправили ее. Если вы нажмете кнопку исправления, мы возобновим отправку предупреждений в обычном режиме, чтобы вы могли видеть, сработало ли исправление в течение 5–10 минут, вместо того, чтобы ждать час.
  • Поддержка. Используйте это, чтобы открыть чат с @BotSupport, если вы не видите никаких проблем с вашим ботом или если вы думаете, что проблема на нашей стороне.
  • Без звука на 8 часов / 1 нед. Используйте это, если вы не можете исправить своего бота в данный момент. Это отключит все предупреждения для рассматриваемого бота за указанный период времени. Мы не рекомендуем использовать эту опцию, поскольку ваши пользователи могут перейти на более стабильный бот. Вы можете включить оповещения в настройках своего бота через Botfather.
Отслеживаемые проблемы

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

1.

  Слишком мало ** личных сообщений ** отправлено по сравнению с предыдущими неделями: ** {value} **  

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

2.

  Слишком мало ответов на входящие ** личные сообщения **. Коэффициент конверсии: ** {value} **  

Ваш бот не отвечает на все отправляемые ему сообщения (коэффициент конверсии запросов / ответов для вашего бота был слишком низким как минимум в течение двух из трех последних 5-минутных периодов).Чтобы обеспечить удобство работы пользователей, отвечайте на все сообщения, отправляемые вашему боту. Ответьте на сообщение обновлений , вызвав методы send… (например, sendMessage).

3.

  Слишком мало ответов на ** встроенные запросы **. Коэффициент конверсии: ** {value} **  

Ваш бот не отвечает на все отправляемые ему встроенные запросы, рассчитанные таким же образом, как указано выше. Ответьте на обновлений inline_query , вызвав answerInlineQuery.

4.

  Слишком мало ответов на ** запросы обратного вызова **. Коэффициент конверсии: ** {значение} **
Слишком мало ответов на ** запросы к игре обратного вызова **. Коэффициент конверсии: ** {value} **  

Ваш бот не отвечает на все запросы обратного вызова, которые ему отправляются (с играми или без них), рассчитанные таким же образом, как указано выше. Ответьте на обновления callback_query , вызвав answerCallbackQuery.

Обратите внимание, что функция предупреждений о состоянии все еще тестируется и будет улучшена в будущем.


На этом введение. Теперь вы определенно готовы перейти к РУКОВОДСТВУ ПО API BOT .

Если у вас есть вопросы, ознакомьтесь с часто задаваемыми вопросами о Bot »

Telegram Bot API

Bot API — это интерфейс на основе HTTP, созданный для разработчиков, стремящихся создавать ботов для Telegram.
Чтобы узнать, как создать и настроить бота, обратитесь к разделу Introduction to Bots и Часто задаваемые вопросы о ботах .

Последние изменения

Подпишитесь на @BotNews, чтобы первым узнавать о последних обновлениях и присоединяться к обсуждению в @BotTalk

4 ноября 2020

Представляем Bot API 5.0

Запустите собственный сервер API ботов

  • Исходный код Bot API теперь доступен по адресу telegram-bot-api. Теперь вы можете запустить свой собственный сервер Bot API локально, повышая производительность ваших ботов (проверьте это, чтобы узнать, пойдет ли это на пользу вашему проекту).
  • Добавлен метод logOut, который можно использовать для выхода из облачного сервера API ботов перед локальным запуском бота. Вы должны выйти из бота перед его локальным запуском, в противном случае нет гарантии, что бот получит все обновления.
  • Добавлен метод close, который можно использовать для закрытия экземпляра бота перед перемещением его с одного локального сервера на другой.

Передача права собственности на бота

  • Теперь вы можете использовать @BotFather для переноса существующих ботов в другую учетную запись Telegram.

Вебхуки

  • Добавлен параметр ip_address к методу setWebhook, позволяющий обойти разрешение DNS и использовать указанный фиксированный IP-адрес для отправки запросов веб-перехватчиков.
  • В класс WebhookInfo добавлено поле ip_address , содержащее текущий IP-адрес, используемый для создания веб-перехватчиков.
  • Добавлена ​​возможность отбрасывать все ожидающие обновления при изменении URL-адреса веб-перехватчика с помощью параметра drop_pending_updates в методах setWebhook и deleteWebhook.

Работа с группами

  • Запрос getChat теперь возвращает биографию пользователя для приватных чатов, если она доступна.
  • Запрос getChat теперь возвращает идентификатор связанного чата для супергрупп и каналов, то есть идентификатор группы обсуждения для канала и наоборот.
  • Запрос getChat теперь возвращает местоположение, к которому подключена супергруппа (см. Локальные группы). Добавлен класс ChatLocation для представления местоположения.
  • Добавлен параметр only_if_banned в метод unbanChatMember, чтобы разрешить безопасную разблокировку.

Работа с файлами

  • В классы Аудио и Видео добавлено поле имя_файла , содержащее имя исходного файла.
  • Добавлена ​​возможность отключить определение типа содержимого файла на стороне сервера с помощью параметра disable_content_type_detection в методе sendDocument и классе inputMediaDocument.

Множественные закрепленные сообщения

  • Добавлена ​​возможность закреплять сообщения в приватных чатах .
  • Добавлен параметр message_id к методу unpinChatMessage, чтобы разрешить открепление конкретного закрепленного сообщения.
  • Добавлен метод unpinAllChatMessages, который можно использовать для открепления всех закрепленных сообщений в чате.

Файловые альбомы

  • Добавлена ​​поддержка отправки и получения аудио и альбомов документов в методе sendMediaGroup.

Текущие местоположения

Анонимные администраторы

  • В класс Message добавлено поле sender_chat , содержащее отправителя сообщения, которое является чатом (группой или каналом). Для обратной совместимости в неканальных чатах поле из в таких сообщениях будет содержать пользователя 777000 для сообщений, автоматически перенаправляемых в группу обсуждения, и пользователя 1087968824 (@GroupAnonymousBot) для сообщений от администраторов анонимных групп.
  • В класс chatMember добавлено поле is_anonymous , которое можно использовать для распознавания администраторов анонимного чата.
  • Добавлен параметр is_anonymous к методу promotionChatMember, позволяющий продвигать администраторов анонимного чата. Сам бот должен иметь для этого право is_anonymous . Несмотря на то, что боты могут иметь право is_anonymous , они никогда не будут отображаться в чате как анонимные. Боты могут использовать право только для передачи другим администраторам.
  • Добавлен настраиваемый заголовок отправителя анонимного сообщения в класс Message как author_signature .

и более

  • Добавлен метод copyMessage, который отправляет копию любого сообщения.
  • Максимальная длина вопроса опроса увеличена до 300.
  • Добавлена ​​возможность вручную указать текстовые объекты вместо указания parse_mode в классах InputMediaPhoto, InputMediaVideo, InputMediaAnimation, InputMediaAudio, InputMediaDocument, InlineQueryResultPhoto, InlineQueryResultGif, InlineQueryResultMpeg4Gif, InlineQueryResultVideo, InlineQueryResultAudio, InlineQueryResultVoice, InlineQueryResultDocument, InlineQueryResultCachedPhoto, InlineQueryResultCachedGif, InlineQueryResultCachedMpeg4Gif, InlineQueryResultCachedVideo , InlineQueryResultCachedAudio, InlineQueryResultCachedVoice, InlineQueryResultCachedDocument, InputTextMessageContent и методы sendMessage, sendPhoto, sendVideo, sendAnimation, sendAudio, sendDocument, sendVoice, sendPollage, editMessageTessage.
  • Добавлены поля google_place_id и google_place_type в классы Venue, InlineQueryResultVenue, InputVenueMessageContent и необязательные параметры google_place_id и google_place_type для поддержки метода Google Place_type в качестве поставщика Google PlaceVenue в качестве провайдера.
  • Добавлено поле allow_sending_without_reply в методы sendMessage, sendPhoto, sendVideo, sendAnimation, sendAudio, sendDocument, sendSticker, sendVideoNote, sendVoice, sendLocation, sendVenue, sendContact, sendPoll, sendDice, sendInvoice как для отправки сообщений sendMessage, send ответить, если ответное сообщение уже было удалено.

И последнее, но не менее

  • Поддерживаются новые футбол и игровые автоматы анимации для случайных игральных костей. Выберите между различными анимациями (игра в кости, дартс, баскетбол, футбол, игровой автомат), указав параметр emoji в методе sendDice.
4 июня 2020 г.

Бот API 4.9

  • Добавлено новое поле via_bot в объект сообщения.Теперь вы можете узнать, какой бот использовался для отправки сообщения.
  • Поддерживаются эскизы видео для встроенной анимации GIF и MPEG4.
  • Поддерживается новая анимация баскетбола для случайных кубиков. Выбирайте между различными анимациями (игра в кости, дартс, баскетбол), задав параметр emoji в методе sendDice.
24 апреля 2020

Бот API 4.8

  • Поддерживаемые объяснения викторин 2.0. Добавьте объяснения, указав параметры объяснение и объяснение_парс_мод в методе sendPoll.
  • Добавлены поля объяснение, и объяснение_entities, к объекту опроса.
  • Поддерживаются опросы по времени, которые автоматически закрываются в определенную дату и время. Настройте, указав параметр open_period или close_date в методе sendPoll.
  • Добавлены поля open_period и close_date к объекту Poll.
  • Поддерживается новая анимация дартса для мини-игры в кости. Выберите между анимацией игральных костей по умолчанию и анимацией дартса, указав параметр emoji в методе sendDice.
  • В объект Dice добавлено поле emoji .
30 марта 2020

Бот API 4,7

  • Добавлен метод sendDice для отправки сообщения о кубиках, которое будет иметь случайное значение от 1 до 6. (Да, мы знаем о «правильном» единственном числе die . Но это неудобно, и мы решили чтобы помочь ему измениться. По одной кости за раз!)
  • Добавлен кубик поля в объект сообщения.
  • Добавлен метод getMyCommands для получения текущего списка команд бота.
  • Добавлен метод setMyCommands для изменения списка команд бота через Bot API вместо @BotFather.
  • Добавлена ​​возможность создавать наборы анимированных стикеров, задав параметр tgs_sticker вместо png_sticker в методе createNewStickerSet.
  • Добавлена ​​возможность добавлять анимированные стикеры в наборы, созданные ботом, указав параметр tgs_sticker вместо png_sticker в методе addStickerToSet.
  • Добавлено поле thumb в объект StickerSet.
  • Добавлена ​​возможность изменять эскизы наборов стикеров, созданных ботом с помощью метода setStickerSetThumb.

См. Ранние изменения »

Авторизация бота

При создании каждому боту выдается уникальный токен аутентификации. Маркер выглядит примерно так: 123456: ABC-DEF1234ghIkl-zyx57W2v1u123ew11 , но вместо этого в этом документе мы будем использовать просто .Вы можете узнать о получении токенов и создании новых в этом документе.

Запросы

Все запросы к Telegram Bot API должны обслуживаться через HTTPS и должны быть представлены в следующей форме: https://api.telegram.org/bot/METHOD_NAME . Например:

  https://api.telegram.org/bot123456:ABC-DEF1234ghIkl-zyx57W2v1u123ew11/getMe  

Мы поддерживаем HTTP-методы GET и POST .Мы поддерживаем четыре способа передачи параметров в запросах Bot API:

  • Строка запроса URL
  • приложение / x-www-form-urlencoded
  • приложение / json (кроме загрузки файлов)
  • multipart / form-data (используется для загрузки файлов)

Ответ содержит объект JSON, который всегда имеет логическое поле «ok» и может иметь необязательное поле String «description» с понятным для человека описанием результата. Если «ok» равно true, запрос был успешным, и его результат можно найти в поле «результат».В случае неудачного запроса «ok» равно false, а ошибка объясняется в «описании». Также возвращается целочисленное поле error_code, но его содержимое может измениться в будущем. Некоторые ошибки могут также иметь необязательное поле «параметры» типа ResponseParameters, которое может помочь автоматически обработать ошибку.

  • Все методы в Bot API нечувствительны к регистру.
  • Все запросы должны выполняться с использованием UTF-8.
Запросы при получении обновлений

Если вы используете веб-перехватчик , вы можете выполнить запрос к API бота при отправке ответа веб-перехватчику.Используйте тип содержимого ответа application / json или application / x-www-form-urlencoded или multipart / form-data для передачи параметров. Укажите вызываемый метод в параметре method запроса. Невозможно узнать, что такой запрос был успешным, или получить его результат.

Примеры можно найти в нашем FAQ.

Использование локального сервера API ботов

Исходный код сервера Bot API доступен по адресу telegram-bot-api.Вы можете запустить его локально и отправлять запросы на свой сервер вместо https://api.telegram.org . Если вы переключитесь на локальный сервер API ботов, ваш бот сможет:

  • Скачивание файлов без ограничения размера.
  • Загружать файлы размером до 2000 МБ.
  • Загрузите файлы, используя их локальный путь и схему URI файла.
  • Используйте URL-адрес HTTP для веб-перехватчика.
  • Используйте любой локальный IP-адрес для веб-перехватчика.
  • Используйте любой порт для веб-перехватчика.
  • Установить max_webhook_connections от до 100000.
  • Получить абсолютный локальный путь как значение поля file_path без необходимости загружать файл после запроса getFile.
Нужен ли мне локальный сервер API ботов?

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

Получение обновлений

Существует два взаимоисключающих способа получения обновлений для вашего бота — метод getUpdates с одной стороны и Webhooks с другой.Входящие обновления хранятся на сервере до тех пор, пока бот не получит их в любом случае, но они не будут храниться дольше 24 часов.

Независимо от того, какой вариант вы выберете, в результате вы получите JSON-сериализованные объекты обновления.

Обновление

Этот объект представляет входящее обновление.
Максимум один дополнительных параметров может присутствовать в любом данном обновлении.

.
Поле Тип Описание
update_id Целое Уникальный идентификатор обновления.Идентификаторы обновления начинаются с определенного положительного числа и последовательно увеличиваются. Этот идентификатор становится особенно удобным, если вы используете Webhooks, поскольку он позволяет игнорировать повторяющиеся обновления или восстанавливать правильную последовательность обновлений, если они выходят из строя. Если новых обновлений нет хотя бы неделю, то идентификатор следующего обновления будет выбран случайно, а не последовательно.
сообщение Сообщение Дополнительно . Новое входящее сообщение любого типа — текст, фото, стикер и т. Д.
edited_message Сообщение Дополнительно . Новая версия сообщения, известная боту и отредактированная
канал_пост Сообщение Дополнительно . Новые входящие сообщения на канале любого типа — текст, фото, стикеры и т. Д.
edited_channel_post Сообщение Дополнительно . Новая известная боту версия поста канала отредактирована
inline_query InlineQuery Дополнительно .Новый входящий встроенный запрос
selected_inline_result ChosenInlineResult Дополнительно . Результат встроенного запроса, который был выбран пользователем и отправлен своему партнеру по чату. Пожалуйста, ознакомьтесь с нашей документацией по сбору отзывов, чтобы узнать, как включить эти обновления для вашего бота.
callback_query Обратный звонок Запрос Дополнительно . Новый входящий запрос обратного вызова
shipping_query Запрос на доставку Дополнительно .Новый входящий запрос на доставку. Только для счетов с гибкой ценой
pre_checkout_query PreCheckoutQuery Дополнительно . Новый входящий предварительный запрос. Содержит полную информацию о кассе
опрос Опрос Дополнительно . Новое состояние опроса. Боты получают только обновления об остановленных опросах и опросах, которые отправляет бот
poll_answer Ответ на опрос Дополнительно .Пользователь изменил свой ответ в неанонимном опросе. Боты получают новые голоса только в опросах, которые отправил сам бот.
getUpdates

Используйте этот метод для получения входящих обновлений с помощью длительного опроса (вики). Возвращается массив объектов обновления.

Параметр Тип Обязательно Описание
смещение Целое Дополнительно Идентификатор первого возвращаемого обновления.Должен быть на единицу больше, чем самый высокий среди идентификаторов ранее полученных обновлений. По умолчанию возвращаются обновления, начиная с самого раннего неподтвержденного обновления. Обновление считается подтвержденным, как только вызывается getUpdates со смещением на выше, чем его update_id . Отрицательное смещение может быть указано для получения обновлений, начиная с -offset update от конца очереди обновлений. Все предыдущие обновления будут забыты.
предел Целое Дополнительно Ограничивает количество получаемых обновлений.Принимаются значения от 1 до 100. По умолчанию 100.
тайм-аут Целое Дополнительно Тайм-аут в секундах для длительного опроса. По умолчанию 0, т.е. обычный короткий опрос. Должен быть положительным, короткий опрос следует использовать только в целях тестирования.
allowed_updates Массив строк Дополнительно Сериализованный в формате JSON список типов обновлений, которые должен получать бот. Например, укажите [«message», «edited_channel_post», «callback_query»], чтобы получать обновления только этих типов.См. Обновление для получения полного списка доступных типов обновлений. Укажите пустой список для получения всех обновлений независимо от типа (по умолчанию). Если не указано, будет использоваться предыдущая настройка.

Обратите внимание, что этот параметр не влияет на обновления, созданные до вызова getUpdates, поэтому нежелательные обновления могут быть получены в течение короткого периода времени.

Примечания
1. Этот метод не будет работать, если настроен исходящий веб-перехватчик.
2. Чтобы избежать дублирования обновлений, пересчитывайте смещение после каждого ответа сервера.

комплект Webhook

Используйте этот метод, чтобы указать URL-адрес и получать входящие обновления через исходящий веб-перехватчик. При каждом обновлении для бота мы будем отправлять HTTPS-запрос POST на указанный URL-адрес, содержащий сериализованное обновление JSON. В случае неудачного запроса мы откажемся от него после разумного количества попыток. В случае успеха возвращает Истинно .

Если вы хотите убедиться, что запрос Webhook исходит от Telegram, мы рекомендуем использовать секретный путь в URL-адресе, например https://www.example.com/ <токен> . Поскольку никто другой не знает токен вашего бота, можете быть уверены, что это мы.

Параметр Тип Обязательно Описание
url Строка Есть URL-адрес HTTPS для отправки обновлений.Используйте пустую строку, чтобы удалить интеграцию веб-перехватчика
сертификат Входной файл Дополнительно Загрузите сертификат открытого ключа, чтобы можно было проверить используемый корневой сертификат. См. Подробности в нашем самоподписанном руководстве.
ip_адрес Строка Дополнительно Фиксированный IP-адрес, который будет использоваться для отправки запросов веб-перехватчика вместо IP-адреса, разрешенного через DNS
max_connections Целое Дополнительно Максимально допустимое количество одновременных HTTPS-подключений к веб-перехватчику для доставки обновлений, 1–100.По умолчанию 40 . Используйте более низкие значения, чтобы ограничить нагрузку на сервер вашего бота, и более высокие значения, чтобы увеличить пропускную способность вашего бота.
allowed_updates Массив строк Дополнительно Сериализованный в формате JSON список типов обновлений, которые должен получать бот. Например, укажите [«message», «edited_channel_post», «callback_query»], чтобы получать обновления только этих типов. См. Обновление для получения полного списка доступных типов обновлений. Укажите пустой список для получения всех обновлений независимо от типа (по умолчанию).Если не указано, будет использоваться предыдущая настройка.
Обратите внимание, что этот параметр не влияет на обновления, созданные до вызова setWebhook, поэтому нежелательные обновления могут быть получены в течение короткого периода времени.
drop_pending_updates логический Дополнительно Пройдите Истинно , чтобы удалить все ожидающие обновления

Примечания
1. Вы не сможете получать обновления с помощью getUpdates, пока настроен исходящий веб-перехватчик.
2. Чтобы использовать самозаверяющий сертификат, вам необходимо загрузить сертификат открытого ключа, используя параметр сертификат . Пожалуйста, загрузите как InputFile, отправка строки не будет работать.
3. В настоящее время поддерживаются порты для Webhooks : 443, 80, 88, 8443 .

НОВИНКА! Если у вас возникли проблемы с настройкой веб-перехватчиков, ознакомьтесь с этим замечательным руководством по веб-перехватчикам.

удалитьWebhook

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

Параметр Тип Обязательно Описание
drop_pending_updates логический Дополнительно Пройдите Истинно , чтобы удалить все ожидающие обновления
getWebhookInfo

Используйте этот метод, чтобы получить текущий статус веб-перехватчика. Не требует параметров. В случае успеха возвращает объект WebhookInfo.Если бот использует getUpdates, он вернет объект с пустым полем url .

WebhookInfo

Содержит информацию о текущем состоянии веб-перехватчика.

Поле Тип Описание
url Строка URL-адрес веб-перехватчика, может быть пустым, если веб-перехватчик не настроен
has_custom_certificate логический Верно, если для проверки сертификата веб-перехватчика был предоставлен настраиваемый сертификат
pending_update_count Целое Количество ожидающих доставки обновлений
ip_адрес Строка Дополнительно .Текущий IP-адрес веб-перехватчика
last_error_date Целое Дополнительно . Время Unix для самой последней ошибки, которая произошла при попытке доставить обновление через webhook
last_error_message Строка Дополнительно . Сообщение об ошибке в удобочитаемом формате для самой последней ошибки, которая произошла при попытке доставить обновление через webhook
max_connections Целое Дополнительно .Максимально допустимое количество одновременных HTTPS-подключений к веб-перехватчику для доставки обновлений
allowed_updates Массив строк Дополнительно . Список типов обновлений, на которые подписан бот. По умолчанию для всех типов обновлений

Доступные типы

Все типы, используемые в ответах Bot API, представлены как JSON-объекты.

Можно безопасно использовать 32-разрядные целые числа со знаком для хранения всех полей Integer , если не указано иное.

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

Пользователь

Этот объект представляет пользователя или бота Telegram.

Поле Тип Описание
id Целое Уникальный идентификатор этого пользователя или бота
is_bot логический Верно, если этот пользователь бот
first_name Строка Имя пользователя или бота
фамилия Строка Дополнительно .Фамилия пользователя или бота
имя пользователя Строка Дополнительно . Имя пользователя или бота
language_code Строка Дополнительно . Языковой тег IETF языка пользователя
can_join_groups логический Дополнительно . Правда, если бота можно приглашать в группы. Вернулся только в getMe.
can_read_all_group_messages логический Дополнительно .Верно, если для бота отключен приватный режим. Вернулся только в getMe.
supports_inline_queries логический Дополнительно . Правда, если бот поддерживает встроенные запросы. Вернулся только в getMe.
Чат

Этот объект представляет чат.

Фото
Поле Тип Описание
id Целое Уникальный идентификатор этого чата.Это число может быть больше 32 бит, и некоторые языки программирования могут иметь затруднения / молчаливые дефекты при его интерпретации. Но он меньше 52 бит, поэтому 64-битное целое число со знаком или плавающий тип двойной точности безопасны для хранения этого идентификатора.
тип Строка Тип чата, может быть «частным», «групповым», «супергрупповым» или «канальным».
название Строка Дополнительно . Заголовок, для супергрупп, каналов и групповых чатов
имя пользователя Строка Дополнительно .Имя пользователя, для приватных чатов, супергрупп и каналов, если доступно
first_name Строка Дополнительно . Имя собеседника в приватном чате
фамилия Строка Дополнительно . Фамилия собеседника в приватном чате
фото Чат Дополнительно . Фото чата. Вернул только в getChat.
био Строка Дополнительно .Биография собеседника в приватном чате. Вернул только в getChat.
описание Строка Дополнительно . Описание, для групп, супергрупп и чатов каналов. Вернул только в getChat.
invit_link Строка Дополнительно . Ссылка для приглашения в чат для групп, супергрупп и чатов каналов. Каждый администратор в чате генерирует свои собственные пригласительные ссылки, поэтому бот должен сначала создать ссылку с помощью exportChatInviteLink.Вернул только в getChat.
pinned_message Сообщение Дополнительно . Последнее закрепленное сообщение (по дате отправки). Вернул только в getChat.
разрешения ChatPermissions Дополнительно . Разрешения участников чата по умолчанию для групп и супергрупп. Вернул только в getChat.
slow_mode_delay Целое Дополнительно .Для супергрупп — минимально допустимая задержка между последовательными сообщениями, отправляемыми каждым непривилегированным пользователем. Вернул только в getChat.
имя_набора_наклей Строка Дополнительно . Для супергрупп — название набора групповых стикеров. Вернул только в getChat.
can_set_sticker_set логический Дополнительно . Правда, если бот умеет менять групповой набор стикеров. Вернул только в getChat.
connected_chat_id Целое Дополнительно .Уникальный идентификатор связанного чата, то есть идентификатор группы обсуждения для канала и наоборот; для супергрупп и чатов каналов. Длина этого идентификатора может превышать 32 бита, и некоторые языки программирования могут иметь затруднительные / скрытые дефекты при его интерпретации. Но он меньше 52 бит, поэтому 64-битное целое число со знаком или плавающий тип двойной точности безопасны для хранения этого идентификатора. Вернул только в getChat.
расположение чат, местонахождение Дополнительно .Для супергрупп — место, к которому подключается супергруппа. Вернул только в getChat.
Сообщение

Этот объект представляет сообщение.

...
Поле Тип Описание
message_id Целое Уникальный идентификатор сообщения в этом чате
из Пользователь Дополнительно . Отправитель, пусто для сообщений, отправленных на каналы
sender_chat Чат Дополнительно .Отправитель сообщения, отправленного от имени чата. Сам канал для сообщений канала. Сама супергруппа для сообщений от администраторов анонимных групп. Связанный канал для сообщений, автоматически перенаправляемых в группу обсуждения
дата Целое Дата отправки сообщения по времени Unix
чат Чат Диалог, которому принадлежит сообщение
вперед_от Пользователь Дополнительно .Для пересылаемых сообщений отправитель исходного сообщения
forward_from_chat Чат Дополнительно . Для сообщений, пересылаемых с каналов или от анонимных администраторов, информация об исходном чате отправителя
forward_from_message_id Целое Дополнительно . Для сообщений, пересылаемых из каналов, идентификатор исходного сообщения в канале
forward_signature Строка Дополнительно .Для сообщений, пересылаемых с каналов, подпись автора сообщения, если есть
forward_sender_name Строка Дополнительно . Имя отправителя для сообщений, пересылаемых от пользователей, которые не разрешают добавлять ссылку на свою учетную запись в пересылаемых сообщениях
forward_date Целое Дополнительно . Для пересылаемых сообщений дата отправки исходного сообщения в Unix-времени
reply_to_message Сообщение Дополнительно .Для ответов — исходное сообщение. Обратите внимание, что объект сообщения в этом поле не будет содержать дополнительных полей reply_to_message , даже если он сам является ответом.
via_bot Пользователь Дополнительно . Бот, через который было отправлено сообщение
edit_date Целое Дополнительно . Дата последнего редактирования сообщения в Unix-времени
media_group_id Строка Дополнительно .Уникальный идентификатор группы мультимедийных сообщений, к которой принадлежит это сообщение
автор_подпись Строка Дополнительно . Подпись автора поста для сообщений в каналах или произвольное название анонимного администратора группы
текст Строка Дополнительно . Для текстовых сообщений фактический текст сообщения в кодировке UTF-8, 0-4096 символов
юридических лиц Массив MessageEntity Дополнительно .Для текстовых сообщений специальные объекты, такие как имена пользователей, URL-адреса, команды ботов и т. Д., Которые появляются в тексте
анимация Анимация Дополнительно . Сообщение — это анимация, информация об анимации. Для обратной совместимости, когда это поле установлено, поле документа также будет установлено
аудио Аудио Дополнительно . Сообщение представляет собой аудиофайл, информация о файле
документ Документ Дополнительно .Сообщение — это общий файл, информация о файле
фото Массив PhotoSize Дополнительно . В сообщении есть фотография, доступные размеры фото
наклейка Наклейка Дополнительно . Сообщение — наклейка, информация о наклейке
видео Видео Дополнительно . Сообщение видео, информация о видео
video_note VideoNote Дополнительно .Сообщение — видеозаметка, информация о видео сообщении
голос Голос Дополнительно . Сообщение — голосовое сообщение, информация о файле
подпись Строка Дополнительно . Подпись к анимации, аудио, документу, фотографии, видео или голосу, 0-1024 символов
caption_entities Массив MessageEntity Дополнительно .Для сообщений с подписью используются специальные объекты, такие как имена пользователей, URL-адреса, команды ботов и т. Д., Которые появляются в подписи
контакт Контакт Дополнительно . Сообщение — общий контакт, информация о контакте
кости Игральные кости Дополнительно . Сообщение представляет собой игральную кость со случайным значением от 1 до 6
игра Игра Дополнительно . Сообщение — это игра, информация об игре.Подробнее об играх »
опрос Опрос Дополнительно . Сообщение нативный опрос, информация о опросе
заведение Заведение Дополнительно . Сообщение — это место проведения, информация о месте проведения. Для обратной совместимости, когда это поле установлено, поле местоположения также будет установлено
расположение Расположение Дополнительно .Сообщение является общим местоположением, информация о местоположении
new_chat_members Массив пользователей Дополнительно . Новые участники, которые были добавлены в группу или супергруппу, и информация о них (сам бот может быть одним из этих участников)
left_chat_member Пользователь Дополнительно . Участник удален из группы, информация о нем (этим участником может быть сам бот)
new_chat_title Строка Дополнительно .Название чата было изменено на это значение
new_chat_photo Массив PhotoSize Дополнительно . Фотография чата была изменена на это значение
delete_chat_photo Правда Дополнительно . Служебное сообщение: фото чата удалено
group_chat_created Правда Дополнительно . Служебное сообщение: группа создана
supergroup_chat_created Правда Дополнительно .Служебное сообщение: супергруппа создана. Это поле нельзя получить в сообщении, приходящем через обновления, потому что бот не может быть членом супергруппы при ее создании. Его можно найти в reply_to_message только в том случае, если кто-то отвечает на самое первое сообщение в непосредственно созданной супергруппе.
channel_chat_created Правда Дополнительно . Служебное сообщение: канал создан. Это поле нельзя получить в сообщении, приходящем через обновления, потому что бот не может быть участником канала при его создании.Его можно найти в reply_to_message, только если кто-то отвечает на самое первое сообщение в канале.
migrate_to_chat_id Целое Дополнительно . Группа была перенесена в супергруппу с указанным идентификатором. Это число может быть больше 32 бит, и некоторые языки программирования могут иметь затруднения / молчаливые дефекты при его интерпретации. Но он меньше 52 бит, поэтому 64-битное целое число со знаком или плавающий тип двойной точности безопасны для хранения этого идентификатора.
migrate_from_chat_id Целое Дополнительно . Супергруппа была перенесена из группы с указанным идентификатором. Это число может быть больше 32 бит, и некоторые языки программирования могут иметь затруднения / молчаливые дефекты при его интерпретации. Но он меньше 52 бит, поэтому 64-битное целое число со знаком или плавающий тип двойной точности безопасны для хранения этого идентификатора.
pinned_message Сообщение Дополнительно .Указанное сообщение закреплено. Обратите внимание, что объект сообщения в этом поле не будет содержать дополнительных полей reply_to_message , даже если он сам является ответом.
счет-фактура Счет-фактура Дополнительно . Сообщение — это счет на оплату, информация о счете. Подробнее о платежах »
успешный_платеж Успешный платеж Дополнительно . Сообщение — служебное сообщение об успешном платеже, информация о платеже.Подробнее о платежах »
connected_website Строка Дополнительно . Доменное имя сайта, на котором зарегистрировался пользователь. Подробнее о Telegram Login »
паспортные данные ПаспортДанные Дополнительно . Telegram Паспортные данные
близости_alert_triggered ProximityAlertTriggered Дополнительно . Сервисное сообщение. Пользователь в чате активировал оповещение о близости другого пользователя, когда делился своим местоположением в реальном времени.
reply_markup InlineKeyboardMarkup Дополнительно . Встроенная клавиатура, прикрепленная к сообщению. login_url кнопки представлены как обычные кнопки url .
Идентификатор сообщения

Этот объект представляет уникальный идентификатор сообщения.

Поле Тип Описание
message_id Целое Уникальный идентификатор сообщения
MessageEntity

Этот объект представляет одну особую сущность в текстовом сообщении.Например, хэштеги, имена пользователей, URL-адреса и т. Д.

Поле Тип Описание
тип Строка Тип юридического лица. Может быть «упоминание» ( @username ), «hashtag» ( #hashtag ), «cashtag» ( $ долларов США), «bot_command» ( / start @ jobs_bot ), «url» ( https : //telegram.org ), «электронная почта» ( [email protected] ), «phone_number» ( + 1-212-555-0123 ), «жирный» ( жирный текст ), «Курсив» ( курсивный текст, ), «подчеркнутый» (подчеркнутый текст), «зачеркнутый» (зачеркнутый текст), «код» (моноширинная строка), «pre» (моноширинный блок), «текст_ссылка» (для кликабельной текстовые URL), «text_mention» (для пользователей без имени пользователя)
смещение Целое Смещение в единицах кода UTF-16 до начала объекта
длина Целое Длина объекта в единицах кода UTF-16
url Строка Дополнительно .Только для «text_link», URL-адрес, который будет открыт после нажатия пользователем текста
пользователь Пользователь Дополнительно . Только для «text_mention» указанный пользователь
язык Строка Дополнительно . Только для «pre», язык программирования текста объекта
Размер фото

Этот объект представляет один размер фотографии или эскиз файла / стикера.

Поле Тип Описание
file_id Строка Идентификатор этого файла, который можно использовать для загрузки или повторного использования файла
file_unique_id Строка Уникальный идентификатор этого файла, который должен быть одинаковым во времени и для разных ботов. Невозможно использовать для загрузки или повторного использования файла.
ширина Целое Ширина фото
высота Целое Высота фото
размер_файла Целое Дополнительно .Размер файла
Анимация

Этот объект представляет файл анимации (видео в формате GIF или H.264 / MPEG-4 AVC без звука).

Размер фото
Поле Тип Описание
file_id Строка Идентификатор этого файла, который можно использовать для загрузки или повторного использования файла
file_unique_id Строка Уникальный идентификатор этого файла, который должен быть одинаковым во времени и для разных ботов.Невозможно использовать для загрузки или повторного использования файла.
ширина Целое Ширина видео, определенная отправителем
высота Целое Высота видео, определенная отправителем
длительность Целое Продолжительность видео в секундах, определенная отправителем
большой палец Дополнительно . Миниатюра анимации, определенная отправителем
имя_файла Строка Дополнительно .Исходное имя файла анимации, определенное отправителем
mime_type Строка Дополнительно . MIME-тип файла, определенный отправителем
размер_файла Целое Дополнительно . Размер файла
Аудио

Этот объект представляет аудиофайл, который клиенты Telegram будут рассматривать как музыку.

Размер фото
Поле Тип Описание
file_id Строка Идентификатор этого файла, который можно использовать для загрузки или повторного использования файла
file_unique_id Строка Уникальный идентификатор этого файла, который должен быть одинаковым во времени и для разных ботов.Невозможно использовать для загрузки или повторного использования файла.
длительность Целое Продолжительность звука в секундах, определенная отправителем
исполнитель Строка Дополнительно . Исполнитель аудио, определенный отправителем или аудио тегами
название Строка Дополнительно . Название аудио, определенное отправителем или аудио тегами
имя_файла Строка Дополнительно .Исходное имя файла, определенное отправителем
mime_type Строка Дополнительно . MIME-тип файла, определенный отправителем
размер_файла Целое Дополнительно . Размер файла
большой палец Дополнительно . Миниатюра обложки альбома, к которому принадлежит музыкальный файл
Документ

Этот объект представляет собой общий файл (в отличие от фотографий, голосовых сообщений и аудиофайлов).

Размер фото
Поле Тип Описание
file_id Строка Идентификатор этого файла, который можно использовать для загрузки или повторного использования файла
file_unique_id Строка Уникальный идентификатор этого файла, который должен быть одинаковым во времени и для разных ботов. Невозможно использовать для загрузки или повторного использования файла.
большой палец Дополнительно .Миниатюра документа, определенная отправителем
имя_файла Строка Дополнительно . Исходное имя файла, определенное отправителем
mime_type Строка Дополнительно . MIME-тип файла, определенный отправителем
размер_файла Целое Дополнительно . Размер файла
Видео

Этот объект представляет видеофайл.

Размер фото
Поле Тип Описание
file_id Строка Идентификатор этого файла, который можно использовать для загрузки или повторного использования файла
file_unique_id Строка Уникальный идентификатор этого файла, который должен быть одинаковым во времени и для разных ботов. Невозможно использовать для загрузки или повторного использования файла.
ширина Целое Ширина видео, определенная отправителем
высота Целое Высота видео, определенная отправителем
длительность Целое Продолжительность видео в секундах, определенная отправителем
большой палец Дополнительно .Миниатюра видео
имя_файла Строка Дополнительно . Исходное имя файла, определенное отправителем
mime_type Строка Дополнительно . Mime-тип файла, определенный отправителем
размер_файла Целое Дополнительно . Размер файла
VideoNote

Этот объект представляет собой видеосообщение (доступно в приложениях Telegram начиная с v.4.0).

Размер фото
Поле Тип Описание
file_id Строка Идентификатор этого файла, который можно использовать для загрузки или повторного использования файла
file_unique_id Строка Уникальный идентификатор этого файла, который должен быть одинаковым во времени и для разных ботов. Невозможно использовать для загрузки или повторного использования файла.
длина Целое Ширина и высота видео (диаметр видеосообщения), определенные отправителем
длительность Целое Продолжительность видео в секундах, определенная отправителем
большой палец Дополнительно .Миниатюра видео
размер_файла Целое Дополнительно . Размер файла
Голос

Этот объект представляет собой голосовую заметку.

Поле Тип Описание
file_id Строка Идентификатор этого файла, который можно использовать для загрузки или повторного использования файла
file_unique_id Строка Уникальный идентификатор этого файла, который должен быть одинаковым во времени и для разных ботов.Невозможно использовать для загрузки или повторного использования файла.
длительность Целое Продолжительность звука в секундах, определенная отправителем
mime_type Строка Дополнительно . MIME-тип файла, определенный отправителем
размер_файла Целое Дополнительно . Размер файла
Контакт

Этот объект представляет телефонный контакт.

Поле Тип Описание
номер телефона Строка Телефон контакта
first_name Строка Имя контакта
фамилия Строка Дополнительно . Фамилия контакта
user_id Целое Дополнительно .Идентификатор пользователя контакта в Telegram
визитка Строка Дополнительно . Дополнительные данные о контакте в виде vCard
Кости

Этот объект представляет собой анимированный смайлик, отображающий случайное значение.

Опция опроса

Этот объект содержит информацию об одном варианте ответа в опросе.

Поле Тип Описание
текст Строка Текст опции, 1-100 знаков
voter_count Целое Количество пользователей, проголосовавших за этот вариант
Ответ на опрос

Этот объект представляет собой ответ пользователя в неанонимном опросе.

Поле Тип Описание
poll_id Строка Уникальный идентификатор опроса
пользователь Пользователь Пользователь, изменивший ответ на опрос
option_ids Массив целых Отсчитываемые от 0 идентификаторы вариантов ответа, выбранных пользователем. Может быть пустым, если пользователь отозвал свой голос.
Опрос

Этот объект содержит информацию об опросе.

Поле Тип Описание
id Строка Уникальный идентификатор опроса
вопрос Строка Вопрос для опроса, 1-255 знаков
варианты Массив вариантов опроса Список вариантов опроса
total_voter_count Целое Общее количество пользователей, проголосовавших в опросе
закрыто логический Верно, если опрос закрыт
is_anonymous логический Верно, если опрос анонимный
тип Строка Тип опроса, в настоящее время может быть «обычный» или «викторина»
allow_multiple_answers логический Верно, если опрос позволяет несколько ответов
правильный_ идентификатор_опции Целое Дополнительно .Отсчитываемый от 0 идентификатор правильного варианта ответа. Доступно только для опросов в режиме викторины, которые закрыты, были отправлены (не перенаправлены) ботом или в приватный чат с ботом.
объяснение Строка Дополнительно . Текст, который отображается, когда пользователь выбирает неправильный ответ или нажимает на значок лампы в опросе в стиле викторины, 0-200 символов
объяснение_ сущности Массив MessageEntity Дополнительно .Специальные объекты, такие как имена пользователей, URL-адреса, команды ботов и т. Д., Которые появляются в объяснении
open_period Целое Дополнительно . Время в секундах, в течение которого опрос будет активен после создания
close_date Целое Дополнительно . Момент времени (временная метка Unix), когда опрос будет автоматически закрыт
Расположение

Этот объект представляет точку на карте.

Поле Тип Описание
долгота Поплавок Долгота, определенная отправителем
широта Поплавок Широта, определенная отправителем
горизонтальная_точность Число с плавающей запятой Дополнительно . Радиус неопределенности местоположения, измеряемый в метрах; 0-1500
live_period Целое Дополнительно .Время относительно даты отправки сообщения, в течение которого местоположение может быть обновлено, в секундах. Только для активных живых локаций.
товарная позиция Целое Дополнительно . Направление, в котором движется пользователь, в градусах; 1-360. Только для активных живых локаций.
близости_alert_radius Целое Дополнительно . Максимальное расстояние для предупреждений о приближении к другому участнику чата в метрах.Только для отправленных живых местоположений.
Место проведения

Этот объект представляет собой место проведения.

Поле Тип Описание
расположение Расположение Место проведения. Не может быть живым местом
название Строка Название заведения
адрес Строка Адрес места проведения
foursquare_id Строка Дополнительно .Foursquare идентификатор площадки
foursquare_type Строка Дополнительно . Тип площадки Foursquare. (Например, «arts_entertainment / default», «arts_entertainment / aquarium» или «food / icecream».)
google_place_id Строка Дополнительно . Google Places идентификатор места
google_place_type Строка Дополнительно .Тип места проведения Google Places. (См. Поддерживаемые типы.)
ProximityAlertTriggered

Этот объект представляет содержимое служебного сообщения, отправляемого всякий раз, когда пользователь в чате запускает оповещение о близости, установленное другим пользователем.

Поле Тип Описание
путешественник Пользователь Пользователь, вызвавший предупреждение
Наблюдатель Пользователь Пользователь, установивший оповещение
расстояние Целое Расстояние между пользователями
Профиль пользователя Фото

Этот объект представляет собой изображение профиля пользователя.

Поле Тип Описание
total_count Целое Общее количество изображений профиля целевого пользователя
фото Массив массива PhotoSize Запрошенные изображения профиля (до 4 размеров каждое)
Файл

Этот объект представляет файл, готовый к загрузке. Файл можно скачать по ссылке https: // api.telegram.org/file/bot/ . Гарантируется, что ссылка будет действительна не менее 1 часа. По истечении срока действия ссылки можно запросить новую, вызвав getFile.

Максимальный размер загружаемого файла — 20 МБ

Поле Тип Описание
file_id Строка Идентификатор этого файла, который можно использовать для загрузки или повторного использования файла
file_unique_id Строка Уникальный идентификатор этого файла, который должен быть одинаковым во времени и для разных ботов.Невозможно использовать для загрузки или повторного использования файла.
размер_файла Целое Дополнительно . Размер файла, если известен
file_path Строка Дополнительно . Путь файла. Используйте https://api.telegram.org/file/bot/ , чтобы получить файл.
ОтветитьKeyboardMarkup

Этот объект представляет собой настраиваемую клавиатуру с параметрами ответа (подробности и примеры см. В разделе Введение в ботов).

Поле Тип Описание
клавиатура Массив массива KeyboardButton Массив строк кнопок, каждая из которых представлена ​​массивом объектов KeyboardButton
resize_keyboard логический Дополнительно . Просит клиентов изменить размер клавиатуры по вертикали для оптимальной подгонки (например, сделать клавиатуру меньше, если есть только два ряда кнопок).По умолчанию , ложь , и в этом случае настраиваемая клавиатура всегда имеет ту же высоту, что и стандартная клавиатура приложения.
one_time_keyboard логический Дополнительно . Просит клиентов скрыть клавиатуру, как только она будет использована. Клавиатура по-прежнему будет доступна, но клиенты будут автоматически отображать обычную буквенную клавиатуру в чате — пользователь может нажать специальную кнопку в поле ввода, чтобы снова увидеть настраиваемую клавиатуру.По умолчанию , ложь .
селективный логический Дополнительно . Используйте этот параметр, если хотите показать клавиатуру только определенным пользователям. Цели: 1) пользователи, @ упомянутые в тексте объекта сообщения; 2) если сообщение бота является ответом (имеет значение response_to_message_id ), отправитель исходного сообщения.

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

Клавиатура

Этот объект представляет одну кнопку ответной клавиатуры. Для простых текстовых кнопок Строка может использоваться вместо этого объекта, чтобы указать текст кнопки. Необязательные поля request_contact , request_location и request_poll являются взаимоисключающими.

Поле Тип Описание
текст Строка Текст кнопки.Если ни одно из дополнительных полей не используется, оно будет отправлено в виде сообщения при нажатии кнопки
запрос_контакт логический Дополнительно . Если True , номер телефона пользователя будет отправлен как контакт при нажатии кнопки. Доступно только в приватных чатах
request_location логический Дополнительно . Если True , текущее местоположение пользователя будет отправлено при нажатии кнопки.Доступно только в приватных чатах
request_poll KeyboardButtonPollType Дополнительно . Если указано, пользователю будет предложено создать опрос и отправить его боту при нажатии кнопки. Доступно только в приватных чатах

Примечание: параметры request_contact и request_location будут работать только в версиях Telegram, выпущенных после 9 апреля 2016 года. Старые клиенты будут отображать неподдерживаемое сообщение .
Примечание. Параметр request_poll будет работать только в версиях Telegram, выпущенных после 23 января 2020 года. Старые клиенты будут отображать неподдерживаемое сообщение .

KeyboardButtonPollType

Этот объект представляет тип опроса, который может быть создан и отправлен при нажатии соответствующей кнопки.

Поле Тип Описание
тип Строка Дополнительно .Если пройден тест , пользователю будет разрешено создавать только опросы в режиме викторины. Если пройдено обычных , будут разрешены только обычные опросы. В противном случае пользователю будет разрешено создать опрос любого типа.
ОтветитьKeyboardRemove

При получении сообщения с этим объектом клиенты Telegram удаляют текущую настраиваемую клавиатуру и отображают буквенную клавиатуру по умолчанию. По умолчанию настраиваемые клавиатуры отображаются до тех пор, пока бот не отправит новую клавиатуру.Исключение составляет одноразовая клавиатура, которая скрывается сразу после нажатия кнопки пользователем (см. ReplyKeyboardMarkup).

Поле Тип Описание
remove_keyboard Правда Запрашивает клиентов удалить настраиваемую клавиатуру (пользователь не сможет вызвать эту клавиатуру; если вы хотите скрыть клавиатуру от глаз, но оставить ее доступной, используйте one_time_keyboard в ReplyKeyboardMarkup)
селективный логический Дополнительно .Используйте этот параметр, если вы хотите удалить клавиатуру только для определенных пользователей. Цели: 1) пользователи, @ упомянутые в тексте объекта сообщения; 2) если сообщение бота является ответом (имеет значение response_to_message_id ), отправитель исходного сообщения.

Пример: Пользователь голосует в опросе, бот возвращает сообщение с подтверждением в ответ на голосование и удаляет клавиатуру для этого пользователя, по-прежнему показывая клавиатуру с параметрами опроса пользователям, которые еще не проголосовали.

InlineKeyboardMarkup

Этот объект представляет собой встроенную клавиатуру, которая отображается рядом с сообщением, которому она принадлежит.

Примечание: Это будет работать только в версиях Telegram, выпущенных после 9 апреля 2016 года. Более старые клиенты будут отображать неподдерживаемое сообщение .

InlineKeyboardButton

Этот объект представляет одну кнопку встроенной клавиатуры. Вы должны использовать ровно одно из необязательных полей.

Поле Тип Описание
текст Строка Текст надписи на кнопке
url Строка Дополнительно . HTTP или tg: // URL, который открывается при нажатии кнопки
login_url LoginUrl Дополнительно . URL-адрес HTTP, используемый для автоматической авторизации пользователя. Может использоваться как замена виджета входа в Telegram.
callback_data Строка Дополнительно . Данные для отправки боту в ответном запросе при нажатии кнопки, 1-64 байта
switch_inline_query Строка Дополнительно . Если установлено, нажатие кнопки предложит пользователю выбрать один из своих чатов, открыть этот чат и вставить имя пользователя бота и указанный встроенный запрос в поле ввода. Может быть пустым, и в этом случае будет вставлено только имя пользователя бота.

Примечание: Это дает пользователям простой способ начать использовать вашего бота во встроенном режиме, когда они в данный момент находятся в приватном чате с ним. Особенно полезно в сочетании с действиями switch_pm… — в этом случае пользователь автоматически вернется в чат, из которого он переключился, пропуская экран выбора чата.

switch_inline_query_current_chat Строка Дополнительно . Если установлено, нажатие кнопки вставит имя пользователя бота и указанный встроенный запрос в поле ввода текущего чата.Может быть пустым, и в этом случае будет вставлено только имя пользователя бота.

Это дает пользователю быстрый способ открыть вашего бота во встроенном режиме в том же чате — удобно для выбора чего-либо из нескольких вариантов.

callback_game Обратный звонокИгра Дополнительно . Описание игры, которая будет запускаться при нажатии пользователем кнопки.

ПРИМЕЧАНИЕ: Кнопка этого типа должна всегда быть первой кнопкой в ​​первой строке.

платить логический Дополнительно . Укажите True, чтобы отправить кнопку Pay.

ПРИМЕЧАНИЕ: Кнопка этого типа должна всегда быть первой кнопкой в ​​первой строке.

LoginUrl

Этот объект представляет параметр встроенной кнопки клавиатуры, используемой для автоматической авторизации пользователя. Служит отличной заменой виджета входа в Telegram, когда пользователь переходит из Telegram.Все, что нужно сделать пользователю, это нажать / щелкнуть кнопку и подтвердить, что он хочет войти в систему:

Приложения

Telegram поддерживают эти кнопки начиная с версии 5.7.

Пример бота: @discussbot

Поле Тип Описание
url Строка URL-адрес HTTP, который должен быть открыт с данными авторизации пользователя, добавленными в строку запроса при нажатии кнопки. Если пользователь отказывается предоставить данные авторизации, будет открыт исходный URL без информации о пользователе.Добавляемые данные такие же, как описано в разделе Получение данных авторизации.

ПРИМЕЧАНИЕ: Вы, , должны всегда проверять хэш полученных данных для проверки аутентификации и целостности данных, как описано в разделе «Проверка авторизации».

forward_text Строка Дополнительно . Новый текст кнопки в перенаправленных сообщениях.
bot_username Строка Дополнительно .Логин бота, который будет использоваться для авторизации пользователя. См. Подробности в разделе «Настройка бота». Если не указано, будет использоваться имя текущего бота. URL-адрес Домен должен совпадать с доменом, связанным с ботом. Дополнительные сведения см. В разделе «Связывание домена с ботом».
request_write_access логический Дополнительно . Передайте True, чтобы запросить у вашего бота разрешение на отправку сообщений пользователю.
Обратный звонок Запрос

Этот объект представляет входящий запрос обратного вызова от кнопки обратного вызова на встроенной клавиатуре.Если кнопка, инициировавшая запрос, была прикреплена к сообщению, отправляемому ботом, будет присутствовать поле сообщение . Если кнопка была прикреплена к сообщению, отправленному через бота (в режиме inline), будет присутствовать поле inline_message_id . Ровно одно из полей data или game_short_name будет присутствовать.

Поле Тип Описание
id Строка Уникальный идентификатор этого запроса
из Пользователь Отправитель
сообщение Сообщение Дополнительно .Сообщение с кнопкой обратного вызова, которая инициировала запрос. Обратите внимание, что содержание сообщения и дата сообщения будут недоступны, если сообщение слишком старое
inline_message_id Строка Дополнительно . Идентификатор сообщения, отправленного через бот во встроенном режиме, из которого был сделан запрос.
chat_instance Строка Глобальный идентификатор, однозначно соответствующий чату, в который было отправлено сообщение с кнопкой обратного вызова.Полезно для высоких результатов в играх.
данные Строка Дополнительно . Данные, связанные с кнопкой обратного вызова. Имейте в виду, что плохой клиент может отправлять произвольные данные в это поле.
game_short_name Строка Дополнительно . Краткое название игры, которое будет возвращено, служит уникальным идентификатором для игры

ПРИМЕЧАНИЕ. После того, как пользователь нажмет кнопку обратного вызова, клиенты Telegram будут отображать индикатор выполнения, пока вы не вызовете answerCallbackQuery.Следовательно, необходимо реагировать путем вызова answerCallbackQuery, даже если уведомление для пользователя не требуется (например, без указания каких-либо дополнительных параметров).

ForceReply

После получения сообщения с этим объектом клиенты Telegram будут отображать интерфейс ответа для пользователя (действовать так, как если бы пользователь выбрал сообщение бота и нажал «Ответить»). Это может быть чрезвычайно полезно, если вы хотите создавать удобные пошаговые интерфейсы, не жертвуя режимом конфиденциальности.

Поле Тип Описание
force_reply Правда Показывает интерфейс ответа для пользователя, как если бы он вручную выбрал сообщение бота и нажал «Ответить».
селективный логический Дополнительно . Используйте этот параметр, если вы хотите принудительно отвечать только определенным пользователям. Цели: 1) пользователи, @ упомянутые в тексте объекта сообщения; 2) если сообщение бота является ответом (имеет значение response_to_message_id ), отправитель исходного сообщения.

Пример: Бот для опроса групп работает в режиме конфиденциальности (только принимает команды, отвечает на свои сообщения и упоминает). Создать новый опрос можно двумя способами:

  • Объясните пользователю, как отправить команду с параметрами (например, / newpoll question answer1 answer2). Может быть привлекательным для заядлых пользователей, но ему не хватает современной полировки.
  • Проведите пользователя через пошаговые инструкции. «Пожалуйста, пришлите мне свой вопрос», «Круто, теперь давайте добавим первый вариант ответа», «Отлично.Продолжайте добавлять варианты ответа, а затем отправьте / готово, когда будете готовы ».

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

Чат Фото

Этот объект представляет собой фотографию чата.

Поле Тип Описание
small_file_id Строка Идентификатор файла небольшой (160×160) фотографии чата.Этот file_id можно использовать только для загрузки фотографий и только до тех пор, пока фотография не будет изменена.
small_file_unique_id Строка Уникальный идентификатор файла небольшой (160×160) фотографии чата, который должен быть одинаковым с течением времени и для разных ботов. Невозможно использовать для загрузки или повторного использования файла.
big_file_id Строка Идентификатор файла большой (640×640) фотографии чата. Этот file_id можно использовать только для загрузки фотографий и только до тех пор, пока фотография не будет изменена.
big_file_unique_id Строка Уникальный идентификатор файла большой (640×640) фотографии чата, который должен быть одинаковым во времени и для разных ботов. Невозможно использовать для загрузки или повторного использования файла.
ChatMember

Этот объект содержит информацию об одном участнике чата.

Поле Тип Описание
пользователь Пользователь Информация о пользователе
статус Строка Статус участника в чате.Может быть «создатель», «администратор», «участник», «с ограниченным доступом», «оставлен» или «исключен»
custom_title Строка Дополнительно . Только владелец и администраторы. Пользовательский заголовок для этого пользователя
is_anonymous логический Дополнительно . Только владелец и администраторы. Правда, если присутствие пользователя в чате скрыто
can_be_edited логический Дополнительно .Только администраторы. Верно, если боту разрешено редактировать права администратора этого пользователя
can_post_messages логический Дополнительно . Только администраторы. Правда, если администратор может оставлять сообщения в канале; только каналы
can_edit_messages логический Дополнительно . Только администраторы. Правда, если администратор может редактировать сообщения других пользователей и может закреплять сообщения; только каналы
can_delete_messages логический Дополнительно .Только администраторы. Правда, если администратор может удалять сообщения других пользователей
can_restrict_members логический Дополнительно . Только администраторы. Правда, если администратор может ограничивать, банить или разблокировать участников чата
can_promote_members логический Дополнительно . Только администраторы. Верно, если администратор может добавлять новых администраторов с подмножеством их собственных привилегий или понижать в должности администраторов, которых он повысил, прямо или косвенно (продвинутых администраторами, назначенными пользователем)
can_change_info логический Дополнительно .Только администраторы и с ограничениями. Правда, если пользователю разрешено изменять название чата, фото и другие настройки
can_invite_users логический Дополнительно . Только администраторы и с ограничениями. Правда, если пользователю разрешено приглашать новых пользователей в чат
can_pin_messages логический Дополнительно . Только администраторы и с ограничениями. Истинно, если пользователю разрешено закреплять сообщения; только группы и супергруппы
is_member логический Дополнительно .Только с ограничениями. Верно, если пользователь является участником чата на момент запроса
can_send_messages логический Дополнительно . Только с ограничениями. Верно, если пользователю разрешено отправлять текстовые сообщения, контакты, места и места проведения
can_send_media_messages логический Дополнительно . Только с ограничениями. Верно, если пользователю разрешено отправлять аудио, документы, фотографии, видео, видеозаметки и голосовые заметки
can_send_polls логический Дополнительно .Только с ограничениями. Правда, если пользователю разрешено отправлять опросы
can_send_other_messages логический Дополнительно . Только с ограничениями. Верно, если пользователю разрешено отправлять анимацию, игры, стикеры и использовать встроенных ботов
can_add_web_page_previews логический Дополнительно . Только с ограничениями. Верно, если пользователю разрешено добавлять превью веб-страниц в свои сообщения
до_дата Целое Дополнительно .Только с ограничениями и пинками. Дата снятия ограничений для этого пользователя; unix time
ChatPermissions

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

Поле Тип Описание
can_send_messages логический Дополнительно . Верно, если пользователю разрешено отправлять текстовые сообщения, контакты, места и места проведения
can_send_media_messages логический Дополнительно .Правда, если пользователю разрешено отправлять аудио, документы, фотографии, видео, видеозаметки и голосовые заметки, подразумевается can_send_messages
can_send_polls логический Дополнительно . Правда, если пользователю разрешено отправлять опросы, подразумевается can_send_messages
can_send_other_messages логический Дополнительно . Правда, если пользователю разрешено отправлять анимации, игры, стикеры и использовать встроенных ботов, подразумевается can_send_media_messages
can_add_web_page_previews логический Дополнительно .Верно, если пользователю разрешено добавлять превью веб-страниц в свои сообщения, подразумевается can_send_media_messages
can_change_info логический Дополнительно . Верно, если пользователю разрешено менять название чата, фото и другие настройки. Игнорируется в публичных супергруппах
can_invite_users логический Дополнительно . Правда, если пользователю разрешено приглашать новых пользователей в чат
can_pin_messages логический Дополнительно .Верно, если пользователю разрешено закреплять сообщения. Игнорируется в публичных супергруппах
Chat Location

Представляет местоположение, к которому подключен чат.

Поле Тип Описание
расположение Расположение Местоположение, к которому подключена супергруппа. Не может быть живым местом.
адрес Строка Адрес местонахождения; 1-64 символа, как определено владельцем чата
BotCommand

Этот объект представляет команду бота.

Поле Тип Описание
команда Строка Текст команды, 1-32 символа. Может содержать только строчные английские буквы, цифры и символы подчеркивания.
описание Строка Описание команды, 3–256 знаков.
Параметры отклика

Содержит информацию о том, почему запрос был неудачным.

Поле Тип Описание
migrate_to_chat_id Целое Дополнительно . Группа была перенесена в супергруппу с указанным идентификатором. Это число может быть больше 32 бит, и некоторые языки программирования могут иметь затруднения / молчаливые дефекты при его интерпретации. Но он меньше 52 бит, поэтому 64-битное целое число со знаком или плавающий тип двойной точности безопасны для хранения этого идентификатора.
retry_after Целое Дополнительно . В случае превышения уровня защиты от наводнения количество секунд, оставшееся до повторения запроса, может быть выполнено
InputMedia

Этот объект представляет содержимое отправляемого мультимедийного сообщения. Это должно быть одно из

InputMediaPhoto

— фотография для отправки.

Поле Тип Описание
тип Строка Тип результата, обязательно фото
СМИ Строка Файл для отправки.Передайте file_id для отправки файла, который существует на серверах Telegram (рекомендуется), передайте URL-адрес HTTP для Telegram, чтобы получить файл из Интернета, или передайте «attach: // », чтобы загрузить новый, используя multipart / данные формы под именем . Подробнее об отправке файлов »
подпись Строка Дополнительно . Подпись к отправляемой фотографии, 0–1024 символов после синтаксического анализа объектов
parse_mode Строка Дополнительно .Режим разбора сущностей в подписи к фото. См. Дополнительные сведения в параметрах форматирования.
caption_entities Массив MessageEntity Дополнительно . Список особых сущностей, которые появляются в заголовке, которые можно указать вместо parse_mode
InputMediaVideo

Представляет видео для отправки.

Поле Тип Описание
тип Строка Тип результата, должно быть видео
СМИ Строка Файл для отправки.Передайте file_id для отправки файла, который существует на серверах Telegram (рекомендуется), передайте URL-адрес HTTP для Telegram, чтобы получить файл из Интернета, или передайте «attach: // », чтобы загрузить новый, используя multipart / данные формы под именем . Подробнее об отправке файлов »

FAQ по ботам

Если вы новичок в ботах Telegram, мы рекомендуем сначала ознакомиться с нашим Знакомство с ботами . Вы также можете найти руководство Bot API Manual .


Общие вопросы

Как создать бота?

Создавать ботов Telegram очень просто, но вам потребуются хотя бы некоторые навыки программирования. Чтобы бот работал, создайте учетную запись бота с помощью @BotFather, а затем подключите его к своему внутреннему серверу через наш API.

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

Я разработчик. Где найти примеры?

Вот два примера ботов, написанных на PHP:

  • Hello Bot демонстрирует основы API бота Telegram.
  • Бот
  • Simple Poll — более полный пример, он поддерживает как длинный опрос, так и Webhooks для получения обновлений.

Многие члены нашего сообщества создают ботов и публикуют исходники. Собираем их на на этой странице »

Напишите нам на @BotSupport, если вы создали бота и хотели бы поделиться им с другими.

Вы добавите X в Bot API?

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

Приглашаем всех разработчиков ботов поделиться идеями о нашем Bot API в нашей учетной записи @BotSupport .

Какие сообщения будет получать мой бот?

1. Все боты независимо от настроек получат:

  • Все служебные сообщения.
  • Все сообщения из приватных чатов с пользователями.
  • Все сообщения от каналов, участником которых они являются.

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

3. Боты с включенным режимом конфиденциальности получат:

  • Команды, явно предназначенные для них (например, / command @ this_bot).
  • Общие команды от пользователей (например,грамм. / start) если бот был последним ботом, отправившим сообщение группе.
  • Сообщения, отправленные через этого бота.
  • Отвечает на любые сообщения, явно или неявно предназначенные для этого бота.

Примечание , что каждое конкретное сообщение может быть доступно только одному боту с включенной конфиденциальностью за раз, то есть ответ боту A, содержащий явную команду для бота B или отправленный через бота C, будет доступен только боту A. Ответы имеют наивысший приоритет.

Почему мой бот не видит сообщения от других ботов?

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

Получение обновлений

Как получать обновления?

В настоящее время есть два способа получения обновлений. Вы можете использовать либо длинный опрос, либо Webhooks. Обратите внимание, что , а не , возможно получать обновления с помощью длительного опроса, пока установлен исходящий Webhook.

Продолжительный опрос дает мне одни и те же обновления снова и снова!

Метод getUpdates возвращает 100 первых неподтвержденных обновлений. Чтобы подтвердить обновление, используйте параметр смещения при вызове getUpdates следующим образом:

  смещение = update_id последнего обработанного обновления + 1  

Все обновления с update_id меньше или равным смещению будут помечены как подтвержденные на сервере и больше не будут возвращаться.

У меня проблемы с Webhooks.

Если вы успешно настроили веб-перехватчик, но не получаете никаких обновлений, помните:

  • Для работы веб-перехватчиков необходим действующий сертификат SSL.
  • Чтобы использовать самозаверяющий сертификат, вам необходимо загрузить сертификат открытого ключа с помощью параметра certificate в setWebhook. Пожалуйста, загрузите как InputFile, отправка строки не будет работать.
  • Порты, которые в настоящее время поддерживаются для Webhooks: 443 , 80 , 88 , 8443 .
  • Подстановочные сертификаты могут не поддерживаться.
  • Редиректы не поддерживаются.
  • CN должен точно соответствовать вашему домену.

Пожалуйста, ознакомьтесь с этим новым WEBHOOK GUIDE , чтобы узнать все, что нужно знать о веб-перехватчиках!

У меня проблемы с самозаверяющим сертификатом!

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

Как я могу убедиться, что запросы Webhook поступают из Telegram?

Если вы хотите убедиться, что запрос Webhook исходит от Telegram, мы рекомендуем использовать секретный путь в URL-адресе, который вы нам даете, например www.example.com/your_token. Поскольку никто другой не знает токен вашего бота, можете быть уверены, что это мы.

Как я могу делать запросы в ответ на обновления?

Это возможно, если вы используете веб-перехватчики. Достоинством является то, что вам нужно меньше запросов, и недостатком — в этом случае невозможно узнать, что такой запрос был успешным, или получить его результат.

Каждый раз, когда вы получаете обновление веб-перехватчика, у вас есть два варианта:

1. Отправьте сообщение POST на https://api.telegram.org/bot<token>/method

2. Ответьте напрямую и укажите метод как полезную нагрузку JSON в ответе

Вы также можете посмотреть наш пример HelloBot, он предлагает PHP-реализацию этого.

Работа со СМИ

Как загружать файлы?

Используйте метод getFile.Обратите внимание, что это будет работать только с файлами размером до 20 МБ.

Как загрузить большой файл?

Боты в настоящее время могут отправлять файлы любого типа размером до 50 МБ, так что да, очень большие файлы пока работать не будут. Сожалею. Этот лимит может быть изменен в будущем.

Могу ли я рассчитывать на то, что file_ids будет постоянным?

Да, file_ids можно рассматривать как постоянные.

Передача пользователям

Мой бот достигает пределов, как мне этого избежать?

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

Если вы отправляете массовые уведомления нескольким пользователям, API не будет разрешать более 30 сообщений в секунду или около того. Для достижения наилучших результатов рассмотрите возможность рассылки уведомлений через большие интервалы в 8–12 часов.

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

Как я могу отправить сообщение всем подписчикам моего бота сразу?

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

Чтобы избежать выхода за наши пределы при рассылке массовых уведомлений, рассмотрите возможность их распространения на более длительные интервалы, например 8-12 часов. API не будет разрешать массовые уведомления для более чем ~ 30 пользователей в секунду, если вы перейдете к этому, вы начнете получать 429 ошибок.

См. Также: Как избежать превышения лимита?


Если у вас есть вопросы, на которые нет ответа на этой странице, напишите нам на @BotSupport в Telegram.

Добавить комментарий

Ваш адрес email не будет опубликован. Обязательные поля помечены *