Розбіжності

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

--- ubillingtelegram [2023/06/16 17:49] – skybetik
+++ ubillingtelegram [2026/09/17 12:50] (поточний) – nightfly
@@ Рядок 1: / Рядок 1: @@
 ====== 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]] і бути максимально простим для розуміння. Також ви можете одночасно працювати з кількома ботами, створивши для кожного з них по екземпляру класу, або на-ходу перемикаючи їхні токени. Розглянемо роботу з ботом на простому прикладі:
 <code php>
-$botToken = '123456:ABC-DEF1234ghIkl-zyx57W2v1u123ew11';
+$botToken = '1234567890:EXAMPLEfakeToken1234567890ABCDXXXXX';
 // ми можемо передавати токен нашого бота або в конструкторі класу
 $telegram = new UbillingTelegram($botToken);
@@ Рядок 15: / Рядок 15: @@
 debarr($botContacts);
-// Також ми можемо помістити повідомлення в чергу для подальшого надсилання собакою-посилакой для одного з цих chatid.
+// Також ми можемо помістити повідомлення в чергу для подальшого надсилання собакою-посилакою для одного з цих chatid.
 // Рекомендується використовувати цей метод у ваших модулях.
 $chatId = '-1001070840004';
@@ Рядок 39: / Рядок 39: @@
-Також в Ubilling 1.0.2 з'явилася можливість увімкнути режим налагодження, щоб бачити запити і відповіді на них від сервера API:
+Також є можливість увімкнути режим налагодження, щоб бачити запити і відповіді на них від сервера API:
 <code php>
 $telegram->setDebug(true);
@@ Рядок 49: / Рядок 49: @@
 $testText = 'sendLocation:50.45093260638449, 30.52267174950622'; // так, формат повідомлення "sendLocation:координати"
 $telegram->sendMessage($chatid, $testText);
+</code>
+Аналогічно ніхто не забороняє нам, розміщати повідомлення для розсилки, не тільки від токена бота за замовчуванням, а і від будь якого іншого токена бота, просто вказавши його 5-м параметром в sendMessage
+<code php>
+$telegram->sendMessage($eachChatId, $messageText, false, 'SOMEMODULE', '0987654321:ANOTHERfakeToken1234567890ABCDXXXXX');
 </code>
@@ Рядок 59: / Рядок 65: @@
 Так, усі поля і формат дужок суворо обов'язкові.
-А ще починаючи з Ubilling 1.0.5 можна встановлювати кастомну розмітку для ваших повідомлень. Наприклад використовувати HTML. Наприклад так:
+А ще можна встановлювати кастомну розмітку для ваших повідомлень. Наприклад використовувати HTML. Наприклад так:
 <code php>
  $message='Просто текст <b>жирний текст</b> <a href="http://ubilling.net.ua">Посилання на сайт</a> parseMode:{html}';
@@ Рядок 65: / Рядок 71: @@
 </code>
-Починаючи з Ubilling 1.0.9 також підтримується надсилання фоточок контактам бота. Формат надсилання фоточок наступний:
+Формат надсилання фоточок наступний:
 <code php>
-$message = 'sendPhoto:[http://piclod.com/i/1592634849/CEYG67MWEAEsvwa.jpeg]{Це опціональний заголовок}';
+$message = 'sendPhoto:[https://piclod.com/i/1737542661/kitty.jpg]{Це необов`язковий текстовий заголовок}';
 $telegram->sendMessage($chatId, $message);
 </code>
-Починаючи з Ubilling 1.1.4 ви можете використовувати для ваших ботів кастомні клавіатури. Для цього клавіатуру, зібрану з масиву за допомогою **makeKeyboard**, тупо відсилають за допомогою **directPushMessage**. Якось так:
+Також ви можете використовувати для ваших ботів кастомні клавіатури. Для цього клавіатуру, зібрану з масиву за допомогою **makeKeyboard**, тупо відсилають за допомогою **directPushMessage**. Якось так:
 <code php>
         $buttonsArray[] = array('кнопка раз', 'кнопка поруч');
@@ Рядок 84: / Рядок 90: @@
 <code php>
- $telegram->directPushMessage($chatid, 'removeKeyboard:ой всё');
+ $telegram->directPushMessage($chatid, 'removeKeyboard:ой ну і добре');
 </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>