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

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


Сайдбар

Розділи

Загальний опис
Історія змін
Рекомендації до оновлення
Плани на майбутнє
Відомі проблеми
Онлайн демо
Допомога проекту
Люди
Трохи про безпеку

FAQ



Редагувати сайдбар

senddog

Це стара версія документу!


Собака-посилака

Собака-посилака є штатною підсистемою абстракції та розсилання повідомлень. На даний момент вона підтримує посилку SMS, Telegram та 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)

Якщо вашого улюбленого сервісу немає у цьому списку, завжди на замовлення можна дописати його підтримку. Не складно, не довго, дорого. Звертайтесь.

Ввімкнення

Собака-посилака вмикається наступною опцією alter.ini:

alter.ini
SENDDOG_ENABLED=1

та працює при відповідному виклику з remote API:

*/5 * * * *     /bin/ubapi "senddog"

Налаштування та використання

Ви справді думаєте, що для цього потрібна документація? =)

У випадку, якщо ви не плануєте використовувати всі підтримувані сервіси одночасно (а очевидно, що це так) ви можете вимкнути всі непотрібні вам, просто перерахувавши налаштовані та використовувані вами сервіси через кому у відповідній опції alter.ini, наприклад, якось так:

alter.ini
SENDDOG_SMS_SERVICES_ENABLED="tsms,tsmshttp"

Продвинутая собака-посылака

Существенно отличается от стандартной интерфейсом.

А так же привносит возможность “раутинга” СМС сообщений путем назначения каждому пользователю предпочитаемого СМС сервиса.

В данный момент маршрутизация поддерживается SMSZill'ой в направлении “Интернет” и модулем EasySMS. Модуль Reminder функционал раутинга пока не поддерживает. Но в скором будущем все обязательно изменится. так же вполне себе поддерживает.

Также “продвинутая собака” отдельно реализует поддержку следующих сервисов

  • AlphaSms
  • LifeCell
  • Mobipace
  • SkySms
  • SmsPilot
  • GradwellSms
  • SmsClubMobi
  • RedSms
  • SmsFly
  • SmsFly API2
  • TurboSms

Ответственный за разработку этой реализации вот этот милорд.

Включение продвинутой собаки-посылаки

Продвинутая собака-посылака включается следующими опциями 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

Единственное что следует заметить - для отсылки при помощи Telegram пользовательские Chat ID можно получить из “контактов бота Telegram” (да, это иконка с лупой). Они там появятся, только после того как пользователь сам первый что-либо напишет боту в приват. Так устроена защита от спама в этом мессенджере. Мы считаем, что это очень круто.

senddog.1675176588.txt.gz · Востаннє змінено: 2023/01/31 16:49 повз nightfly