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

> [!WARNING]
> 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. 

> [!WARNING]
> Na základě uvedeného nemůžeme garantovat doručitelnost.  

## Instalace

Prvním krokem je stažení Android aplikace, která se nachází [zde](/download/mobile-connect.apk).

Po instalaci se ukáže základní obrazovka.

![init_page](helpdesk:mobile-connect-install/mobile_connect_cs2)

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`

![init_page](helpdesk:mobile-connect-install/mobile_connect_portal1_cs)

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

![init_page](helpdesk:mobile-connect-install/mobile_connect_portal2_cs)

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

![Nastavení odesílatele](helpdesk:mobile-connect-install/mobile-connect-sender-setting-cs)

## Použití

Na hlavní obrazovce je velké tlačítko `Start`, které zapne a vypne zasílání.

![init_page](helpdesk:mobile-connect-install/mobile_connect_cs3)

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`

![init_page](helpdesk:mobile-connect-install/mobile_connect_cs4)


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

![init_page](helpdesk:mobile-connect-install/mobile_connect_cs5)

## Nastavení API

Abyste mohli Mobile Connect API začít používat potřebujete:
1. Nainstalovat aplikaci Mobile Connect App. Stáhněte [zde](/download/mobile-connect.apk).
2. Vytvořit API na [BulkGate Portálu](https://portal.bulkgate.com/)
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](#instalace) 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):**
```http-json
POST /api/2.0/advanced/transactional HTTP/1.1
Host: portal.bulkgate.com
Content-Type: application/json
Cache-Control: no-cache

{
    "application_id": 451,
    "application_token": "NKN02TWE6NfBkfl-your-secret-token-Wf05GaqLIWLW4aBj",
    "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"
      }
    }
}
```