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.
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:
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".
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.
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.
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.
Descarcă Google Authenticator pe telefonul tău mobil Android de pe Google Play sau App Store dacă folosești un dispozitiv iOS.
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.
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.
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.
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.
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.
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ă.
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.
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".
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.
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.
Pentru a iniția procesul de creare a aplicației, găsiți butonul "Create app", apoi faceți clic pe el.
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".
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.
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.
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.
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ă.
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.
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”.
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.
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.
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.
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.
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.
După ce ați introdus aceste date, faceți clic pe butonul „Trimite”.
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.
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
- Send SMS to Telecom Slovenije SMSC
- How to send SMS with amazon SNS
- How to send SMS from Clickatell
- How to send SMS using the MTN Developer APIs (MADAPI)
- Sunrise SMS service
- Vodafone SMS Service
- How to send SMS from Clicksend
- How to send SMS from Infobip
- How to send SMS using Messagebird
- How to send SMS using Nexmo
- How to send SMS from Telnyx
- How to send SMS from Twilio
- How to send SMS with Yettel SMS Futár connection