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

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


senddog

Розбіжності

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

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

Порівняння попередніх версій Попередня ревізія
Попередня ревізія
Наступна ревізія По сторонах наступні версії
senddog [2018/11/23 10:59]
senddog [2023/01/31 16:49]
nightfly
Рядок 1: Рядок 1:
 +====== Собака-посилака ======
 +
 +Собака-посилака є штатною підсистемою абстракції та розсилання повідомлень. На даний момент вона підтримує посилку [[ubillingsms|SMS]], [[ubillingtelegram|Telegram]] та [[ubillingemail|Email]].\\
 +
 +Наразі вона, в своєму первозданному вигляді, з коробки підтримує наступні сервіси посилки SMS:
 +
 +  * TurboSMS SQL (tsms)
 +  * TurboSMS HTTP (tsmshttp)
 +  * SMS-Fly (smsflyapi2)
 +  * SMS-Fly API2 (smsfly)
 +  * RED-Sms (redsms)
 +  * SMSPILOT (smspilot)
 +  * Skyriver (skyriver)
 +  * Lifecell (lifecell)
 +  * AlphaSMS (alphasms)
 +  * Mobipace (mobipace)
 +  * BulkSMS.md (bulksms)
 +  * Notificore (notificoresms)
 +
 +Якщо вашого улюбленого сервісу немає у цьому списку, завжди на замовлення можна дописати його підтримку. Не складно, не довго, дорого. [[http://ubilling.net.ua/?module=fnpages&pid=ubpay|Звертайтесь]].
 +
 +====== Ввімкнення ======
 +Собака-посилака вмикається наступною опцією [[alteriniconf|alter.ini]]:
 +
 +<file ini alter.ini>
 +SENDDOG_ENABLED=1
 +</file>
 +
 +та працює при відповідному виклику з [[remoteapi|remote API]]:
 +<code bash>
 +*/5 * * * *     /bin/ubapi "senddog"
 +</code>
 +
 +====== Налаштування та використання ======
 +
 +Ви справді думаєте, що для цього потрібна документація? =) \\
 +
 +{{:senddog-new.png?|}}
 +
 +У випадку, якщо ви не плануєте використовувати всі підтримувані сервіси одночасно (а очевидно, що це так) ви можете вимкнути всі непотрібні вам, просто перерахувавши налаштовані та використовувані вами сервіси через кому у відповідній опції alter.ini, наприклад, якось так:
 +
 +<file ini alter.ini>
 +SENDDOG_SMS_SERVICES_ENABLED="tsms,tsmshttp"
 +</file>
 +
 +====== Продвинутая собака-посылака ======
 +
 +Существенно отличается от стандартной интерфейсом.
 +{{ :adv_sms_screen11.jpg?direct&300 |}}    
 +
 +А так же привносит возможность "раутинга" СМС сообщений путем назначения каждому пользователю предпочитаемого СМС сервиса.
 +{{ :adv_sms_screen22.jpg?direct&300 |}}
 +
 +В данный момент маршрутизация поддерживается [[smszilla|SMSZill'ой]] в направлении "Интернет" и модулем EasySMS. Модуль [[reminder|Reminder]] функционал раутинга <del>пока не поддерживает. Но в скором будущем все обязательно изменится.</del> так же вполне себе поддерживает.
 +
 +Также "продвинутая собака" отдельно реализует поддержку следующих сервисов
 +  * AlphaSms
 +  * LifeCell
 +  * Mobipace
 +  * SkySms
 +  * SmsPilot
 +  * GradwellSms
 +  * SmsClubMobi
 +  * RedSms
 +  * SmsFly
 +  * SmsFly API2
 +  * TurboSms
 +
 +Ответственный за разработку этой реализации вот [[http://ubilling.net.ua/?module=fnpages&pid=bobrpay|этот милорд]].
 +
 +====== Включение продвинутой собаки-посылаки ======
 +Продвинутая собака-посылака включается следующими опциями [[alteriniconf|alter.ini]]:
 +
 +<code ini>
 +SENDDOG_ENABLED=1
 +SMS_SERVICES_ADVANCED_ENABLED=1
 +</code>
 +
 +Как видим, требуется включение стандартной собаки-посылаки, поскольку продвинутая собака-посылака все же базируется на ней чуть более, чем полностью, и, соответственно, для обработки очереди СМС сообщений достаточно того же вызова из [[remoteapi|remote API]], который описан [[senddog#включение|парой абзацев выше]]. 
 +
 +Так же существует необязательная опция 
 +<code ini>
 +SMS_SERVICES_BINDINGS_CACHE_LIFETIME=1800
 +</code>
 +которая определяет таймаут для обновления кэша связей(да-да, речь идет именно о назначениях предпочитаемых СМС сервисов для различных сущностей, например интернет-пользователей, или сотрудников(в будущем) или ещё чего угодно) продвинутой собаки-посылаки. По умолчанию таймаут равен 1800 секунд или 30 минут. 
 +
 +Основная прелесть продвинутой собаки-посылаки(кроме раутинга, естественно) - возможность динамического добавления СМС сервисов путем складывания в **/api/vendor/sms_services_APIs** файлов реализации API СМС сервиса в виде PHP класса наследующего абстрактный класс **SMSServiceApi**. Что означает, что если поддержки <del>вашего любимого</del> необходимого вам СМС провайдера в Ubilling пока нет - добавить ее теперь стало относительно не сложно. \\
 +Так же это позволяет добавить, например, 2(или 3, или 10) **одинаковых** СМС сервиса с **различными** альфа-именами или учетными данными.
 +
 +
 +====== Telegram ======
 +Единственное что следует заметить - для отсылки при помощи [[ubillingtelegram|Telegram]] пользовательские Chat ID можно получить из "контактов бота Telegram" (да, это иконка с лупой). Они там появятся, только после того как пользователь сам первый что-либо напишет [[https://tlgrm.ru/docs/bots|боту]] в приват. Так устроена защита от спама в этом мессенджере. Мы считаем, что это очень круто.
  
senddog.txt · Востаннє змінено: 2023/01/31 16:59 повз nightfly