https://share.getcloudapp.com/llu5wWdx

Чтобы подключить своего бота к Telegram, выполните следующие действия:

1. В Flow XO щелкните Bots в верхней строке меню, затем выберите + New .
2. Теперь выберите Telegram в качестве платформы обмена сообщениями.
3. Введите описательное имя для бота.
4. Затем вы должны перейти по этой ссылке, чтобы начать разговор с @BotFather и создать бота с помощью команды «/ newbot».Более подробные инструкции вы найдете на сайте Telegram.
5. После того, как вы создадите бота, вам выдадут токен. Скопируйте его, так как вам нужно будет вставить его в Flow XO.
6. Для поддержки всех доступных типов сообщений вам также необходимо включить «/ setinline» (для упоминания или прямого упоминания) и «/ setprivacy» для отключения (для подслушивания) в BotFather. Мы объясним, как дальше.
7. Чтобы включить встроенную поддержку, отправьте сообщение @BotFather с помощью «/ setinline». Когда он спросит, выберите только что созданного бота.Теперь вам будет предложено ввести сообщение-заполнитель. Введите здесь что-нибудь, мы предлагаем общий вариант «Спросите что-нибудь». Затем вы должны увидеть сообщение о том, что ваши встроенные настройки были обновлены.
8. По умолчанию боты Telegram могут слышать только сообщения, адресованные им. Чтобы включить подслушивающие команды (если они вам нужны), вы должны отключить конфиденциальность. Хорошая практика — оставлять конфиденциальность включенной, если вам действительно не нужно подслушивать. Сообщение @BotFather с помощью «/ setprivacy». Затем вам будет предложено выбрать бота.Теперь введите «отключить», чтобы изменить режим конфиденциальности, и, наконец, вы должны увидеть сообщение об успешном завершении.
9. Вернувшись в Flow XO, введите имя пользователя вашего нового бота и вставьте токен, который вам ранее дал @BotFather.
10. Наконец, сохраните бота. Теперь бот запущен!
11. Последний шаг предоставит вам подробную информацию о том, как распространить вашего бота среди других пользователей.

Распространение вашего бота

Для распространения вашего бота среди других пользователей вы можете использовать ссылку в таком формате:

 https: // телеграмма.я / {имя пользователя}
 

Где {username} — имя пользователя вашего бота. Это позволит любому пользователю Telegram начать разговор с вашим ботом. Конечно, человек, переходящий по ссылке, должен быть зарегистрирован и готов использовать Telegram на своем устройстве.

Если вы хотите дать людям ссылку, позволяющую им добавить вашего бота в свою группу, вы можете использовать следующий формат ссылки:

 https://telegram.me/{username}?startgroup=1
 

Снова замените {username} на имя пользователя вашего бота.

Настройка бота

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

Обо всех настройках бота можно прочитать в Telegram.

Кнопка Пуск

Когда пользователь впервые подключается к боту (он нажимает кнопку «СТАРТ» в Telegram), боту будет отправлено сообщение «/ start». Вы можете проверить наличие этого, чтобы узнать, что пользователь нажал «ПУСК» и впервые поприветствовал пользователя. Начальное сообщение также может иметь необязательные аргументы в случае глубокой ссылки (способ направить трафик в определенные потоки с помощью URL-адресов).Узнайте, как работать с командами здесь и как настроить их в Telegram с автозаполнением для ваших пользователей здесь.

Особенности Telegram

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

Сообщите нам, как мы можем улучшить Flow XO на нашем сайте отзывов.

Создайте погодного бота в Telegram с помощью Python

Telegram, одно из самых популярных приложений для обмена сообщениями, немного более гибкое, чем другие популярные чат-приложения, такие как WhatsApp или Messenger от Facebook. Telegram — это кроссплатформенный сервис обмена мгновенными сообщениями, который также поддерживает видеозвонки, VOIP и обмен файлами с друзьями. Запущенный в 2013 году, Telegram сейчас насчитывает более 300 миллионов активных пользователей.

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

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

Предварительные требования:

• Базовые знания Python
• Учетная запись Telegram
• Учетная запись OpenWeather

Шаг –1: Получение учетных данных API

Мы расскажем, как получить учетные данные Telegram API, которые вы можете получить непосредственно из своего мобильного приложения. , но я бы посоветовал вам перейти на web.telegram.org и начать чат с этим именем пользователя BotFather.

Итак, найдите Bot Father и отправьте это сообщение: / newbot

Как только вы нажмете Enter, BotFather задаст вам следующий вопрос:

«Хорошо, новый бот.Как мы это назовем? Пожалуйста, выберите имя для своего бота ».

Давайте назовем его «WeatherBot»

Затем он спросит: «Хорошо. Теперь давайте выберем имя пользователя для вашего бота. Он должен заканчиваться ботом . Как этот, например, TetrisBot или tetris_bot ».

Здесь вы должны убедиться, что он заканчивается на «бот», поэтому дайте ему имя. Например, я даю ему «geekyhumans_weather_bot».

В случае успеха он ответит следующим сообщением:

  Готово! Поздравляю с приобретением нового бота.Вы найдете его на t.me/geekyhumans_weather_bot. Теперь вы можете добавить описание, раздел о себе и изображение профиля для своего бота. Список команд см. В разделе / ​​help. Кстати, когда вы закончите создавать своего крутого бота, обратитесь в нашу службу поддержки ботов, если вы хотите получить для него лучшее имя пользователя. Просто убедитесь, что бот полностью работает, прежде чем делать это.

Используйте этот токен для доступа к HTTP API:
XXXXXXXXXXXXXXXXXXXX
Держите свой токен в безопасности и храните его в безопасности, он может использоваться кем угодно для управления вашим ботом.

Описание Bot API см. На этой странице: https: // core.telegram.org/bots/api
  

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

Шаг –3: Получение учетных данных API погоды

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

После этого войдите на веб-сайт, и вы увидите что-то вроде этого:

Здесь нажмите «Ключи API» и скопируйте оттуда свой ключ API.

Шаг –3: Настройка кода:

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

  mkdir telegram-api  

А затем откройте папку:

  cd telegram-api  

Теперь пришло время установить некоторые зависимости. Итак, вставьте в свой терминал следующий код:

  python3 -m pip install requests  

Мы устанавливаем запросы здесь, потому что это упрощает выполнение вызовов API.

Как только это будет сделано, создайте новый файл с помощью telegram.py и откройте его в своем любимом редакторе. Пришло время написать код!

Давайте начнем с импорта некоторых модулей, поэтому вставьте приведенный ниже код для импорта модулей:

  import json
запросы на импорт
время импорта
импортировать urllib
импорт журнала
импортный сигнал
import sys

TOKEN = "API_KEY ДЛЯ ТЕЛЕГРАММЫ"
OWM_KEY = "ОТКРЫТЬ КЛЮЧ API ПОГОДЫ"
POLLING_TIMEOUT = None  

Объяснение кода:

Здесь мы импортируем несколько необходимых модулей, таких как json для анализа JSON, запрашивает для выполнения вызовов API в Telegram, а также OpenWeatherAPI, время для использования времени .sleep () , который поможет в опросе, urllib для анализа текста, закодированного в URL-адресе.

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

  # Лямбда-функции для парсинга обновлений из Telegram
def getText (update): return update ["сообщение"] ["текст"]
def getLocation (update): return update ["сообщение"] ["местоположение"]
def getChatId (update): return update ["сообщение"] ["чат"] ["идентификатор"]
def getUpId (update): return int (update ["update_id"])
def getResult (updates): вернуть обновления ["результат"]

# # Лямбда-функции для анализа погодных условий
def getDesc (w): return w ["погода"] [0] ["описание"]
def getTemp (w): return w ["main"] ["temp"]
def getCity (w): return w ["имя"]
logger = ведение журнала.getLogger ("погодная телеграмма")
logger.setLevel (ведение журнала.DEBUG)

# Города для запросов о погоде
cities = ["Лондон", "Брашов"]
def sigHandler (сигнал, кадр):
    logger.info ("SIGINT получен. Выходит ... Пока, пока")
    sys.exit (0)
  

Объяснение кода:

Мы определили множество лямбда-функций, и каждая функция используется для возврата разных данных. Например, getText () используется для получения текста из сообщения в Telegram, getLocation () используется для возврата местоположения из сообщения, getChatId () используется для возврата идентификатора чата сообщения, getUpId возвращает идентификатор обновления, getResult возвращает результат.

Точно так же есть лямбда-функции для API погоды, например, getDesc () возвращает описание погоды, getTemp () возвращает температуру, getCity возвращает город.

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

Итак, мы создали ключ API и инициализировали все функции. Теперь перейдем к основному функционалу.

Шаг –4: Определение всех функций:

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

  # Настроить ведение журнала и консоли.
def configLogging ():
    # Создать регистратор файлов и установить уровень DEBUG
    # Mode = write -> очистить существующий файл журнала
    handler = logging.FileHandler ("run.log", mode = "w")
    handler.setLevel (ведение журнала.DEBUG)
    formatter = logging.Formatter ("% (asctime) s -% (name) s -% (levelname) s -% (message) s")
    handler.setFormatter (форматтер)
    logger.addHandler (обработчик)

    # Создать обработчик консоли и установить уровень в INFO
    ch = ведение журнала.StreamHandler ()
    ch.setLevel (logging.INFO)
    formatter = logging.Formatter ("[% (levelname) s] -% (message) s")
    ch.setFormatter (форматтер)
    logger.addHandler (ch)

def parseConfig ():
    глобальный URL, URL_OWM, POLLING_TIMEOUT
    URL = "https://api.telegram.org/bot{}/".format(TOKEN)
    URL_OWM = "http://api.openweathermap.org/data/2.5/weather?appid={}&units=metric".format(OWM_KEY)
    POLLING_TIMEOUT  

Объяснение кода:

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

  2020-12-13 02: 56: 36,450 - ИНФОРМАЦИЯ - Получение обновлений
2020-12-13 02: 56: 36,450 t - ОТЛАДКА - URL: https://api.telegram.org/bot1482273391:XXXXXXX/getUpdates?timeout=None
2020-12-13 02: 56: 41,082 - ОТЛАДКА - {'keyboard': [[{'text': 'London'}], [{'text': 'Brasov'}], [{'text': ' Совместное использование местоположения ',' request_location ': True}]],' one_time_keyboard ': True}  

Теперь мы определим еще три функции: makeRequest () , getUpdates () , buildkeyboard () , buildCitiesKeyboard () .Поэтому вставьте приведенный ниже код в тот же файл:

  # Сделайте запрос боту Telegram и получите ответ в формате JSON.
def makeRequest (url):
    logger.debug ("URL:% s"% url)
    r = requests.get (URL)
    resp = json.loads (r.content.decode ("utf8"))
    возврат респ

# Возвращаем все обновления с ID> offset
# (Список обновлений хранится в Telegram 24 часа)
def getUpdates (смещение = Нет):
    url = URL + "getUpdates? timeout =% s"% POLLING_TIMEOUT
    logger.info («Получение обновлений»)
    если смещение:
        url + = "& offset = {}".формат (смещение)
    js = makeRequest (URL)
    вернуть js

# Создайте одноразовую клавиатуру для экранных опций
def buildKeyboard (элементы):
    keyboard = [[{"text": item}] для элемента в элементах]
    replyKeyboard = {"keyboard": keyboard, "one_time_keyboard": True}
    logger.debug (replyKeyboard)
    вернуть json.dumps (replyKeyboard)

def buildCitiesKeyboard ():
    keyboard = [[{"text": c}] для c в городах]
    keyboard.append ([{"text": "Поделиться местоположением", "request_location": True}])
    replyKeyboard = {"keyboard": keyboard, "one_time_keyboard": True}
    регистратор.отладка (replyKeyboard)
    return json.dumps (replyKeyboard)  

Объяснение кода:

Функция makeResuest () — это своего рода универсальная функция, в которой нам просто нужно передать URL-адрес, и она выполнит запрос GET и вернет ответ в формате JSON. Функция getUpdates () возвращает обновления для регистратора с таймаутом опроса. Мы также определили еще две функции: buildKeyboard () и buildCitiesKeyboard () , которые будут создавать настраиваемую клавиатуру, которую мы покажем вам позже в этом руководстве.

Теперь мы добавим еще несколько функций, связанных с Weather API и Telegram API. Поэтому добавьте следующий код:

  # Запросите в OWM погоду для места или координат.
def getWeather (место):
    if isinstance (place, dict): # предоставлены координаты
        lat, lon = место ["широта"], место ["долгота"]
        url = URL_OWM + "& lat =% f & lon =% f & cnt = 1"% (lat, lon)
        logger.info ("Запрос погоды:" + url)
        js = makeRequest (URL)
        logger.debug (js)
        return u "% s \ N {DEGREE SIGN} C,% s в% s"% (getTemp (js), getDesc (js), getCity (js))
    else: предоставлено # название места
        # сделать req
        url = URL_OWM + "& q = {}".формат (место)
        logger.info ("Запрос погоды:" + url)
        js = makeRequest (URL)
        logger.debug (js)
        return u "% s \ N {DEGREE SIGN} C,% s в% s"% (getTemp (js), getDesc (js), getCity (js))

# Отправить сообщение в кодировке URL на идентификатор чата
def sendMessage (текст, chatId, interface = None):
    текст = текст.encode ('utf-8', 'строгий')
    text = urllib.parse.quote_plus (текст)
    url = URL + "sendMessage? text = {} & chat_id = {} & parse_mode = Markdown".формат (текст, chatId)
    если интерфейс:
        url + = "& reply_markup = {}". формат (интерфейс)
    request.get (URL)

# Получить идентификатор последнего доступного обновления
def getLastUpdateId (обновления):
    ids = []
    для обновления в getResult (обновления):
        ids.append (getUpId (обновление))
    return max (ids)  

Объяснение кода:

Здесь мы определили еще три функции: getWeather () , которая принимает долготу и широту текущего местоположения, а затем делает запрос к Weather API и возвращает температуру, описание и город.Функция sendMessages () анализирует сообщение в формате с кодировкой URL-адреса и вызывает API Telegram, а затем отправляет сообщение в Telegram. Функция getLastUpdatedID () возвращает идентификатор последнего сообщения; мы делаем это, чтобы наш бот не запутался со старыми сообщениями при запросе нового сообщения.

Теперь мы добавим две последние функции, и тогда наш бот готов. Итак, добавьте эти две функции:

  # Следите за состояниями разговора: 'weatherReq'
чаты = {}

# Вывести все сообщения обратно
def handleUpdates (обновления):
    для обновления в getResult (обновления):
        chatId = getChatId (обновить)
        пытаться:
            text = getText (обновить)
        кроме исключения как e:
            регистратор.ошибка («Нет текстового поля в обновлении. Попробуйте определить местоположение»)
            loc = getLocation (обновить)
            # Была ли ранее запрошена погода?
            if (chatId в чатах) и (chats [chatId] == "weatherReq"):
                logger.info ("Погода запрошена для% s в чате с идентификатором% d"% (str (loc), chatId))
                # Отправить погоду в чат id и очистить состояние
                sendMessage (getWeather (loc), chatId)
                дель чаты [chatId]
            Продолжать

        если text == "/ weather":
            keyboard = buildCitiesKeyboard ()
            chats [chatId] = "weatherReq"
            sendMessage («Выберите город», chatId, клавиатура)
        elif text == "/ start":
            sendMessage («Аксиома Кана: когда ничего не помогает, прочтите инструкции», chatId)
        elif текст.начинается с("/"):
            logger.warning ("Недопустимая команда% s"% текст)
            Продолжать
        elif (текст в городах) и (chatId в чатах) и (chats [chatId] == "weatherReq"):
            logger.info ("Погода запрошена для% s"% text)
            # Отправить погоду в чат id и очистить состояние
            sendMessage (getWeather (текст), chatId)
            дель чаты [chatId]
        еще:
            keyboard = buildKeyboard (["/ погода"])
            sendMessage ("Я узнаю что-то новое каждый день, но пока вы можете спросить меня о погоде.", chatId, keyboard)

def main ():
    # Настроить файловые и консольные логгеры
    configLogging ()



    # Получить жетоны и ключи
    parseConfig ()
 
    # Перехватить Ctrl-C SIGINT
    signal.signal (сигнал.SIGINT, sigHandler)
 
    # Основной цикл
    last_update_id = Нет
    в то время как True:
        обновления = getUpdates (last_update_id)
        если len (getResult (updates))> 0:
            last_update_id = getLastUpdateId (обновления) + 1
            handleUpdates (обновления)
        time.sleep (0,5)

если __name__ == "__main__":
    main ()  

Объяснение кода:

Мы определили функцию handleUpdates () , которая обрабатывает всю обработку.Он вызывает getResult () , чтобы получить идентификатор последнего сообщения. Если есть новое сообщение, он вызывает getText () , чтобы получить текст из сообщения. Он проверяет, искали ли город ранее в прошлом. Если да, то он просто вызовет API и вернет информацию о погоде. Если он соответствует строке / weather , он вернет настраиваемую клавиатуру. При выборе города он выполнит вызов API и вернет информацию о погоде. Если в сообщении нет текста, оно попытается определить текущее местоположение, а затем попытается выполнить вызов API в зависимости от местоположения.

У нас тоже есть функция main () . Это вызовет другие функции в правильной последовательности и запустится по умолчанию.

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

Шаг –5: Тестирование нашего бота:

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

  python3 telegram.py  

А затем откройте приложение Telegram и найдите имя пользователя, которое вы выбрали для бота.Теперь нажмите на бота и напишите / погода . Он покажет вам что-то вроде этого:

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

Заключительные слова:

Мы успешно создали Telegram Weather Bot. API Telegram может гораздо больше, чем просто возвращать текущую погоду. Вы даже можете создать бота, который может возвращать текущие цены на акции или все, что угодно. Вы можете попробовать изучить API и попробовать реализовать новые функции с помощью API.

Интеграция Telegram - Документы Hummingbot

Интеграция Hummingbot с Telegram Messenger позволяет получать обновления в реальном времени и отправлять команды своему торговому боту с любого устройства, на котором у вас установлен Telegram. Независимо от того, используете ли вы Hummingbot в облаке или на своем локальном компьютере, вы можете использовать Telegram для мониторинга и управления ботами, где бы вы ни находились!

Щелкните эту ссылку, чтобы запустить официальный бот BotFather, бот Telegram, который помогает создавать и управлять ботами Telegram: https: // telegram.я / BotFather.

1. В Telegram перейдите на вновь созданную панель чата BotFather и нажмите Пуск или введите / start
2. Введите / newbot , чтобы создать бота
3. Введите имя вашего бота, название бота в Telegram, например hummingbot
4. Введите уникальный идентификатор, который заканчивается словом bot (например, my_awesome_hummingbot )
5. Обязательно скопируйте или сохраните токен. Это необходимо для включения Telegram на Hummingbot.
6. Щелкните ссылку на своего нового бота в сообщении выше, запустите его: t.me/<ВАШЕ ИМЯ БОТА> .
7. Нажмите Start или введите / start , чтобы запустить бота.

Щелкните следующее, чтобы запустить userinfobot, бот Telegram, который поможет вам получить ваш Telegram ID: https://telegram.me/userinfobot.

В Telegram перейдите на вновь созданную панель чата userinfobot и нажмите Start или введите / start .Сохраните идентификационный номер.

Теперь вы можете запустить Hummingbot и убедиться, что интеграция настроена правильно. Чтобы включить Telegram в Hummingbot, выполните следующие действия:

1. Запустите config telegram_enabled и установите значение True или ответьте Да, чтобы включить интеграцию Telegram
2. Запустите config telegram_token и введите идентификатор токена Telegram из BotFather
3. Запустите config telegram_chat_id и введите идентификатор чата из Получение идентификатора Telegram

Перед запуском Hummingbot убедитесь, что бот Telegram активен.Если это так, вы должны увидеть панель чата с именем вашего бота в Telegram. Запустите Hummingbot как обычно. Telegram будет подключен, как только вы запустите start в окне командной строки hummingbot. Сообщения синхронизируются в реальном времени между ботом Telegram и фактическим запущенным экземпляром Hummingbot. Например, вы можете использовать такие команды, как status и history для мониторинга производительности бота, config показывает текущие конфигурации бота, и вы можете использовать start и stop для управления ботом.

python-telegram-bot / python-telegram-bot: Мы сделали вам оболочку, от которой вы не можете отказаться

Мы сделали вам обертку, от которой невозможно отказаться

У нас есть активное сообщество разработчиков, помогающих друг другу в нашей группе Telegram.Присоединяйтесь к нам!

Следите за обновлениями библиотеки и новыми выпусками на нашем канале Telegram.

Содержание

Введение

Эта библиотека предоставляет чистый интерфейс Python для Telegram Bot API. Он совместим с версиями Python 3.6+. PTB также может работать на PyPy, хотя раньше было много проблем. Следовательно, PyPy официально не поддерживается.

В дополнение к чистой реализации API, эта библиотека включает ряд высокоуровневых классов для сделать разработку ботов простой и понятной.Эти классы содержатся в telegram.ext Подмодуль .

Чистая реализация API без telegram.ext доступна как отдельный пакет python-telegram-bot-raw . Подробности смотрите здесь.

Примечание

Совместная установка python-telegram-bot и python-telegram-bot-raw приведет к нежелательным побочным эффектам, поэтому устанавливайте только по одному обоих.

Поддержка Telegram API

Все типы и методы Telegram Bot API 5.1 поддерживаются.

Установка

Вы можете установить или обновить python-telegram-bot с помощью:

 $ pip install python-telegram-bot --upgrade 

Или вы можете установить из исходников с помощью:

 $ git clone https://github.com/python-telegram-bot/python-telegram-bot --recursive
$ cd Python-Telegram-бот
$ python setup.py установить 

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

 $ git обновление подмодуля --init --recursive 

Дополнительные зависимости

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

• pip install python-telegram-bot [паспорт] устанавливает библиотеку криптографии.Используйте это, если хотите использовать функции, связанные с Telegram Passport.
• pip install python-telegram-bot [ujson] устанавливает библиотеку ujson. Затем он будет использоваться для декодирования и кодирования JSON, что может увеличить скорость по сравнению со стандартной библиотекой json.
• pip install python-telegram-bot [socks] устанавливает библиотеку PySocks. Используйте это, если хотите работать за сервером Socks5.

Начало работы

Наша Wiki содержит множество ресурсов, которые помогут вам начать работу с python-telegram-bot :

Прочие ссылки:

Учимся на примере

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

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

Лесозаготовка

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

 импорт журнала
logging.basicConfig (уровень = logging.DEBUG,
                    format = '% (asctime) s -% (имя) s -% (имя уровня) s -% (сообщение) s') 

в начале вашего скрипта.

Вы также можете использовать журналы в своем приложении, вызвав logging.getLogger () и установив желаемый уровень журнала:

 logger = logging.getLogger ()
logger.setLevel (logging.INFO) 

Если вместо этого нужны журналы DEBUG:

 регистратор.setLevel (ведение журнала.DEBUG) 

Документация

python-telegram-bot документация находится на readthedocs.io.

Получение помощи

Вы можете получить помощь несколькими способами:

1. У нас есть активное сообщество разработчиков, которые помогают друг другу в нашей группе Telegram. Присоединяйтесь к нам!
2. Если вы не можете присоединиться к нашей группе из-за ограничений Telegram, вы можете использовать наш канал IRC.
3. Сообщайте об ошибках, запрашивайте новые функции или задавайте вопросы, создавая проблему или обсуждая.
4. Наши страницы Wiki предлагают постоянно растущее количество ресурсов.
5. Вы даже можете попросить о помощи по переполнению стека, используя тег python-telegram-bot.

Содействие

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

Пожертвование

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

Лицензия

Вы можете копировать, распространять и изменять программное обеспечение при условии, что модификации описаны и лицензированы бесплатно в соответствии с LGPL-3. Производные работы (включая модификации или все, что статически связано с библиотекой) могут распространяться только в рамках LGPL-3, но приложения, использующие библиотеку, не обязаны.

чат-ботов для Telegram - создайте своего первого чат-бота

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

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

Основные последствия? Более приятный пользовательский интерфейс и более быстрое и простое взаимодействие со службой поддержки.

Как создать бота для Telegram

Обо всем по порядку. Вам необходимо зарегистрироваться в Telegram (очевидно). Я рекомендую использовать веб-клиент Telegram, чтобы проверить основы.

Откройте приложение Telegram, найдите @BotFather и начните чат. Отправьте команду / newbot и следуйте инструкциям. Выполнив начальные шаги, вы получите:

• Собственный токен
• Telegram api URL - api.telegram.org/<ваш токен>
• ссылка на документацию

На данный момент бот на 100% пассивен.

Интеграция с Chatcompose

Для продолжения вам понадобится учетная запись ChatCompose. Вы можете зарегистрироваться здесь.

После регистрации перейдите в раздел «Установка»> «Интеграции». Там вы увидите возможность интеграции с Telegram.

Вы увидите следующее:

Введите токен, который вы создали с помощью BotFather, и сохраните.

После сохранения мы зарегистрируем маршрут нашего бота в телеграмме. Скопируйте маршрут и вставьте его в этот URL вместе со своим токеном.

 api.telegram.org/bot/setWebHook?url=  

URL-адрес должен выглядеть примерно так:

 api.telegram.org/bot000000:AAAAAAAAAAAAA/setWebHook?url=https://panel.chatcompose.com/telegram/yourbot 

Перейти к этому маршруту. Ответ должен вернуть следующее:

 {"ok": true, "result": true, "description": "Webhook был установлен"} 

Чтобы проверить, была ли конфигурация успешной, вы можете перейти к:

 api.telegram.org/bot/getWebhookInfo 

Вызов должен вернуть только что настроенный URL-адрес chatcompose.

Если вы еще не ввели токен, созданный с помощью BotFather в ChatCompose, сделайте это сейчас.

Следующие шаги

Ваш бот должен быть установлен и запущен в Telegram. Не забудьте настроить автоматические ответы в ChatCompose в разделе База данных.

Щелкните адрес вашего бота, созданный BotFather (t.me/nameofyour), и начните с ним взаимодействовать.

Знакомство с API

  # Отправить сообщение
бот $ sendMessage (chat_id,
  text = "foo * bold * _italic_",
  parse_mode = "Уценка"
)

# Отправить фотографию
бот $ sendPhoto (chat_id,
  photo = "https://telegram.org/img/t_logo.png"
)

# Отправить аудио
бот $ sendAudio (chat_id,
  audio = "http://www.largesound.com/ashborytour/sound/brobob.mp3"
)

# Отправить документ
бот $ sendDocument (chat_id,
  документ = paste0 (
    "https: // github.com / ebeneditos / telegram.bot / raw / gh-pages / docs / ",
    "telegram.bot.pdf"
  )
)

# Отправить стикер
бот $ sendSticker (chat_id,
  стикер = "https://www.gstatic.com/webp/gallery/1.webp"
)

# Отправить видео
бот $ sendVideo (chat_id,
  видео = "http://techslides.com/demos/sample-videos/small.mp4"
)

# Отправить gif
бот $ sendAnimation (chat_id,
  animation = "https://media.giphy.com/media/sIIhZliB2McAo/giphy.gif"
)

# Отправить местоположение
бот $ sendLocation (chat_id,
  широта = 51,521727,
  долгота = -0,117255
)

# Отправить действие в чате
бот $ sendChatAction (chat_id,
  действие = "набор текста"
)

# Получить фото профиля пользователя
фотографии <- бот $ getUserProfilePhotos (user_id = chat_id)

# Скачать фото профиля пользователя
file_id <- фото $ photos [[1L]] [[1L]] $ file_id
бот $ getFile (file_id, destfile = "photo.jpg ")  

  {
   "ок": правда,
   "результат":{
      "id": 1101361374,
      "is_bot": правда,
      "first_name": "Пример бота для блога",
      "username": "example_blog_bot",
      "can_join_groups": ложь,
      "can_read_all_group_messages": ложь,
      "supports_inline_queries": false
   }
}
  

  {
   "ок": правда,
   "результат":[
      {
         update_id: 726362299,
         "сообщение":{
            "message_id": 3,
            "из":{
               "id": 877419474,
               "is_bot": ложь,
               "first_name": "Алекс",
               "last_name": "Сарафский"
            },
            "чат":{
               "id": - 475387861,
               "title": "Пример блогового бота",
               "тип": "группа",
               "all_members_are_administrators": истина
            },
            «дата»: 1585150611,
            "текст": "Привет"
         }
      }
   ]
}
  

  {
   "ок": правда,
   "результат":{
      "message_id": 4,
      "из":{
         "id": 1101361374,
         "is_bot": правда,
         "first_name": "Пример бота для блога",
         "имя пользователя": "example_blog_bot"
      },
      "чат":{
         "id": - 475387861,
         "title": "Пример блогового бота",
         "тип": "группа",
         "all_members_are_administrators": истина
      },
      «дата»: 1585151160,
      "текст": "Привет"
   }
}