## Was ist Mobile Connect?

Mobile Connect ist eine **mobile Anwendung für Android**, mit der Sie Ihr Telefon mit dem BulkGate Portal verbinden und Ihren Mobilfunktarif für die geschäftliche Kommunikation mit Ihren Kunden nutzen können. In der Praxis erstellen Sie im Portal eine SMS-Kampagne und senden sie durch Auswahl des richtigen Absenders an Ihr Telefon, das die SMS-Kampagne anschließend über Ihren Mobilfunktarif an Ihre Kunden verteilt.

Wird das Telefon bei der Nutzung der App Mobile Connect nicht verwendet (d. h. der Bildschirm ist ausgeschaltet), kann es in den Ruhemodus wechseln (um Akku zu sparen). Dadurch werden SMS möglicherweise nicht rechtzeitig oder gar nicht gesendet. Das Telefon muss während der Nutzung aktiv sein – die App muss also eingeschaltet und aktiv sein.

Der Ruhemodus kann auf manchen Geräten auch standardmäßig eingestellt sein (abhängig vom Hersteller, von der Betriebssystem-Distribution oder davon, wie aggressiv der Ruhemodus Anwendungen beendet).

Wenn Sie die erste MT-SMS (ursprüngliche Nachricht) senden, wird die MO-SMS (eingehende Nachricht) automatisch Ihrem Wallet zugeordnet.
Wenn Sie die erste MO-SMS ohne MT-SMS senden möchten, kontaktieren Sie uns bitte, damit wir Ihr Standard-Wallet im System zuordnen können. Die MO-SMS wird dann automatisch dem richtigen Konto zugeordnet.

> [!WARNING]
> Bitte beachten Sie, dass es sich bei der Nutzung der App Mobile Connect um einen maschinellen SMS-Versand handelt. Mobilfunkbetreiber erlauben den maschinellen SMS-Versand in einigen Ländern nicht. Halten Sie sich stets an die Geschäftsbedingungen Ihres Mobilfunkbetreibers. 

> [!WARNING]
> Aus diesem Grund können wir die Zustellbarkeit nicht garantieren.

## Installation

Laden Sie im ersten Schritt die Android-Anwendung [hier](/download/mobile-connect.apk) herunter.

Nach der Installation erscheint der Startbildschirm.

![Startbildschirm](helpdesk:mobile-connect-install/mobile_connect_en2)

Dort sehen Sie einen `Key` und eine `PIN`, die Sie anschließend im Portal eingeben.

## Verknüpfen der Anwendung

1. Gehen Sie im linken Menü des [BulkGate Portals](https://portal.bulkgate.com/) zu `Module und APIs`
2. Wählen Sie in der Liste `Mobile Connect`
3. Klicken Sie auf `API erstellen`

![Startbildschirm](helpdesk:mobile-connect-install/mobile_connect_portal1_en)

Geben Sie nun den `Key` und die `PIN` vom Telefonbildschirm in die entsprechenden Felder im Portal ein und klicken Sie auf `sparen` (*Save*).

![Startbildschirm](helpdesk:mobile-connect-install/mobile_connect_portal2_en)

Die Installation ist damit abgeschlossen.

## Absendereinstellungen
1. Gehen Sie zum zweiten Schritt der SMS-Kampagne.
2. Klicken Sie rechts neben dem Editor für den SMS-Text auf das Menü `Absendertyp` und wählen Sie `Mobile Connect`.
3. Es erscheint ein weiteres Menü `Mobiler Anschluss`
4. Wählen Sie, welchen Konnektor Sie verwenden möchten


![Absendereinstellung](helpdesk:mobile-connect-install/mobile-connect-sender-setting-en)


## Verwendung

Auf dem Hauptbildschirm befindet sich eine große Schaltfläche `Start`, die das Senden von Nachrichten ein- und ausschaltet.

![Startbildschirm](helpdesk:mobile-connect-install/mobile_connect_en3)

Nach der Aktivierung wechselt die Anwendung in den Zustand `Idle` und wartet auf Nachrichten aus dem Portal.

### Einstellungen

Die Anwendung bietet folgende Einstellungen:

- **Randomize delay** - Ermöglicht es, das Senden einer Nachricht im Bereich von 1 s bis 20 s zu verzögern (der Benutzer legt das Intervall fest, z. B. 5 s bis 18 s).
- **Process SMS replies** - Alle vom Telefon empfangenen Antworten werden in das Portal übertragen.
- **Support long messages** - Nachrichten mit mehr als 160 Zeichen (bzw. 70 bei Unicode) werden in Teilen gesendet (die Nachricht wird in mehrere Nachrichten zu je 160/70 Zeichen aufgeteilt), und das Telefon des Empfängers erhält die Teile der Nachricht einzeln.
  
Die Statistiken `Sent daily`/`Sent total` werden nach der Anzahl der Textnachrichten berechnet (d. h. 1 über die API empfangene und in mehrere SMS aufgeteilte Nachricht wird in der Statistik als 1 Nachricht gezählt).

### Senden

Um SMS aus der Anwendung zu senden, wählen Sie in der Kampagne den Absendertyp `Mobile Connect` und anschließend das entsprechende Mobiltelefon. Danach läuft alles wie bei einer gewöhnlichen Kampagne ab.
Während die Anwendung sendet, befindet sie sich im Zustand `Running`.

![Startbildschirm](helpdesk:mobile-connect-install/mobile_connect_en4)


## PUSH-Benachrichtigungen

Die App kann Nachrichten auch nur auf Ihrem Telefon empfangen, ohne sie weiterzuleiten. Klicken Sie im Menü oben rechts auf die Glocke, um zur Liste der empfangenen Nachrichten zu gelangen.

![Startbildschirm](helpdesk:mobile-connect-install/mobile_connect_en5)

## API-Einstellungen

Um die Mobile Connect API zu nutzen, benötigen Sie Folgendes:
1. Installieren Sie die App Mobile Connect. Download [hier](/download/mobile-connect.apk).
2. Erstellen Sie eine API im [BulkGate Portal](https://portal.bulkgate.com/)
3. Wählen Sie den Absendertyp: `sender_id: gMobile`.
4. Geben Sie den Schlüssel ein: `sender_id_value: KEY`, wobei Sie den `KEY` aus der [App Mobile Connect auf dem Telefon](#installation) erhalten, mit dem Sie die Nachricht senden möchten.


**Beispiel einer vollständigen Anfrage an die HTTP Advanced API v2 (gilt für HTTP Advanced API v1 und v2 (transaktional und Marketing) sowie 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"
      }
    }
}
```