Создание окружения, рабочие методы. Блок администрирования бот-магазина. Дополнения и изменения в структуре базы данных. Знакомство с PDO.
Продолжение: (Часть 1 и Часть 3, Часть 4) цикла статей по созданию чат-бот-магазина в Телеграм. В этой статье мы перейдем непосредственно к практической части. Забегая вперед сообщу, что исходный код рассматриваемого блока администрирования можно скачать в конце статьи. Созданию окружения для работы в BOT API мы уделим особое внимание, считаю это одним из основных составляющих приложения. Что я имею ввиду под словом «окружение»: это методы запуска приложения, для работы с базой данных, метод-роутер и методы работы с BOT API. * * *
Настройка окружения
Рассмотрим метод запуска приложения init() — это метод, который запускает работу с базой данных и работу роутера.
setPdo(); // получаем данные от АПИ и преобразуем их в ассоциативный массив $rawData = json_decode(file_get_contents(‘php://input’), true); // направляем данные из бота в метод роутер // для определения дальнейшего выбора действий $this->router($rawData); // в любом случае вернем true для бот апи return true; > ?>
В методе работы с базой данных, создадим объект PDO и добавим его в свойство $this->pdo
host;dbname=$this->db;charset=$this->charset»; // дополнительные опции $opt = [ // способ обработки ошибок — режим исключений PDO::ATTR_ERRMODE => PDO::ERRMODE_EXCEPTION, // тип получаемого результата по-умолчанию — ассоциативный массив PDO::ATTR_DEFAULT_FETCH_MODE => PDO::FETCH_ASSOC, // отключаем эмуляцию подготовленных запросов PDO::ATTR_EMULATE_PREPARES => false, // определяем кодировку запросов PDO::MYSQL_ATTR_INIT_COMMAND => «SET NAMES utf8mb4 COLLATE utf8mb4_unicode_ci» ]; // записываем объект PDO в свойство $this->pdo $this->pdo = new PDO($dsn, $this->user, $this->pass, $opt); > ?>
Наш роутер определяет какой тип данных нам пришел от BOT API и направляет их по заданному нами направлению. В нем мы будем использовать дополнительно еще несколько инструментов для определения статуса пользователя и в случае если это администратор бота, то проверим на цель данных. Для работы нашего приложения в блоке администрирования бот-магазина, мы будем обрабатывать 2 типа данных — это message и callback_query , остальные нам пока не нужны, поэтому будем выводить предупреждение. В тип message приходят объекты, отправленные пользователем: текст, картинки, видео, документы, аудиофайл, видеофайл и другие. Объект callback_query приходит только при нажатии inline кнопки с опцией callback_data . Мы составим условия таким образом, что принимать message будем только текст и картинки, а callback_query будем перенаправлять в необходимый метод и в нем уже обрабатывать запрос на действие. При проверке на текстовое сообщение мы зададим несколько шаблонов в условиях и при их выполнении направим в нужные нам методы. Это стандартная команда для старта бота /start , для страницы админа /admin и еще несколько команд для отображения экранов для просмотра категорий, контактов, добавления категории. Все остальные текстовые сообщения, которые пришли в бот, мы будем определять по действию, которое было записано во временную таблицу в бд и при условии, что пользователь является админом. Действия мы записываем в бд по мере вызова методов добавления категорий или товара в категории. При запросе на добавление категории мы запишем действие в бд как addcategory , и следующее текстовое сообщение мы будем воспринимать как название категории. В случае если будет отправлен другой контент — картинка например, то по условиям будет выведена ошибка в отправленных данных, потому что картинку мы ждем только на 5 шаге добавления товара. Обратите внимание как обрабатывается объект callback_query . Мы смотрим какое значение data приходит в объекте, это всегда (в нашем приложении) строка, состоящая из значений разделенные знаком нижнего подчеркивания и первым значением идет название метода в который нужно передать данные, далее это необходимые параметры в основном это идентификаторы.
Работаем с Google Таблицами API на Python. Подключаем к Телеграмм боту Google Таблцу
getChatId($data); $text = $this->getText($data); // если пришли данные message if (array_key_exists(«message», $data)) < // дастаем действие админа из базы $action = $this->getAdminAction(); // текстовые данные if (array_key_exists(«text», $data[‘message’])) < // если это пришел старт бота if ($text == «/start») < $this->startBot($chat_id); > elseif ($text == «/admin» $this->isAdmin($chat_id)) < // выводим страницу только админу $this->adminPage(); > elseif ($text == «/admincategory» $this->isAdmin($chat_id)) < // Страница админ категорий $this->adminCategory(); > elseif ($text == «/addcategory» $this->isAdmin($chat_id)) < // отправляем на добавление категории $this->addCategory(); > elseif ($text == «/admincontact» $this->isAdmin($chat_id)) < // просмотр контактов $this->adminContact(); > else < // смотрим куда отправить данные if ($action == «addcategory» $this->isAdmin($chat_id)) < // если ждем данные для добавления категории $this->adderCategory($text); > elseif (preg_match(«~^addproduct_1_~», $action) $this->isAdmin($chat_id)) < // если ждем данные для добавления товара step_1 — название $param = explode(«_», $action); // отправляем на добавление описания $this->addProductName($param[‘2’], $text); > elseif (preg_match(«~^addproduct_2_~», $action) $this->isAdmin($chat_id)) < // если ждем данные для добавления товара step_2 — описание $param = explode(«_», $action); // отправляем на добавление описания $this->addProductDescription($param[‘2’], $param[‘3’], $text); > elseif (preg_match(«~^addproduct_3_~», $action) $this->isAdmin($chat_id)) < // если ждем данные для добавления товара step_3 — единица измерения $param = explode(«_», $action); // отправляем на добавление описания $this->addProductPrice($param[‘2’], $param[‘3’], $text); > elseif (preg_match(«~^addproduct_4_~», $action) $this->isAdmin($chat_id)) < // если ждем данные для добавления товара step_4 — цена $param = explode(«_», $action); // отправляем на добавление описания $this->addProductUnit($param[‘2’], $param[‘3’], $text); > elseif (preg_match(«~^addcontact_~», $action) $this->isAdmin($chat_id)) < // если ждем данные для для редактирования контактов $param = explode(«_», $action); // отправляем данные на редактирование контактов $this->rederContact($param[1], $text); > else < $this->sendMessage($chat_id, «Нам пока не нужны эти данные. Спасибо.»); > > > elseif (array_key_exists(«photo», $data[‘message’])) < // если пришли картинки if (preg_match(«~^addproduct_5_~», $action) $this->isAdmin($chat_id)) < // если ждем данные для добавления товара step_5 — картинка $param = explode(«_», $action); // берем данные картинки $file_id = end($data[‘message’][‘photo’])[‘file_id’]; // отправляем на добавление описания $this->addProductPhoto($param[‘2’], $param[‘3’], $file_id); > else < $this->sendMessage($chat_id, «Нам пока не нужны эти данные. Спасибо.»); > > else < $this->sendMessage($chat_id, «Нам пока не нужны эти данные. Спасибо.»); > > // если пришел запрос на функцию обратного вызова elseif (array_key_exists(«callback_query», $data)) < // смотрим какая функция вызывается $func_param = explode(«_», $text); // определяем функцию в переменную $func = $func_param[0]; // вызываем функцию передаем ей весь объект $this->$func($data[‘callback_query’]); > // Здесь пришли пока не нужные нам форматы else < // вернем текст с ошибкой $this->sendMessage($chat_id, «Нам пока не нужны эти данные. Спасибо.»); > > ?>
Для работы с действиями администратора есть несколько методов для выборки, для записи и для очистки.
Источник: imakebots.ru
Как отправить таблицу в Телеграме?
Телеграм — это одно из самых популярных мессенджеров в мире, и часто возникает необходимость отправить таблицу в этом приложении. Но как это сделать правильно и удобно? В данной статье мы расскажем вам о нескольких способах отправки таблицы в Телеграм, а также поделимся полезными советами, которые помогут вам освоить эту задачу без лишних сложностей.
1. Копирование и вставка таблицы
Самым простым и распространенным способом отправки таблицы в Телеграм является копирование и вставка. Для этого вы можете воспользоваться программы Excel, Google Sheets или любым другим редактором, в котором у вас есть таблица. Просто выделите нужные ячейки, скопируйте их и вставьте в окно чата в Телеграме. После вставки, Телеграм автоматически форматирует таблицу и отправит ее в качестве прикрепленного файла.
2. Использование бота
Если вы отправляете таблицу в Телеграм часто и хотите сэкономить время, вы можете воспользоваться специальными ботами, которые помогут автоматизировать этот процесс. В магазине приложений Telegram существует большое количество ботов, которые могут помочь вам с отправкой таблиц. Подключение бота — это простой процесс, который займет всего несколько шагов, и затем вам будет удобно отправлять таблицы в Телеграм всего парой нажатий.
3. Пересылка файла
Если у вас уже есть готовая таблица в файловом формате, например, в формате Excel или CSV, вы можете просто отправить этот файл в Телеграм. Для этого вам нужно выбрать файл и отправить его в чат в Телеграме. Получатели смогут открыть файл и просмотреть таблицу с помощью любого удобного им редактора. Этот способ особенно удобен, если у вас несколько таблиц, которые вы хотите отправить вместе.
Независимо от выбранного способа, важно помнить про сохранность данных. Если вы отправляете таблицу с конфиденциальной информацией, убедитесь, что вы делаете это в безопасной сети и соблюдаете все правила безопасности. Также обратите внимание на форматирование таблицы, чтобы она выглядела читабельно и удобно для получателей.
Источник: khokku.ru
Создаем для Телеграм таблицу рекламных закупов
Боты — это модно. Нина Белая специально для Нетологии выбрала 45 полезных ботов для Telegram.
Эти телеграм-боты помогут решать задачи быстро и с пользой.
Хранить и обмениваться файлами
Найти и скачать
курс
Интернет-маркетолог
Узнать больше
- Освойте одну из самых востребованных digital-профессий
- Познакомьтесь с основными инструментами интернет-маркетинга
- Изучите теорию и отработайте практические навыки на реальных проектах
Почта
Языки
Текст
Для работы в Telegram
Читать также
10 каналов для копирайтеров, журналистов и редакторов в Telegram
В городе и в мире
Спорт
Читать также
11 чатов в Telegram для маркетологов
Прочие
Хотите написать колонку для Нетологии? Читайте наши условия публикации. Чтобы быть в курсе всех новостей и читать новые статьи, присоединяйтесь к Телеграм-каналу Нетологии.
Читать также
4) настройки публикации должны быть такими (email будет ваш)
Строим загрузочный док
Нам нужен URL приложения, чтобы получать данные из Telegram. К счастью, у Google очень простая публикация веб-приложений через редактор сценариев. Когда мы опубликуем скрипт, то получим уникальный адрес веб-приложения. Нажимайте Publish в редакторе скриптов Google Spreadsheet. Пожалуйста, обратите внимание на варианты на изображении ниже. Каждый раз, когда вы публикуете свою работу, выбран должен быть вариант новое, ваша личная электронная почта и любой, даже аноним должен иметь доступ к приложению.
И теперь у нас есть адрес веб-приложения! ?
Сохраните все ссылки в переменных
Теперь, когда у нас есть пропуск и загрузочный док, давайте создадим веб-хук — наш крючок. Согласно документации Telegram API, все запросы к API (App Programming Interface) должны быть такими: https://api.telegram.org/bot/METHOD_NAME . Похоже, нам будет очень часто нужна эта ссылка. Давайте сохраним все нужные ссылки в переменных, чтобы мы могли легко писать их позже:
Настройка веб-хука
Чтобы настроить хук, давайте напишем функцию, которая позволит нам извлекать данные из Telegram с помощью токена от Botfather. Эти данные должны быть отправлены непосредственно на адрес нашего веб-приложения. Вы можете скопировать и вставить код ниже и нажать кнопку Опубликовать, когда закончите.
Когда вы публикуете (или развёртываете) свой код, вам могут предложить авторизовать свое собственное приложение для доступа к вашим данным в Google:
Авторизуйте приложение: жизнь слишком коротка, чтобы прожить её в безопасности:
Настройка обмена сообщениями
Есть две вещи, которые наш бот должен знать, прежде чем сможет отправить кому-то сообщение:
- Кому сообщение? Идентификатор чата.
- Что напишем? Текст сообщения.
Запишем эти требования как параметры функции. Не стесняйтесь копировать и вставлять код:
Настройка запроса POST
По словам разработчиков Telegram, все запросы к API должны идти по HTTPS. Они также упомянули, что поддерживают только запросы GET и POST . GET означает, что кто-то пытается получить данные. POST означает, что кто-то пытается их отправить. Это единственная концепция в учебнике, которую я ещё не освоила, поэтому я перестану притворяться, что знаю, о чем говорю, и просто покажу вам эту статью, которая помогла мне лучше понять принцип.
В любом случае, важно знать, что вы должны написать функцию, которая может отправлять POST -запрос в Telegram, чтобы вы могли отправлять сообщение каждый раз, когда человек общается с вашим ботом. Не стесняйтесь копировать и вставлять этот код. Я объясню, что он делает, в ближайшее время:
Нам нужна эта функция, потому что она — наш способ отправки данных в Telegram и сам Google требует, чтобы его пользователи сценариев приложений — то есть мы — включали либо функцию doGet , либо doPost , когда публикуем веб-приложение. Вот документация об этом. В этом документе Google объясняет, что означает аргумент ( e ) в функции. Он представляет собой данные из события, созданного человеком внутри приложения, к которому подключен наш веб-хук. В нашем случае аргумент e содержит все данные, генерируемые всякий раз, когда человек отправляет сообщение Telegram-боту. И именно в аргументе мы получим идентификатор чата пользователя. В конце концов, все предыдущие бредни оправдались ? (может быть).
Итак, вот история нашего бота:
- Когда пользователь общается с нашим ботом Telegram, происходит событие. Оно генерирует данные, получаемые нами из e .
- Веб-хук автоматически отправляет e на URL-адрес веб-приложения.
- Как только e попадёт в URL-адрес веб-приложения, оно захочет отправить запрос POST в Telegram. Он запросит Telegram об отправке сообщения пользователю.
- Однако он не может отправить запрос с неполными требованиями. Нам нужен идентификатор чата человека и сообщение, которое мы хотим отправить в Telegram. Функция doPost переносит сообщение внутри переменной text .
- doPost также обрабатывает идентификатор chat , но сначала ей нужно проанализировать e , чтобы найти его.
- После обнаружения она передаёт параметры в Telegram с помощью функции sendMessage . Всё: сообщение передаётся пользователю. Запрос завершен. И вот — работающий бот:
Читайте нас в Telegram, VK и Яндекс.Дзен
Перевод статьи Mars Escobin: Seven Easy Steps to Create a Telegram Bot Using Webhooks
Источник: geopressa.ru