Тут показані розбіжності між вибраною ревізією та поточною версією сторінки.
Порівняння попередніх версій Попередня ревізія | Остання ревізія По сторонах наступні версії | ||
ubillingtelegram [2019/10/18 14:56] |
ubillingtelegram [2022/09/24 14:39] 127.0.0.1 зовнішнє редагування |
||
---|---|---|---|
Рядок 1: | Рядок 1: | ||
+ | ====== API UbillingTelegram ====== | ||
+ | Ubilling предоставляет удобную модель абстракции, | ||
+ | |||
+ | API базового класса UbillingTelegram пытается повторять работу [[ubillingsms|UbillingSMS]] и быть максимально простым для понимания. Также вы можете одновременно работать с несколькими ботами, | ||
+ | |||
+ | <code php> | ||
+ | $botToken = ' | ||
+ | // мы можем передавать токен нашего бота либо в конструкторе класса | ||
+ | $telegram = new UbillingTelegram($botToken); | ||
+ | // либо принудительно выставить при помощи публичного метода setToken, например так: | ||
+ | $telegram-> | ||
+ | // мы можем получить список контактов, | ||
+ | $botContacts = $telegram-> | ||
+ | debarr($botContacts); | ||
+ | |||
+ | // Также мы можем поместить сообщение в очередь для дальнейшей посылки собакой-посылакой для одного из этих chatid. | ||
+ | // Рекомендуется использовать этот метод в ваших модулях. | ||
+ | $chatId = ' | ||
+ | $telegram-> | ||
+ | |||
+ | // Далее, если потребуется мы можем работать с очередью сообщений. | ||
+ | // например получить количество сообщений ожидающих отправки | ||
+ | $queueCount=$telegram-> | ||
+ | deb($queueCount); | ||
+ | |||
+ | //или содержимое этой очереди в виде массива | ||
+ | $queueData=$telegram-> | ||
+ | debarr($queueData); | ||
+ | |||
+ | // | ||
+ | $botChats=$telegram-> | ||
+ | debarr($botChats); | ||
+ | |||
+ | // Если нам требуется отправка сообщения от имени бота отличного от настроенного в собаке-посылаке, | ||
+ | // мы можем принудительно инициализировать посылку сообщения в обход очереди при помощи публичного метода " | ||
+ | $telegram-> | ||
+ | </ | ||
+ | |||
+ | |||
+ | Также в Ubilling 1.0.2 появилась возможность включить режим отладки, | ||
+ | <code php> | ||
+ | $telegram-> | ||
+ | </ | ||
+ | |||
+ | |||
+ | А также отсылать данные о местонахождении контактам вашего бота. Пример: | ||
+ | <code php> | ||
+ | $testText = ' | ||
+ | $telegram-> | ||
+ | </ | ||
+ | |||
+ | А можно не просто данные о местонахождении, | ||
+ | <code php> | ||
+ | $message=' | ||
+ | $telegram-> | ||
+ | </ | ||
+ | |||
+ | Да, все поля и формат скобочек строго обязательны. | ||
+ | |||
+ | А еще начиная с Ubilling 1.0.5 можно устанавливать кастомную разметку для ваших сообщений. Например использовать HTML. Например так: | ||
+ | <code php> | ||
+ | | ||
+ | | ||
+ | </ | ||
+ | |||
+ | Начиная с Ubilling 1.0.9 также поддерживается посылка фоточек контактам бота. Формат посылки фоточек следующий: | ||
+ | <code php> | ||
+ | $message = ' | ||
+ | |||
+ | $telegram-> | ||
+ | </ | ||
+ | |||
+ | Начиная с Ubilling 1.1.4 вы можете использовать для ваших ботов кастомные клавиатуры. Для этого клавиатура собранная из массива при помощи **makeKeyboard** тупо отсылается при помощи **directPushMessage**. Как-то так: | ||
+ | <code php> | ||
+ | $buttonsArray[] = array(' | ||
+ | $buttonsArray[] = array(' | ||
+ | | ||
+ | $keyboard = $telegram-> | ||
+ | $telegram-> | ||
+ | </ | ||
+ | |||
+ | Принудительно ее убить можно в свою очередь, | ||
+ | |||
+ | <code php> | ||
+ | | ||
+ | </ |