Jak používat HLR lookupy při směrování SMS

Tento průvodce poskytuje informace o HLR lookupech a o tom, jak lze HLR informace využít při směrování SMS. Nejprve definuje, co je HLR, a poté poskytuje informace o tom, jak lze HLR informace použít při směrování SMS. Nakonec podrobně popisuje, jak nastavit HLR lookupy v Ozeki SMS Gateway.

Co je HLR

HLR znamená Home Location Register (Registr domovské lokality). HLR je databáze spravovaná operátorem mobilní sítě, která obsahuje seznam telefonních čísel, která původně vydal. HLR ukládá informace o tom, zda je telefonní číslo připojeno k mobilní síti, zda bylo převedeno k jiné telefonní společnosti a zda roamuje v jiné síti.

Začínáme

Všichni operátoři mobilních sítí jsou propojeni v systému nazývaném signalizační síť SS7. SS7 přenáší data o účastnících, síťových připojeních, hlasových hovorech a SMS zprávách mezi operátory. Aktuální kontextové a stavové informace o každém mobilním telefonu jsou uloženy v databázích nazývaných Home Location Registers, které tvoří základ informací o účastnících mobilní sítě.

HLR Lookupy jsou technologie pro dotazování registrů domovské lokality a získávání živých informací o síťovém připojení mobilních telefonních čísel, jako je například to, zda je mobilní telefon zapnutý nebo vypnutý, ke které síti patří, zda právě roamuje, zda bylo číslo převedeno mezi sítěmi a zda je platné nebo neplatné.

HLR Lookupy poskytují firmám reálné dotazy směrem k registrům domovské lokality všech mobilních sítí. Tato dokumentace vám pomůže implementovat HLR Lookupy do vašeho vlastního softwaru, abyste automaticky získávali aktuální informace o mobilních telefonech, když je potřebujete.

Vytvoření účtu na hlr-lookups.com (Video návod)

Následující video vás informuje o tom, jak můžete propojit účet HLR a Ozeki 10 SMS Gateway. Video začíná registrací nového účtu HLR Lookup a provede vás celým procesem až k propojení s SMS Gateway. Dozvíte se, jak zaregistrovat nový uživatelský účet HLR a jak nastavit funkční spojení s Ozeki 10 SMS Gateway. Toto podrobné video trvá jen něco málo přes 2 minuty a je snadno srozumitelné. Nebudete mít problém sledovat jednotlivé kroky.

Video 1 - Jak vytvořit účet na hlr-lookups.com (Video návod)

Registrace uživatelského účtu na HLR Lookup

Chcete-li začít používat službu, nejprve navštivte domovskou stránku HLK Lookup. Vyhledejte zelené tlačítko signup umístěné v pravém horním rohu stránky (Obrázek 1). Klikněte na něj a zobrazí se vám registrační formulář. Vyplňte požadované údaje pro registraci a klikněte na zelené tlačítko Create Account. Tím získáte registrovaný uživatelský účet pro službu HLR Lookup. S tímto účtem můžete začít implementovat tuto funkci do vašeho systému.

vytvořit nový účet na hlr-lookups.com
Obrázek 1 - Vytvoření nového účtu na hlr-lookups.com

Zkontrolujte potvrzovací email

Přihlaste se ke svému emailovému účtu a vyhledejte potvrzovací email od HLR Lookup. Klikněte na modrý odkaz pro dokončení registrace (Obrázek 2). Tento email je zárukou, že emailová adresa pro uživatelský účet je platná a dostupná pro vlastníka. Pokud jste účet aktivovali, vraťte se na hlavní stránku webu HLR Lookup.

dokončení registrace
Obrázek 2 - Dokončení registrace

Otevřete nastavení API

Přihlaste se ke svému účtu, abyste získali přístup k dashboardu, kde můžete zkontrolovat své výdaje. Chcete-li získat přístup k nastavení účtu, vyhledejte zelené tlačítko Account umístěné pod nadpisem Dashboard. Kliknutím na něj se dostanete na stránku nastavení účtu. (Obrázek 3)

otevření nastavení účtu
Obrázek 3 - Otevření nastavení účtu

Vyhledejte možnost API settings, která je poslední v seznamu nastavení (Obrázek 4). Klikněte na ni a najděte zelené tlačítko Got To API Settings. Konfigurací nastavení API získáte všechny potřebné přihlašovací údaje API, které potřebujete pro práci se službou HLR Lookup.

otevření nastavení api
Obrázek 4 - Otevření nastavení API

Zkopírujte API klíč a API secret

API je Aplikační Programovací Rozhraní, které poskytuje přístup k hardwarovým a softwarovým prvkům systému. Program může odesílat požadavky na API, které vrátí požadované informace. Aby nedošlo k ohrožení ekosystému HLR Lookup, je důležité chránit API unikátním klíčem a heslem, které jsou k dispozici pouze pro uživatele služby.

Klíč a heslo můžete získat na stránce API Credentials v menu HLR Lookup (Obrázek 5). Zkopírujte tyto informace, abyste je mohli později použít při vytváření poskytovatele HLR v Ozeki 10 SMS Gateway.

přihlašovací údaje api
Obrázek 5 - Přihlašovací údaje API

Otevřete Ozeki 10 SMS Gateway a otevřete Pokročilé menu pomocí ikony na panelu nástrojů (Obrázek 6). Na levém panelu najdete tlačítko HLR Lookups. Klikněte na něj a vyhledejte modré tlačítko Vytvořit nového HLR poskytovatele. Stiskněte jej a na pravé straně obrazovky se zobrazí dvě možnosti. Vyberte hlrlookups.com. Tím získáte přímé připojení ke službě HLR Lookup prostřednictvím API.

vytvořit nového hlr lookup poskytovatele v ozeki sms gateway
Obrázek 6 - Vytvoření nového HLR lookup poskytovatele v Ozeki SMS Gateway

Zadejte autentizační údaje API

V záložce Obecné najdete skupinu Autentizace (Obrázek 7). Zde najdete dvě textová pole. Vložte správná data, která jste zkopírovali z HLR Lookup, do vstupních polí. První pole vyžaduje klíč, druhé potřebuje heslo nebo tajný kód. Kliknutím na tlačítko OK pod skupinou Autentizace dokončíte nastavení.

zadejte api klíč a tajný kód
Obrázek 7 - Zadejte API klíč a tajný kód

Spusťte HRL lookup z Ozeki SMS Gateway (Video návod)

V tomto videu se naučíte, jak vytvořit nový HLR záznam přímo z Ozeki 10 SMS Gateway. Video začíná s existujícím HLR poskytovatelem a provede vás až k získání všech informací o zadaném telefonním čísle. Naučíte se, jak vytvořit nový HLR záznam a jak získat informace o záznamu. Toto video trvá pouze 75 sekund. Je velmi podrobné a snadno srozumitelné, takže nebudete mít problém sledovat jednotlivé kroky.

Video 2 - Jak spustit HRL lookup z Ozeki SMS Gateway (Video návod)

Otevřete odkaz HLR Lookups

Pro správu vašich HLR poskytovatelů otevřete pokročilou stránku. Klikněte na ikonu Pokročilé umístěnou na panelu nástrojů Ozeki 10 SMS Gateway. Zde je třeba najít HLR Lookups na levém panelu (Obrázek 8). Klikněte na něj a uvidíte všechny existující HLR poskytovatele v prostředním panelu. Tento seznam je důležitý, protože zde můžete upravovat, mazat a přidávat nové poskytovatele.

otevřít hlr poskytovatele
Obrázek 8 - Otevřít HLR poskytovatele

Vytvořte nový HLR záznam

Pro přidání nové položky do seznamu HLR záznamů najděte záložku HLR záznamy (Obrázek 9). Klikněte na ni a pod záložkou najděte modré tlačítko Vytvořit nový HLR záznam. Klikněte na něj a v záložce Obecné na pravém panelu můžete zadat telefonní číslo, o kterém chcete získat informace pomocí HLR Lookup. Toto telefonní číslo a všechny informace, které HLR Lookup najde, se stanou HLR záznamem.

vytvořit nový hlr záznam
Obrázek 9 - Vytvořit nový HLR záznam

Požádejte o datový dotaz z HLR Lookup

Pro vyhledání informací o záznamu se vraťte do seznamu HLR záznamů. Zde najdete svou novou položku. Můžete zde vidět telefonní číslo, stav připojení a další data. Pro získání dalších informací stiskněte tlačítko HLR lookup umístěné vedle data lookupu v seznamu. Stisknutím odešlete požadavek na API HLR Lookup. Vrátí nejdůležitější datové prvky o záznamu. (Obrázek 10)

spustit hlr lookup
Obrázek 10 - Spustit HLR lookup

Podívejte se na výsledek datového dotazu

Pro kontrolu výsledku dotazu vyhledejte tlačítko Podrobnosti umístěné na konci řádku s daty záznamu (Obrázek 11). Kliknutím na něj otevřete stránku s podrobnostmi, která obsahuje všechny informace, které služba HLR Lookup získala. Stránka, kterou nyní uvidíte, je stránka s podrobnostmi záznamu.

otevřít podrobnosti hlr záznamu
Obrázek 11 - Otevřít podrobnosti HLR záznamu

Na stránce s podrobnostmi záznamu vyhledejte záložku Pokročilé. Zde uvidíte seznam informací o telefonním čísle. Můžete například zjistit, zda je telefonní číslo připojeno k nějakému poskytovateli služeb a v které zemi je telefonní číslo registrováno. Ikona nápovědy vedle každého textového pole vám poskytne více informací o daném datovém prvku (Obrázek 12).

podrobné hlr informace
Obrázek 12 - Podrobné HLR informace

Jak se využívají HLR dotazy při směrování SMS?

Domovský registr polohy (HLR) hraje důležitou roli při směrování SMS, protože může poskytnout informace o tom, kam by měla být textová zpráva směrována.

Velké společnosti nastavují mnoho SMS tras k různým poskytovatelům SMS služeb a mobilním operátorům a používají směrování SMS k určení, kam by měla každá textová zpráva dorazit. Směrování SMS vybírá vhodné připojení k poskytovateli SMS služeb, jako je například připojení pomocí protokolu SMPP, připojení pomocí protokolu CIMD2 nebo připojení pomocí protokolu UCP pro doručení SMS.

HLR dotaz může poskytnout cenné informace o tom, jak by měly být SMS zprávy směrovány. HLR dotaz v Ozeki funguje tak, že k SMS zprávám připojuje tagy. Tagy obsahují informace o polích vrácených HLR dotazem. HLR dotaz se provádí před tím, než dojde k směrování SMS. Při vytváření SMS trasy lze využít podmínky shody tagů k výběru vhodného připojení k poskytovateli SMS služeb na základě informací získaných z HLR dotazu.

Směrování na základě HLR (Video návod)

Následující video vám poskytne všechny informace o tom, jak můžete použít službu HLR Lookup pro směrování vašich SMS zpráv. Toto video začíná povolením služby HLR Lookup pro směrování SMS a provede vás celým procesem až k odeslání první SMS zprávy. Video je podrobné, ale snadno srozumitelné. Trvá jen o něco více než 3 a půl minuty, takže budete mít problém sledovat jednotlivé kroky. Dozvíte se, jak povolit HLR Lookup pro směrování SMS, jak nakonfigurovat zprávu pro úspěšné doručení a jak zkontrolovat, zda byla zpráva přijata a odeslána.

Video 3 - Jak používat službu HLR Lookup pro směrování vašich SMS zpráv (Video návod)

Upravte nastavení Ozeki 10 SMS Gateway

V hlavní nabídce Ozeki 10 SMS Gateway můžete vidět tlačítko Upravit. Pod ním uvidíte položku podnabídky Předvolby. Klikněte na tlačítko pro otevření nabídky předvoleb (Obrázek 13). Odtud můžete upravit nastavení Ozeki 10 SMS Gateway a povolit službu HLR Lookup pro směrování SMS.

otevřít předvolby serveru
Obrázek 13 - Otevřít předvolby serveru

Povolte možnost HLR Lookup pro směrování SMS

V seznamu Obecná nastavení vyhledejte položku HLR Lookup. Klikněte na ni, abyste viděli panel podrobností obecného nastavení. V skupinovém rámečku HLR Lookupy najdete zaškrtávací políčko, které slouží k povolení použití služby pro směrování SMS (Obrázek 14). Zaškrtněte políčko a klikněte na tlačítko Ok, abyste dokončili konfiguraci.

povolit hlr lookup pro směrování sms
Obrázek 14 - Povolit HLR lookup pro směrování SMS

Odešlete testovací zprávu

Nové nastavení směrování můžete otestovat odesláním testovací zprávy na zaznamenané telefonní číslo. Tímto způsobem získáte tag, který HLR Lookup připojí k zprávě. Chcete-li tak učinit, klikněte na ikonu Nový na panelu nástrojů Ozeki 10 SMS Gateway (Obrázek 15). Nyní uvidíte panel pro vytvoření nové zprávy. V textovém poli Adresa budete potřebovat telefonní číslo, na které chcete odeslat testovací zprávu. Pod ním můžete vidět pole pro vstup zprávy. Napište testovací text HLR a klikněte na tlačítko Ok pro odeslání zprávy. Tímto způsobem služba HLR lookup vyhledá informace o telefonním čísle. Tyto informace připojí k zprávě.

odeslat testovací sms
Obrázek 15 - Odeslat testovací SMS

Zkontrolujte tagy odeslané zprávy

Pokud jste zprávu úspěšně odeslali a byla odeslána, bude viditelná ve složce Odeslané. Chcete-li zkontrolovat potřebné informace v tazích, vyhledejte panel uživatelských informací na levé straně (Obrázek 16). Ve skupinovém rámečku Složky můžete najít složku Odeslané. Klikněte na ni a zkontrolujte seznam odeslaných zpráv. Pod seznamem najdete panel Podrobnosti zprávy. Zde můžete vidět všechny informace o odeslané zprávě. Vyhledejte záložku Tagy vedle záložky Historie doručení. Klikněte na ni a uvidíte tagy, které služba HLR Lookup připojila k zprávě. Zde musíte najít pole hlr_original_country_code. To vám řekne, kde je telefonní číslo původně registrováno. Zkopírujte tyto informace pro pozdější použití.

tagy hlr sms zprávy
Obrázek 16 - Tagy HLR SMS zprávy

Přidejte novou trasu podle HLR

Aby byla zpráva úspěšně doručena, musíte vytvořit trasu podle informací získaných ze služby HLR. Chcete-li to provést, otevřete Seznam tras pomocí Ikony Trasa umístěné na panelu nástrojů (Obrázek 17). Nyní najdete modré tlačítko s názvem Vytvořit novou trasu. Klikněte na něj, abyste otevřeli Panel podrobností trasy na pravé straně obrazovky. Zde najdete skupinový rámeček Nastavení. V tomto skupinovém rámečku najdete vstupní pole Pro. Zde musíte zadat adresu vytvořeného klienta SMPP.

přidat nové pravidlo směrování na základě hlr
Obrázek 17 - Přidat nové pravidlo směrování na základě HLR

V panelu Podrobnosti trasy najdete stránku Záložka Shoda. Zde uvidíte Skupinové pole Tag (Obrázek 18). V tomto skupinovém poli můžete přidat název tagu, který bude detekován, a hodnotu tagu, která bude použita jako podmínka pro detekci. Vedle každého vstupního pole bude ikona nápovědy, kterou lze použít pro získání dalších informací o tom, co je třeba do textového pole napsat.

přidat shodu tagů pro směrování
Obrázek 18 - Přidat shodu tagů pro směrování

Ve skupinovém poli Název tagu vložte text hlr_original_country_code, který byl zkopírován z tagů odeslané zprávy. Vložte hodnotu hlr_original_country_code do tohoto textového pole. Pokud brána zjistí, že zpráva je odeslána s poskytnutou hodnotou, automaticky použije tento vhodný protokol SMPP pro odeslání SMS. V příkladu je to tag GB (Obrázek 19).

definovat HLR tag pro směrování
Obrázek 19 - Definovat HLR tag pro směrování

Odeslat novou testovací zprávu

Nyní je čas odeslat novou testovací zprávu. Stejně jako předtím klikněte na Ikona Nový na panelu nástrojů. Tím se dostanete na stránku Editor nové zprávy. V textovém poli Adresa je třeba uvést telefonní číslo, na které jste odeslali poslední testovací zprávu. Pod ním je vidět vstupní pole Zpráva. Napište text testu HLR trasy. Klikněte na tlačítko OK pro odeslání zprávy. (Obrázek 20)

odeslat novou testovací zprávu
Obrázek 20 - Odeslat novou testovací zprávu

Testovací zpráva úspěšně odeslána

Na stránce Historie doručení zpráv můžete potvrdit, že testovací zpráva byla nyní odeslána přes nově nakonfigurované SMS spojení. Stav první testovací zprávy byl odesláno. Nyní stav této nově nakonfigurované SMS zprávy je Odeslání přijato příjemcem. Nyní můžete použít toto nakonfigurované SMPP spojení pro odesílání zpráv do země, jejíž kód jste zadali jako hodnotu tagu.

zpráva odeslána přes nakonfigurované SMS spojení
Obrázek 21 - Zpráva odeslána přes nakonfigurované SMS spojení

More information