Jak odeslat SMS pomocí MTN Developer API (MADAPI)
Tento průvodce vysvětluje, jak můžete získat přístup k MTN value added API prostřednictvím portálu pro vývojáře MTN (https://developers.mtn.com/). Ukazuje, jak získat přístupový token pro vývojáře a jak použít MTN SMS API v2 k odesílání SMS zpráv pomocí Ozeki SMS Gateway.
URL adresy API
- https://sandbox.api.mtn.com/oauth/client_credential/accesstoken?grant_type=client_credentials
- https://api.mtn.com/v2/messages/sms/outbound
Co je služba MTN SMS?
MTN jako panafrický mobilní operátor poskytuje služby SMS (odesílání a příjem SMS) pro své obchodní partnery a uživatele mobilních telefonů.
Co je protokol MADAPI?
Jedná se o implementaci protokolu pro online službu SMS od MTN.
Co je MADAPI API?
MTN MAD API je jednotné API, které zahrnuje různé nezávislé mikroslužby (jako je Mobile Money API, SMS a USSD API, Chenosis Marketplace API atd.) K těmto službám mají přístup MTN a partneři prostřednictvím MAD API. Spojení služeb MAD-API jsou poskytována společností Google Apigee prostřednictvím jednotné API brány a portálu pro zřizování.
Jak MADAPI API funguje?
MADAPI je platforma, kde SMS Messaging API od MTN umožňuje vývojářům integrovat SMS zprávy do jejich obchodních aplikací.
Jak se zaregistrovat na portálu Madapi Developer
Následující video vás provede bezproblémovým procesem registrace na portálu Madapi Developer, kde se můžete dozvědět o možnostech vývoje API. Objevte sílu API od MTN, která mohou pozvednout vaše aplikace, zlepšit komunikaci a zefektivnit vaše projekty. Sledujte, jak demonstrujeme jednoduchost a účinnost použití MTN SMS API v2 v kombinaci s Ozeki SMS Gateway pro bezproblémové odesílání SMS zpráv.
Pro zahájení procesu se musíte zaregistrovat na webu https://developers.mtn.com/ kliknutím na tlačítko "Registrovat" v pravém horním rohu stránky. Tato registrace vám umožní vytvořit aplikaci; stačí postupovat podle jednoduchých registračních kroků. Pro vytvoření účtu postupujte takto:
Kliknutím na tlačítko "Registrovat" se zobrazí registrační stránka, kde je nutné zadat některé osobní údaje, jako je jméno a e-mailová adresa. Ujistěte se, že používáte platnou e-mailovou adresu, protože bude použita pro komunikaci a ověření. Poté klikněte na tlačítko "Další". Přidejte také své příjmení. Znovu vyberte tlačítko "Další".
Pro účely bezpečnosti zvolte silné, jedinečné heslo pro svůj účet, které kombinuje velká a malá písmena, číslice a speciální znaky. Po vytvoření hesla jej potvrďte opětovným zadáním a klikněte na tlačítko "Další" pro přechod do další fáze.
Pro pokračování vyberte svou zemi pobytu z nabízených možností a po výběru klikněte na tlačítko "Další". Tím se dostanete do další fáze registračního procesu. Přečtěte si podmínky, zásady ochrany osobních údajů a další relevantní dohody poskytované společností MTN. Pokud s jejich podmínkami souhlasíte, zaškrtněte příslušné políčko, abyste vyjádřili svůj souhlas.
Po dokončení registračního formuláře bude na vámi uvedenou e-mailovou adresu odeslán e-mail. Kliknutím na ověřovací odkaz v tomto e-mailu potvrdíte svůj účet a aktivujete jej. Budete muset zadat ověřovací kód, který obdržíte prostřednictvím aplikace Google Authenticator. Pokud tuto aplikaci ještě nemáte, získejte ji z jakékoli digitální distribuční platformy pro software, jako je Google Play nebo App Store.
Stáhněte si Google Authenticator na svůj mobilní telefon s Androidem z Google Play nebo App Store, pokud používáte zařízení iOS.
Nyní musíte přiřadit účet Google Authenticator, abyste mohli ověřovat svůj účet MTN. Klepněte na tlačítko "+" nebo "Přidat" v aplikaci a nastavte nový účet. Zadejte údaje uvedené v ověřovacím e-mailu od MTN. Budete mít dvě možnosti, jak přidat svůj účet MTN: Pokud MTN poskytuje QR kód, použijte aplikaci Google Authenticator k jeho naskenování. Tím se účet automaticky nastaví v aplikaci. Pokud není QR kód k dispozici, můžete údaje o účtu zadat ručně.
Budete muset zadat název účtu, e-mail vašeho účtu MTN a tajný klíč nebo ověřovací kód poskytnutý společností MTN. Zvolte název, který identifikuje váš účet MTN v aplikaci Google Authenticator. Zadejte e-mailovou adresu spojenou s vaším účtem MTN. Vložte svůj tajný klíč, což je jedinečný kód poskytnutý společností MTN speciálně pro povolení dvoufaktorového ověřování (2FA) pomocí Google Authenticator.
Jakmile přidáte účet do Google Authenticatoru, aplikace začne generovat šestimístná jednorázová hesla (OTP), která se mění každých 30 sekund. Vraťte se k ověřovacímu e-mailu od MTN, kde byste měli najít pole pro zadání ověřovacího kódu generovaného aplikací Google Authenticator. Zadejte aktuální kód z aplikace Google Authenticator do určeného pole v ověřovacím e-mailu. Klepnutím na tlačítko "Ověřit" dokončíte proces nastavení. Kliknutím na tlačítko "Ověřit" se zobrazí vývojářský portál MTN. Zde uvidíte stránku Můj profil, kde můžete přizpůsobit svůj účet a zobrazit dříve nastavené podrobnosti o účtu.
Jak se přihlásit pomocí Google Authenticator
Pro přihlášení do svého účtu načtěte stránku https://developers.mtn.com/ a zadejte svou e-mailovou adresu a heslo do příslušných polí, poté klikněte na tlačítko "Přihlásit se" v dolní části.
Poté je nutné zadat ověřovací kód 2FA, který poskytuje aplikace Google Authenticator. Zadejte dané heslo a poté vyberte tlačítko "Ověřit" pro dokončení procesu přihlášení.
Jak vytvořit aplikaci
V tomto krátkém videu se dozvíte, jak vytvořit aplikaci pomocí MTN SMS API v2 ve spolupráci s Ozeki SMS Gateway, což vám umožní bezproblémové odesílání SMS zpráv. Postupujte podle podrobného průvodce a uvidíte, jak snadné a efektivní je integrovat tyto nástroje do vašich projektů.
Nejprve klikněte na tlačítko "Vytvořit aplikaci" v pravém horním rohu stránky. Toto tlačítko spustí proces vytváření aplikace a umožní vám prozkoumat četné možnosti vývoje na platformě MTN pro vývojáře.
Je nutné zadat některé základní údaje související s aplikací. Tyto údaje jsou nezbytné pro nastavení a konfiguraci vaší aplikace na platformě MTN pro vývojáře. Zvolte jedinečný název pro vaši aplikaci. Tento název bude sloužit k identifikaci vaší aplikace v rámci vývojářského portálu. Je volitelné napsat stručný popis účelu a funkcionality vaší aplikace. Poté klikněte na tlačítko "Vybrat země".
Po zadání potřebných údajů souvisejících s vaší aplikací je dalším krokem vybrat zemi, ze které pocházíte a kterou chcete s vaší aplikací spojit. Tento výběr pomáhá MTN přizpůsobit a optimalizovat služby a API dostupné pro vaši aplikaci na základě požadavků a předpisů konkrétního regionu.
Nyní vyberte možnost rozhraní MTN SMS V2 ze seznamu produktů. Klikněte na tlačítko "+" umístěné v pravém dolním rohu popisu produktu. Kliknutím na něj vytvoříte toto SMS rozhraní s podporou zpětného volání.
Pro zahájení procesu vytváření aplikace najděte tlačítko "Vytvořit aplikaci" a klikněte na něj.
Pokud byla aplikace úspěšně vytvořena, obdržíte oznámení o vytvoření. Poté budete přesměrováni na souhrnnou stránku, která poskytuje přehled vašich schválených aplikací. Na souhrnné stránce najdete některé podrobnosti o aplikacích. Pokud máte nějaké aplikace, které nebyly úspěšně nainstalovány, uvidíte jejich seznam pod nadpisem "Zrušené aplikace".
Jak přidat službu SMS V2 do vaší aplikace
Nyní si vysvětlíme, jak přidat službu SMS V2 do vaší aplikace. Pro přidání služby SMS V2 do vaší aplikace je nutné upravit detaily aplikace na stránce Moje aplikace v záložce Schválené aplikace.
Proveďte změny v detailech aplikace. Změňte název vaší aplikace. Upravte popis vaší aplikace tak, aby lépe odrážel její účel a funkčnost. Přidejte nebo upravte URL, na které by měli být uživatelé přesměrováni. Klikněte na tlačítko "Upravit" pro úpravu aplikace. Po provedení změn zkontrolujte jejich správnost a klikněte na tlačítko "Další" pro pokračování.
Po dokončení těchto kroků klikněte na zaškrtnutí v černém kruhu. Služba SMS V2 bude úspěšně přidána do vaší aplikace. Nyní můžete využít SMS možnosti MTN pro zlepšení komunikace.
Jak zkopírovat zákaznický klíč a produkční tajný kód do Ozeki 10
V následujícím videu si krok za krokem ukážeme, jak zkopírovat zákaznický klíč a produkční tajný kód do Ozeki 10. Tento postup umožní hladkou integraci mezi oběma platformami, což vám umožní využít funkce MTN API a Ozeki 10 k vylepšení vašich možností zasílání zpráv a zefektivnění komunikace s vašimi uživateli.
Nejprve se přihlaste ke svému účtu Ozeki SMS Gateway. Pokud účet ještě nemáte, můžete si software stáhnout z webu https://ozeki.hu/. Jakmile máte účet připravený, otevřete Ozeki Gateway na Ozeki Desktopu, abyste získali přístup k rozhraní pro správu brány a mohli nakonfigurovat nastavení zasílání zpráv. Klikněte na odkaz "Přidat nové připojení..." v panelu Připojení nebo zvolte ikonu "Připojit" na panelu nástrojů.
Po kliknutí se zobrazí seznam různých klientů, které lze nainstalovat. Najděte "MTN MADAPI klienta", který vám umožní vytvářet odchozí SMS požadavky pomocí MTN SMS V2 API, a poté klikněte na odkaz "Nainstalovat".
Instalace MTN MADAPI klienta otevře stránku, kde musíte zadat některé údaje pro nastavení připojení. Načtěte portál pro vývojáře MNP a zkopírujte kódy consumer key a secret.
Vložte tyto kódy do určených polí v Ozeki SMS Gateway. Jakmile kódy vložíte do příslušných sekcí, přejděte dolů na konec stránky. Pro uložení změn a potvrzení integrace klikněte na tlačítko "OK". Uložení kódů pomocí tlačítka "OK" zajistí, že Ozeki SMS Gateway je nyní správně nakonfigurován pro práci s MTN API.
Jak zjistit, že jste obdrželi přístupový token
Po uložení údajů v ovládacím panelu Ozeki SMS Gateway přejděte na kartu "Události". Zde najdete posuvné tlačítko na levé straně panelu. Přepněte posuvné tlačítko do zelené polohy. Pokud bylo nastavení úspěšné, obdržíte v panelu Události oznámení s označením "Access Token". To znamená, že integrace mezi MTN API a Ozeki SMS Gateway je nyní aktivní a vaše aplikace může získat potřebný autentizační token pro hladkou komunikaci se službami MTN.
Jak odeslat testovací SMS a jak zkontrolovat protokoly
V následujícím videu vám poskytneme podrobný návod, jak odeslat testovací SMS pomocí integrované služby MTN SMS přes Ozeki SMS Gateway. Provedeme vás procesem vytvoření a odeslání testovací zprávy, abyste mohli efektivně komunikovat s vašimi příjemci. Dále vám ukážeme, jak zkontrolovat protokoly v Ozeki SMS Gateway, abyste mohli sledovat stav a podrobnosti o doručení odeslaných SMS zpráv.
Jako první krok se přihlaste ke svému účtu Ozeki SMS Gateway a načtěte domovskou stránku Ozeki. Vyberte připojení MNT_MADAPI_client. Otevřete kartu "Test" v podrobnostech MNT_MADAPI_client. Zde můžete vytvořit SMS zprávu. Pro vytvoření zadejte telefonní číslo příjemce do určeného pole a poté zadejte text zprávy do pole SMS.
Po zadání těchto údajů klikněte na tlačítko "Odeslat".
Po otevření karty Události v Ozeki SMS Gateway budete moci zobrazit stav odeslané zprávy. Pokud byla zpráva odeslána úspěšně, obdržíte oznámení s označením "Úspěšně inicializováno." Toto oznámení potvrzuje, že SMS byla doručena příjemci bez problémů.
Shrnutí
Tento průvodce poskytuje podrobné pokyny, jak používat MTN Developer API (MADAPI) ve spojení s bránou Ozeki SMS Gateway pro bezproblémové odesílání SMS zpráv. Podle tohoto průvodce mohou vývojáři získat přístup k MTN API pro přidanou hodnotu prostřednictvím portálu pro vývojáře MTN, získat přístupový token pro vývojáře a využít MTN SMS API v2 k odesílání SMS zpráv. Celkově kombinace MTN Developer API a Ozeki SMS Gateway nabízí vývojářům užitečné a spolehlivé řešení pro integraci SMS zasílání do jejich aplikací, což umožňuje efektivní komunikaci a zlepšuje uživatelský zážitek.
More information
- Odeslat SMS na Telecom Slovenije SMSC
- Jak odeslat SMS pomocí Amazon SNS
- Jak odeslat SMS z Clickatell
- Jak odeslat SMS pomocí MTN Developer API (MADAPI)
- SMS služba Sunrise
- SMS služba Vodafone
- Jak odeslat SMS z Clicksend
- Jak odeslat SMS z Infobip
- Jak odeslat SMS pomocí Messagebird
- Jak odeslat SMS pomocí Nexmo
- Jak odeslat SMS z Telnyx
- Jak odeslat SMS z Twilio
- Jak odeslat SMS s připojením Yettel SMS Futár