Интеграция с TVIP TMS и TVIP media

Skip to end of metadata
Go to start of metadata

Заведение оборудования

Время выполнения инструкции: до 5 минут

Для настройки IPTV нужно:

Шаг 1. Создать сервер IPTV  в разделе оборудования, вкладка IPTV

IP-адрес - любой, например 1.1.1.1
IP важен только для [Ministra]


Примечание: Стандартная схема OSS зависит от IPTV портала. В данном случае схема выбрана для TITV!

Шаг 2. На вкладке Дополнительно ставим опцию "Передавать пароль в скрипт событий"

Шаг 3. Переходим в управление  и нажимаем Сохранить где указан каталог управления. Затем В "шаг 1 Инициализация" выполняем все кнопки последовательно

Шаг 4. Переходим на вкладку Настройка и обновляем список файлов

Шаг 5. В main.ini прописываем данные для вашего IPTV

TVIP TMS и TVIPmedia

При создании нового NAS в «Стандартной схеме OSS» нужно выбрать «TVIPmedia». Заполните параметры сервиса в файле main.ini следующим образом:

  • Обязательные опции
    • url - адрес доступа в личный кабинет администратора. Например, для TVIP Media это скорей всего будет https://my.tvip.media/, для прочих сервисов на платформе TVIP TMS ссылка будет другой.
    • username - логин от администраторского личного кабинета
    • password - пароль от администраторского личного кабинета
    • provider - id провайдера (необходимо уточнить у TVIPmedia)
  • Необязательные опции
    • delete_not_existing - включение/отключение проверки пользователей на портале TVIPmedia. Если поставить 1, то пользователи, которые есть на портале, но которых нет в биллинге, будут удаляться. По умолчанию — 0.

После этого обязательно нужно нажать кнопку "Сохранить" сразу под полем, в которое вносились изменения.

Ограничение запросов к API поставщика услуг

В файле main.ini необходимо добавить параметр sync_minutes (по умолчанию значение параметра равно 60, единица измерения - 1 минута). Данный параметр задает период ожидания между синхронизациями IPTV OSS, другими словами, регулирует частоту отправки API-запросов на портал поставщика. У некоторых поставщиков услуг IPTV есть ограничение на кол-во API-запросов к их серверу. Чтобы не выходить за рамки данных ограничений, рекомендуется увеличить параметр sync_minutes таким образом, чтобы период ожидания увеличился с 60 минут до 24 часов или 7 суток. После этого необходимо перезапустить обработчик синхронизаций:

chroot /app/asr_billing
service oss restart

Создание услуг IPTV

Время выполнения инструкции: от 5 минут, 1-2 минуты на каждую услугу, 1-2 минуты на создание шаблона сообщения

Для подключения сервиса IPTV абоненту, рекомендуется подключить как минимум две услуги:

  • Первая: создание учетной записи
    В настройках услуги создания учётной записи для сервиса LifeStream нужно указать буквенный префикс логина для исключения возможного совпадения логинов в системе LifeStream.
  • Вторая: подключение пакетов телевидения

Услуг, подключающих пакеты ТВ может быть несколько.

  • Услуга создания учётной записи должна быть в единственном экземпляре для каждого сервиса IPTV: одна для 24часаТВ, одна для Смотрёшки и тд
  • Если не делать отдельную услугу, создающую учетную запись IPTV, она все равно будет создана синхронизатором в течение 10 минут после подключения услуги с пакетом ТВ

Добавление услуги, подключающей пакеты телевидения

Создайте услугу с типом "IP телевидение" по статье документации "Услуги". Настройте в ней следующие опции:

  1. Вкладка "Основные". Опции:
    • Вид сервиса: IPTV;
    • Название: любое, соответствующее пакету TV выбранного оператора



  2. Вкладка "Дополнительно". Опции:
    • Строка с дополнительными параметрами по активации/деактивации: ID пакета телевидения, список пакетов уточните у оператора IPTV



  3. Вкладка "Личный кабинет". Опции:
    • Разрешить заказ через веб-интерфейс и Разрешить отключать через ЛК: параметры, позволяющие абоненту самостоятельно управлять подключением пакетов телевидения



Добавление услуги, создающей учетную запись на портале телевидения

Создайте услугу с типом "IP телевидение" по статье документации "Услуги". Настройте в ней следующие опции:

  1. Вкладка "Основные". Опции:
    • Вид сервиса: IPTV;
    • Название: любое,  например "Учетная запись IPTV"
    • Бесплатный пакет IPTV: необходимая опция для работы услуги создания учетной записи:
      • в схеме LifeStream услуги с этой опцией не синхронизируются как пакеты IPTV
      • в схеме MEGOGO услуги с опцией не отображаются как возможные для заказа на промо-странице



  2. Вкладка "Дополнительно".
    • Строка с дополнительными параметрами по активации/деактивации: оставьте пустыми;
    • NAS: выберите NAS соответствующего IPTV сервиса
    • Создавать учетную запись при подключении: включите;
    • Количество учетных записей: в зависимости от специфики работы Вашего IPTV, минимум одна;
    • Использовать цифровой пароль при создании учетной записи: включении этой опции не обязательно, но может быть полезно для сервисов настраиваемых на ТВ-приставках


  3. Вкладка "Личный кабинет". Опции:
    • Разрешить заказ через веб-интерфейс: включите, чтобы абонент сам мог создать себе учетную запись;
    • Разрешить отключать через ЛК: отключите, чтобы  абонент случайно не создал себе множество учетных записей



Отправка сообщения абоненту о создании учетной записи

Создайте шаблон с типом сообщения "Создание учетной записи из услуги" по статье "Система отправки сообщений" как показано на изображении ниже:

Для передачи логина и пароля новой учетной записи, используйте переменные user_login и user_psw. Например:
Реквизиты учетной записи: логин %(user_login)s, пароль %(user_psw)s. Используйте их для идентификации в портале IPTV

В настройках шаблона сообщений должна быть отключена опция "Использовать шаблонизатор django"


Если несколько сервисов телевидения, как правильно настроить?

Если в биллинг интегрировано более 1 сервиса IPTV одновременно (например, Lifestream + IPTVPortal) - смс будет отправляться по любому событию создания учетной записи.
В этом случае абонент может получить логин и пароль от второго сервиса.

Как решить

  1. Добавьте в личном кабинете страницу с данными доступа к IPTV
  2. В СМС отправляйте текст общего характера, например: "Реквизиты учетной записи IPTV находятся в личном кабинете".

Отладка

Лог интеграции с сервисом:

tail /app/asr_billing/var/log/nas_event_daemon/tvipmedia.log

Найти возникшие ошибки можно командой grep, например:

grep -i err /app/asr_billing/var/log/nas_event_daemon/tvipmedia.log

Сервер TVIP TMS вернул 401 статус (Unauthorized Error). Необходимо проверить логин и пароль в main.ini

Это ошибка basic авторизации на API. Она может возникнуть в двух случаях:

  • Логин или пароль в main.ini указаны неверно
  • Доступ отключен поставщиком

Неверный логин или пароль

  1. Исправьте данные авторизации в main.ini
  2. Перезапустите синхронизатор OSS:
    chroot /app/asr_billing service oss restart

Доступ к платформе отключен

Если Вы уверены, что логин и пароль правильные, то возможно отключена платформа TMS. Обратитесь в поддержку TVIP.

Введите метки, чтобы добавить к этой странице:
Please wait 
Ищите метку? просто начните печатать.