Kako poslati SMS koristeći MTN Developer API-je (MADAPI)

Ovaj vodič objašnjava kako možete pristupiti MTN API-jima za dodatu vrednost preko MTN developer portala (https://developers.mtn.com/). Pokazuje vam kako da dobijete developer Access token i kako da koristite MTN SMS API v2 za slanje SMS poruka koristeći 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, kao pan-afrički mobilni operator, pruža SMS usluge (slanje i prijem SMS poruka) za svoje poslovne partnere i korisnike mobilnih telefona.

To je implementacija protokola MTN-ovog online SMS servisa.

MTN MAD API je unificirani API koji uključuje različite nezavisne mikroservise (kao što su Mobile Money API, SMS i USSD API, Chenosis Marketplace API, itd.) Ovim servisima pristupaju MTN i partneri preko MAD API-ja. MAD-API veze za servise obezbeđuje Google Apigee preko unificiranog API gejta i portala za provisioning.

MADAPI je platforma gde MTN-ov SMS Messaging API omogućava programerima da ugradе SMS poruke u svoje poslovne aplikacije.

Kako se registrovati na Madapi Developer Portal

Sledeći video će vas provesti kroz jednostavan proces registracije na Madapi Developer Portal-u, gde možete naučiti o mogućnostima razvoja API-ja. Otkrijte snagu MTN-ovih API-ja koji mogu unaprediti vaše aplikacije, poboljšati komunikaciju i pojednostaviti vaše projekte. Pratite dok demonstriramo jednostavnost i efikasnost korišćenja MTN SMS API v2 u kombinaciji sa Ozeki SMS Gateway-om za besprekorno slanje SMS poruka.

Da biste započeli proces, potrebno je da se registrujete na https://developers.mtn.com/ sajtu, klikom na dugme "Register" u gornjem desnom uglu stranice. Ova registracija će vam omogućiti da kreirate aplikaciju; samo pratite jednostavne korake registracije. Pratite ove korake da biste kreirali svoj nalog:

Klikom na dugme "Register" otvara se stranica za registraciju, gde je potrebno uneti neke lične podatke, kao što su ime, e-mail adresa. Obavezno koristite validnu e-mail adresu jer će se ona koristiti za komunikaciju i verifikaciju. Nakon toga, kliknite na dugme "Next". Dodajte i svoje prezime. Ponovo izaberite dugme "Next".

Izaberite jaku, jedinstvenu lozinku za svoj nalog koja kombinuje velika i mala slova, brojeve i specijalne karaktere radi bezbednosti. Kada kreirate lozinku, potvrdite je ponovnim unosom, zatim kliknite na dugme "Next" da biste prešli na sledeći korak.

Da biste nastavili, izaberite svoju zemlju prebivališta iz ponuđenih opcija, i nakon što izaberete, kliknite na dugme "Next". Ovo će vas odvesti na sledeći korak registracije. Pročitajte uslove korišćenja, politiku privatnosti i druge relevantne ugovore koje pruža MTN. Ako se slažete sa njihovim uslovima, označite odgovarajuću kutiju da biste dali svoj pristanak.

Nakon popunjavanja registracionog formulara, e-mail će biti poslat na adresu koju ste naveli. Kliknite na verifikacioni link u tom e-mailu da biste potvrdili svoj nalog i aktivirali ga. Potrebno je da unesete autentifikacioni kod koji ćete dobiti putem svoje Google Authenticator aplikacije. Ako još uvek nemate ovu aplikaciju, preuzmite je sa bilo koje platforme za digitalnu distribuciju softvera, kao što su Google Play ili App Store.

Preuzmite Google Authenticator na svoj Android mobilni telefon sa Google Play-a ili App Store-a ako koristite iOS uređaj.

Sada, potrebno je da dodelite Google Authenticator nalog, kako biste mogli da autentifikujete svoj MTN nalog. Dodirnite "+" ili "Add" dugme unutar aplikacije da biste podesili novi nalog. Unesite svoje podatke, koje ste dobili u MTN-ovom verifikacionom e-mailu. Imaćete dve opcije za dodavanje svog MTN naloga: Ako MTN pruža QR kod, koristite Google Authenticator aplikaciju da biste ga skenirali. Ovo će automatski podesiti nalog unutar aplikacije. Ili ako nema dostupnog QR koda, možete ručno uneti podatke o nalogu.

Biće potrebno da unesete naziv naloga, vašu MTN e-mail adresu i tajni ključ ili autentifikacioni kod koji vam je pružio MTN. Izaberite naziv za identifikaciju vašeg MTN naloga unutar Google Authenticator aplikacije. Unesite e-mail adresu povezanu sa vašim MTN nalogom. Nalepite svoj tajni ključ, koji je jedinstveni kod koji vam je pružio MTN posebno za omogućavanje dvofaktorske autentifikacije (2FA) sa Google Authenticator-om.

Nakon što ste dodali nalog u Google Authenticator, aplikacija će početi da generiše šestocifrene jednokratne lozinke (OTP) koje se menjaju svakih 30 sekundi. Vratite se na MTN-ov verifikacioni e-mail, gde biste trebali pronaći polje za unos verifikacionog koda generisanog od strane Google Authenticator aplikacije. Unesite trenutni kod iz Google Authenticator aplikacije u određeno polje u verifikacionom e-mailu. Kliknite na dugme "Authenticate" da biste završili proces podešavanja. Klikom na dugme "Authenticate", pojaviće se MTN-ov developer portal. Tamo možete videti stranicu Moj Profil, gde možete personalizovati svoj nalog i pogledati prethodno postavljene detalje naloga.

Kako se prijaviti koristeći Google Authenticator

Da biste se prijavili na svoj nalog, učitajte stranicu https://developers.mtn.com/ i unesite svoju email adresu i lozinku u odgovarajuća polja, zatim kliknite na dugme "Prijavi se" na dnu stranice.

Nakon toga, potrebno je uneti 2FA autentifikacioni kod, koji pruža Google Authenticator aplikacija. Unesite datu lozinku, zatim izaberite dugme "Autentifikuj" kako biste završili proces prijave.

U ovom kratkom videu, otkrićete kako da kreirate aplikaciju koristeći MTN SMS API v2, u saradnji sa Ozeki SMS Gateway-om, što vam omogućava da bez problema šaljete SMS poruke. Pratite korak-po-korak vodič kako biste videli efikasnost i lakoću integracije ovih alata u vaše projekte.

Prvo, kliknite na dugme "Napravi aplikaciju" u gornjem desnom uglu stranice. Ovo dugme će pokrenuti proces kreiranja aplikacije i omogućiti vam da pregledate brojne opcije razvoja na MTN platformi za developere.

Potrebno je uneti neke osnovne detalje vezane za aplikaciju. Ovi detalji su neophodni za postavljanje i konfiguraciju vaše aplikacije unutar MTN platforme za developere. Izaberite jedinstveno ime za vašu aplikaciju. Ovo ime će se koristiti za identifikaciju vaše aplikacije unutar portala za developere. Opciono je napisati kratak opis namene i funkcionalnosti vaše aplikacije. Nakon toga, kliknite na dugme "Izaberi zemlje".

Nakon unosa neophodnih detalja vezanih za vašu aplikaciju, sledeći korak je izbor zemlje iz koje dolazite i koju želite da povežete sa vašom aplikacijom. Ovaj izbor pomaže MTN-u da prilagodi i optimizuje usluge i API-je dostupne vašoj aplikaciji na osnovu zahteva i propisa specifične regije.

Sada, izaberite opciju MTN SMS V2 interfejsa sa liste proizvoda. Kliknite na "+" dugme koje se nalazi u donjem desnom uglu opisa proizvoda. Klikom na njega, kreiraćete ovaj SMS interfejs sa podrškom za povratni poziv.

Da biste pokrenuli proces kreiranja aplikacije, pronađite dugme "Kreiraj aplikaciju", zatim kliknite na njega.

Ako je aplikacija uspešno kreirana, dobićete obaveštenje o kreiranju. Nakon toga, bićete preusmereni na stranicu sa pregledom koja pruža pregled vaših odobrenih aplikacija. Na stranici sa pregledom, naći ćete neke detalje o aplikacijama. Ako imate aplikacija koje nisu uspešno instalirane, tada ćete videti listu aplikacija pod naslovom "Opozvano".

Sada ćemo objasniti kako dodati SMS V2 servis u vašu aplikaciju. Da biste dodali SMS V2 servis u vašu aplikaciju, potrebno je da izmenite detalje aplikacije na stranici Moje aplikacije, pod karticom Odobrene aplikacije.

Unesite izmene u detaljima aplikacije. Promenite naziv vaše aplikacije. Izmenite opis vaše aplikacije kako bi bolje odražavao njen cilj i funkcionalnost. Dodajte ili izmenite URL-ove na koje korisnici treba da budu preusmereni. Kliknite na dugme "Izmeni", kako biste izmenili aplikaciju. Nakon unošenja izmena, proverite tačnost, zatim kliknite na dugme "Sledeće" kako biste nastavili sa sledećim korakom.

Nakon završetka ovih koraka, kliknite na kvačicu u crnom krugu. SMS V2 servis će biti uspešno dodat u vašu aplikaciju. Sada možete koristiti MTN-ove SMS mogućnosti kako biste unapredili komunikaciju.

Kako kopirati korisnički ključ i Production secret u Ozeki 10

U narednom videu, pokazaćemo korak po korak proces kopiranja korisničkog ključa i Production secret-a u Ozeki 10. Ovaj postupak omogućava bespremnu integraciju između ove dve platforme, što vam omogućava da iskoristite prednosti MTN-ovih API-ja i Ozeki 10 kako biste poboljšali svoje mogućnosti slanja poruka i pojednostavili komunikaciju sa svojim korisnicima.

Za početak, prijavite se na svoj Ozeki SMS Gateway nalog. Ako još uvek nemate nalog, možete preuzeti softver sa https://ozeki.hu/ vebsajta. Nakon što pripremite svoj nalog, otvorite Ozeki Gateway na Ozeki Desktop-u kako biste pristupili interfejsu za upravljanje gateway-om i podesili postavke za slanje poruka. Kliknite na link "Add new connections..." u Connections panelu ili izaberite ikonu "Connect" u alatnoj traci.

Klikom na to, pojaviće se lista koja sadrži različite opcije klijenata koje se mogu instalirati. Pronađite "MTN MADAPI client" koji vam omogućava kreiranje odlazećih SMS zahteva koristeći MTN SMS V2 API, zatim kliknite na link "Install".

Instaliranjem MTN MADAPI klijenta, otvoriće se stranica gde morate uneti neke detalje kako biste podesili vezu. Učitajte MNP-ov Developers Portal i kopirajte consumer key i secret kodove.

Nalepite ove kodove u odgovarajuća polja u Ozeki SMS Gateway-u. Nakon što zalepite kodove u odgovarajuće sekcije, pomerite se do dna stranice. Da biste sačuvali promene i potvrdili integraciju, kliknite na dugme "Ok". Čuvanje kodova sa dugmetom "Ok" osigurava da je Ozeki SMS Gateway sada pravilno konfigurisan za rad sa MTN-ovim API-jima.

Kako proveriti da li ste primili svoj access token

Nakon što sačuvate detalje u Ozeki SMS Gateway kontrolnom panelu, idite na "Events" karticu. Ovde ćete naći klizač na levoj strani panela. Podesite klizač u zeleni položaj. Ako je podešavanje bilo uspešno, dobićete obaveštenje sa oznakom "Access Token" u Events panelu. Ovo označava da je integracija između MTN-ovih API-ja i Ozeki SMS Gateway-a sada aktivna, i vaša aplikacija može pristupiti neophodnom tokenu za autentifikaciju kako bi se bespremno komunicirala sa MTN-ovim servisima.

Kako poslati test SMS i kako proveriti logove

U narednom videu, pružićemo vodič korak po korak kako poslati test SMS koristeći integrisani MTN SMS servis preko Ozeki SMS Gateway-a. Vodićemo vas kroz proces sastavljanja i slanja test poruke, osiguravajući da možete efikasno komunicirati sa namenjenim primalacima. Dodatno, pokazaćemo vam kako proveriti logove unutar Ozeki SMS Gateway-a kako biste pratili status i detalje isporuke poslatih SMS poruka.

Kao prvi korak, prijavite se na svoj Ozeki SMS Gateway nalog i učitajte Ozeki Home stranicu. Izaberite MNT_MADAPI_client vezu. Otvorite karticu "Test" u detaljima MNT_MADAPI_client-a. Tamo možete kreirati SMS poruku. Za kreiranje, unesite broj telefona primaoca u određeno polje, zatim unesite tekst poruke u SMS polje.

Nakon unosa ovih podataka, kliknite na dugme "Send".

Nakon otvaranja kartice Event u Ozeki SMS Gateway-u, moći ćete videti status poslate poruke. Ako je poruka uspešno poslata, dobićete obaveštenje sa oznakom "Successfully initialized." Ovo obaveštenje potvrđuje da je SMS isporučen primalacu bez ikakvih problema.

Резиме

Водич пружа упутства корак по корак о томе како да користите MTN Developer API-је (MADAPI) у вези са Ozeki SMS Gateway-ем за беспрекоран слање SMS порука. Пратећи водич, програмери могу да приступе MTN API-јима за додатну вредност преко MTN developer портала, добију Access token за програмере и искористе MTN SMS API v2 за слање SMS порука. Укратко, комбинација MTN Developer API-ја и Ozeki SMS Gateway-а нуди програмерима корисно и поуздано решење за интегрисање SMS порука у њихове апликације, омогућавајући ефикасну комуникацију и побољшавајући корисничко искуство.