Táto príručka poskytuje informácie o HLR vyhľadávaniach a ako môže byť HLR informácia použitá v smerovaní SMS. Najprv definuje, čo je HLR a pokračuje informáciami o tom, ako môže byť HLR informácia použitá v smerovaní SMS. Nakoniec poskytuje podrobné kroky, ako nastaviť HLR vyhľadávania v Ozeki SMS Gateway.
Čo je HLR
HLR znamená Home Location Register. HLR je databáza spravovaná operátorom mobilnej siete so zoznamom telefónnych čísel, ktoré pôvodne vydal. HLR ukladá informácie o tom, či je telefónne číslo pripojené k mobilnej sieti, či bolo prenesené k inej telefónnej spoločnosti a či sa pohybuje v roamingu v inej sieti.
Začíname
Všetci operátori mobilných sietí sú prepojení v systéme nazývanom SS7 signalizačná sieť. SS7 prenáša dáta o účastníkoch, sieti, hlasových hovoroch a SMS správach medzi operátormi. Reálne kontextové a stavové informácie o každom mobilnom telefóne sú uložené v databázach nazývaných Home Location Registers, ktoré tvria základ informácií o účastníkoch pre mobilnú sieť.
HLR vyhľadávania sú technológiou na dotazovanie sa na home location registry a získavanie živých informácií o sieti a pripojení mobilných telefónnych čísel, ako napríklad, či je mobilný telefón zapnutý alebo vypnutý, ku ktorej sieti patrí, či je momentálne v roamingu, či bolo číslo prenesené medzi sieťami a či je platné alebo neplatné.
HLR vyhľadávania poskytujú firmám reálne dotazy smerované k home location registrom všetkých mobilných sietí. Táto dokumentácia vám pomôže implementovať HLR vyhľadávania do vášho vlastného softvéru, aby ste automaticky dostávali reálne informácie o mobilných telefónoch, keď sú potrebné.
Vytvorte si účet na hlr-lookups.com (Video návod)
Nasledujúce video vás informuje o tom, ako môžete spojiť HLR účet a Ozeki 10 SMS Gateway. Video začína registráciou nového HLR Lookup účtu a prevedie vás až k spojeniu SMS Gateway s ním. Dozviete sa, ako zaregistrovať nový HLR používateľský účet a ako nastaviť funkčné spojenie s Ozeki 10 SMS Gateway. Toto podrobné video trvá len niečo málo cez 2 minúty a je ľahko sledovateľné. Nebudete mať problém nasledovať kroky.
Zaregistrujte si používateľský účet na HLR Lookup
Ak chcete začať používať službu, musíte najprv navštíviť domovskú stránku HLK Lookup. Hľadajte zelené tlačidlo signup umiestnené v pravej hornej časti stránky (Obrázok 1). Kliknite naň a budete presmerovaní na registračný formulár. Zadajte požadované informácie pre registráciu a kliknite na zelené tlačidlo Create Account. Týmto spôsobom budete mať zaregistrovaný používateľský účet pre službu HLR Lookup. S týmto účtom môžete začať implementovať túto funkciu do vášho systému.
Obrázok 1 - Vytvoriť nový účet na hlr-lookups.com
Skontrolujte potvrdzovací email
Prihláste sa do svojho emailového účtu a vyhľadajte potvrdzovací email od HLR Lookup. Kliknite na modrý odkaz, aby ste dokončili svoju registráciu (Obrázok 2). Tento email je zárukou, že emailová adresa pre používateľský účet je legitímna a dosiahnuteľná vlastníkom. Ak ste aktivovali svoj účet, vráťte sa na hlavnú stránku webovej stránky HLR Lookup.
Obrázok 2 - Dokončiť registráciu
Otvorte nastavenia API
Prihláste sa do svojho účtu, aby ste mali prístup k svojmu dashboardu, kde môžete skontrolovať svoje výdavky. Ak chcete získať prístup k nastaveniam účtu, vyhľadajte zelené tlačidlo Account umiestnené pod označením Dashboard. Kliknutím naň sa dostanete na stránku nastavení účtu. (Obrázok 3)
Obrázok 3 - Otvoriť nastavenia účtu
Hľadajte možnosť API settings, ktorá je posledná v zozname nastavení (Obrázok 4). Kliknite na ňu a nájdite zelené tlačidlo Got To API Settings. Konfiguráciou svojich nastavení API získate všetky potrebné API poverenia, ktoré potrebujete na prácu so službou HLR Lookup.
Obrázok 4 - Otvoriť nastavenia API
Skopírujte API kľúč a API tajomstvo
API je Aplikačné Programovacie Interface, ktoré poskytuje prístup k hardvérovým a softvérovým prvkom systému. Program môže posielať požiadavky na API, ktoré vráti zbierku požadovaných informácií. Aby sa zabránilo vystaveniu ekosystému HLR Lookup útokom, je dôležité chrániť API pomocou unikátneho kľúča a hesla, ktoré sú dostupné len pre používateľa služby.
Kľúč a heslo môžete získať na stránke API Credentials v menu HLR Lookup (Obrázok 5). Skopírujte tieto informácie, aby ste ich mohli neskôr použiť pri vytváraní HLR poskytovateľa v Ozeki 10 SMS Gateway.
Obrázok 5 - API poverenia
Otvorte Ozeki 10 SMS Gateway a otvorte Rozšírené menu pomocou ikony na paneli nástrojov (Obrázok 6).
Na ľavej paneli nájdete tlačidlo HLR Lookups. Kliknite naň a hľadajte modré tlačidlo Vytvoriť nového HLR poskytovateľa.
Stlačte ho a na pravej strane obrazovky sa zobrazia dve možnosti.
Vyberte hlrlookups.com. Týmto spôsobom budete mať priame pripojenie k službe HLR Lookup prostredníctvom API.
Obrázok 6 - Vytvorenie nového HLR poskytovateľa v Ozeki SMS Gateway
Zadajte autentifikačné údaje API
V karte Všeobecné nájdete skupinu Autentifikácia (Obrázok 7).
Tam nájdete dva textové políčka. Vložte správne údaje, ktoré ste skopírovali z
HLR Lookup, do vstupných polí.
Do prvého políčka zadajte kľúč, do druhého heslo alebo
tajný kód.
Kliknite na tlačidlo OK pod skupinou Autentifikácia, aby ste dokončili nastavenie.
Obrázok 7 - Zadanie API kľúča a tajného kódu
Spustenie HLR lookup z Ozeki SMS Gateway (Video návod)
V tomto videu sa naučíte, ako vytvoriť nový HLR záznam priamo z Ozeki 10 SMS Gateway.
Video začína s existujúcim HLR poskytovateľom a prevedie vás až k získaniu všetkých informácií o zadanom telefónnom čísle.
Naučíte sa, ako vytvoriť nový HLR záznam a ako získať informácie o zázname.
Toto video trvá len 75 sekúnd. Je veľmi podrobné a ľahko zrozumiteľné, takže nebudete mať problém sledovať kroky.
Otvorenie odkazu HLR Lookups
Pre správu vašich HLR poskytovateľov otvorte rozšírenú stránku. Kliknite na ikonu Rozšírené umiestnenú na paneli nástrojov Ozeki 10 SMS Gateway.
Tu musíte na ľavej paneli nájsť HLR Lookups (Obrázok 8). Kliknite naň a v strednom paneli uvidíte všetkých existujúcich HLR poskytovateľov.
Tento zoznam je dôležitý, pretože tu môžete upravovať, mazať a pridávať nových poskytovateľov.
Obrázok 8 - Otvorenie HLR poskytovateľov
Vytvorenie nového HLR záznamu
Pre pridanie novej položky do zoznamu HLR záznamov nájdite kartu HLR záznamy (Obrázok 9).
Kliknite na ňu a nájdite modré tlačidlo Vytvoriť nový HLR záznam priamo pod kartou.
Kliknite naň a vo všeobecnej karte na pravej strane panelu môžete zadať telefónne číslo, o ktorom chcete ukladať a zisťovať informácie pomocou HLR Lookup.
Toto telefónne číslo a všetky informácie, ktoré HLR Lookup nájde, sa stanú HLR záznamom.
Obrázok 9 - Vytvorenie nového HLR záznamu
Vyžiadanie dátového dopytu z HLR Lookup
Pre vyhľadanie informácií o zázname sa vráťte do zoznamu HLR záznamov. Tam nájdete svoju novú položku.
Môžete nájsť telefónne číslo, stav pripojenia a ďalšie údaje.
Pre získanie ešte viac informácií stlačte tlačidlo HLR lookup umiestnené vedľa dátumu vyhľadávania v zozname položiek.
Stlačte ho pre odoslanie požiadavky na API HLR Lookup. Vráti najdôležitejšie dátové prvky o zázname.
(Obrázok 10)
Obrázok 10 - Spustenie HLR lookup
Pozrite si výsledok dátového dopytu
Pre kontrolu výsledku dopytu hľadajte tlačidlo Detaily umiestnené na konci riadku s údajmi záznamu (Obrázok 11).
Kliknite naň pre zobrazenie stránky s detailmi, ktorá obsahuje všetky informácie, ktoré služba HLR Lookup dokázala získať.
Stránka, ktorú teraz uvidíte, je stránka s detailmi záznamu.
Obrázok 11 - Otvorenie detailov HLR záznamu
Na stránke s detailmi záznamu hľadajte kartu Rozšírené. Tam uvidíte zoznam informácií o telefónnom čísle.
Môžete vidieť napríklad, či je telefónne číslo pripojené k nejakému poskytovateľovi služieb a v ktorej krajine je telefónne číslo registrované.
Ikona nápovedy vedľa každého textového poľa vám poskytne viac informácií o konkrétnom dátovom prvku (Obrázok 12).
Obrázok 12 - Podrobné HLR informácie
Ako sa používajú HLR vyhľadávania v smerovaní SMS?
Domácka lokácia registra (HLR) zohráva dôležitú úlohu v smerovaní SMS,
pretože môže poskytnúť informácie o tom, kam by mala byť textová správa smerovaná.
HLR vyhľadávanie môže poskytnúť cenné informácie o tom, ako by mali byť SMS správy
smerované. HLR vyhľadávanie v Ozeki funguje tak, že k SMS správam pripája značky. Značky
obsahujú informácie o poliach vrátených HLR vyhľadávaním. HLR vyhľadávanie sa
vykonáva pred tým, ako sa uskutoční smerovanie SMS. Keď sa vytvorí SMS trasa, môže
použiť podmienky zhody značiek na výber vhodného pripojenia k poskytovateľovi SMS služieb
na základe informácií získaných z HLR vyhľadávania.
Smerovanie na základe HLR (Video návod)
Nasledujúce video vám poskytne všetky informácie o tom, ako môžete použiť službu HLR vyhľadávania na smerovanie vašich SMS správ.
Toto video začína povolením služby HLR vyhľadávania pre smerovanie SMS a prevedie vás až k odoslaniu vašej prvej SMS správy.
Video je podrobné, ale ľahko zrozumiteľné. Trvá len o niečo viac ako 3 a pol minúty, takže budete mať žiaden problém sledovať kroky.
Dozviete sa, ako povoliť HLR vyhľadávanie pre smerovanie SMS, ako nakonfigurovať správu pre úspešné doručenie a ako skontrolovať, či bola správa prijatá a odoslaná.
Upraviť nastavenia Ozeki 10 SMS Gateway
V paneli menu Ozeki 10 SMS Gateway môžete vidieť tlačidlo Upraviť. Pod ním uvidíte položku podmenu Nastavenia.
Kliknite na tlačidlo, aby ste otvorili menu nastavení (Obrázok 13).
Odtiaľ môžete upraviť nastavenia Ozeki 10 SMS Gateway a povoliť službu HLR vyhľadávania pre smerovanie SMS.
Obrázok 13 - Otvoriť nastavenia servera
Povoliť možnosť HLR vyhľadávania pre smerovanie SMS
V zozname Všeobecné nastavenia vyhľadajte položku HLR vyhľadávanie.
Kliknite na ňu, aby ste videli panel podrobných všeobecných nastavení.
V skupinovom boxe HLR vyhľadávania nájdete začiarkavacie políčko, ktoré slúži na
povolenie používania služby pre smerovanie SMS (Obrázok 14).
Začiarknite políčko a kliknite na tlačidlo Ok, aby ste dokončili konfiguráciu.
Obrázok 14 - Povoliť HLR vyhľadávanie pre smerovanie SMS
Odoslať testovaciu správu
Nové nastavenia smerovania môžete otestovať odoslaním testovacej správy na zaznamenané telefónne číslo.
Týmto spôsobom získate značku, ktorú HLR vyhľadávanie pripája k správe.
Ak to chcete urobiť, kliknite na ikonu Nový na paneli nástrojov Ozeki 10 SMS Gateway (Obrázok 15).
Teraz uvidíte panel na vytvorenie novej správy. V textovom poli Adresa budete potrebovať telefónne číslo, na ktoré chcete odoslať testovaciu správu.
Pod ním môžete vidieť pole na zadanie správy. Napíšte testovací text HLR a kliknite na tlačidlo Ok, aby ste odoslali správu. Týmto spôsobom služba HLR vyhľadávania
vyhľadá informácie o telefónnom čísle. Pripojí tieto informácie k správe.
Obrázok 15 - Odoslať testovaciu SMS
Skontrolovať značky odoslanej správy
Ak ste správu úspešne odoslali a bola odoslaná, bude viditeľná v priečinku Odoslané.
Ak chcete skontrolovať informácie, ktoré potrebujete v značkách, vyhľadajte panel používateľských informácií
na ľavej strane (Obrázok 16).
V skupinovom boxe Priečinky nájdete priečinok Odoslané. Kliknite naň
a skontrolujte zoznam odoslaných správ.
Pod zoznamom nájdete panel Podrobnosti správy. Tu môžete
vidieť všetky informácie o odoslanej správe.
Vyhľadajte kartu Značky vedľa karty História doručenia. Kliknite na ňu
a uvidíte značky, ktoré služba HLR pripojila k
správe.
Tu musíte nájsť pole hlr_original_country_code.
To vám povie, kde je telefónne číslo pôvodne registrované.
Skopírujte túto informáciu niekam pre neskoršie použitie.
Obrázok 16 - Značky HLR SMS správy
Pridať novú trasu podľa HLR
Aby bola správa úspešne doručená, musíte pre ňu vytvoriť trasu podľa informácií získaných službou HLR.
Ak to chcete urobiť, otvorte Zoznam trás pomocou Ikony Trasa umiestnenej na paneli nástrojov (Obrázok 17). Teraz nájdete modré tlačidlo s názvom Vytvoriť novú trasu.
Kliknite naň, aby ste otvorili panel podrobností trasy na pravej strane obrazovky.
Tam nájdete skupinový box Nastavenia. V tomto skupinovom boxe nájdete vstupné pole Komu. Tu musíte zadať adresu vytvoreného SMPP klienta.
Obrázok 17 - Pridať nové pravidlo smerovania na základe HLR
Pridať novú smerovaciu podmienku
V paneli Detaily trasy nájdete stránku Karta zhody. Tu
uvidíte Skupinové pole značky (Obrázok 18).
V tomto skupinovom poli môžete pridať názov značky, ktorý bude detegovaný, a
hodnotu značky, ktorá sa použije ako podmienka detekcie.
Vedľa každého vstupného poľa bude ikona pomoci, ktorú môžete použiť
ako spôsob, ako získať viac informácií o tom, čo musíte do textového poľa napísať.
Obrázok 18 - Pridať značky pre smerovanie
V skupinovom poli Názov značky vložte text hlr_original_country_code,
ktorý bol skopírovaný zo značiek odoslanej správy.
Vložte hodnotu hlr_original_country_code do tohto textového poľa.
Týmto spôsobom, ak brána zistí, že správa bola odoslaná s poskytnutou hodnotou,
automaticky použije tento vhodný protokol SMPP na odoslanie SMS.
V príklade je to značka GB (Obrázok 19).
Obrázok 19 - Definovať HLR značku pre smerovanie
Odoslať novú testovaciu správu
Teraz je čas odoslať novú testovaciu správu. Rovnako ako predtým, kliknite na Ikona Nový na paneli nástrojov.
Toto vás presmeruje na stránku Editor novej správy. V textovom poli Adresa musíte uviesť telefónne číslo, na ktoré ste odoslali poslednú testovaciu správu.
Pod ním uvidíte vstupné pole Správa. Napíšte text testu HLR trasy.
Kliknite na tlačidlo OK na odoslanie správy. (Obrázok 20)
Obrázok 20 - Odoslať novú testovaciu správu
Testovacia správa úspešne odoslaná
Na stránke História doručenia správ môžete potvrdiť, že testovacia správa bola odoslaná cez novo nakonfigurované SMS pripojenie.
Stav prvej testovacej správy uvádzal, že správa je odoslaná.
Teraz stav tejto novo nakonfigurovanej SMS správy uvádza, že správa bola Odoslanie akceptované príjemcom.
Teraz môžete použiť toto nakonfigurované SMPP pripojenie na odosielanie správ do krajiny, ktorej kód ste
zadali ako hodnotu značky.
Obrázok 21 - Správa odoslaná cez nakonfigurované SMS pripojenie