Користувальницькькі налаштування

Налаштування сайту


ubillingtelegram

Розбіжності

Тут показані розбіжності між вибраною ревізією та поточною версією сторінки.

Посилання на цей список змін

Порівняння попередніх версій Попередня ревізія
Наступна ревізія
Попередня ревізія
ubillingtelegram [2023/06/16 17:49]
skybetik
ubillingtelegram [2025/10/28 18:45] (поточний)
nightfly
Рядок 1: Рядок 1:
 ====== API UbillingTelegram ====== ====== API UbillingTelegram ======
  
-Ubilling надає зручну модель абстракції, для роботи з повідомленнями [[https://core.telegram.org/api|бота Telegram]]. Починаючи зі стабільного релізу Ubilling 0.8.0 ви можете використовувати базовий клас UbillingTelegram для надсилання, приймання та читання повідомлень, прийнятих ботом. Для надсилання повідомлень потрібен токен заздалегідь [[https://tlgrm.ru/docs/bots|створеного бота]] і ввімкнена та налаштована підсистема [[senddog|собаки-посилаки]]. Так, ви можете запросити бота у свою закриту групку або куди забажаєте.+Ubilling надає зручну модель абстракції, для роботи з повідомленнями [[https://core.telegram.org/api|бота Telegram]]. Починаючи зі стабільного релізу Ubilling 0.8.0 ви можете використовувати базовий клас UbillingTelegram для надсилання, приймання та читання повідомлень, прийнятих ботом. Для надсилання повідомлень потрібен токен заздалегідь [[tgbotfather|створеного бота]] і ввімкнена та налаштована підсистема [[senddog|собаки-посилаки]]. Так, ви можете запросити бота у свою закриту групку або куди забажаєте.
  
 API базового класу UbillingTelegram намагається повторювати роботу [[ubillingsms|UbillingSMS]] і бути максимально простим для розуміння. Також ви можете одночасно працювати з кількома ботами, створивши для кожного з них по екземпляру класу, або на-ходу перемикаючи їхні токени. Розглянемо роботу з ботом на простому прикладі: API базового класу UbillingTelegram намагається повторювати роботу [[ubillingsms|UbillingSMS]] і бути максимально простим для розуміння. Також ви можете одночасно працювати з кількома ботами, створивши для кожного з них по екземпляру класу, або на-ходу перемикаючи їхні токени. Розглянемо роботу з ботом на простому прикладі:
  
 <code php> <code php>
-$botToken = '123456:ABC-DEF1234ghIkl-zyx57W2v1u123ew11';+$botToken = '1234567890:EXAMPLEfakeToken1234567890ABCDXXXXX';
 // ми можемо передавати токен нашого бота або в конструкторі класу // ми можемо передавати токен нашого бота або в конструкторі класу
 $telegram = new UbillingTelegram($botToken); $telegram = new UbillingTelegram($botToken);
Рядок 39: Рядок 39:
  
  
-Також в Ubilling 1.0.2 з'явилася можливість увімкнути режим налагодження, щоб бачити запити і відповіді на них від сервера API:+Також є можливість увімкнути режим налагодження, щоб бачити запити і відповіді на них від сервера API:
 <code php> <code php>
 $telegram->setDebug(true); $telegram->setDebug(true);
Рядок 59: Рядок 59:
 Так, усі поля і формат дужок суворо обов'язкові. Так, усі поля і формат дужок суворо обов'язкові.
  
-А ще починаючи з Ubilling 1.0.5 можна встановлювати кастомну розмітку для ваших повідомлень. Наприклад використовувати HTML. Наприклад так:+А ще можна встановлювати кастомну розмітку для ваших повідомлень. Наприклад використовувати HTML. Наприклад так:
 <code php> <code php>
  $message='Просто текст <b>жирний текст</b> <a href="http://ubilling.net.ua">Посилання на сайт</a> parseMode:{html}';  $message='Просто текст <b>жирний текст</b> <a href="http://ubilling.net.ua">Посилання на сайт</a> parseMode:{html}';
Рядок 65: Рядок 65:
 </code> </code>
  
-Починаючи з Ubilling 1.0.9 також підтримується надсилання фоточок контактам бота. Формат надсилання фоточок наступний:+Формат надсилання фоточок наступний:
 <code php> <code php>
-$message = 'sendPhoto:[http://piclod.com/i/1592634849/CEYG67MWEAEsvwa.jpeg]{Це опціональний заголовок}';+$message = 'sendPhoto:[https://piclod.com/i/1737542661/kitty.jpg]{Це опціональний заголовок}';
  
 $telegram->sendMessage($chatId, $message); $telegram->sendMessage($chatId, $message);
 </code> </code>
  
-Починаючи з Ubilling 1.1.4 ви можете використовувати для ваших ботів кастомні клавіатури. Для цього клавіатуру, зібрану з масиву за допомогою **makeKeyboard**, тупо відсилають за допомогою **directPushMessage**. Якось так:+Також ви можете використовувати для ваших ботів кастомні клавіатури. Для цього клавіатуру, зібрану з масиву за допомогою **makeKeyboard**, тупо відсилають за допомогою **directPushMessage**. Якось так:
 <code php> <code php>
         $buttonsArray[] = array('кнопка раз', 'кнопка поруч');         $buttonsArray[] = array('кнопка раз', 'кнопка поруч');
Рядок 84: Рядок 84:
  
 <code php> <code php>
- $telegram->directPushMessage($chatid, 'removeKeyboard:ой всё');+ $telegram->directPushMessage($chatid, 'removeKeyboard:ой ну і добре');
 </code>  </code> 
 +
 +
 +Також можна банити та розбанювати користувачів в групових чатах:
 +
 +<code php>
 + $telegram->directPushMessage($groupId, 'banChatMember:[' . $memberId . '@' . $groupId . ']');
 +</code> 
 +
 +
 +<code php>
 + $telegram->directPushMessage($groupId, 'unbanChatMember:[' . $memberId . '@' . $groupId . ']');
 +</code> 
 +
 +Видаляти повідомлення
 +<code php>
 + $telegram->directPushMessage($chatId, 'removeChatMessage:[' . $messageId. '@' . $chatId. ']');
 +</code>
 +
 +
 +Редагувати власні
 +
 +<code php>
 + $telegram->directPushMessage($chatId, 'editMessageText:[' . $messageId. '@' . $chatId. ']новий текст повідомлення');
 +</code>
 +
ubillingtelegram.1686926978.txt.gz · Востаннє змінено: 2023/06/16 17:49 повз skybetik