Ubilling Wiki

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

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

Відвідано:
ubillingtelegram

Розбіжності

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

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

Наступна ревізія 		Попередня ревізія
ubillingtelegram [2022/09/24 14:39]
127.0.0.1 зовнішнє редагування 		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);
-// либо принудительно выставить при помощи публичного метода setToken, например так:+// або примусово виставити за допомогою публічного методу setToken, наприклад так:
 $telegram->setToken($botToken); $telegram->setToken($botToken);
-// мы можем получить список контактов, ранее писавших боту либо в чаты в которые он приглашен+// ми можемо отримати список контактів, які раніше писали боту або в чати, в які він запрошений
 $botContacts = $telegram->getBotContacts(); $botContacts = $telegram->getBotContacts();
 debarr($botContacts); debarr($botContacts);
  
-// Также мы можем поместить сообщение в очередь для дальнейшей посылки собакой-посылакой для одного из этих chatid. +// Також ми можемо помістити повідомлення в чергу для подальшого надсилання собакою-посилакой для одного з цих chatid. 
-// Рекомендуется использовать этот метод в ваших модулях.+// Рекомендується використовувати цей метод у ваших модулях.
 $chatId = '-1001070840004'; $chatId = '-1001070840004';
-$telegram->sendMessage($chatId, 'это тестовое сообщение', false, 'SAMPLEMODULE');+$telegram->sendMessage($chatId, 'це тестове повідомлення', false, 'SAMPLEMODULE');
  
-// Далее, если потребуется мы можем работать с очередью сообщений. +// Далі, якщо буде потрібно, ми можемо працювати з чергою повідомлень. 
-// например получить количество сообщений ожидающих отправки+// наприклад отримати кількість повідомлень, які очікують на відправлення
 $queueCount=$telegram->getQueueCount(); $queueCount=$telegram->getQueueCount();
 deb($queueCount); deb($queueCount);
  
-//или содержимое этой очереди в виде массива+//або вміст цієї черги у вигляді масиву
 $queueData=$telegram->getQueueData(); $queueData=$telegram->getQueueData();
 debarr($queueData); debarr($queueData);
  
-//также нам никто не запрещает почитать какие же приватные или сообщения канала получал бот:+//Також нам ніхто не забороняє почитати, які ж приватні або повідомлення каналу отримував бот:
 $botChats=$telegram->getBotChats(); $botChats=$telegram->getBotChats();
 debarr($botChats); debarr($botChats);
  
-// Если нам требуется отправка сообщения от имени бота отличного от настроенного в собаке-посылаке, +// Якщо нам потрібне надсилання повідомлення від імені бота, відмінного від налаштованого в собаці-посилаці, 
-// мы можем принудительно инициализировать посылку сообщения в обход очереди при помощи публичного метода "прямо щас"+// ми можемо примусово ініціалізувати надсилання повідомлення в обхід черги за допомогою публічного методу "прямо зараз"
 $telegram->directPushMessage($chatId, 'это тоже тестовое сообщение посланное напрямую'); $telegram->directPushMessage($chatId, 'это тоже тестовое сообщение посланное напрямую');
 </code> </code>
  
  
-Также в Ubilling 1.0.2 появилась возможность включить режим отладки, чтобы видеть запросы и ответы на них от сервера API:+Також є можливість увімкнути режим налагодження, щоб бачити запити і відповіді на них від сервера API:
 <code php> <code php>
 $telegram->setDebug(true); $telegram->setDebug(true);
Рядок 45: Рядок 45:
  
  
-А также отсылать данные о местонахождении контактам вашего бота. Пример:+А також відсилати дані про місцезнаходження контактам вашого бота. Приклад:
 <code php> <code php>
-$testText = 'sendLocation:50.45093260638449, 30.52267174950622'; // да, формат сообщения "sendLocation:координаты"+$testText = 'sendLocation:50.45093260638449, 30.52267174950622'; // так, формат повідомлення "sendLocation:координати"
 $telegram->sendMessage($chatid, $testText); $telegram->sendMessage($chatid, $testText);
 </code> </code>
  
-А можно не просто данные о местонахождении, а также с заголовком и адресом:+А можна не просто дані про місцезнаходження, а також із заголовком і адресою:
 <code php> <code php>
 $message='title:{Налаштувати роутер}address:(Де бабайко каже надобраніч)sendVenue:[50.45093260638449, 30.52267174950622]'; $message='title:{Налаштувати роутер}address:(Де бабайко каже надобраніч)sendVenue:[50.45093260638449, 30.52267174950622]';
Рядок 57: Рядок 57:
 </code> </code>
  
-Да, все поля и формат скобочек строго обязательны.+Так, усі поля і формат дужок суворо обов'язкові.
  
-А еще начиная с 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}';
  $telegram->directPushMessage($chatid, $message);  $telegram->directPushMessage($chatid, $message);
 </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('кнопка раз', 'кнопка поруч');
         $buttonsArray[] = array('кнопка внизу');         $buttonsArray[] = array('кнопка внизу');
                  
         $keyboard = $telegram->makeKeyboard($buttonsArray, false, true, true);         $keyboard = $telegram->makeKeyboard($buttonsArray, false, true, true);
-        $telegram->directPushMessage($chatid, 'Здесь клавиатура вылезла!', $keyboard);+        $telegram->directPushMessage($chatid, 'Тут клавіатура вилізла!', $keyboard);
 </code>  </code> 
  
-Принудительно ее убить можно в свою очередь, используя сообщение, содержащее текст вида "removeKeyboard:тут текст сообщения"+Примусово її вбити можна зі свого боку, використовуючи повідомлення, що містить текст вигляду "removeKeyboard:тут текст повідомлення"
  
 <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.1664019551.txt.gz · Востаннє змінено: 2022/09/24 14:39 повз 127.0.0.1

Налаштування сторінки

Donate Powered by PHP Valid HTML5 Valid CSS Driven by DokuWiki