Preskočiť na obsah
Beta verzia novej dokumentácie. Prejsť na starú verziu
Domov Konektory Konektor pre SMS bránu

Konektor pre SMS bránu

Naposledy aktualizované

Konektor SMS slúži na odosielanie notifikácií z CDESK, CM formou SMS správ cez SMS bránu externého poskytovateľa. Kým konektor nie je pridaný a zapnutý, CDESK žiadne SMS neposiela, aj keď je spôsob SMS zvolený v nastaveniach notifikácií.

Konektor môže používať východziu SMS bránu, ktorú pre CDESK centrálne nastavil poskytovateľ CDESK, alebo vlastný účet vašej organizácie u niektorého z podporovaných poskytovateľov SMS brány. Text SMS sa pripraví zo šablóny notifikácie a CDESK ho odošle na mobilné čísla príjemcov.

Princíp fungovania konektora SMS
Obrázok: Princíp fungovania konektora SMS

Čo konektor umožňuje – zapnutý konektor SMS sprístupní spôsob doručenia SMS vo všetkých častiach CDESK, ktoré posielajú notifikácie. Konkrétne umožňuje:

  • SMS notifikácie k požiadavkám – riešiteľ, zadávateľ, kontakt a ďalší príjemcovia môžu dostať SMS pri udalostiach požiadavky podľa nastavení notifikácií.
  • SMS notifikácie ďalších modulov – SMS je možné posielať aj z ďalších modulov, napríklad pri úlohách, zmluvách, servisnej údržbe v CMDB alebo v chate, ak to nastavenia notifikácií daného modulu umožňujú.
  • SMS v pravidlách notifikácií – v pravidlách pre odosielanie notifikácií je možné vybrať šablónu SMS.
  • Výber brány – konektor môže použiť východziu bránu poskytovateľa CDESK alebo vlastný účet u podporovaného poskytovateľa SMS brány.
  • Evidenciu odoslaných SMS – každá odoslaná SMS sa zapíše do zoznamu „Odoslané SMS a CM E-Mail“ s výsledkom odoslania a počtom účtovaných SMS.
Poznámka

Konektor slúži len na odosielanie SMS notifikácií. Prijaté SMS nespracúva a požiadavky z nich nezakladá. Text SMS je obmedzený na 270 znakov a diakritika sa z neho odstraňuje.

Predpoklady

Pred nasadením konektora musia byť splnené tieto podmienky:

  • SMS brána – na použitie východzieho nastavenia musí mať poskytovateľ CDESK nastavenú a povolenú východziu SMS bránu. Na použitie vlastného nastavenia je potrebný účet u podporovaného poskytovateľa SMS brány.
  • Mobilné čísla príjemcov – používatelia musia mať vo svojom profile vyplnené mobilné číslo a kontakty v Adresári mobilný kontaktný údaj.
  • Oprávnenie – konektor môže pridať a upraviť používateľ s prístupom do Globálnych nastavení a s právom zápisu do nich.
  • Počet konektorov – v jednom prostredí CDESK môže existovať najviac jeden konektor typu SMS.

Príprava v externom systéme

Príprava v externom systéme je potrebná len v prípade, že chcete posielať SMS cez vlastný účet. Pri východzom nastavení zabezpečuje SMS bránu poskytovateľ CDESK a vy nič nepripravujete.

Pri vlastnom nastavení si u poskytovateľa SMS brány zriaďte účet a pripravte prístupové údaje podľa typu brány:

  • Brána služby smsbrana.cz – potrebujete prihlasovacie meno a heslo k rozhraniu služby.
  • Brána SMS API spoločnosti Slovak Telekom – potrebujete prístupový token rozhrania.

Postup zriadenia účtu a vydania prístupových údajov určuje poskytovateľ SMS brány. Odoslané SMS účtuje poskytovateľ brány podľa svojich podmienok.

Nastavenie konektora

Konektor sa pridáva v globálnych nastaveniach v zozname „Konektory do externých systémov“. Vo formulári sa určuje, či konektor použije východziu bránu, alebo vlastný účet u poskytovateľa SMS brány.

Pridanie konektora

Konektor sa pridáva v sprievodcovi pridaním konektora. Pri vlastnom nastavení si pred začatím pripravte prístupové údaje k bráne podľa časti Príprava v externom systéme. Konektor sa pridáva týmto postupom:

  1. Otvorte Globálne nastavenia → Konektory, API.
  2. V zozname „Konektory do externých systémov“ kliknite na tlačidlo Pridať konektor.
  3. V sprievodcovi „Pridanie konektora“ vyberte v poli Typ konektora hodnotu SMS.
  4. Kliknite na tlačidlo Pokračovať. Ak už konektor typu SMS existuje, systém zobrazí hlásenie „Pre daný typ už nie je možné vytvoriť ďalší konektor“.
  5. Vyplňte pole Názov a skontrolujte prepínač Zapnuté.
  6. V poli Nastavenie konektora vyberte Východzie alebo Vlastné.
  7. Pri voľbe Vlastné vyberte v poli Brána pre posielanie SMS notifikácií bránu a vyplňte jej prístupové údaje.
  8. Kliknite na tlačidlo Vytvoriť.
Formulár konektora SMS s vlastným nastavením
Obrázok: Formulár konektora SMS s vlastným nastavením

Význam polí

Formulár konektora SMS obsahuje spoločné polia konektora a nastavenie SMS brány. Polia pre prístupové údaje sa zobrazujú podľa zvolenej brány.

  • Typ konektora – zobrazuje typ SMS vybraný v sprievodcovi. Pole nie je možné zmeniť.
  • Názov – pomenovanie konektora v zozname konektorov. Pole je povinné.
  • Zapnuté – zapína a vypína posielanie SMS v celom prostredí. Pri vypnutom konektore sa SMS neposielajú a v pravidlách notifikácií sa pri SMS zobrazuje označenie „(Vyp.)“. Pri východzom nastavení je prepínač neaktívny v prípade, že poskytovateľ CDESK východziu bránu nepovolil.
  • Nastavenie konektora – určuje zdroj nastavenia brány:
    • Východzie – konektor použije bránu, ktorú centrálne nastavil a povolil poskytovateľ CDESK. Ďalšie polia sa nezobrazujú.
    • Vlastné – konektor použije vlastný účet vašej organizácie. Zobrazí sa výber brány a polia pre prístupové údaje.
  • Brána pre posielanie SMS notifikácií – poskytovateľ SMS brány, cez ktorého sa SMS posielajú. Zobrazuje sa a je povinné len pri voľbe Vlastné. Zoznam obsahuje brány, ktoré CDESK podporuje, napríklad bránu služby smsbrana.cz alebo bránu SMS API spoločnosti Slovak Telekom.
  • Prihlasovacie údaje – riadok s prístupovými údajmi pre bránu smsbrana.cz:
    • Prihlasovacie meno – prihlasovacie meno účtu u poskytovateľa brány. Pole je povinné.
    • Prihlasovacie heslo – heslo účtu. Pri vytváraní konektora je povinné. Pri úprave sa nové heslo uloží len v prípade, že ho vyplníte.
  • Token – prístupový token pre bránu SMS API spoločnosti Slovak Telekom. Zobrazuje sa len pri tejto bráne a pri vytváraní konektora je povinný.
Upozornenie

Pri zmene brány v poli Brána pre posielanie SMS notifikácií sa pôvodné prístupové údaje nahradia údajmi pre novú bránu. Pred uložením preto vyplňte prístupové údaje novej brány.

Tlačidlá formulára

V spodnej časti formulára sú tlačidlá na uloženie a odstránenie konektora a na návrat do zoznamu. Tlačidlá na uloženie a odstránenie sa zobrazujú len používateľovi s právom zápisu do Globálnych nastavení.

  • Vytvoriť alebo Uložiť – uloží konektor. Pri novom konektore má tlačidlo názov Vytvoriť, pri existujúcom konektore Uložiť.
  • Zmazať – odstráni uložený konektor. Tlačidlo Zmazať sa zobrazuje len pri existujúcom konektore. Po odstránení konektora CDESK prestane posielať SMS.
  • Späť – kliknutím na tlačidlo Späť sa vrátite do zoznamu konektorov bez uloženia zmien.

Používanie konektora

Konektor SMS sa v CDESK prejaví ako ďalší spôsob doručenia notifikácií. Komu a kedy sa SMS pošle, sa neurčuje v konektore, ale v nastaveniach notifikácií, v nastavení typov požiadavky a v pravidlách notifikácií. Táto časť opisuje podmienky odoslania SMS k požiadavke, prípravu textu SMS a prehľad odoslaných SMS.

Kedy sa posiela SMS k požiadavke

SMS notifikácia k požiadavke sa odošle len v prípade, že sú splnené všetky tieto podmienky:

  • Konektor SMS je zapnutý.
  • Pre danú udalosť a príjemcu je zapnutý prepínač v stĺpci SMS v Globálne nastavenia → Notifikácie nastavenia → Základné nastavenia, prípadne vo vlastných nastaveniach notifikácií používateľa v jeho profile.
  • Požiadavka má jednu z dvoch najvyšších priorít alebo má typ požiadavky, pri ktorom je zapnutý stĺpec SMS notifikácie v nastavení typov požiadavky. Na túto podmienku upozorňuje aj tooltip pri stĺpci SMS v nastaveniach notifikácií.
  • Príjemca má vyplnené platné mobilné číslo. Pri kontakte z Adresára sa použije jeho mobilný kontaktný údaj.

Typy požiadavky s posielaním SMS sa nastavujú v nastaveniach požiadaviek na stránke „Nastavenie typov požiadavky a oblastí služieb“ zaškrtnutím stĺpca SMS notifikácie pri vybranom type.

Príklad z praxe

Organizácia chce, aby riešiteľ dostal SMS pri každej požiadavke typu „Výpadok“, bez ohľadu na prioritu. Pri tomto type sa zaškrtne stĺpec SMS notifikácie a v nastaveniach notifikácií sa pre riešiteľa zapne stĺpec SMS pri udalosti založenia požiadavky.

Text SMS

Text SMS sa pripraví zo šablóny notifikácie typu SMS. Šablóny sa spravujú v zozname „Zoznam šablón pre notifikácie“ a v pravidlách notifikácií je možné vybrať, ktorá šablóna SMS sa použije. Pri odoslaní CDESK z textu odstráni diakritiku a nadbytočné medzery. Text dlhší ako 270 znakov sa skráti. Poskytovateľ brány účtuje každých začatých 160 znakov ako jednu SMS.

Prehľad odoslaných SMS

Každá odoslaná SMS sa zapíše do zoznamu „Odoslané SMS a CM E-Mail“, ktorý sa otvára v hlavnom menu cez Komunikácia → Odoslané SMS a E-mail. Položka menu sa zobrazuje len používateľovi s oprávnením Prístup ku Komunikácii a k SMS a E-Mail log, ktoré je predvolene povolené len Administrátorom. Zoznam obsahuje napríklad príjemcu, telefónne číslo, text správy, odosielateľa, čas odoslania, Účtované SMS, Výsledok odoslania a Odpoveď (SMS Brány). Zoznam je možné exportovať kliknutím na tlačidlo XLS.

Riešenie problémov

Pri ukladaní konektora alebo pri odosielaní SMS môže CDESK zobraziť alebo zapísať niektoré z nasledujúcich hlásení. Výsledok každého odoslania je viditeľný v zozname „Odoslané SMS a CM E-Mail“.

HlásenieČo znamená a ako postupovať
„Pre daný typ už nie je možné vytvoriť ďalší konektor“V prostredí už konektor SMS existuje. Upravte existujúci konektor.
„Neplatné meno“Pri bráne smsbrana.cz nie je vyplnené pole Prihlasovacie meno. Doplňte ho.
„Neplatné heslo“Pri vytváraní konektora s bránou smsbrana.cz nie je vyplnené pole Prihlasovacie heslo. Doplňte ho.
„Neplatny token“Pri bráne SMS API spoločnosti Slovak Telekom nie je vyplnené pole Token. Doplňte ho.
„Posielanie SMS správ nie je nastavené“Konektor nie je zapnutý alebo nemá platné nastavenie brány. Pri východzom nastavení nemusí byť východzia brána povolená. Skontrolujte konektor, prípadne kontaktujte poskytovateľa CDESK.
„SMS správa je prázdna“Šablóna SMS po spracovaní neobsahuje žiadny text. Skontrolujte obsah šablóny SMS.
Prepínač Zapnuté nie je aktívnyKonektor používa východzie nastavenie a poskytovateľ CDESK východziu bránu nepovolil. Použite vlastné nastavenie alebo kontaktujte poskytovateľa CDESK.
SMS sa neodoslala, hoci je notifikácia zapnutáPožiadavka nemá jednu z dvoch najvyšších priorít ani typ so zapnutými SMS notifikáciami, prípadne príjemca nemá platné mobilné číslo. Overte podmienky v časti Používanie konektora.

Bola táto stránka užitočná?