Jak na notifikační e-maily o IPTV kanálech

Pokud je v textu chyba či Vám schází nějaké informace, informujte nás na support@cibs.cz, jako předmět uveďte název článku.

Přehled použitých pojmů

Termín	Popis
CP	CIBS partner - vlastník licence CIBS dle licenční smlouvy nebo pronájemce CIBS
SelfCare	zákaznické rozhraní CIBS

Zpět na obsah: Jak na notifikační e-maily o IPTV kanálech

---

Význam

Funkcionalita, která je popsaná v této dokumentaci nalezne praktické uplatnění v souvislosti balíčků u IPTV služeb. Systém u tříd služeb, které mají IPTV složku [Kódovaná TV (Antik), IPTV, Triple Play, Dual Play: internet + IPTV, Dual Play: data + IPTV] umožňuje posílat notifikační e-maily. Tyto notifikace jsou zasílány koncovým zákazníkům za předpokladu, že má uveden validní e-mail a má zároveň povolen komunikační kanál typu e-mail. Notifikace jsou dvojího typu: Notifikace změny služby prostřednictvím CRM systému (settopboxu) a Periodická notifikace o stavu IPTV kanálů. V notifikacích lze doplnit informaci o programových tipech.

Zpět na obsah: Jak na notifikační e-maily o IPTV kanálech

---

Notifikace změny služby prostřednictvím CRM systému (settopboxu)

První typ notifikace je zasílán v případech, kdy si koncový zákazník přes STB aktivuje/deaktivuje IPTV kanál (zavislá služba třídy IPTV pod bázovou v určité skupině služeb).

Notifikace je podmíněna nastavením NOTIFY.SERVICES_DEP.CHANGE.CCC.SSS (domluvte si se supportem):

• CCC je třída služby. Pokud je nastaveno *, platí toto nastavení pro všechny třídy služeb.
• SSS je skupina služby. Pokud je nastaveno *, platí toto nastavení pro všechny skupiny služeb.

Priority jsou tyto (první řádek je největší priorita):

• CCC.SSS
• CCC.*
• *.SSS

Hodnotou nastavení je šablona, která se použije pro notifikaci. Příklad: NOTIFY.SERVICES_DEP.CHANGE.14.*, hodnota 'notify_stb': notifikace proběhne pro služby třídy 14 - IPTV bez ohledu na zařazení do skupin, použita bude šablona s názvem notify_stb.

CIBS partner si vytvoří vlastní šablonu typu Předmět e-mailu (uživatelský) a Text e-mailu (uživatelský) se shodným názvem a tento název sdělí supportu a zároveň definuje, pro jaké třídy služeb a případně skupiny služeb šablona platí.

Obsahem šablony může být třeba vzorový text, který může obsahovat následující proměnné:

• %SA_ID - ID aktivované závislé služby.
• %SA_NAME - název aktivované závislé služby.
• %PRICE - cena s ohledem na ceny dle definice závislosti typu 'Návazné volitelné služby zdarma', viz (Jak na nastavení TV balíčků obsahující kanály zdarma).
• Všechny parametry služby, ve tvaru %PARAM_NÁZEV_PARAMETRU.

Předmět: Objednání/Odebrání kanálu Tělo:

Vážený zákazníku,

právě jste si aktivoval/deaktivoval kanál %SA_NAME v ceně %PRICE Kč. Cena je účtována měsíčně za poměrnou část od okamžiku aktivace do konce měsíce/od začátku měsíce do okamžiku deaktivace.

%PARAM_CHANNEL.SUGGESTION

%PARAM_CHANNELS_OTHER.SUGGESTION

Pozn.: část programových tipů se zobrazuje na základě definice.

Kontrolní mechanismy při objednání kanálu

• CrmSubscribeOffer.NotLoggedIn: Uživatel nepřihlášen.
• CrmSubscribeOffer.NotDependantService: Tuto službu nelze aktivovat. Služba SN_CODE = %SN_CODE neexistuje nebo není definována jako závislá služba.
• CrmSubscribeOffer.NoBaseService: Nelze přes jednotku dohledat bázovou službu, u které mělo dojít k aktivaci závislé služby.
• CrmSubscribeOffer.DependencyCheckResul: Službu %SN_NAME_DEP nelze aktivovat vzhledem k restrikcím (závislou službu nelze aktivovat k bázové službě %SA_NAME_BASE).
• CrmSubscribeOffer.NotNodeId: Nelze dohledat jednotku, na které by mohla být bázová služba aktivována.
• CrmSubscribeOffer.NoActivateDepService: Nepodařilo se aktivovat závislou službu.
• CrmSubscribeOffer.PortaxError: Nelze najít technika provisioningu, skupinu provisioningu nebo typ procesu.
• CrmSubscribeOffer.NoProcessCreate: Nepodařilo se vytvořit proces.

Kontrolní mechanismy při odebrání kanálu

• CrmUnsubscribeOffer.NotLoggedIn: Uživatel nepřihlášen.
• CrmUnsubscribeOffer.NoBaseService: Nelze přes jednotku dohledat bázovou službu, u které mělo dojít k ukončení závislé služby.
• CrmUnsubscribeOffer.NotDepService: Službu s kódem %SN_CODE nemá uživatel aktivovanou.
• CrmUnsubscribeOffer.NotNodeId: Nelze dohledat jednotku, na které by mohla být bázová služba %SA_NAME_BASE (%SA_ID_BASE) odebrána.
• CrmUnsubscribeOffer.ErrorDateCancel: Službu %SA_NAME_DEP (%SA_ID_DEP) nelze ukončit v den aktivace.
• CrmUnsubscribeOffer.NoCancelService: Službu %SA_NAME_DEP %SA_NAME_BASE se nepodařilo ukončit.
• CrmUnsubscribeOffer.NoPriceChange: Nelze nastavit cenu služby %SA_NAME_BASE (%SA_ID_BASE) s návazností "Návazně volitelné služby zdarma"
• CrmUnsubscribeOffer.PortaxError: Nelze najít technika provisioningu, skupinu provisioningu nebo typ procesu.
• CrmUnsubscribeOffer.NoProcessCreate: Nepodařilo se vytvořit proces.

Zpět na obsah: Jak na notifikační e-maily o IPTV kanálech

---

Periodická notifikace o stavu IPTV kanálů

Druhý typ notifikace je zasílán periodicky n-dní před koncem měsíce a to pouze v určité dny (např. úterý, středa, čtvrtek). Pokud např. n-tý den připadne na Po, Pá, So, Ne nebo státem uznaný svátek, tak se notifikace přesouvá na nejbližší povolený den dopředu. Například 5 dní před koncem měsíce je pondělí, email se odešle dříve, ve čtvrtek (v příkladu jsou povoleny notifikace pouze ve dnech út, st, čt).

Notifikace je podmíněna nastavením (domluvte si se supportem):

• 'NOTIFY.SERVICES_DEP.MONTHLY.DAY' - den v měsíci, kdy se má spustit - např. 5 dní před koncem měsíce se zadá jako -5
• 'NOTIFY.SERVICES_DEP.MONTHLY.WEEKDAYS' - dny v týdnu, pro které se může generování provést (čárkou oddělený seznam). Hodnoty 1=neděle, 2=pondělí, 3=úterý, ... 7=sobota
• 'NOTIFY.SERVICES_DEP.MONTHLY.WORKDAY_ONLY' - omezení pouze na pracovní dny 1-pouze pracovní, 0 nebo nenastaveno-bez omezení
• 'NOTIFY.SERVICES_DEP.MONTHLY.CLASS' - třída bázové služby, která se má notifikovat. Více tříd se specifikuje jako čárkou oddělený seznam ID tříd. Pokud hodnota není zadána, tak se jedná o všechny třídy
• 'NOTIFY.SERVICES_DEP.MONTHLY.SERVICE_GROUP' - skupina služeb, čárkou oddělená ID skupin služeb. Pokud není zadáno, tak se jedná o všechny skupiny
• 'NOTIFY.SERVICES_DEP.MONTHLY.TEMPLATE' - název šablony, která se použije k notifikaci
• 'NOTIFY.SERVICES_DEP.MONTHLY.ENABLED' - nastavení, zda jsou automatické notifikace pro lokaci zapnuty

CIBS partner si vytvoří vlastní šablonu typu Předmět e-mailu (uživatelský) a Text e-mailu (uživatelský) se shodným názvem a tento název sdělí supportu a zároveň definuje ostatní parametry pro nastavení.

Obsahem šablony může být třeba vzorový text, který může obsahovat následující proměnné:

• %SA_ID - ID aktivované závislé služby
• %SA_NAME - název aktivované závislé služby
• %PRICE - cena s ohledem na ceny dle definice závislosti typu 'Návazné volitelné služby zdarma', viz (Jak na nastavení TV balíčků obsahující kanály zdarma).
• Všechny parametry služby, ve tvaru %PARAM_NÁZEV_PARAMETRU.

Předmět: Měsíční shrnutí stavu kanálů Tělo:

Vážený zákazníku,

v současné době máte aktivovány následující kanály: {BLOCK_REC_START}%SA_NAME{BLOCK_REC_END}

{BLOCK_REC_START}
%SA_NAME

%PARAM_CHANNEL.SUGGESTION
{BLOCK_REC_END}

Pozn.: část programových tipů se zobrazuje na základě definice.

Zpět na obsah: Jak na notifikační e-maily o IPTV kanálech

---

Programový tip pro daný kanál a Programové tipy pro příbuzné kanály

Pro oba způsoby notifikace lze navíc definovat programové tipy. Definice se provádí v modulu Produkty a služby. Parametry se jmenují 'Programový tip pro daný kanál' a 'Programové tipy pro příbuzné kanály'. Jsou k dispozici u tříd služeb, které mají IPTV složku [Kódovaná TV (Antik), IPTV, Triple Play, Dual Play: internet + IPTV, Dual Play: data + IPTV] a slouží pro informování koncových zákazníků o programových tipech. Parametry byly vytvořeny v souvislosti funkcionality Jak na nastavení TV balíčků obsahující kanály zdarma, ale je možné je používat obecně.

Každé IPTV službě je možné definovat HTML obsah tipů kanálu, který může mít např. následující strukturu:

Nepropásněte na vašem kanálu: (pro 'Programový tip pro daný kanál') / Mohlo by se vám líbit: (pro 'Programové tipy pro příbuzné kanály')
Název programu
Typ (pro daný kanál, pro související kanál)
Kanál
Obrázek
krátký text

V nadefinovaných šablonách (viz pokyny výše) lze uvést 'Programový tip pro daný kanál' proměnnou %PARAM_CHANNEL.SUGGESTION a 'Programové tipy pro příbuzné kanály' proměnnou %PARAM_CHANNELS_OTHER.SUGGESTION.

Zpět na obsah: Jak na notifikační e-maily o IPTV kanálech

---

Odkazující články

Jak na parametry služeb a produktů
Seznam nastavení e-mailových adres
[[Mango.PublishPluginHistory#CibsDocHowToNotifyIptvChannels][]]

Zpět na obsah: Jak na notifikační e-maily o IPTV kanálech

---