Skip to content

TelegramESP - это библиотека для ESP32 для работы с Telegram-ботами.

License

Notifications You must be signed in to change notification settings

KITTEN2008/TeleBot

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

16 Commits
 
 
 
 
 
 
 
 
 
 

Repository files navigation

TeleBot

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

TeleBot - это библиотека для ESP32 для работы с Telegram-ботами, которая позволит вам работать с токеном бота и получать от него сообщения, отправлять ответы и в общем развивать IoT для ESP32!

Команды

Команда Параметры Описание Пример
#include - Подключение библиотеки #include <TeleBot.h>
begin() - Инициализация бота bot.begin()
loop() - Главный цикл обработки bot.loop()
send() chat_id, text, [parse], [keys] Отправка сообщения bot.send(123, "Hello")
sendIn() chat_id, text, keys Сообщение с inline-кнопками bot.sendIn(123, "Выберите", keyboard)
sendChat() chat_id, action Действие в чате bot.sendChat(123, "typing")
edit() chat_id, msg_id, text, [keys] Редактирование сообщения bot.edit(123, 456, "Новый текст")
del() chat_id, msg_id Удаление сообщения bot.del(123, 456)
answer() inline_id, [text] Ответ на inline-кнопку bot.answer("cb_id", "Выбрано")
photo() chat_id, url, [caption] Отправка фото bot.photo(123, "http://...")
document() chat_id, url, [caption] Отправка документа bot.document(123, "file.txt")
location() chat_id, lat, lon Отправка локации bot.location(123, 55.75, 37.61)
on() handler Обработчик всех сообщений bot.on(myHandler)
com() command, handler Обработчик команд bot.com("/start", startCmd)
inl() handler Обработчик inline-кнопок bot.inl(handleInline)
createKey() buttons[][2], rows, [resize], [once] Обычная клавиатура createKey(btns, 2)
createIn() buttons[][3], rows, [delBtn] Inline-кнопки createIn(inBtns, 3, true)
createURL() buttons[][2], rows Кнопки со ссылками createURL(urlBtns, 2)
server() interval Частота опроса (мс) bot.server(2000)
debug() enable Включение отладки bot.debug(true)
useDNS() enable Использование DNS bot.useDNS(true)
conWiFi() ssid, password или WiFiConf Подключение к WiFi bot.conWiFi("SSID", "PASS")
deconWiFi() - Отключение от WiFi bot.deconWiFi()
autoWiFi() enable, [interval] Авто-реконнект bot.autoWiFi(true, 30000)
isWiFi() - Проверка подключения if(bot.isWiFi())
callWiFi() handler Callback для событий WiFi bot.callWiFi(wifiCallback)
wifiStatus() - Статус WiFi bot.wifiStatus()
initSD() [csPin], [freq] Инициализация SD карты bot.initSD(5)
readSD() path, [type] Чтение файла bot.readSD("/log.txt")
recordSD() path, data, [type] Запись файла bot.recordSD("/log.txt", "data")
appendSD() path, data Добавление в файл bot.appendSD("/log.txt", "new")
deleteSD() path Удаление файла bot.deleteSD("/old.txt")
existsSD() path Проверка существования bot.existsSD("/file.txt")
listSD() [path] Список файлов bot.listSD("/")
extF() - Поддерживаемые расширения bot.extF()

📈 Производительность

Память: ~3-5KB на бота

Макс. ботов: 5-8 (зависит от сложности кода)

Интервал опроса: 1000-5000 мс (рекомендуется)

Подключение WiFi: 10-20 секунд

⚠️ Ограничения

Токен бота должен быть получен от @BotFather

WiFi должен быть настроен перед использованием бота

SD карта требует отдельной инициализации

Память ESP32 ограничена, избегайте больших файлов

Telegram API имеет лимиты на запросы (30/сек)

About

TelegramESP - это библиотека для ESP32 для работы с Telegram-ботами.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages