Kako poslati SMS z uporabo MTN Developer API-jev (MADAPI)

Ta vodič razlaga, kako lahko dostopate do MTN-jevih API-jev z dodano vrednostjo prek portala za razvijalce MTN (https://developers.mtn.com/). Prikazuje vam, kako pridobiti dostopni žeton za razvijalce in kako uporabiti MTN SMS API v2 za pošiljanje SMS sporočil z uporabo Ozeki SMS Gateway.

• https://sandbox.api.mtn.com/oauth/client_credential/accesstoken?grant_type=client_credentials
• https://api.mtn.com/v2/messages/sms/outbound

MTN kot panafriški mobilni operater ponuja storitve SMS (pošiljanje in prejemanje SMS-ov) za svoje poslovne partnerje in uporabnike mobilnih telefonov.

To je implementacija protokola za MTN-ovo spletno storitev SMS.

MTN MAD API je enoten API, ki vključuje različne neodvisne mikrostoritve (kot so API za mobilni denar, API za SMS in USSD, API za tržnico Chenosis itd.) Do teh storitev dostopajo MTN in partnerji prek MAD API-ja. Povezave storitev MAD-API so zagotovljene prek Google Apigee prek enotnega API-ja prehoda in portala za zagotavljanje.

MADAPI je platforma, kjer MTN-ov API za sporočanje SMS omogoča razvijalcem, da vgradijo sporočanje SMS v svoje poslovne aplikacije.

Kako se registrirati na Madapi Developer Portal

Naslednji video vas bo popeljal skozi enostaven postopek registracije na Madapi Developer Portal, kjer se lahko naučite o možnostih razvoja API-jev. Odkrijte moč MTN-jevih API-jev, ki lahko izboljšajo vaše aplikacije, izboljšajo komunikacijo in poenostavijo vaše projekte. Sledite nam, ko demonstriramo enostavnost in učinkovitost uporabe MTN SMS API v2 v kombinaciji z Ozeki SMS Gateway za brezhibno pošiljanje SMS sporočil.

Za začetek postopka se morate registrirati na spletni strani https://developers.mtn.com/ s klikom na gumb "Register" v zgornjem desnem kotu strani. Ta registracija vam bo omogočila ustvarjanje aplikacije; samo sledite preprostim korakom registracije. Sledite tem korakom za ustvarjanje vašega računa:

S klikom na gumb "Register" se prikaže registracijska stran, kjer je potrebno vnesti nekaj osebnih podatkov, kot so ime in e-poštni naslov. Poskrbite, da uporabite veljaven e-poštni naslov, saj bo ta uporabljen za komunikacijo in namene preverjanja. Nato kliknite na gumb "Next". Dodajte tudi svoj priimek. Ponovno izberite gumb "Next".

Izberite močno, edinstveno geslo za svoj račun, ki združuje velike in male črke, številke in posebne znake zaradi varnosti. Ko ustvarite svoje geslo, ga potrdite tako, da ga znova vnesete, nato kliknite gumb "Next", da nadaljujete na naslednjo stopnjo.

Za nadaljevanje izberite svojo državo prebivališča med ponujenimi možnostmi in ko izberete, kliknite na gumb "Next". To vas bo pripeljalo do naslednje stopnje registracijskega postopka. Preberite pogoje uporabe, politiko zasebnosti in druge ustrezne dogovore, ki jih ponuja MTN. Če se strinjate z njihovimi pogoji, potrdite ustrezno polje, da date soglasje.

Po zaključku registracijskega obrazca bo na vaš e-poštni naslov poslano sporočilo. Kliknite na potrditveno povezavo v tem sporočilu, da potrdite svoj račun in ga aktivirate. Vnesti morate avtentikacijsko kodo, ki jo boste prejeli prek aplikacije Google Authenticator. Če te aplikacije še nimate, jo pridobite na kateri koli digitalni platformi za distribucijo programske opreme, kot sta Google Play ali App Store.

Prenesite Google Authenticator na svoj Android mobilni telefon iz trgovine Google Play ali App Store, če uporabljate iOS napravo.

Zdaj morate dodeliti račun Google Authenticator, da boste lahko avtenticirali svoj MTN račun. Tapnite na gumb "+" ali "Add" v aplikaciji, da nastavite nov račun. Vnesite svoje podatke, ki so navedeni v MTN-jevem potrditvenem e-poštnem sporočilu. Imeli boste dve možnosti za dodajanje svojega MTN računa: Če MTN ponuja QR kodo, uporabite aplikacijo Google Authenticator, da jo skenirate. To bo samodejno nastavilo račun v aplikaciji. Če QR koda ni na voljo, lahko ročno vnesete podatke o računu.

Vnesti boste morali ime računa, vaš MTN e-poštni naslov in skrivni ključ ali avtentikacijsko kodo, ki jo je posredoval MTN. Izberite ime za identifikacijo vašega MTN računa v aplikaciji Google Authenticator. Vnesite e-poštni naslov, povezan z vašim MTN računom. Prilepite svoj skrivni ključ, ki je edinstvena koda, ki jo je posredoval MTN posebej za omogočanje dvofaktorske avtentikacije (2FA) z Google Authenticator.

Ko dodate račun v Google Authenticator, bo aplikacija začela generirati šestmestna enkratna gesla (OTP), ki se spreminjajo vsakih 30 sekund. Vrnite se na MTN-jev potrditveni e-poštni naslov, kjer bi morali najti polje za vnos verifikacijske kode, ki jo je ustvarila aplikacija Google Authenticator. Vnesite trenutno kodo iz aplikacije Google Authenticator v določeno polje na potrditvenem e-poštnem sporočilu. Kliknite na gumb "Authenticate", da dokončate postopek nastavitve. S klikom na gumb "Authenticate" se bo prikazal MTN-jev razvijalski portal. Tam lahko vidite stran Moj profil, kjer lahko personalizirate svoj račun in ogledate predhodno nastavljene podrobnosti računa.

Za prijavo v vaš račun naložite stran https://developers.mtn.com/ in vnesite svoj e-poštni naslov in geslo v ustrezna polja, nato kliknite na gumb "Prijava" na dnu strani.

Po tem je potrebno vnesti 2FA avtentikacijsko kodo, ki jo zagotovi aplikacija Google Authenticator. Vnesite dano geslo, nato izberite gumb "Avtentikacija" za dokončanje postopka prijave.

Kako ustvariti aplikacijo

V tem kratkem videoposnetku boste izvedeli, kako ustvariti aplikacijo z uporabo MTN SMS API v2, v sodelovanju z Ozeki SMS Gateway, kar vam omogoča brezhibno pošiljanje SMS sporočil. Sledite navodilom po korakih, da vidite učinkovitost in enostavnost integracije teh orodij v vaše projekte.

Najprej kliknite na gumb "Ustvari aplikacijo" v zgornjem desnem kotu strani. Ta gumb bo začel postopek ustvarjanja aplikacije in vam omogočil, da začnete z pregledovanjem številnih možnosti razvoja na platformi MTN za razvijalce.

Vnesti morate nekaj osnovnih podatkov, povezanih z aplikacijo. Ti podatki so potrebni za nastavitev in konfiguracijo vaše aplikacije znotraj platforme MTN za razvijalce. Izberite edinstveno ime za vašo aplikacijo. To ime bo uporabljeno za identifikacijo vaše aplikacije znotraj razvijalskega portala. Opcijsko lahko napišete kratek opis namena in funkcionalnosti vaše aplikacije. Nato kliknite na gumb "Izberi države".

Po vnosu potrebnih podatkov, povezanih z vašo aplikacijo, je naslednji korak izbrati državo, iz katere prihajate in s katero želite povezati svojo aplikacijo. Ta izbira pomaga MTN prilagoditi in optimizirati storitve in API-je, ki so na voljo vaši aplikaciji glede na zahteve in predpise določene regije.

Zdaj izberite možnost MTN SMS V2 vmesnika s seznama izdelkov. Kliknite na "+" gumb, ki se nahaja v spodnjem desnem kotu opisa izdelka. S klikom nanj boste ustvarili ta SMS vmesnik s podporo za povratne klice.

Za začetek postopka ustvarjanja aplikacije poiščite gumb "Ustvari aplikacijo" in kliknite nanj.

Če je bila aplikacija uspešno ustvarjena, boste prejeli obvestilo o ustvarjanju. Nato boste preusmerjeni na stran s povzetkom, ki ponuja pregled vaših odobrenih aplikacij. Na strani s povzetkom boste našli nekaj podrobnosti o aplikacijah. Če imate kakšno aplikacijo, ki ni bila uspešno nameščena, potem boste v tem primeru videli seznam aplikacij pod naslovom "Preklicane aplikacije".

Zdaj bomo razložili, kako dodati storitev SMS V2 v vašo aplikacijo. Če želite dodati storitev SMS V2 v vašo aplikacijo, morate urediti podrobnosti aplikacije na strani Moje aplikacije, pod zavihkom Odobrene aplikacije.

Spremenite podrobnosti aplikacije. Spremenite ime vaše aplikacije. Spremenite opis vaše aplikacije, da bolje odraža njen namen in funkcionalnost. Dodajte ali spremenite URL-je, na katere naj bodo uporabniki preusmerjeni. Kliknite na gumb "Uredi", da spremenite aplikacijo. Po spremembah se prepričajte o točnosti, nato kliknite na gumb "Naprej" za nadaljevanje na naslednji korak.

Po zaključku teh korakov kliknite na kljukico v črnem krogu. Storitev SMS V2 bo uspešno dodana v vašo aplikacijo. Zdaj lahko izkoristite MTN-jeve SMS zmogljivosti za izboljšanje komunikacije.

V prihajajočem videu bomo prikazali postopek po korakih za kopiranje ključa stranke in produkcijskega ključa v Ozeki 10. Ta postopek omogoča brezhibno integracijo med obema platformama, kar vam omogoča izkoriščanje funkcij MTN-jevih API-jev in Ozeki 10 za izboljšanje vaših sporočilnih zmogljivosti in poenostavitev komunikacije z uporabniki.

Za začetek se prijavite v svoj račun Ozeki SMS Gateway. Če še nimate računa, lahko programsko opremo prenesete s spletnega mesta https://ozeki.hu/. Ko imate račun pripravljen, odprite Ozeki Gateway na Ozeki namizju, da dostopate do upravljalnega vmesnika prehoda in konfigurirate nastavitve pošiljanja sporočil. Kliknite na povezavo "Dodaj novo povezavo..." na plošči Povezave ali izberite ikono "Poveži" v orodni vrstici.

S klikom nanj se prikaže seznam z različnimi možnostmi odjemalcev, ki jih je mogoče namestiti. Poiščite "MTN MADAPI odjemalca", ki vam omogoča ustvarjanje odhodnih SMS zahtevkov z uporabo MTN SMS V2 API, nato kliknite na povezavo "Namesti".

Ob namestitvi MTN MADAPI odjemalca se prikaže stran, kjer morate vnesti nekaj podrobnosti za nastavitev povezave. Naložite MNP-jev portal za razvijalce in kopirajte potrošniški ključ in skrivne kode.

Te kode prilepite v določena polja v Ozeki SMS Gateway. Ko ste kode prilepili v ustrezne odseke, se pomaknite na dno strani. Za shranjevanje sprememb in potrditev integracije kliknite gumb "V redu". Shranjevanje kod z gumbom "V redu" bo zagotovilo, da je Ozeki SMS Gateway pravilno konfiguriran za delo z MTN-jevimi API-ji.

Kako preveriti, ali ste prejeli svoj dostopni žeton

Po shranjevanju podrobnosti v nadzorni plošči Ozeki SMS Gateway se pomaknite na zavihek "Dogodki". Tukaj boste na levi strani plošče našli drsni gumb. Prestavite drsni gumb v zeleni položaj. Če je bila nastavitev uspešna, boste v plošči Dogodki prejeli obvestilo z oznako "Dostopni žeton". To pomeni, da je integracija med MTN-jevimi API-ji in Ozeki SMS Gateway zdaj aktivna, vaša aplikacija pa lahko dostopa do potrebnega avtentikacijskega žetona za brezhibno komunikacijo z MTN-jevimi storitvami.

V prihajajočem videu vam bomo podali navodila po korakih, kako poslati testno SMS sporočilo z uporabo integrirane storitve MTN SMS prek Ozeki SMS Gateway. Vodili vas bomo skozi postopek sestavljanja in pošiljanja testnega sporočila, da boste lahko učinkovito komunicirali z želenimi prejemniki. Poleg tega vam bomo pokazali, kako preveriti dnevnik v Ozeki SMS Gateway za spremljanje stanja in podrobnosti dostave poslanih SMS sporočil.

Kot prvi korak se prijavite v svoj račun Ozeki SMS Gateway in naložite domačo stran Ozeki. Izberite povezavo MNT_MADAPI_client. Odprite zavihek "Test" pri podrobnostih MNT_MADAPI_client. Tam lahko ustvarite SMS sporočilo. Za ustvarjanje vnesite telefonsko številko prejemnika v določeno polje, nato pa vnesite besedilo sporočila v polje SMS.

Po vnosu teh podatkov kliknite gumb "Pošlji".

Ko odprete zavihek Dogodki v Ozeki SMS Gateway, si lahko ogledate stanje poslanega sporočila. Če je bilo sporočilo uspešno poslano, boste prejeli obvestilo z oznako "Uspešno inicializirano." To obvestilo potrjuje, da je bil SMS dostavljen prejemniku brez težav.

Vodnik ponuja navodila po korakih za uporabo MTN Developer API-jev (MADAPI) v povezavi z Ozeki SMS Gateway za nemoteno pošiljanje SMS sporočil. Z upoštevanjem vodnika lahko razvijalci dostopajo do MTN API-jev z dodano vrednostjo prek MTN portala za razvijalce, pridobijo dostopni žeton in uporabijo MTN SMS API v2 za pošiljanje SMS sporočil. Skupaj MTN Developer API-ji in Ozeki SMS Gateway ponujajo razvijalcem uporabno in zanesljivo rešitev za vključevanje SMS sporočil v svoje aplikacije, kar omogoča učinkovito komunikacijo in izboljša uporabniško izkušnjo.