Розбіжності

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

--- ubillingtelegram [2025/01/25 13:40] – nightfly
+++ 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';
@@ Рядок 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>
@@ Рядок 67: / Рядок 73: @@
 Формат надсилання фоточок наступний:
 <code php>
-$message = 'sendPhoto:[https://piclod.com/i/1737542661/kitty.jpg]{Це опціональний заголовок}';
+$message = 'sendPhoto:[https://piclod.com/i/1737542661/kitty.jpg]{Це необов`язковий текстовий заголовок}';
 $telegram->sendMessage($chatId, $message);
@@ Рядок 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>