Hogyan küldjön SMS-t az MTN fejlesztői API-k (MADAPI) segítségével

Ez az útmutató bemutatja, hogyan érheti el az MTN értékteremtő API-kat az MTN fejlesztői portálon (https://developers.mtn.com/) keresztül. Megmutatja, hogyan szerezhet fejlesztői hozzáférési tokent, és hogyan használhatja az MTN SMS API v2-t SMS üzenetek küldéséhez az Ozeki SMS Gateway segítségével.

API URL-ek

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

Mi az az MTN SMS szolgáltatás?

Az MTN, mint pan-afrikai mobil szolgáltató, SMS szolgáltatásokat (SMS küldés és fogadás) biztosít üzleti partnerei és mobiltelefon-felhasználói számára.

Mi az a MADAPI protokoll?

Ez az MTN online SMS szolgáltatásának protokollimplementációja.

Mi az a MADAPI API?

Az MTN MAD API egy egységes API, amely különféle független mikroszolgáltatásokat tartalmaz (például Mobile Money API, SMS és USSD API, Chenosis Marketplace API stb.) Ezeket a szolgáltatásokat az MTN és partner szolgáltatók a MAD API-n keresztül érik el. A MAD-API szolgáltatáskapcsolatokat a Google Apigee biztosítja egy egységes API átjárón és kiépítési portálon keresztül.

Hogyan működik a MADAPI API?

A MADAPI egy olyan platform, ahol az MTN SMS Messaging API lehetővé teszi a fejlesztők számára, hogy SMS üzenetküldést építsenek be üzleti alkalmazásaikba.

Hogyan regisztrálj a Madapi Fejlesztői Portálra

Az alábbi videó végigvezeti a Madapi Fejlesztői Portálra történő zökkenőmentes regisztráció folyamatán, ahol megismerkedhetsz az API-fejlesztési lehetőségekkel. Fedezd fel az MTN API-k erejét, amelyek fejleszthetik alkalmazásaid, javíthatják a kommunikációt és egyszerűsíthetik projekteidet. Kövesd végig, ahogy bemutatjuk az MTN SMS API v2 és az Ozeki SMS Gateway együttes használatának egyszerűségét és hatékonyságát az SMS-ek zökkenőmentes küldéséhez.

A folyamat megkezdéséhez regisztrálnod kell a https://developers.mtn.com/ weboldalon, a lap jobb felső sarkában található "Regisztráció" gombra kattintva. Ez a regisztráció lehetővé teszi egy alkalmazás létrehozását; csak kövesd az egyszerű regisztrációs lépéseket. Kövesd ezeket a lépéseket a fiókod létrehozásához:

A "Regisztráció" gombra kattintva megjelenik egy regisztrációs oldal, ahol meg kell adnod néhány személyes adatot, például nevet, e-mail címet. Győződj meg róla, hogy érvényes e-mail címet használsz, mivel ezt fogják használni a kommunikációhoz és az ellenőrzéshez. Ezután kattints a "Tovább" gombra. Add meg a vezetékneved is. Válaszd ismét a "Tovább" gombot.

Válassz egy erős, egyedi jelszót a fiókodhoz, amely nagy- és kisbetűket, számokat és speciális karaktereket is tartalmaz a biztonság érdekében. Amikor létrehoztad a jelszavad, erősítsd meg úgy, hogy újra beírod, majd kattints a "Tovább" gombra a következő lépéshez.

A folytatáshoz válaszd ki a lakóhelyed szerinti országot a megadott lehetőségek közül, és miután kiválasztottad, kattints a "Tovább" gombra. Ez eljuttat a regisztráció következő lépéséhez. Olvasd el a felhasználási feltételeket, az adatvédelmi irányelveket és az MTN által biztosított egyéb releváns megállapodásokat. Ha elfogadod a feltételeket, pipáld ki a megfelelő négyzetet a hozzájárulásod megadásához.

A regisztrációs űrlap kitöltése után egy e-mailt küldünk a megadott címre. Kattints az e-mailben található ellenőrző linkre a fiókod megerősítéséhez és aktiválásához. Be kell írnod egy hitelesítő kódot, amelyet a Google Authenticator alkalmazásodon keresztül fogsz megkapni. Ha még nincs meg ez az alkalmazás, szerezd be bármely szoftveralkalmazásokat terjesztő digitális platformról, például a Google Play-ről vagy az App Store-ból.

Töltsd le a Google Authenticatort az Androidos mobiltelefonodra a Google Play-ről vagy az App Store-ból, ha iOS-eszközt használsz.

Most hozzá kell rendelned egy Google Authenticator fiókot, hogy képes legyél hitelesíteni az MTN fiókodat. Koppints a "+" vagy "Hozzáadás" gombra az alkalmazáson belül egy új fiók beállításához. Add meg az adatokat, amelyeket az MTN ellenőrző e-mailjében kaptál. Két lehetőséged van az MTN fiók hozzáadására: Ha az MTN QR-kódot biztosít, használd a Google Authenticator alkalmazást annak beolvasásához. Ez automatikusan beállítja a fiókot az alkalmazáson belül. Vagy, ha nincs QR-kód megadva, manuálisan is megadhatod a fiókinformációkat.

Meg kell adnod a fiók nevét, az MTN fiókod e-mail címét és az MTN által biztosított titkos kulcsot vagy hitelesítési kódot. Válassz egy nevet az MTN fiókod azonosításához a Google Authenticator alkalmazáson belül. Add meg az MTN fiókodhoz tartozó e-mail címet. Illeszd be a titkos kulcsodat, amely egy egyedi kód, amelyet az MTN biztosít kifejezetten a kétlépcsős hitelesítés (2FA) engedélyezéséhez a Google Authenticatort használva.

Miután hozzáadtad a fiókot a Google Authenticatorhoz, az alkalmazás elkezd hatjegyű egyszeri jelszavakat (OTP-ket) generálni, amelyek 30 másodpercenként változnak. Térj vissza az MTN ellenőrző e-mailjéhez, ahol találnod kell egy mezőt a Google Authenticator alkalmazás által generált ellenőrző kód megadásához. Írd be az aktuális kódot a Google Authenticator alkalmazásból az ellenőrző e-mailben található kijelölt mezőbe. Kattints a "Hitelesítés" gombra a beállítási folyamat befejezéséhez. A "Hitelesítés" gombra kattintva megjelenik az MTN fejlesztői portálja. Itt láthatod a Profilom oldalt, ahol személyre szabhatod a fiókodat és megtekintheted a korábban beállított fiókadatokat.

Bejelentkezés Google Authenticator segítségével

A fiókba való bejelentkezéshez töltse be a https://developers.mtn.com/ oldalt, írja be az e-mail címét és jelszavát a megfelelő mezőkbe, majd kattintson az alul található "Bejelentkezés" gombra.

Ezután meg kell adnia a Google Authenticator alkalmazás által biztosított 2FA hitelesítési kódot. Írja be a megadott jelszót, majd válassza a "Hitelesítés" gombot a bejelentkezési folyamat befejezéséhez.

Alkalmazás létrehozása

Ebben a rövid videóban megtudhatja, hogyan hozhat létre alkalmazást az MTN SMS API v2 és az Ozeki SMS Gateway együttműködésével, amely lehetővé teszi az SMS-üzenetek zökkenőmentes küldését. Kövesse a lépésről lépésre szóló útmutatót, hogy láthassa ezen eszközök projektjeibe való integrálásának hatékonyságát és egyszerűségét.

Először kattintson az oldal jobb felső sarkában található "Alkalmazás készítése" gombra. Ez a gomb elindítja az alkalmazás létrehozásának folyamatát, és lehetővé teszi, hogy átnézze az MTN fejlesztői platform számos fejlesztési lehetőségét.

Meg kell adnia néhány alapvető adatot az alkalmazással kapcsolatban. Ezek az adatok szükségesek az alkalmazás beállításához és konfigurálásához az MTN fejlesztői platformon belül. Válasszon egy egyedi nevet az alkalmazásának. Ez a név azonosítja az alkalmazást a fejlesztői portálon. Opcionális lehet egy rövid leírást írni az alkalmazás céljáról és funkcióiról. Ezután kattintson az "Ország kiválasztása" gombra.

Miután megadta az alkalmazással kapcsolatos szükséges adatokat, a következő lépés az, hogy kiválassza azt az országot, ahonnan származik, és amelyhez az alkalmazását társítani szeretné. Ez a kiválasztás segít az MTN-nek testreszabni és optimalizálni az alkalmazásához elérhető szolgáltatásokat és API-kat a régió specifikus követelményei és szabályozásai alapján.

Most válassza ki az MTN SMS V2 interfész opciót a termékek listájából. Kattintson a termékleírás jobb alsó sarkában található "+" gombra. Erre kattintva létrehozza ezt az SMS-interfészt visszahívási támogatással.

Az alkalmazás létrehozási folyamatának elindításához keresse meg az "Alkalmazás létrehozása" gombot, majd kattintson rá.

Ha az alkalmazás sikeresen létrejött, értesítést kap a létrehozásról. Ezután egy összegző oldalra kerül, amely áttekintést nyújt a jóváhagyott alkalmazásairól. Az összegző oldalon találhat néhány részletet az alkalmazásokról. Ha vannak olyan alkalmazások, amelyeket nem sikerült sikeresen telepíteni, akkor ezek az alkalmazások a "Visszavont alkalmazások" cím alatt jelennek meg.

Az SMS V2 szolgáltatás hozzáadása az alkalmazáshoz

Most elmagyarázzuk, hogyan adhatja hozzá az SMS V2 szolgáltatást az alkalmazásához. Az SMS V2 szolgáltatás hozzáadásához az alkalmazáshoz szerkesztenie kell az alkalmazás részleteit a Saját alkalmazások oldalon, a Jóváhagyott alkalmazások lapon.

Végezzen változtatásokat az alkalmazás részleteiben. Módosítsa az alkalmazás nevét. Módosítsa az alkalmazás leírását, hogy jobban tükrözze annak célját és funkcióit. Adjon hozzá vagy módosítson URL-eket, amelyekre a felhasználókat át kell irányítani. Kattintson a "Szerkesztés" gombra az alkalmazás módosításához. A változtatások elvégzése után ellenőrizze a pontosságot, majd kattintson a "Tovább" gombra a következő lépéshez.

Ezeknek a lépéseknek a befejezése után kattintson a fekete körben található pipára. Az SMS V2 szolgáltatás sikeresen hozzáadódik az alkalmazásához. Most már kihasználhatja az MTN SMS képességeit a kommunikáció javításához.

Hogyan másoljuk át a vásárlói kulcsot és a Production secretet az Ozeki 10-be

A következő videóban bemutatjuk lépésről lépésre, hogyan másolhatjuk át a vásárlói kulcsot és a Production secretet az Ozeki 10-be. Ez az eljárás lehetővé teszi a két platform zökkenőmentes integrációját, így kihasználhatjuk az MTN API-jainak és az Ozeki 10-nek a funkcióit, hogy javítsuk üzenetküldési képességeinket és egyszerűsítsük a felhasználóinkkal való kommunikációt.

Kezdésként jelentkezzen be az Ozeki SMS Gateway fiókjába. Ha még nincs fiókja, letöltheti a szoftvert a https://ozeki.hu/ weboldalról. Miután a fiókja elkészült, nyissa meg az Ozeki Gateway-t az Ozeki Desktop-on, hogy hozzáférjen az átjáró kezelőfelületéhez és beállíthassa az üzenetküldési beállításokat. Kattintson a "Add new connections..." linkre a Connections panelen, vagy válassza a "Connect" ikont az eszköztáron.

A rákattintás után megjelenik egy lista, amely különböző kliens opciókat tartalmaz, amelyek telepíthetők. Keresse meg az "MTN MADAPI client" lehetőséget, amely lehetővé teszi a kimenő SMS kérések létrehozását az MTN SMS V2 API segítségével, majd kattintson a "Install" linkre.

Az MTN MADAPI kliens telepítése után megjelenik egy oldal, ahol néhány adatot meg kell adni a kapcsolat beállításához. Töltse be az MNP'S Developers Portal-t és másolja át a consumer key és secret kódokat.

Illessze be ezeket a kódokat a megfelelő mezőkbe az Ozeki SMS Gateway-ben. Miután beillesztette a kódokat a megfelelő szakaszokba, görgessen le az oldal aljára. A változtatások mentéséhez és az integráció megerősítéséhez kattintson az "Ok" gombra. A kódok mentése az "Ok" gombbal biztosítja, hogy az Ozeki SMS Gateway most már megfelelően be van állítva az MTN API-jainak használatára.

Hogyan ellenőrizhetjük, hogy megkaptuk-e az access tokent

Az adatok mentése után az Ozeki SMS Gateway vezérlőpultján navigáljon az "Events" fülre. Itt a panel bal oldalán talál egy csúszkagombot. Kapcsolja a csúszkagombot a zöld pozícióba. Ha a beállítás sikeres volt, egy "Access Token" című értesítést fog kapni az Events panelen. Ez jelzi, hogy az MTN API-jai és az Ozeki SMS Gateway közötti integráció most már aktív, és az alkalmazása hozzáférhet a szükséges hitelesítési tokenhez, hogy zökkenőmentesen kommunikálhasson az MTN szolgáltatásaival.

Hogyan küldjünk teszt SMS-t és hogyan ellenőrizzük a naplókat

A következő videóban lépésről lépésre bemutatjuk, hogyan küldhet teszt SMS-t az integrált MTN SMS szolgáltatás segítségével az Ozeki SMS Gateway-en keresztül. Végigvezetjük a teszt üzenet összeállításának és küldésének folyamatán, hogy hatékonyan kommunikálhasson a címzetteivel. Ezenkívül megmutatjuk, hogyan ellenőrizheti a naplókat az Ozeki SMS Gateway-en belül, hogy nyomon kövesse az elküldött SMS üzenetek állapotát és kézbesítési részleteit.

Első lépésként jelentkezzen be az Ozeki SMS Gateway fiókjába és töltse be az Ozeki Home oldalt. Válassza ki az MNT_MADAPI_client kapcsolatot. Nyissa meg a "Test" fület az MNT_MADAPI_client részleteinél. Itt létrehozhat egy SMS üzenetet. A létrehozáshoz adja meg a címzett telefonszámát a megfelelő mezőbe, majd írja be az üzenet szövegét az SMS mezőbe.

Az adatok megadása után kattintson a "Send" gombra.

Az Ozeki SMS Gateway "Event" fülének megnyitásával megtekintheti az elküldött üzenet állapotát. Ha az üzenet sikeresen elküldődött, egy "Successfully initialized." című értesítést fog kapni. Ez az értesítés megerősíti, hogy az SMS probléma nélkül kézbesítésre került a címzettnek.

Az útmutató lépésről lépésre bemutatja, hogyan használhatók az MTN Developer API-k (MADAPI) az Ozeki SMS Gatewayjel való zökkenőmentes SMS küldéshez. Az útmutatót követve a fejlesztők hozzáférhetnek az MTN értékteremtő API-hoz az MTN fejlesztői portálon keresztül, szerezhetnek fejlesztői hozzáférési tokent és használhatják az MTN SMS API v2-t SMS üzenetek küldésére. Összességében az MTN Developer API-k és az Ozeki SMS Gateway kombinációja hasznos és megbízható megoldást kínál a fejlesztőknek az SMS üzenetküldés alkalmazásaikba való integrálásához, lehetővé téve a hatékony kommunikációt és javítva a felhasználói élményt.