Cum să trimiți SMS folosind API-urile MTN Developer (MADAPI)

Acest ghid explică cum poți accesa API-urile cu valoare adăugată MTN prin portalul pentru dezvoltatori MTN (https://developers.mtn.com/). Îți arată cum să obții un token de acces pentru dezvoltatori și cum să folosești API-ul MTN SMS v2 pentru a trimite mesaje SMS folosind Ozeki SMS Gateway.

URL-uri API

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

Ce este serviciul MTN SMS?

MTN, ca operator mobil pan-african, oferă servicii SMS (trimitere și primire SMS) pentru partenerii lor de afaceri și utilizatorii de telefoane mobile.

Ce este protocolul MADAPI?

Este o implementare a protocolului serviciului online SMS al MTN.

Ce este API-ul MADAPI?

API-ul MTN MAD este un API unificat care include diverse microservicii independente (cum ar fi API-ul Mobile Money, API-ul SMS și USSD, API-ul Chenosis Marketplace etc.) Aceste servicii sunt accesate de MTN și furnizorii parteneri prin intermediul API-ului MAD. Conexiunile serviciului MAD-API sunt furnizate de Google Apigee printr-o poartă de acces API unificată și un portal de provisioning.

Cum funcționează API-ul MADAPI?

MADAPI este o platformă unde API-ul de mesagerie SMS al MTN permite dezvoltatorilor să integreze mesageria SMS în aplicațiile lor de afaceri.

Cum să te înregistrezi pe Portalul pentru Dezvoltatori Madapi

Următorul videoclip te va ghida prin procesul simplu de înregistrare pe Portalul pentru Dezvoltatori Madapi, unde poți afla mai multe despre posibilitățile de dezvoltare API. Descoperă puterea API-urilor MTN care pot îmbunătăți aplicațiile tale, îmbunătăți comunicarea și simplifica proiectele tale. Urmează demonstrația noastră despre simplitatea și eficiența utilizării API-ului SMS MTN v2 în combinație cu Ozeki SMS Gateway pentru a trimite mesaje SMS fără probleme.

Video 1 - Cum să te înregistrezi pe Portalul pentru Dezvoltatori Madapi (Tutorial video)

Pentru a începe procesul, trebuie să te înregistrezi pe site-ul https://developers.mtn.com/, făcând clic pe butonul "Înregistrare" din colțul din dreapta sus al paginii. Această înregistrare îți va permite să creezi o aplicație; urmează pur și simplu pașii de înregistrare. Urmează acești pași pentru a-ți crea contul:

selectează înregistrare
Figura 1 - Selectează înregistrare

Făcând clic pe butonul "Înregistrare" se va deschide o pagină de înregistrare, unde este necesar să introduci câteva detalii personale, cum ar fi numele și adresa de e-mail. Asigură-te că folosești o adresă de e-mail validă, deoarece aceasta va fi folosită pentru comunicare și verificare. După aceea, fă clic pe butonul "Următorul". Adaugă și numele tău de familie. Selectează din nou butonul "Următorul".

definește nume și adresă de e-mail
Figura 2 - Definește nume și adresă de e-mail

Alege o parolă puternică și unică pentru contul tău, care să combine litere mari și mici, cifre și caractere speciale pentru siguranță. După ce ai creat parola, confirm-o introducând-o din nou, apoi fă clic pe butonul "Următorul" pentru a trece la etapa următoare.

adaugă parolă
Figura 3 - Adaugă parolă

Pentru a continua, selectează țara ta de reședință din opțiunile furnizate și, odată ce ai făcut selecția, fă clic pe butonul "Următorul". Acest lucru te va duce la următoarea etapă a procesului de înregistrare. Citește termenii și condițiile, politica de confidențialitate și orice alte acorduri relevante furnizate de MTN. Dacă ești de acord cu termenii lor, bifează caseta corespunzătoare pentru a-ți da consimțământul.

selectează țara
Figura 4 - Selectează țara

După completarea formularului de înregistrare, un e-mail va fi trimis la adresa pe care ai furnizat-o. Fă clic pe link-ul de verificare din acel e-mail pentru a-ți confirma contul și a-l activa. Trebuie să introduci un cod de autentificare pe care îl vei primi prin aplicația Google Authenticator. Dacă nu ai încă această aplicație, descarc-o de pe orice platformă de distribuție digitală pentru software numită aplicații, cum ar fi Google Play sau App Store.

verifică adresa de e-mail
Figura 5 - Verifică adresa de e-mail

Descarcă Google Authenticator pe telefonul tău mobil Android de pe Google Play sau App Store dacă folosești un dispozitiv iOS.

instalează google authenticator
Figura 6 - Instalează Google Authenticator

Acum, trebuie să asociezi un cont Google Authenticator, pentru a putea autentifica contul tău MTN. Apasă pe butonul "+" sau "Adaugă" din aplicație pentru a configura un nou cont. Introdu detaliile furnizate în e-mailul de verificare de la MTN. Veți avea două opțiuni pentru a adăuga contul MTN: Dacă MTN furnizează un cod QR, folosește aplicația Google Authenticator pentru a-l scana. Acest lucru va configura automat contul în aplicație. Sau, dacă nu este furnizat un cod QR, poți introduce manual informațiile contului.

adaugă cont în google authenticator
Figura 7 - Adaugă cont în Google Authenticator

Va trebui să introduci numele contului, e-mailul tău MTN și cheia secretă sau codul de autentificare furnizat de MTN. Alege un nume pentru a-ți identifica contul MTN în cadrul aplicației Google Authenticator. Introdu adresa de e-mail asociată cu contul tău MTN. Lipește cheia ta secretă, care este un cod unic furnizat de MTN special pentru activarea autentificării cu doi factori (2FA) cu Google Authenticator.

detalii cont în google authenticator
Figura 8 - Detalii cont în Google Authenticator

După ce ai adăugat contul în Google Authenticator, aplicația va începe să genereze parole unice de șase cifre (OTP) care se schimbă la fiecare 30 de secunde. Reveniți la e-mailul de verificare de la MTN, unde ar trebui să găsiți un câmp pentru a introduce codul de verificare generat de aplicația Google Authenticator. Introdu codul curent din aplicația Google Authenticator în câmpul desemnat din e-mailul de verificare. Fă clic pe butonul "Autentificare" pentru a finaliza procesul de configurare. Prin făcerea clic pe butonul "Autentificare", portalul pentru dezvoltatori MTN va apărea. Acolo, poți vedea o pagină Profilul meu, unde poți personaliza contul tău și vizualiza detaliile contului configurate anterior.

activează autentificarea cu doi factori
Figura 9 - Activează autentificarea cu doi factori

Cum să vă autentificați folosind Google Authenticator

Pentru a vă conecta la cont, încărcați pagina https://developers.mtn.com/ și introduceți adresa de e-mail și parola în câmpurile corespunzătoare, apoi faceți clic pe butonul "Log In" din partea de jos.

autentificare în portalul pentru dezvoltatori
Figura 10 - Autentificare în portalul pentru dezvoltatori

După aceea, este necesar să introduceți codul de autentificare 2FA, furnizat de aplicația Google Authenticator. Introduceți parola generată, apoi alegeți butonul "Authenticate" pentru a finaliza procesul de autentificare.

autentificare cu doi factori
Figura 11 - Autentificare cu doi factori

Cum să creați o aplicație

În acest scurt videoclip, veți descoperi cum să creați o aplicație folosind MTN SMS API v2, în colaborare cu Ozeki SMS Gateway, permițându-vă să trimiteți mesaje SMS fără probleme. Urmați ghidul pas cu pas pentru a vedea eficiența și ușurința integrării acestor unelte în proiectele dumneavoastră.

Video 2 - Cum să creați o aplicație

Pentru început, faceți clic pe butonul "Build app" din colțul din dreapta sus al pagini. Acest buton va iniția procesul de creare a aplicației și vă va permite să începeți prin a explora numeroasele opțiuni de dezvoltare ale platformei MTN pentru dezvoltatori.

construiți aplicație
Figura 12 - Construiți aplicație

Trebuie să introduceți câteva detalii esențiale legate de aplicație. Aceste detalii sunt necesare pentru configurarea și setarea aplicației dumneavoastră în cadrul platformei MTN pentru dezvoltatori. Alegeți un nume unic pentru aplicația dumneavoastră. Acest nume va fi folosit pentru a identifica aplicația în portalul pentru dezvoltatori. Este opțional să scrieți o scurtă descriere a scopului și funcționalității aplicației dumneavoastră. După aceea, faceți clic pe butonul "Select countries".

definiți detalii aplicație
Figura 13 - Definiți detalii aplicație

După ce ați introdus detaliile necesare legate de aplicația dumneavoastră, următorul pas este să selectați țara din care sunteți și pe care doriți să o asociați cu aplicația dumneavoastră. Această selecție ajută MTN să personalizeze și să optimizeze serviciile și API-urile disponibile pentru aplicația dumneavoastră în funcție de cerințele și reglementările specifice regiunii.

selectați țară
Figura 14 - Selectați țară

Acum, alegeți opțiunea MTN SMS V2 din lista de produse. Faceți clic pe butonul "+" situat în colțul din dreapta jos al descrierii produsului. Prin apăsarea acestuia, veți crea această interfață SMS cu suport pentru callback.

adăugați interfață SMS V2
Figura 15 - Adăugați interfață SMS V2

Pentru a iniția procesul de creare a aplicației, găsiți butonul "Create app", apoi faceți clic pe el.

creați aplicație
Figura 16 - Creați aplicație

Dacă aplicația a fost creată cu succes, veți primi o notificare despre creare. Ulterior, veți fi direcționat către o pagină de rezumat care oferă o prezentare generală a aplicațiilor dumneavoastră aprobate. Pe pagina de rezumat, veți găsi câteva detalii despre aplicații. Dacă aveți aplicații care nu au fost instalate cu succes, atunci în acest caz, veți vedea lista aplicațiilor sub titlul "Revoked Apps".

aplicație madapi creată
Figura 17 - Aplicație MADAPI creată

Cum să adăugați serviciul SMS V2 la aplicația dumneavoastră

Acum, vă vom explica cum să adăugați serviciul SMS V2 la aplicația dumneavoastră. Pentru a adăuga serviciul SMS V2 la aplicația dumneavoastră, trebuie să editați detaliile aplicației în pagina My apps, sub fila Approved Apps.

editați aplicație
Figura 18 - Editați aplicație

Faceți modificări în detaliile aplicației. Schimbați numele aplicației dumneavoastră. Modificați descrierea aplicației dumneavoastră pentru a reflecta mai bine scopul și funcționalitatea acesteia. Adăugați sau modificați URL-urile către care ar trebui redirecționați utilizatorii. Faceți clic pe butonul "Edit", pentru a modifica aplicația. După ce ați făcut modificările, asigurați-vă că sunt corecte, apoi faceți clic pe butonul "Next" pentru a trece la pasul următor.

modificați detaliile aplicației
Figura 19 - Modificați detaliile aplicației

După ce ați completat acești pași, faceți clic pe bifa din cercul negru. Serviciul SMS V2 va fi adăugat cu succes la aplicația dumneavoastră. Acum puteți profita de capabilitățile SMS ale MTN pentru a îmbunătăți comunicarea.

adăugați serviciul SMS V2 la aplicația dumneavoastră
Figura 20 - Adăugați serviciul SMS V2 la aplicația dumneavoastră

Cum să copiați cheia clientului și secretul de producție în Ozeki 10

În videoclipul următor, vom demonstra procesul pas cu pas de copiere a cheii clientului și a secretului de producție în Ozeki 10. Această procedură permite integrarea perfectă între cele două platforme, permițându-vă să profitați de funcționalitățile API-urilor MTN și ale Ozeki 10 pentru a vă îmbunătăți capabilitățile de mesagerie și a simplifica comunicarea cu utilizatorii dumneavoastră.

Video 3 - Cum să copiați cheia clientului și secretul de producție în Ozeki 10 (Tutorial video)

Pentru a începe, conectați-vă la contul dumneavoastră Ozeki SMS Gateway. Dacă nu aveți încă un cont, puteți descărca software-ul de pe site-ul https://ozeki.hu/. După ce v-ați pregătit contul, deschideți Ozeki Gateway pe Ozeki Desktop pentru a accesa interfața de management a gateway-ului și a configura setările de mesagerie. Faceți clic pe linkul „Adăugați conexiuni noi...” din panoul Connections sau alegeți pictograma „Conectare” din bara de instrumente.

adaugă conexiune nouă
Figura 21 - Adăugați conexiune nouă

Prin apăsarea acestuia, va apărea o listă care conține diverse opțiuni de clienți care pot fi instalate. Găsiți „Client MTN MADAPI” care vă permite să creați cereri SMS de ieșire folosind MTN SMS V2 API, apoi faceți clic pe linkul „Instalare”.

instalare client madapi
Figura 22 - Instalați clientul Madapi

Instalarea clientului MTN MADAPI va deschide o pagină unde trebuie să introduceți câteva detalii pentru a configura conexiunea. Încărcați Portalul pentru Dezvoltatori MNP și copiați cheia de consumator și codurile secrete.

copiază cheie și secret
Figura 23 - Copiați cheia și secretul

Lipiți aceste coduri în câmpurile desemnate din Ozeki SMS Gateway. După ce ați lipit codurile în secțiunile corespunzătoare, derulați în josul paginii. Pentru a salva modificările și a confirma integrarea, faceți clic pe butonul „Ok”. Salvarea codurilor cu butonul „Ok” va asigura că Ozeki SMS Gateway este acum configurat corect pentru a funcționa cu API-urile MTN.

lipiți cheie și secret
Figura 24 - Lipiți cheia și secretul

Cum să vizualizați că ați primit token-ul de acces

După ce ați salvat detaliile în panoul de control Ozeki SMS Gateway, navigați la fila „Evenimente”. Aici, veți găsi un buton glisant în partea stângă a panoului. Comutați butonul glisant în poziția verde. Dacă configurarea a fost reușită, veți primi o notificare etichetată „Token de acces” în panoul Evenimente. Aceasta indică faptul că integrarea dintre API-urile MTN și Ozeki SMS Gateway este acum activă, iar aplicația dumneavoastră poate accesa token-ul de autentificare necesar pentru a comunica fără probleme cu serviciile MTN.

token de acces primit
Figura 25 - Token de acces primit

Cum să trimiteți un SMS test și cum să verificați jurnalele

În videoclipul următor, vă vom oferi un ghid pas cu pas despre cum să trimiteți un SMS test folosind serviciul integrat MTN SMS prin Ozeki SMS Gateway. Vă vom ghida prin procesul de compunere și trimitere a mesajului test, asigurându-vă că puteți comunica eficient cu destinatarii intenționați. În plus, vă vom arăta cum să verificați jurnalele din Ozeki SMS Gateway pentru a monitoriza starea și detaliile de livrare ale mesajelor SMS trimise.

Video 4 - Cum să trimiteți un SMS test și cum să verificați jurnalele (Tutorial video)

Ca prim pas, conectați-vă la contul dumneavoastră Ozeki SMS Gateway și încărcați pagina Ozeki Home. Selectați conexiunea MNT_MADAPI_client. Deschideți fila „Test” la detaliile MNT_MADAPI_client. Acolo, puteți crea un mesaj SMS. Pentru creare, introduceți numărul de telefon al destinatarului în câmpul corespunzător, apoi introduceți textul mesajului în câmpul SMS.

creați mesaj sms test
Figura 26 - Creați mesaj SMS test

După ce ați introdus aceste date, faceți clic pe butonul „Trimite”.

trimite mesaj test
Figura 27 - Trimiteți mesaj test

La deschiderea filei Evenimente în Ozeki SMS Gateway, veți putea vizualiza starea mesajului trimis. Dacă mesajul a fost trimis cu succes, veți primi o notificare etichetată „Inițializat cu succes”. Această notificare confirmă faptul că SMS-ul a fost livrat destinatarului fără probleme.

mesaj trimis
Figura 28 - Mesaj trimis

Rezumat

Ghidul oferă instrucțiuni pas cu pas despre cum să utilizați API-urile pentru dezvoltatori MTN (MADAPI) în legătură cu Ozeki SMS Gateway pentru a trimite mesaje SMS fără probleme. Urmând ghidul, dezvoltatorii pot accesa API-urile cu valoare adăugată MTN prin portalul pentru dezvoltatori MTN, pot obține un token de acces pentru dezvoltatori și pot utiliza API-ul SMS MTN v2 pentru a trimite mesaje SMS. În general, combinația dintre API-urile pentru dezvoltatori MTN și Ozeki SMS Gateway oferă dezvoltatorilor o soluție utilă și fiabilă pentru integrarea mesajelor SMS în aplicațiile lor, permițând o comunicare eficientă și îmbunătățind experiența utilizatorilor.

More information