Cum să folosești interogări HLR în rutarea SMS

Acest ghid oferă informații despre interogările HLR și modul în care informațiile HLR pot fi utilizate în rutarea SMS. Mai întâi definește ce este un HLR și continuă cu informații despre cum pot fi utilizate informațiile HLR în rutarea SMS. În final, oferă instrucțiuni detaliate pas cu pas despre cum să configurezi interogări HLR în Ozeki SMS Gateway.

Ce este HLR

HLR înseamnă Home Location Register (Registrul de Locație Principal). HLR este o bază de date menținută de operatorul de rețea mobilă cu o listă de numere de telefon pe care le-a emis inițial. HLR stochează informații despre dacă un număr de telefon este conectat la rețeaua mobilă, dacă a fost portat la o altă companie de telefonie și dacă este în roaming pe o altă rețea.

Începutul

Toți operatorii de rețele mobile sunt conectați într-un sistem numit rețea de semnalizare SS7. SS7 transportă date despre abonați, rețele, apeluri vocale și mesaje SMS între operatori. Informații în timp real despre context și starea fiecărui telefon mobil sunt stocate în baze de date numite Home Location Registers, care formează coloana vertebrală a informațiilor despre abonați pentru o rețea mobilă.

Interogările HLR sunt o tehnologie pentru a interoga registrele de locație principală și a obține informații în timp real despre rețea și conectivitate pentru numerele de telefon mobile, cum ar fi, dacă un telefon mobil este pornit sau oprit, cărei rețele aparține, dacă este în roaming în prezent, dacă un număr a fost portat între rețele, și dacă este valid sau invalid.

Interogările HLR oferă afacerilor interogări în timp real către registrele de locație principală ale tuturor rețelelor mobile. Această documentație te ajută să implementezi interogări HLR în propriul software pentru a primi automat informații în timp real despre telefoanele mobile atunci când este nevoie.

Crează un cont hlr-lookups.com (Tutorial video)

Următorul videoclip te informează despre cum poți conecta un cont HLR și Ozeki 10 SMS Gateway. Videoclipul începe cu înregistrarea unui nou cont HLR Lookup și te conduce până la conectarea SMS Gateway cu acesta. Vei învăța cum să înregistrezi un nou cont de utilizator HLR și cum să configurezi o conexiune funcțională cu Ozeki 10 SMS Gateway. Acest videoclip detaliat durează puțin peste 2 minute și este ușor de urmărit. Nu vei avea probleme în a urma pașii.

Video 1 - Cum să creezi un cont hlr-lookups.com (Tutorial video)

Înregistrează un cont de utilizator la HLR Lookup

Pentru a începe să folosești serviciul, trebuie mai întâi să vizitezi pagina principală a HLR Lookup. Caută un buton verde signup situat în partea dreaptă sus a paginii (Figura 1). Dă clic pe el și vei fi prezentat cu un formular de înregistrare. Completează informațiile necesare pentru înregistrare și dă clic pe butonul verde Create Account. În acest fel vei avea un cont de utilizator înregistrat pentru serviciul HLR Lookup. Cu acest cont poți începe să implementezi funcționalitatea în sistemul tău.

crează un nou cont hlr-lookups.com
Figura 1 - Crează un nou cont hlr-lookups.com

Verifică email-ul de confirmare

Conectează-te la contul tău de email și caută un email de confirmare de la HLR Lookup. Dă clic pe link-ul albastru pentru a finaliza înregistrarea (Figura 2). Acest email este o asigurare că adresa de email pentru contul de utilizator este legitimă și accesibilă de către proprietar. Dacă ai activat contul, revino la pagina principală a site-ului HLR Lookup.

finalizează înregistrarea
Figura 2 - Finalizează înregistrarea

Deschide setările API

Conectează-te la contul tău pentru a accesa panoul de control, unde poți verifica cheltuielile. Pentru a accesa setările contului, caută un buton verde Account situat sub eticheta Dashboard. Dând clic pe el, vei ajunge la pagina de setări a contului. (Figura 3)

deschide setările contului
Figura 3 - Deschide setările contului

Caută opțiunea API settings, care este ultima din lista de setări (Figura 4). Dă clic pe ea și găsește butonul verde Got To API Settings. Prin configurarea setărilor API, vei obține toate credentialele API necesare pentru a lucra cu serviciul HLR Lookup.

deschide setările api
Figura 4 - Deschide setările API

Copiază cheia API și secretul API

Un API este o Aplicație Programare Interfață care oferă acces la elementele hardware și software ale unui sistem. Un program poate trimite cereri către un API care va returna colecția de informații solicitate. Pentru a evita expunerea ecosistemului HLR Lookup la atacuri, este important să protejezi API-ul cu o cheie unică și parolă care este disponibilă doar pentru utilizatorul serviciului.

Poți obține cheia și parola în pagina API Credentials din meniul HLR Lookup (Figura 5). Copiază aceste informații, pentru a le folosi mai târziu în procesul de creare a unui furnizor HLR în Ozeki 10 SMS Gateway.

credentiale api
Figura 5 - Credentiale API

Crează un nou furnizor în Ozeki 10 SMS Gateway

Deschide Ozeki 10 SMS Gateway și deschide meniul Avansat cu pictograma situată pe bara de instrumente (Figura 6). Pe panoul din stânga, vei găsi butonul HLR Lookups. Apasă pe el și caută butonul albastru Create new HLR provider. Apasă pe el și vei avea două opțiuni în partea dreaptă a ecranului. Alege hlrlookups.com. În acest fel, vei avea o conexiune directă la serviciul HLR Lookup prin API.

crează un nou furnizor hlr lookup în ozeki sms gateway
Figura 6 - Crează un nou furnizor HLR lookup în Ozeki SMS Gateway

Furnizează detaliile de autentificare ale API-ului

În fila General, poți găsi caseta de grup Autentificare (Figura 7). Acolo vei găsi două casete de text. Introdu datele corecte pe care le-ai copiat din HLR Lookup, în casetele de introducere. Prima casetă necesită cheia, iar a doua necesită parola sau secretul. Apasă butonul Ok sub caseta de grup Autentificare pentru a finaliza configurarea.

furnizează cheia api și secretul
Figura 7 - Furnizează cheia API și secretul

Rulează HRL lookup din Ozeki SMS Gateway (Tutorial video)

În acest videoclip, vei învăța cum să creezi un nou record HLR direct din Ozeki 10 SMS Gateway. Videoclipul începe cu un furnizor HLR și te conduce până când ai toate informațiile despre numărul de telefon pe care l-ai furnizat. Vei învăța cum să creezi un nou record HLR și cum să obții informații despre acesta. Acest videoclip durează doar 75 de secunde. Este foarte detaliat și ușor de înțeles, așa că nu vei avea probleme în a urmări pașii.

Video 2 - Cum să rulezi HRL lookup din Ozeki SMS Gateway (Tutorial video)

Deschide link-ul HLR Lookups

Pentru a gestiona furnizorii HLR, deschide pagina avansată. Apasă pictograma Avansat situată pe bara de instrumente a Ozeki 10 SMS Gateway. Aici trebuie să găsești HLR Lookups pe panoul din stânga (Figura 8). Apasă pe el și vei vedea toți furnizorii HLR existenți în panoul central. Această listă este importantă, deoarece poți edita, șterge și adăuga noi furnizori de aici.

deschide furnizorii hlr
Figura 8 - Deschide furnizorii HLR

Crează un nou record HLR

Pentru a adăuga un nou element în lista de recorduri HLR, găsește pagina de filă a recordurilor HLR (Figura 9). Apasă pe ea și găsește butonul albastru Create new HLR record chiar sub filă. Apasă pe el și în fila generală a panoului din dreapta, poți introduce un număr de telefon despre care dorești să stochezi și să interoghezi informații cu HLR Lookup. Acest număr de telefon și toate informațiile pe care le găsește HLR Lookup vor deveni un record HLR.

crează un nou record hlr
Figura 9 - Crează un nou record HLR

Solicită o interogare de date de la HLR Lookup

Pentru a căuta informații despre record, revino la lista de recorduri HLR. Acolo, vei găsi noul tău element. Poți găsi numărul de telefon, starea de conectivitate și alte date. Pentru a obține și mai multe informații, apasă butonul HLR lookup situat lângă data de lookup a elementului din listă. Apasă pe el pentru a trimite o cerere către API-ul HLR Lookup. Acesta va returna cele mai importante elemente de date despre record. (Figura 10)

rulează hlr lookup
Figura 10 - Rulează HLR lookup

Verifică rezultatul interogării de date

Pentru a verifica rezultatul interogării, caută butonul Detalii situat la sfârșitul liniei de date a recordului (Figura 11). Apasă pe el pentru a vedea pagina de detalii, care conține toate informațiile pe care serviciul HLR Lookup le-a putut obține. Pagina pe care o vei vedea acum este pagina de detalii a recordului.

deschide detaliile recordului hlr
Figura 11 - Deschide detaliile recordului HLR

Pe pagina de detalii a recordului, caută fila Avansat. Acolo vei vedea o listă de informații despre numărul de telefon. Poți vedea, de exemplu, dacă numărul de telefon este conectat la vreun furnizor de servicii și în ce țară este înregistrat numărul de telefon. Pictograma Hint de lângă fiecare casetă de text îți va oferi mai multe informații despre acea bucată specifică de date (Figura 12).

informații detaliate hlr
Figura 12 - Informații detaliate HLR

Cum sunt utilizate interogările HLR în rutarea SMS-urilor?

Registrul de Locație Acasă (HLR) joacă un rol important în rutarea SMS-urilor, deoarece poate furniza informații despre locul în care ar trebui direcționat mesajul text.

Marile companii configurează multe rute SMS către diverși furnizori de servicii SMS și operatori de rețele mobile și folosesc rutarea SMS pentru a determina unde ar trebui să ajungă fiecare mesaj text. Rutarea SMS selectează conexiunea adecvată către furnizorul de servicii SMS, cum ar fi o conexiune protocol client CIMD2 sau o conexiune protocol client UCP pentru SMS pentru livrarea mesajelor.

O interogare HLR poate furniza informații valoroase despre cum ar trebui rutat un mesaj SMS. O interogare HLR în Ozeki funcționează prin atașarea de etichete la mesajele SMS. Etichetele conțin informații despre câmpurile returnate de interogarea HLR. Interogarea HLR este efectuată înainte de rutarea SMS-ului. Când se creează o rută SMS, aceasta poate folosi condiții de potrivire a etichetelor pentru a selecta conexiunea adecvată către furnizorul de servicii SMS pe baza informațiilor primite de la interogarea HLR.

Rutare bazată pe HLR (Tutorial video)

Următorul videoclip vă oferă toate informațiile despre cum puteți folosi serviciul HLR Lookup pentru a vă ruta mesajele SMS. Acest videoclip începe cu activarea serviciului HLR Lookup pentru a fi folosit în rutarea SMS-urilor și vă va ghida până la primul mesaj SMS trimis. Videoclipul este detaliat, dar ușor de înțeles. Durează puțin peste 3 minute și jumătate, așa că nu veți avea probleme în a urmări pașii. Veți învăța cum să activați HLR Lookup pentru rutarea SMS-urilor, cum să configurați mesajul pentru o livrare reușită și cum să verificați dacă mesajul a fost acceptat și trimis.

Video 3 - Cum să folosiți serviciul HLR Lookup pentru a vă ruta mesajele SMS (Tutorial video)

Editați setările Ozeki 10 SMS Gateway

În bara de meniu a Ozeki 10 SMS Gateway, puteți vedea butonul de meniu Edit. Sub acesta, veți găsi subelementul de meniu Preferences. Faceți clic pe buton pentru a deschide meniul de preferințe (Figura 13). De acolo puteți edita setările Ozeki 10 SMS Gateway și puteți activa serviciul HLR Lookup pentru rutarea SMS-urilor.

deschide preferințele serverului
Figura 13 - Deschide preferințele serverului

Activați opțiunea HLR Lookup pentru rutarea SMS-urilor

În lista General settings, căutați elementul HLR Lookup. Faceți clic pe el pentru a vedea panoul general setting details. În caseta de grup HLR Lookups, veți găsi o casetă de bifare pentru activarea utilizării serviciului pentru rutarea SMS-urilor (Figura 14). Bifați caseta și faceți clic pe butonul Ok pentru a finaliza configurația.

activează hlr lookup pentru rutarea sms-urilor
Figura 14 - Activează HLR lookup pentru rutarea SMS-urilor

Trimiteți un mesaj de test

Puteți testa noile setări de rutare prin trimiterea unui mesaj de test către numărul de telefon înregistrat. În acest fel, veți putea obține eticheta pe care HLR Lookup o atașează mesajului. Pentru a face acest lucru, faceți clic pe New icon din bara de unelte a Ozeki 10 SMS Gateway (Figura 15). Acum veți vedea panoul de compunere a mesajului nou. În caseta de text Address, veți avea nevoie de numărul de telefon către care doriți să trimiteți mesajul de test. Sub aceasta, puteți vedea câmpul de introducere a mesajului. Introduceți textul de test HLR și faceți clic pe butonul Ok pentru a trimite mesajul. În acest fel, serviciul HLR lookup va căuta informații despre numărul de telefon. Acesta va atașa informațiile mesajului.

trimite sms de test
Figura 15 - Trimite SMS de test

Verificați etichetele mesajului trimis

Dacă ați trimis cu succes mesajul și acesta a fost înregistrat, acesta va fi vizibil în folderul Sent. Pentru a verifica informațiile de care aveți nevoie în etichete, căutați panoul de informații despre utilizator din partea stângă (Figura 16). În caseta de grup Folders, puteți găsi folderul Sent. Faceți clic pe el și verificați lista de mesaje trimise. Sub listă, veți găsi panoul Message details. Aici puteți vedea toate informațiile despre mesajul înregistrat. Căutați fila Tags lângă fila Delivery history. Faceți clic pe ea și vi se vor prezenta etichetele pe care serviciul HLR Lookup le-a atașat mesajului. Aici, trebuie să găsiți câmpul hlr_original_country_code. Acesta indică locul în care numărul de telefon este înregistrat inițial. Copiați această informație undeva pentru utilizare ulterioară.

etichete hlr ale mesajului sms
Figura 16 - Etichete HLR ale mesajului SMS

Adăugați o nouă rută conform HLR

Pentru a avea mesajul livrat cu succes, trebuie să creați o rută pentru acesta conform informațiilor obținute de la serviciul HLR. Pentru a face acest lucru, deschideți Route list cu Route icon situat în Toolbar (Figura 17). Acum veți găsi un buton albastru intitulat Create new Route. Faceți clic pe el pentru a deschide panoul Route details panel din partea dreaptă a ecranului. Acolo veți găsi caseta de grup Settings group box. În acea casetă de grup veți găsi câmpul de introducere To. Aici trebuie să furnizați adresa clientului SMPP creat.

adaugă o nouă regulă de rutare bazată pe hlr
Figura 17 - Adaugă o nouă regulă de rutare bazată pe HLR

Adaugă o nouă condiție de rutare

În panoul Detalii rută, poți găsi pagina Tab-ul Match. Aici vei vedea o Casă de grup pentru tag-uri (Figura 18). În această casă de grup, poți adăuga un nume de tag care va fi detectat și o valoare de tag care va fi folosită ca condiție pentru detectare. Lângă fiecare câmp de introducere, va exista o pictogramă de ajutor, care poate fi folosită pentru a obține mai multe informații despre ce trebuie să introduci în caseta de text.

adaugă tag-uri pentru potrivirea rutării
Figura 18 - Adaugă tag-uri pentru potrivirea rutării

În caseta de grup Nume tag, lipește textul hlr_original_country_code care a fost copiat din tag-urile mesajului trimis. Lipește valoarea hlr_original_country_code în această casetă de text. Astfel, dacă gateway-ul detectează că un mesaj este trimis cu valoarea furnizată, va folosi automat acest protocol SMPP potrivit pentru trimiterea SMS-ului. În exemplul dat, acesta este tag-ul GB (Figura 19).

definește tag HLR pentru rutare
Figura 19 - Definește tag HLR pentru rutare

Trimite un nou mesaj de test

Acum este momentul să trimiți un nou mesaj de test. La fel ca înainte, dă clic pe Pictograma Nou din Bara de unelte. Aceasta te va duce la pagina Compunere mesaj nou. În caseta de text Adresă, trebuie să introduci numărul de telefon căruia i-ai trimis ultimul mesaj de test. Sub aceasta, poți vedea un câmp de introducere Mesaj. Introdu textul de test pentru ruta HLR. Dă clic pe butonul Ok pentru a trimite mesajul. (Figura 20)

trimite un nou mesaj de test
Figura 20 - Trimite un nou mesaj de test

Mesaj de test trimis cu succes

Pe pagina Istoric livrare mesaje, poți confirma că acum mesajul de test a fost trimis prin noua conexiune SMS configurată. Primul mesaj de test avea statutul trimis. Acum, acest nou mesaj SMS configurat are statutul Trimis acceptat de către receptor. Acum poți folosi această conexiune SMPP configurată pentru a trimite mesaje în țara pentru care ai furnizat codul ca valoare de tag.

mesaj trimis prin conexiunea SMS configurată
Figura 21 - Mesaj trimis prin conexiunea SMS configurată

More information