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

Pokud odešlete první MT SMS (původní zprávu), MO SMS (příchozí zpráva) se automaticky přiřadí k vaší peněžence. Pokud plánujete odeslat první MO SMS bez MT SMS, kontaktujte nás, abychom mohli v systému přiřadit vaši výchozí peněženku. Tím se MO SMS automaticky přiřadí ke správnému účtu.

Upozorňujeme, že v případě použití aplikace Mobile Connect se jedná o strojové odesílání SMS zpráv. Mobilní operátoři v některých zemích strojové odesílání SMS zpráv nepovolují. Řiďte se vždy obchodními podmínkami Vašeho mobilního operátora.

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ě
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",
    "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"
      }
    }
}