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.

Video 1 - Jak se zaregistrovat na portálu Madapi Developer (Návodné video)

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:

vyberte registraci
Obrázek 1 - Vyberte registraci

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ší".

zadejte jméno a e-mailovou adresu
Obrázek 2 - Zadejte jméno a e-mailovou adresu

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.

přidejte heslo
Obrázek 3 - Přidejte heslo

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.

vyberte zemi
Obrázek 4 - Vyberte zemi

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.

ověřte e-mailovou adresu
Obrázek 5 - Ověřte e-mailovou adresu

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.

nainstalujte google authenticator
Obrázek 6 - Nainstalujte Google Authenticator

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ě.

přidejte účet v google authenticatoru
Obrázek 7 - Přidejte účet v Google Authenticatoru

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.

podrobnosti účtu v google authenticatoru
Obrázek 8 - Podrobnosti účtu v Google Authenticatoru

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.

povolte dvoufaktorové ověřování
Obrázek 9 - Povolte dvoufaktorové ověřování

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.

přihlášení do vývojářského portálu
Obrázek 10 - Přihlášení do vývojářského portálu

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í.

dvoufázové ověření
Obrázek 11 - Dvoufázové ověř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ů.

Video 2 - Jak vytvořit aplikaci

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.

vytvořit aplikaci
Obrázek 12 - Vytvořit aplikaci

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ě".

definovat detaily aplikace
Obrázek 13 - Definovat detaily aplikace

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.

vybrat zemi
Obrázek 14 - Vybrat zemi

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í.

přidat sms v2 rozhraní
Obrázek 15 - Přidat SMS V2 rozhraní

Pro zahájení procesu vytváření aplikace najděte tlačítko "Vytvořit aplikaci" a klikněte na něj.

vytvořit aplikaci
Obrázek 16 - Vytvořit aplikaci

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".

madapi aplikace vytvořena
Obrázek 17 - Madapi aplikace vytvořena

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.

upravit aplikaci
Obrázek 18 - Upravit aplikaci

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í.

upravit detaily aplikace
Obrázek 19 - Upravit detaily aplikace

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.

přidat službu sms v2 do vaší aplikace
Obrázek 20 - Přidat službu SMS V2 do vaší aplikace

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.

Video 3 - Jak zkopírovat zákaznický klíč a produkční tajný kód do Ozeki 10 (Návod ve videu)

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ů.

přidat nové připojení
Obrázek 21 - Přidat nové připojení

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".

nainstalovat madapi klienta
Obrázek 22 - Nainstalovat Madapi klienta

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.

zkopírovat klíč a tajný kód
Obrázek 23 - Zkopírovat klíč a tajný kód

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.

vložit klíč a tajný kód
Obrázek 24 - Vložit klíč a tajný kód

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.

přístupový token přijat
Obrázek 25 - Přístupový token přijat

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.

Video 4 - Jak odeslat testovací SMS a jak zkontrolovat protokoly (Návod ve videu)

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.

vytvořit testovací sms zprávu
Obrázek 26 - Vytvořit testovací SMS zprávu

Po zadání těchto údajů klikněte na tlačítko "Odeslat".

odeslat testovací zprávu
Obrázek 27 - Odeslat testovací zprávu

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ů.

zpráva odeslána
Obrázek 28 - Zpráva odeslána

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