Instalace Mobile Connect
Co je Mobile Connect?
Mobile Connect je mobilní aplikace pro Android, která vám umožní propojit váš telefon s portálem BulkGate a využít váš mobilní tarif pro komunikaci s vašimi zákazníky. V praxi můžete vytvořit SMS kampaň na portálu a následně ji výběrem správného typu odesilatele poslat do vašeho telefonu, který postupně rozešle kampaň z vašeho tarifu.
Co se týče Mobile Connect aplikace, pokud uživatel telefon nepoužívá (tzn. obrazovka je vypnutá), telefon může přejít do tzv. úsporného režimu (např. z důvodu šetření baterie) a z tohoto důvodu SMS neodejde včas nebo vůbec. Telefon musí být po celou dobu používání aplikace Mobile Connect v aktivním stavu - tzn. aplikace musí být zapnutá a aktivní.
Úsporný režim telefonu může být nastavený i jako výchozí chování na některých telefonech (záleží na výrobci dané distribuce OS a jak mají nastavenou agresivitu vypínání aplikací a uspávání telefonu).
Instalace
Prvním krokem je stažení Android aplikace, která se nachází zde.
Po instalaci se ukáže základní obrazovka.
Na které se zobrazí klíč (Key)
a pin (PIN)
, které následně zadáte do portálu.
Propojení aplikace
- Přejděte do sekce
Moduly a API
v levém menu BulkGate Portálu - V seznamu vyberte
Mobile Connect
- Klikněte na
Vytvořit API
Nyní opište klíč (Key)
a pin (PIN)
z obrazovky telefonu do portálu do příslušných kolonek a klikněte na Uložit.
Tím je instalace hotová
Nastavení odesílatele
- Běžte do druhého kroku SMS kampaně (nebo třetího kroku v případě Smart SMS kampaně)
- Vpravo vedle editoru textu SMS zprávy rozklikněte nabídku
Typ odesílatele
a vyberteMobile Connect
- Zobrazí se vám další nabídka
Mobilní konektor
- Vyberte, který konektor chcete použít
Použití
Na hlavní obrazovce je velké tlačítko Start
, které zapne a vypne zasílání.
Po aktivaci se aplikace přepne do stavu Idle
, ve kterém čeká na zprávy z portálu.
Nastavení
Aplikace obsahuje následující nastavení:
- Randomize delay - Umožňuje odložit odeslání zprávy v rozsahu 1s-20s (interval definuje uživatel, např. 5s-18s).
- Process SMS replies - Všechny odpovědi přijaté telefonem se přenesou na Portál.
- Support long messages - Zprávy, které mají více než 160 znaků (nebo 70 znaků v Unicode), jsou odesílány dávkově (zpráva je rozdělena na více zpráv o 160/70 znacích) a telefon příjemce obdrží více částí zprávy samostatně.
Statistiky Sent daily
/ Sent total
se počítají podle počtu textových zpráv (tj. 1 zpráva přijatá z rozhraní API a rozdělená do několika SMS zpráv se do statistik započítá jako 1 zpráva).
Odesílání
Pro odesílání SMS z aplikace je nutné v kampaňi vybrat typ odesilatele Mobile Connect
a následně příslušný telefon. Pak vše probíhá stejně jako u běžné kampaně.
Pokud aplikace zasílá, tak je ve stavu Running
PUSH Notifikace
Aplikace dokáže přijímat zprávy pouze do telefonu bez toho, aby je přeposílala dál. Po stisknutí zvonečku v pravém horním menu se dostanete do seznamu přijatých zpráv.
Nastavení API
Abyste mohli Mobile Connect API začít používat potřebujete:
- Nainstalovat aplikaci Mobile Connect App. Stáhněte zde.
- Vytvořit API na BulkGate Portálu
- Zvolit typ ID odesílatele:
sender_iD: gMobile
- Vložit klíč:
sender_ID_value: KEY
, kde klíčKEY
získáte v mobilní aplikaci Mobile Connect App v telefonu, který chcete použít k odeslání zprávy.
Příklad úplného požadavku HTTP Advanced API v2 (platí pro HTTP Advanced API v1 a v2 (transakční i marketingovou) a HTTP Simple API):
POST /api/2.0/advanced/transactional HTTP/1.1
Host: portal.bulkgate.com
Content-Type: application/json
Cache-Control: no-cache
{
"application_id": "APPLICATION_ID",
"application_token": "APPLICATION_TOKEN",
"application_product": "http-advanced",
"number": "420111222333",
"text": "example text <first_name>",
"variables": {"first_name": "John Doe"},
"country": "cz",
"schedule": "2018-05-14T18:30:00-01:00",
"channel": {
"sms": {
"sender_id": "gMobile",
"sender_id_value": "KEY",
"unicode": true,
"text": "example text"
}
}
}