API UbillingTelegram

Ubilling предоставляет удобную модель абстракции, для работы с сообщениями бота Telegram. Начиная со стабильного релиза Ubilling 0.8.0 вы можете использовать базовый класс UbillingTelegram для посылки, приема и чтения сообщений принятых ботом. Для посылки сообщений требуется токен заранее созданного бота и включенная и настроенная подсистема собаки-посылаки.

API базового класса UbillingTelegram пытается повторять работу UbillingSMS и быть максимально простым для понимания. Также вы можете одновременно работать с несколькими ботами, создав для каждого из них по экземпляру класса, либо на-ходу переключая их токены. Рассмотрим работу с ботом на простом примере:

$botToken = '123456:ABC-DEF1234ghIkl-zyx57W2v1u123ew11';
// мы можем передавать токен нашего бота либо в конструкторе класса
$telegram = new UbillingTelegram($botToken);
// либо принудительно выставить при помощи публичного метода setToken, например так:
$telegram->setToken($botToken);
// мы можем получить список контактов, ранее писавших боту либо в чаты в которые он приглашен
$botContacts = $telegram->getBotContacts();
debarr($botContacts);
 
// Также мы можем поместить сообщение в очередь для дальнейшей посылки собакой-посылакой для одного из этих chatid.
// Рекомендуется использовать этот метод в ваших модулях.
$chatId = '-1001070840004';
$telegram->sendMessage($chatId, 'это тестовое сообщение', false, 'SAMPLEMODULE');
 
// Далее, если потребуется мы можем работать с очередью сообщений.
// например получить количество сообщений ожидающих отправки
$queueCount=$telegram->getQueueCount();
deb($queueCount);
 
//или содержимое этой очереди в виде массива
$queueData=$telegram->getQueueData();
debarr($queueData);
 
//также нам никто не запрещает почитать какие же приватные или сообщения канала получал бот:
$botChats=$telegram->getBotChats();
debarr($botChats);
 
// Если нам требуется отправка сообщения от имени бота отличного от настроенного в собаке-посылаке,
// мы можем принудительно инициализировать посылку сообщения в обход очереди при помощи публичного метода 
$telegram->directPushMessage($chatId, 'это тоже тестовое сообщение посланное напрямую');
ubillingtelegram.txt · Последние изменения: 2016/11/27 04:45 — nightfly
 
За исключением случаев, когда указано иное, содержимое этой вики предоставляется на условиях следующей лицензии: CC Attribution-Share Alike 3.0 Unported
Recent changes RSS feed Donate Powered by PHP Valid XHTML 1.0 Valid CSS Driven by DokuWiki