Перейти к содержимому

Report в телеграмме что это

  • автор:

Report-Bot — Предложка для Telegram [Часть 3]

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

Для сегодняшних задач обновил библиотеку и добавил класс-хранилище. Принцип его работы похож на тот, что я описывал в статье по ВК-боту. Но всё же чутка отличается.

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

Далее создаём php-файл, в котором будем писать бота (bot.php) и сразу же подключаем библиотеку:

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

const REPORT_CHAT_ID = ''; // ID чата, в который будут приходить репорты

Создаём экземпляр класса Bot, попутно инициализируя $chat_id и $message:

$tg = \telekot\Bot::create( 'токен' ) // Создаём экземпляр класса Bot, передаём в метод create() токен бота ->initChatId( $chat_id ) // Инициализируем айди чата, из которого поступают боту сообщения (например, это может быть айди пользователя, написавшего боту) ->initMessage( $message ); // Инициализируем текст сообщения, которе было отправлено боту

И создаём экземпляр класса Storage, передавая в метод start() экземпляр класса Bot (он у нас записан в переменную $tg):

$ctx = \telekot\Storage::start( $tg ); // Создаём экземпляр класса Storage для работы с хранилищем

Поскольку репорт можно будет написать после введения команды /start — добавляем соответствующее условие в код:

if ( $message == '/start' ) < // Тут продолжим писать код >

В связи с тем, что отправка репорта осуществляется в два этапа (1 — ввод команды /start, 2 — отправка репорта) — нужно записать статус диалога с написавшим боту пользователем в кэш, а также дать юзеру дальнейшие инструкции:

$ctx->ctx(); // Создаём файл в кэше и ставим статус диалога в положение 1 $tg->reply( 'Привет, напиши своё репорт/новость/обращение в следующем сообщении' ); // Отправляем мессаг юзеру

Метод ctx() создаёт в папке cache новый файл (формата *user_id*.php) и устанавливает статус 1 в сгенерированном массиве.

Значения из кэша можно извлекать методом get() по ключу (в нашем случае ключ — ‘status‘). Поэтому в блоке elseif проверяем, писал ли уже этот пользователь боту или нет. Если статус равен единице — значит писал, в противном случае условие не выполняется.

else if ( $ctx->get( 'status' ) == 1 ) < // Тут продолжим >

Больше никаких данных пользователь вводить не будет, а значит из хранилища запись можно удалять. Делаем это, используя метод delete():

$ctx->delete(); // Удаляем запись из кэша

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

$tg->sendMessage( REPORT_CHAT_ID, "Новый репорт от @: \n\n" . $message ); // Отправляем админу репорт $tg->reply( 'Репорт успешно отправлен админу, если хочешь написать ещё что-нибудь - введи команду /start' ); // Говорим челу, что репорт успешно отправлен
initData( $data ) ->initChatId( $chat_id ) // Инициализируем айди чата, из которого поступают боту сообщения (например, это может быть айди пользователя, написавшего боту) ->initMessage( $message ); // Инициализируем текст сообщения, которе было отправлено боту $ctx = \telekot\Storage::start( $tg ); // Создаём экземпляр класса Storage для работы с хранилищем if ( $message == '/start' ) < $ctx->ctx(); // Создаём файл в кэше и ставим статус диалога в положение 1 $tg->reply( 'Привет, напиши своё репорт/новость/обращение в следующем сообщении' ); // Отправляем мессаг юзеру > else if ( $ctx->get( 'status' ) == 1 ) < $ctx->delete(); // Удаляем запись из кэша $tg->sendMessage( REPORT_CHAT_ID, "Новый репорт от @: \n\n" . $message ); // Отправляем админу репорт $tg->reply( 'Репорт успешно отправлен админу, если хочешь написать ещё что-нибудь - введи команду /start' ); // Говорим челу, что репорт успешно отправлен >

  • 5id15
  • 23.08.2022
  • 7 582
  • 4
  • 35

Как пожаловаться на контент в Telegram

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

Личный чат

❓ Условия

В личном чате можно пожаловаться на другого пользователя только тогда, когда выполнены все перечисленные ниже условия:

  1. Пользователь сам начал с вами диалог, прислав первое сообщение.
  2. Пользователь не добавлен в ваш список контактов.
  3. С момента начала диалога прошло не больше 7 суток.

�� Как пожаловаться?

Если над диалогом отображается кнопка “ЗАБЛОКИРОВАТЬ“, нажмите ее и отметьте пункт “Сообщить о спаме“. Если такой кнопки нет, значит, Telegram уже не позволяет пожаловаться на собеседника.

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

Сообщение в группе или канале

❓ Условия

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

На сообщение в канале можно пожаловаться в любом случае.

�� Как пожаловаться?

  1. Нажмите рядом с сообщением и выберите пункт “Пожаловаться”.
  2. Укажите причину жалобы. Если приложение попросит указать комментарий, добавьте краткое описание.

Реакция на сообщение в группе

❓ Условия

  1. Реакция должна быть оставлена пользователем, который не добавлен в ваш список контактов.
  2. Пожаловаться можно только в мобильных приложенях (Android или iPhone) или в Telegram для macOS. В Telegram Desktop такой возможности нет.

�� Как пожаловаться?

  1. Нажмите рядом с сообщением, под которым оставлена реакция.
  2. Откройте список реакций и нажмите на имя того пользователя, на которого хотите пожаловаться.
  3. Нажмите кнопку “Сообщить о спам-реакциях”.

Группа целиком

❓ Условия

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

�� Как пожаловаться?

  1. Откройте группу.
  2. На ПК и Android: нажмите на кнопку с тремя точками в правом верхнем углу экрана и выберите пункт “Пожаловаться”. На IPhone: нажмите на заголовок экрана, а потом на кнопку “Еще” с тремя точками, и выберите пункт “Пожаловаться”.
  3. Укажите причину жалобы. Если приложение попросит добавить комментарий, укажите краткое описание причины жалобы.

Канал целиком

❓ Условия

Пожаловаться можно абсолютно на любой канал.

�� Как пожаловаться?

  1. Откройте канал.
  2. На ПК и Android: нажмите на кнопку с тремя точками в правом верхнем углу экрана и выберите пункт “Пожаловаться”. На IPhone: нажмите на заголовок экрана, а потом на кнопку “Еще” с тремя точками, и выберите пункт “Пожаловаться”.
  3. Укажите причину жалобы. Если приложение попросит добавить комментарий, укажите краткое описание причины жалобы.
  4. Отметьте одно или несколько сообщений, нарушающих правила Telegram.
  5. Нажмите кнопку “Пожаловаться на N сообщений”.

Боты

❓ Условия

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

�� Как пожаловаться?

  1. Нажмите рядом с сообщением и выберите пункт “Пожаловаться”.
  2. Укажите причину жалобы. Если приложение попросит указать комментарий, добавьте краткое описание.

Любой контент или действия

Кроме вышеперечисленных способов Telegram предлагает и другие каналы для отправки жалоб на контент. Подробно мы описывали их в статье Как обратиться в Telegram?

  • Читать @tginfo в Telegram
  • Telegram FAQ
  • Лимиты Telegram
  • Поддержать проект

22 интересные фичи, которые стоит добавить в Telegram

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

Многие идеи были подсмотрены в других сервисах, а также на баг-трекере https://bugs.telegram.org, где есть раздел с идеями.

Реакции на сообщения или посты в каналах

Оригинал идеи: https://bugs.telegram.org/c/23
upd от 31.12.2021 — функция была добавлена в этой версии

Идея из интерфейса Discord: пользователь может поставить любую реакцию (а не только те, которые выбрал автор поста) на сообщение, чтобы выразить своё отношение. При этом не создавать отдельное сообщение, которое будет являться ответом. Список пользователей, оставивших реакции, может быть анонимным или нет.

Подсветка синтаксиса

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

Больше ролей в чате

Оригинал идеи: Discord

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

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

Пинги

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

Сейчас в Telegram можно упомянуть только одного пользователя за раз. Предлагается ввести такие упоминания как @all , @online , @admin и так далее. При создании дополнительных ролей появляется возможность написать @ и упомянуть всех пользователей с такой ролью.

Зал ожидания для вступления в чат

upd от 03.11.2021 — функция была добавлена в этой версии

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

Спойлеры

Источник идеи: Discord
upd от 31.12.2021 — функция для текста была добавлена в этой версии

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

Двойное дно

Источник идеи и неофициальная реализация фичи: https://postufgram.com

Идея заключается в следующем: для входа в приложение используется графический, или биометрический, или любой другой пароль, но есть несколько верных комбинаций, которые ведут в разные аккаунты. Например, такая система уже используется во «Втором пространстве» на некоторых Android-телефонах.

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

Боты для голосовых чатов

Источник идеи: Discord

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

Такой функционал позволит создать различных полезных ботов:

  • Диджей-бот для проигрывания музыки в голосовом чате. Так у всех участников будет возможность делиться музыкой со всеми. Пример: Rythm Bot в дискорде (https://rythm.fm/). Сейчас такой бот в Telegram (@GroupsMusicBot) реализован с помощью юзерботов, а их ограниченное число создаёт очередь.
  • Интеграция с голосовыми помощниками («Алиса», Siri и подобные). Это позволит искать информацию не выходя из чата, а ответ будут слышать все.
  • Text-to-speech бот. Он может зачитывать новые сообщения в текстовых чатах, чтобы участникам не приходилось отвлекаться от звонка на их чтение.

Анонимное создание аккаунта

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

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

Избранные сообщения

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

Чаты с повышенным доверием

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

Улучшение поиска

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

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

QR-код инвайта

upd от 31.12.2021 — функция была добавлена в этой версии

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

Свои аватарки контактов

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

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

Сообщения с общим доступом

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

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

Участники-призраки

В Telegram есть опция импорта чата (например, из WhatsApp). В групповых чатах сообщения отсылаются от имени несуществующих пользователей, у которых вместо имён номера телефона.

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

Репорты администраторам чата

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

Улучшенные папки

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

  • Папка All Chats. В ней отображаются уведомление со всех чатов, что очень сильно раздражает. Если бы была возможность её спрятать сверху списка (как архивированные чаты, только в списке папок), то это было бы удобнее.
  • Добавление чата в папку. Сейчас это можно сделать только через настройки папки, но если бы в списке чатов можно было бы нажать ПКМ и выбрать там опцию «Добавить в папку», то это было бы удобнее, так как список чатов часто намного больше, чем папок.

Цитата

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

Улучшение работы с файлами

Несколько полезных улучшений:

  • Переименовывание файла после отправки. Сейчас для этого нужно заново загружать файл, что часто бывает неудобно.
  • Варианты скачивания при совпадении имён. Если в папке загрузок уже есть файл с таким названием, то можно либо создать файл с (1) в названии, либо перезаписать прошлый. Оба варианта имеют право на существование, и иметь возможность выбирать между ними было бы удобно.

Лента сообщений

upd от 31.08.2021 — в новой версии телеграма появилась функция перехода между каналами

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

Кнопка «Ответить лично»

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

23 марта 2022 г. Процесс создания простого бота Телеграм для отслеживания времени

Процесс создания простого бота Телеграм для отслеживания времени

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

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

Я, например, постоянно пользуюсь чат-ботом @vkmusic_bot_news. Это простой бот для поиска и прослушивания музыки. Отправляешь сообщение с названием композиции или именем автора, и бот выдает тебе варианты по твоему запросу. В примере я запросил композицию «show must go on» и получил несколько вариантов на выбор. Выбрав первый вариант я получил трек в следующем сообщении. Удобно, что можно прослушивать прямо в чате с ботом. Таким образом чат-бот может заменить стороннее приложение — проигрыватель на телефоне. Ищешь и сразу же слушаешь.

Таким образом мы подошли к выводу, что телеграм чат-боты довольно удобная и многофункциональная штука. Поэтому в этой статье и пойдет речь о написании простого чат-бота. Для примера я решил сделать трекер времени — простейший пример взаимодействия с telergram api.

Создание простого чат-бота

Для начала нужно создать — зарегистрировать самого бота в telegram. Ищем отца всех ботов @BotFather — тоже бот для регистрации ботов.

Пишем ему, что хотим создать своего чат-бота.

/newbot

Следующей командой он просит придумать название. Так как мой бот будет трекать время — название соответствующее. Пишу:

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

Готово! В ответе нам приходит токен — это значит, что мы зарегистрировали нового чат-бота.

Разработка

Для начала я решил посмотреть какие библиотеки предлагает нам интернет.

Оказалось вариантов не так мало. Тут можно ознакомится со всем списком предлагаемых вариантов.

Мой выбор пал на TelegramBotApiBundle для Symfony.

composer require borsaco/telegram-bot-api-bundle

Бандл поддерживает работу с несколькими ботами одновременно. Кроме того есть вариант отладки (отправка только разработчику) и работа через прокси. Для тестового примера нам много не нужно — убираем все лишнее.

config/packages/telegram.yaml

Также я вынес токен в переменную APP_TELEGRAM_TOKEN в .env

Немного теории

Telegram api, можно сказать, работает в двух режимах: можно самим получать обновления с сервера через метод getUpdates(), либо настроить webHook. Первый метод хорош тем, что он предельно прост, но плох тем, что нужно самостоятельно постоянно опрашивать сервер на предмет обновлений. Вариант с webhook же позволяет не думать о том, как получить обновления, а сосредоточится на их обработке. В этом случае telegram будет сам отправлять обновления на url, который мы укажем.

Преимущество второго подхода очевидны)

Для регистрации Webhook делаем следующее:

$bot = $botService->getBot('timeTracker'); $bot->setWebhook( [ 'url'=>'https://myWebSite.com/webhook' ] );

webhook в значении url — это роут, который мы сделаем немного позже. $botService — это объект сервиса Borsaco\TelegramBotApiBundle\Service\Bot, который можно инжектить в любом месте проекта.

Важно: telegram api поддерживает отправку только на https!

Теперь проверим наш Webhook: если отправить какое-нибудь сообщение нашему боту telegram пришлет нам вот такой набор данных в ответе:

{ "update_id": 21406673, "message": { "message_id": 24, "from": { "id": 701891111, "is_bot": false, "first_name": "aleksei", "language_code": "ru" }, "chat": { "id": 701891111, "first_name": "aleksei", "type": "private" }, "date": 1580672814, "text": "/help", "entities": [ { "offset": 0, "length": 5, "type": "bot_command" } ] } }

Нас интересует часть с текстом сообщения. В данном случае видно, что я отправил боту «/help». Естественно он пока ничего не отвечает.

Наличие в ответе entities говорит о том, что сообщение было воспринято ботом как команда (все, что начинается со слеша и пишется латиницей, — это для telegram команда)

Создаем контроллер. Это будет входная точка для запросов от telegram api, куда будут приходить обновления.

Для удобства я всю логику вынес в сервис MessageProcessor, куда передаю строку, полученную от telegram.

Смысл прост — есть 4 команды: help, start, stop, report.

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

На каждую команду есть свое поведение.

Также есть 2 ситуации, когда ответ будет говорить пользователю, что данное действие запрещено в данный момент (пока трекер времени не остановлен — нельзя начать новый. Соответственно — пока нет активного, остановить тоже ничего нельзя).

Я добавил такие сущности:

    • User, у которого есть поля name, telegramId и коллекция timeLines,
    • TimeLine, у которой есть дата начала и дата конца: startedAt, stopedAt.

То есть user может иметь несколько timelines (у которых есть время старта и время остановки).

Нам приходит json строка, первое что я делаю — это декодирую строку и получаю объект:

$response = \json_decode((string)$telegramUpdate);

Дальше проверяю есть ли такой пользователь в базе (данные о пользователе, написавшем боту берутся из response->message->from). Если пользователя нет — создаем.

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

$messageText = mb_strtolower($response-&gt;message-&gt;text); $messageText = str_replace([&rsquo;\\&rsquo;, &rsquo;/&rsquo;], &rsquo;&rsquo;, $messageText);

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

$messageCommand = $this-&gt;isSupports($messageText) ? $messageText : false;

Если это команды start или stop — создаем TimeLine для этого пользователя или завершаем текущий соответственно и сообщаем пользователю об этом.

Если это report — подсчитываем время во всех timeline за сегодня и отправляем суммарное количество часов и минут пользователю.

Сообщения отправляется методом sendMessage, который принимаем массив параметров. Обязательные параметры: ’chat_id’ и ’text’. Полный список команд можно посмотреть здесь .

Так как это тестовый пример, я ограничился простым switch / case для выбора команд.

switch ($messageCommand) { case self::HELP_COMMAND : $this->bot->sendMessage(['chat_id' => $user->getTelegramId(), 'text' => self::ANSWERS[self::HELP_COMMAND]]); break; case self::START_COMMAND : if ($this->timelineService->doesActiveExist($user)) { $this->bot->sendMessage(['chat_id' => $user->getTelegramId(), 'text' => self::BAD_ANSWERS['existNotStoppedTimeLine']]); break; } $this->telegramService->startTimeForUser($user); $this->bot->sendMessage(['chat_id' => $user->getTelegramId(), 'text' => self::ANSWERS[self::START_COMMAND]]); break; case self::STOP_COMMAND : if ($this->timelineService->doesActiveExist($user)) { $this->bot->sendMessage(['chat_id' => $user->getTelegramId(), 'text' => self::ANSWERS[self::STOP_COMMAND]]); break; }; $this->bot->sendMessage(['chat_id' => $user->getTelegramId(), 'text' => self::BAD_ANSWERS['timeLineNotFound']]); break; case self::REPORT_COMMAND : $timeForToday = $this->timelineService->getTodayTotalByUser($user); $this->bot->sendMessage(['chat_id' => $user->getTelegramId(), 'text' => \sprintf(self::REPORT_COMMAND, $timeForToday)]); break; default: $this->bot->sendMessage(['chat_id' => $user->getTelegramId(), 'text' => self::ANSWERS[self::HELP_COMMAND]]); }

Общий вид сервиса:

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

Вывод

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

Вам также может понравиться
Базовое понимание Oauth 2.0
Функция распознавания образов в приложении: как и для чего применять
Заглянем под капот Doctrine 2

  • web-development ,
  • PHP

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

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