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

1. Přejděte do sekce Moduly a API v levém menu BulkGate Portálu
2. V seznamu vyberte Mobile Connect
3. 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

1. Běžte do druhého kroku SMS kampaně (nebo třetího kroku v případě Smart SMS kampaně)
2. Vpravo vedle editoru textu SMS zprávy rozklikněte nabídku Typ odesílatele a vyberte Mobile Connect
3. Zobrazí se vám další nabídka Mobilní konektor
4. 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:

1. Nainstalovat aplikaci Mobile Connect App. Stáhněte zde.
2. Vytvořit API na BulkGate Portálu
3. Zvolit typ ID odesílatele: sender_iD: gMobile
4. 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"
      }
    }
}