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

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


senddog

Розбіжності

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

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

Порівняння попередніх версій Попередня ревізія
Попередня ревізія
senddog [2018/11/15 16:39]
senddog [2023/01/31 16:59] (поточний)
nightfly [Telegram]
Рядок 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]].
 +
 +Також "просунутий собака" окремо реалізує підтримку наступних сервісів
 +
 +  * 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://core.telegram.org/bots|боту]]. Так влаштований захист від спаму в цьому месенджері. Ми вважаємо, що це дуже круто.