Kako poslati SMS koristeći MTN Developer API-je (MADAPI)
Ovaj vodič objašnjava kako možete pristupiti MTN API-jima s dodanom vrijednošću putem MTN developer portala (https://developers.mtn.com/). Pokazuje vam kako dobiti developerski Access token i kako koristiti MTN SMS API v2 za slanje SMS poruka koristeći Ozeki SMS Gateway.
API URL-ovi
- https://sandbox.api.mtn.com/oauth/client_credential/accesstoken?grant_type=client_credentials
- https://api.mtn.com/v2/messages/sms/outbound
Što je MTN SMS usluga?
MTN, kao panafrički mobilni operater, pruža SMS usluge (slanje i primanje SMS-ova) za svoje poslovne partnere i korisnike mobilnih telefona.
Što je MADAPI protokol?
To je implementacija protokola MTN-ove online SMS usluge.
Što je MADAPI API?
MTN MAD API je jedinstveni API koji uključuje različite nezavisne mikroservise (kao što su Mobile Money API, SMS i USSD API, Chenosis Marketplace API, itd.) Tim uslugama pristupaju MTN i partneri putem MAD API-ja. MAD-API veze pruža Google Apigee putem jedinstvenog API pristupnika i portala za dodjelu resursa.
Kako funkcionira MADAPI API?
MADAPI je platforma gdje MTN-ov SMS Messaging API omogućuje programerima da ugradnju SMS poruka u svoje poslovne aplikacije.
Sljedeći video vodi vas kroz jednostavan proces registracije na Madapi Developer Portalu, gdje možete naučiti o mogućnostima razvoja API-ja. Otkrijte snagu MTN-ovih API-ja koji mogu unaprijediti vaše aplikacije, poboljšati komunikaciju i pojednostaviti vaše projekte. Pratite dok demonstriramo jednostavnost i učinkovitost korištenja MTN SMS API v2 u kombinaciji s Ozeki SMS Gatewayem za besprijekorno slanje SMS poruka.
Za početak procesa, potrebno je registrirati se na web stranici https://developers.mtn.com/, klikom na gumb "Registriraj se" u gornjem desnom kutu stranice. Ova registracija omogućit će vam stvaranje aplikacije; samo slijedite jednostavne korake registracije. Slijedite ove korake za stvaranje vašeg računa:
Klikom na gumb "Registriraj se" otvorit će se stranica za registraciju, gdje je potrebno unijeti neke osobne podatke, poput imena i adrese e-pošte. Obavezno koristite valjanu adresu e-pošte jer će se koristiti za komunikaciju i potvrdu. Nakon toga, kliknite na gumb "Dalje". Dodajte i svoje prezime. Ponovno odaberite gumb "Dalje".
Odaberite jaku, jedinstvenu lozinku za svoj račun koja kombinira velika i mala slova, brojeve i posebne znakove radi sigurnosti. Nakon što ste kreirali lozinku, potvrdite je ponovnim unosom, zatim kliknite na gumb "Dalje" da biste prešli na sljedeću fazu.
Za nastavak, odaberite svoju zemlju prebivališta iz ponuđenih opcija, a nakon što ste odabrali, kliknite na gumb "Dalje". To će vas odvesti na sljedeću fazu procesa registracije. Pročitajte uvjete korištenja, politiku privatnosti i sve druge relevantne ugovore koje pruža MTN. Ako se slažete s njihovim uvjetima, označite odgovarajući okvir kako biste dali svoj pristanak.
Nakon dovršetka obrasca za registraciju, na adresu e-pošte koju ste naveli bit će poslan e-mail. Kliknite na poveznicu za potvrdu u tom e-mailu kako biste potvrdili svoj račun i aktivirali ga. Potrebno je unijeti autentifikacijski kod koji ćete dobiti putem svoje Google Authenticator aplikacije. Ako još nemate ovu aplikaciju, preuzmite je s bilo koje platforme za digitalnu distribuciju softvera, poput Google Play ili App Storea.
Preuzmite Google Authenticator na svoj Android mobilni telefon s Google Play ili App Storea ako koristite iOS uređaj.
Sada morate dodijeliti Google Authenticator račun kako biste mogli autentificirati svoj MTN račun. Dodirnite "+" ili "Dodaj" gumb unutar aplikacije kako biste postavili novi račun. Unesite svoje podatke, navedene u MTN-ovom e-mailu za potvrdu. Imat ćete dvije opcije za dodavanje svog MTN računa: Ako MTN pruža QR kod, koristite Google Authenticator aplikaciju da ga skenirate. To će automatski postaviti račun unutar aplikacije. Ili ako nema QR koda, možete ručno unijeti podatke o računu.
Morat ćete unijeti naziv računa, svoju MTN e-mail adresu i tajni ključ ili autentifikacijski kod koji pruža MTN. Odaberite naziv za identifikaciju vašeg MTN računa unutar Google Authenticator aplikacije. Unesite e-mail adresu povezanu s vašim MTN računom. Zalijepite svoj tajni ključ, koji je jedinstveni kod koji pruža MTN posebno za omogućavanje dvofaktorske autentifikacije (2FA) s Google Authenticatorom.
Nakon što ste dodali račun u Google Authenticator, aplikacija će početi generirati šestoznamenkaste jednokratne lozinke (OTP) koje se mijenjaju svakih 30 sekundi. Vratite se na MTN-ov e-mail za potvrdu, gdje biste trebali pronaći polje za unos verifikacijskog koda generiranog od strane Google Authenticator aplikacije. Unesite trenutni kod iz Google Authenticator aplikacije u određeno polje na e-mailu za potvrdu. Kliknite na gumb "Autentificiraj" kako biste dovršili proces postavljanja. Klikom na gumb "Autentificiraj", pojavit će se MTN-ov developerski portal. Tamo možete vidjeti stranicu Moj Profil, gdje možete personalizirati svoj račun i pregledati prethodno postavljene podatke o računu.
Da biste se prijavili na svoj račun, učitajte stranicu https://developers.mtn.com/ i unesite svoju email adresu i lozinku u odgovarajuća polja, zatim kliknite na gumb "Prijavi se" na dnu stranice.
Nakon toga, potrebno je unijeti 2FA autentifikacijski kod, koji je dostupan u aplikaciji Google Authenticator. Unesite dobivenu lozinku, zatim odaberite gumb "Autentificiraj" kako biste dovršili proces prijave.
Kako kreirati aplikaciju
U ovom kratkom videu otkrit ćete kako kreirati aplikaciju koristeći MTN SMS API v2, u suradnji s Ozeki SMS Gatewayem, što vam omogućuje besprijekorno slanje SMS poruka. Slijedite korak-po-korak vodič kako biste vidjeli učinkovitost i jednostavnost integracije ovih alata u svoje projekte.
Prvo, kliknite na gumb "Izradi aplikaciju" u gornjem desnom kutu stranice. Ovaj gumb će pokrenuti proces kreiranja aplikacije i omogućiti vam da započnete pregledavanjem brojnih opcija razvoja na MTN developerskoj platformi.
Potrebno je unijeti neke osnovne podatke vezane uz aplikaciju. Ovi podaci su nužni za postavljanje i konfiguraciju vaše aplikacije unutar MTN developerske platforme. Odaberite jedinstveno ime za svoju aplikaciju. Ovo ime će se koristiti za identifikaciju vaše aplikacije unutar developerskog portala. Opcionalno je napisati kratak opis svrhe i funkcionalnosti vaše aplikacije. Nakon toga, kliknite na gumb "Odaberi zemlje".
Nakon unosa potrebnih podataka vezanih uz vašu aplikaciju, sljedeći korak je odabir zemlje iz koje dolazite i koju želite povezati sa svojom aplikacijom. Ovaj odabir pomaže MTN-u prilagoditi i optimizirati usluge i API-je dostupne vašoj aplikaciji prema zahtjevima i propisima specifične regije.
Sada odaberite opciju MTN SMS V2 sučelja s popisa proizvoda. Kliknite na "+" gumb smješten u donjem desnom kutu opisa proizvoda. Klikom na njega, kreirat ćete ovo SMS sučelje s podrškom za povratni poziv.
Da biste pokrenuli proces kreiranja aplikacije, pronađite gumb "Kreiraj aplikaciju", zatim kliknite na njega.
Ako je aplikacija uspješno kreirana, dobit ćete obavijest o kreiranju. Nakon toga, bit ćete preusmjereni na stranicu s pregledom koja pruža pregled vaših odobrenih aplikacija. Na stranici s pregledom pronaći ćete neke detalje o aplikacijama. Ako imate aplikacija koje nisu uspješno instalirane, tada ćete u tom slučaju vidjeti popis aplikacija pod naslovom "Opozvano aplikacije".
Kako dodati SMS V2 uslugu u svoju aplikaciju
Sada ćemo objasniti kako dodati SMS V2 uslugu u svoju aplikaciju. Da biste dodali SMS V2 uslugu u svoju aplikaciju, potrebno je urediti detalje aplikacije na stranici Moje aplikacije, pod karticom Odobrene aplikacije.
Unesite promjene u detaljima aplikacije. Promijenite naziv svoje aplikacije. Izmijenite opis svoje aplikacije kako bi bolje odražavao njezinu svrhu i funkcionalnost. Dodajte ili izmijenite URL-ove na koje bi korisnici trebali biti preusmjereni. Kliknite na gumb "Uredi", kako biste izmijenili aplikaciju. Nakon što unesete promjene, provjerite točnost, zatim kliknite na gumb "Dalje" kako biste nastavili na sljedeći korak.
Nakon što dovršite ove korake, kliknite na kvačicu u crnom krugu. SMS V2 usluga će biti uspješno dodana u vašu aplikaciju. Sada možete iskoristiti MTN-ove SMS mogućnosti kako biste poboljšali komunikaciju.
U nadolazećem videu, pokazat ćemo korak po korak postupak kopiranja korisničkog ključa i Production secret u Ozeki 10. Ovaj postupak omogućuje besprijekornu integraciju između dvije platforme, što vam omogućuje iskorištavanje mogućnosti MTN-ovih API-ja i Ozeki 10 za poboljšanje vaših mogućnosti slanja poruka i pojednostavljenje komunikacije s vašim korisnicima.
Za početak, prijavite se na svoj Ozeki SMS Gateway račun. Ako još nemate račun, možete preuzeti softver s web stranice https://ozeki.hu/. Nakon što imate spreman račun, otvorite Ozeki Gateway na Ozeki Desktopu kako biste pristupili sučelju za upravljanje gatewayom i konfigurirali postavke slanja poruka. Kliknite na poveznicu "Add new connections..." na ploči Connections ili odaberite ikonu "Connect" na alatnoj traci.
Klikom na nju, pojavit će se popis s različitim opcijama klijenata koje se mogu instalirati. Pronađite "MTN MADAPI client" koji vam omogućuje stvaranje odlaznih SMS zahtjeva koristeći MTN SMS V2 API, zatim kliknite na poveznicu "Install".
Instaliranjem MTN MADAPI klijenta, otvorit će se stranica gdje morate unijeti neke detalje za postavljanje veze. Učitajte MNP-ov Developers Portal i kopirajte consumer key i secret kodove.
Zalijepite ove kodove u odgovarajuća polja u Ozeki SMS Gatewayu. Nakon što zalijepite kodove u odgovarajuće odjeljke, pomaknite se do dna stranice. Kako biste spremili promjene i potvrdili integraciju, kliknite na gumb "Ok". Spremanje kodova s gumbom "Ok" osigurat će da je Ozeki SMS Gateway sada ispravno konfiguriran za rad s MTN-ovim API-jima.
Kako provjeriti da ste primili svoj access token
Nakon što spremite detalje u upravljačkoj ploči Ozeki SMS Gatewaya, idite na karticu "Events". Ovdje ćete pronaći klizač na lijevoj strani ploče. Pomaknite klizač u zeleni položaj. Ako je postavljanje bilo uspješno, primit ćete obavijest s oznakom "Access Token" u ploči Events. Ovo označava da je integracija između MTN-ovih API-ja i Ozeki SMS Gatewaya sada aktivna, a vaša aplikacija može pristupiti potrebnom autentifikacijskom tokenu za besprijekornu komunikaciju s MTN-ovim uslugama.
Kako poslati testni SMS i kako provjeriti zapisnike
U nadolazećem videu, pružit ćemo vam korak po korak vodič kako poslati testni SMS koristeći integriranu MTN SMS uslugu kroz Ozeki SMS Gateway. Vodit ćemo vas kroz proces sastavljanja i slanja testne poruke, osiguravajući da možete učinkovito komunicirati s namjeravanim primateljima. Dodatno, pokazat ćemo vam kako provjeriti zapisnike unutar Ozeki SMS Gatewaya kako biste pratili status i detalje isporuke poslanih SMS poruka.
Kao prvi korak, prijavite se na svoj Ozeki SMS Gateway račun i učitajte Ozeki Home stranicu. Odaberite MNT_MADAPI_client vezu. Otvorite karticu "Test" u detaljima MNT_MADAPI_clienta. Ovdje možete kreirati SMS poruku. Za kreiranje, unesite broj telefona primatelja u određeno polje, zatim unesite tekst poruke u SMS polje.
Nakon unosa ovih podataka, kliknite na gumb "Send".
Nakon otvaranja kartice Event u Ozeki SMS Gatewayu, moći ćete vidjeti status poslane poruke. Ako je poruka uspješno poslana, primit ćete obavijest s oznakom "Successfully initialized." Ova obavijest potvrđuje da je SMS isporučen primatelju bez ikakvih problema.
Vodič pruža korak-po-korak upute o korištenju MTN Developer API-ja (MADAPI) u vezi s Ozeki SMS Gateway-om za besprijekorno slanje SMS poruka. Prateći vodič, programeri mogu pristupiti MTN API-jima s dodanom vrijednošću putem MTN developer portala, dobiti developerski pristupni token i koristiti MTN SMS API v2 za slanje SMS poruka. Sveukupno, kombinacija MTN Developer API-ja i Ozeki SMS Gateway-a nudi programerima korisno i pouzdano rješenje za integraciju SMS poruka u njihove aplikacije, omogućujući učinkovitu komunikaciju i poboljšavajući korisničko iskustvo.