Загальний опис
Історія змін
Рекомендації до оновлення
Плани на майбутнє
Відомі проблеми
Онлайн демо
Допомога проекту
Люди
Трохи про безпеку
FAQ
Це стара версія документу!
Собака-посылака представляет собой штатную подсистему абстракции и посылки сообщений. На данный момент, она поддерживает посылку SMS, Telegram и Email.
На даный момент, в своем первозданном виде, из коробки поддерживает следующие сервисы посылки SMS:
Если вашего любимого сервиса нет в этом списке, всегда под заказ можно дописать его поддержку. Не сложно, долго, дорого. Обращайтесь.
Собака-посылака включается следующей опцией alter.ini:
SENDDOG_ENABLED=1
и работает при соответствующем вызове из remote API:
*/5 * * * * /bin/ubapi "senddog"
Вы действительно думаете, что для этого требуется документация? 
В случае, если вы не планируете использовать все поддерживаемые сервисы одновременно (а очевидно, что это так) вы можете отключить все ненужные вам, просто перечислив сконфигурированные и используемые вами сервисы через запятую в соответствующей опции alter.ini, например, как-то так:
SENDDOG_SMS_SERVICES_ENABLED="tsms,tsmshttp"
Существенно отличается от стандартной интерфейсом.
А так же привносит возможность “раутинга” СМС сообщений путем назначения каждому пользователю предпочитаемого СМС сервиса.
В данный момент маршрутизация поддерживается SMSZill'ой в направлении “Интернет” и модулем EasySMS. Модуль Reminder функционал раутинга пока не поддерживает. Но в скором будущем все обязательно изменится. так же вполне себе поддерживает.
Также “продвинутая собака” отдельно реализует поддержку следующих сервисов
Ответственный за разработку этой реализации вот этот милорд.
Продвинутая собака-посылака включается следующими опциями alter.ini:
SENDDOG_ENABLED=1 SMS_SERVICES_ADVANCED_ENABLED=1
Как видим, требуется включение стандартной собаки-посылаки, поскольку продвинутая собака-посылака все же базируется на ней чуть более, чем полностью, и, соответственно, для обработки очереди СМС сообщений достаточно того же вызова из remote API, который описан парой абзацев выше.
Так же существует необязательная опция
SMS_SERVICES_BINDINGS_CACHE_LIFETIME=1800
которая определяет таймаут для обновления кэша связей(да-да, речь идет именно о назначениях предпочитаемых СМС сервисов для различных сущностей, например интернет-пользователей, или сотрудников(в будущем) или ещё чего угодно) продвинутой собаки-посылаки. По умолчанию таймаут равен 1800 секунд или 30 минут.
Основная прелесть продвинутой собаки-посылаки(кроме раутинга, естественно) - возможность динамического добавления СМС сервисов путем складывания в /api/vendor/sms_services_APIs файлов реализации API СМС сервиса в виде PHP класса наследующего абстрактный класс SMSServiceApi. Что означает, что если поддержки вашего любимого необходимого вам СМС провайдера в Ubilling пока нет - добавить ее теперь стало относительно не сложно.
Так же это позволяет добавить, например, 2(или 3, или 10) одинаковых СМС сервиса с различными альфа-именами или учетными данными.
Единственное что следует заметить - для отсылки при помощи Telegram пользовательские Chat ID можно получить из “контактов бота Telegram” (да, это иконка с лупой). Они там появятся, только после того как пользователь сам первый что-либо напишет боту в приват. Так устроена защита от спама в этом мессенджере. Мы считаем, что это очень круто.
