## Čo je Mobile Connect?

Mobile Connect je **mobilná aplikácia pre Android**, ktorá vám umožní prepojiť váš telefón s portálom BulkGate a využiť váš mobilný tarif na komunikáciu s vašimi zákazníkmi. V praxi môžete vytvoriť SMS kampaň na portáli a následne ju výberom správneho typu odosielateľa poslať do svojho telefónu, ktorý kampaň postupne rozošle z vášho tarifu.

Pokiaľ ide o aplikáciu Mobile Connect, ak používateľ telefón nepoužíva (t. j. obrazovka je vypnutá), telefón môže prejsť do tzv. úsporného režimu (napr. kvôli šetreniu batérie) a z tohto dôvodu SMS neodíde včas alebo vôbec.
Telefón musí byť počas celej doby používania aplikácie Mobile Connect v aktívnom stave - t. j. aplikácia musí byť zapnutá a aktívna.

Úsporný režim telefónu môže byť na niektorých telefónoch nastavený aj ako predvolené správanie (závisí od výrobcu danej distribúcie OS a od toho, ako agresívne vypína aplikácie a uspáva telefón).

Ak odošlete prvú MT SMS (pôvodnú správu), MO SMS (prichádzajúca správa) sa automaticky priradí k vašej peňaženke.
Ak plánujete odoslať prvú MO SMS bez MT SMS, kontaktujte nás, aby sme vám v systéme mohli priradiť predvolenú peňaženku. Tým sa MO SMS automaticky priradí k správnemu účtu.

> [!WARNING]
> Upozorňujeme, že pri použití aplikácie Mobile Connect ide o strojové odosielanie SMS správ. Mobilní operátori v niektorých krajinách strojové odosielanie SMS správ nepovoľujú. Vždy sa riaďte obchodnými podmienkami svojho mobilného operátora. 

> [!WARNING]
> Na základe uvedeného nemôžeme garantovať doručiteľnosť.  

## Inštalácia

Prvým krokom je stiahnutie aplikácie pre Android, ktorú nájdete [tu](/download/mobile-connect.apk).

Po inštalácii sa zobrazí základná obrazovka.

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

Zobrazí sa na nej `kľúč (Key)` a `pin (PIN)`, ktoré následne zadáte do portálu.

## Prepojenie aplikácie

1. Prejdite do sekcie `Moduly a API` v ľavom menu BulkGate Portálu
2. V zozname vyberte `Mobile Connect`
3. Kliknite na `Vytvoriť API`

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

Teraz prepíšte `kľúč (Key)` a `pin (PIN)` z obrazovky telefónu do príslušných políčok v portáli a kliknite na `Uložiť.`

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

Tým je inštalácia hotová

## Nastavenie odosielateľa
1. Prejdite do druhého kroku SMS kampane
2. Vpravo vedľa editora textu SMS správy rozbaľte ponuku `Typ odosielateľa` a vyberte `Mobile Connect`
3. Zobrazí sa vám ďalšia ponuka `Mobilný konektor`
4. Vyberte, ktorý konektor chcete použiť

![Nastavenie odosielateľa](helpdesk:mobile-connect-install/mobile-connect-sender-setting-cs)

## Použitie

Na hlavnej obrazovke je veľké tlačidlo `Štart`, ktoré zapína a vypína odosielanie.

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

Po aktivácii sa aplikácia prepne do stavu `Idle`, v ktorom čaká na správy z portálu.

### Nastavenia

Aplikácia obsahuje nasledujúce nastavenia:

- **Randomize delay** - Umožňuje odložiť odoslanie správy v rozsahu 1s-20s (interval definuje používateľ, napr. 5s-18s).
- **Process SMS replies** - Všetky odpovede prijaté telefónom sa prenesú na Portál.
- **Support long messages** - Správy, ktoré majú viac ako 160 znakov (alebo 70 znakov v Unicode), sa odosielajú dávkovo (správa sa rozdelí na viac správ po 160/70 znakov) a telefón príjemcu dostane viac častí správy samostatne.

Štatistiky `Sent daily` / `Sent total` sa počítajú podľa počtu textových správ (t. j. 1 správa prijatá z rozhrania API a rozdelená do niekoľkých SMS správ sa do štatistík započíta ako 1 správa).

### Odosielanie

Na odosielanie SMS z aplikácie je potrebné v kampani vybrať typ odosielateľa `Mobile Connect` a následne príslušný telefón. Potom všetko prebieha rovnako ako pri bežnej kampani. 

Keď aplikácia odosiela, je v stave `Running`

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


## PUSH notifikácie

Aplikácia dokáže správy iba prijímať do telefónu bez toho, aby ich preposielala ďalej. Po stlačení zvončeka v pravom hornom menu sa dostanete do zoznamu prijatých správ.

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

## Nastavenie API

Aby ste mohli začať používať Mobile Connect API, potrebujete:
1. Nainštalovať aplikáciu Mobile Connect App. Stiahnite ju [tu](/download/mobile-connect.apk).
2. Vytvoriť API na [BulkGate Portáli](https://portal.bulkgate.com/)
3. Zvoliť typ ID odosielateľa: `sender_id: gMobile`
4. Vložiť kľúč: `sender_id_value: KEY`, kde kľúč `KEY` získate v mobilnej aplikácii [Mobile Connect App v telefóne](#instalacia), ktorý chcete použiť na odoslanie správy.


**Príklad úplnej požiadavky HTTP Advanced API v2 (platí pre HTTP Advanced API v1 a v2 (transakčné aj marketingové) 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"
      }
    }
}
```