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.
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.
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.
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)
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.
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.
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.
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í.
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.
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.
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.
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)
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.
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).
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.
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.
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.
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ě.
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í.
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.
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.
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).
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)
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.
More information