## Qu'est-ce que Mobile Connect ?

Mobile Connect est une **application mobile pour Android** qui vous permet de connecter votre téléphone au portail BulkGate et d'utiliser votre forfait mobile dans la communication professionnelle avec vos clients. En pratique, vous créez une campagne SMS dans le portail, puis vous l'envoyez vers votre téléphone en sélectionnant le bon expéditeur ; le téléphone distribue ensuite la campagne SMS à vos clients depuis votre forfait mobile.

Avec l'application Mobile Connect, si le téléphone n'est pas utilisé (c'est-à-dire si l'écran est éteint), il peut passer en mode veille (pour économiser la batterie), ce qui peut entraîner l'envoi tardif des SMS, voire leur non-envoi. Le téléphone doit rester actif pendant l'utilisation — l'application doit donc être allumée et active.

Le mode veille peut aussi être activé par défaut sur certains appareils (selon le fabricant, la distribution du système d'exploitation ou l'agressivité avec laquelle le mode veille ferme les applications).

Si vous envoyez le premier SMS MT (message d'origine), le SMS MO (message entrant) est automatiquement attribué à votre portefeuille.
Si vous prévoyez de recevoir le premier SMS MO sans SMS MT, contactez-nous afin que nous puissions définir votre portefeuille par défaut dans le système. Le SMS MO sera ainsi automatiquement attribué au bon compte.

> [!WARNING]
> Veuillez noter qu'avec l'application Mobile Connect, il s'agit d'un service d'envoi automatisé de SMS. Dans certains pays, les opérateurs mobiles n'autorisent pas l'envoi automatisé de SMS. Respectez toujours les conditions générales de votre opérateur mobile.

> [!WARNING]
> Pour cette raison, nous ne pouvons pas garantir la délivrabilité.

## Installation

La première étape consiste à télécharger l'application Android [ici](/download/mobile-connect.apk).

Après l'installation, l'écran principal s'affiche.

![Écran d'accueil](helpdesk:mobile-connect-install/mobile_connect_en2)

Vous y voyez une clé (`Key`) et un code `PIN`, que vous saisirez ensuite dans le portail.

## Association de l'application

1. Dans le menu de gauche du [portail BulkGate](https://portal.bulkgate.com/), allez dans `Modules et API`
2. Sélectionnez `Mobile Connect` dans la liste
3. Cliquez sur `Créer API`

![Écran d'accueil](helpdesk:mobile-connect-install/mobile_connect_portal1_en)

Saisissez maintenant la `Key` et le `PIN` affichés sur l'écran du téléphone dans les champs correspondants du portail et cliquez sur `Enregistrer`.

![Écran d'accueil](helpdesk:mobile-connect-install/mobile_connect_portal2_en)

L'installation est maintenant terminée.

## Réglage de l'expéditeur
1. Passez à la deuxième étape de la campagne SMS.
2. À droite de l'éditeur de texte du SMS, cliquez sur le menu `ID expéditeur` et sélectionnez `Mobile Connect`.
3. Un autre menu, `Connecteur mobile`, apparaît
4. Sélectionnez le connecteur que vous souhaitez utiliser


![Réglage de l'expéditeur](helpdesk:mobile-connect-install/mobile-connect-sender-setting-en)


## Utilisation

L'écran principal comporte un grand bouton `Start` qui active et désactive l'envoi des messages.

![Écran d'accueil](helpdesk:mobile-connect-install/mobile_connect_en3)

Après l'activation, l'application passe à l'état `Idle` et attend les messages du portail.

### Paramètres

L'application propose les paramètres suivants :

- **Randomize delay** - Permet de retarder l'envoi d'un message dans une plage de 1 s à 20 s (l'utilisateur définit l'intervalle, par exemple 5 s à 18 s).
- **Process SMS replies** - Toutes les réponses reçues par le téléphone sont transférées vers le portail.
- **Support long messages** - Les messages de plus de 160 caractères (ou 70 en Unicode) sont envoyés en plusieurs parties (le message est découpé en plusieurs messages de 160/70 caractères) et le téléphone du destinataire reçoit les parties du message séparément.
  
Les statistiques `Sent daily`/`Sent total` sont calculées selon le nombre de messages texte (c'est-à-dire qu'un message reçu de l'API et découpé en plusieurs SMS compte comme 1 message dans les statistiques).

### Envoi

Pour envoyer des SMS depuis l'application, sélectionnez dans la campagne le type d'expéditeur `Mobile Connect`, puis le téléphone mobile approprié. Ensuite, tout se déroule comme pour une campagne ordinaire.
Lorsque l'application envoie des messages, elle est à l'état `Running`.

![Écran d'accueil](helpdesk:mobile-connect-install/mobile_connect_en4)


## Notifications PUSH

L'application peut se contenter de recevoir des messages sur votre téléphone sans les transférer. Cliquez sur la cloche dans le menu en haut à droite pour accéder à la liste des messages reçus.

![Écran d'accueil](helpdesk:mobile-connect-install/mobile_connect_en5)

## Paramètres de l'API

Pour commencer à utiliser l'API Mobile Connect, vous devez :
1. Installer l'application Mobile Connect. Téléchargement [ici](/download/mobile-connect.apk).
2. Créer une API dans le [portail BulkGate](https://portal.bulkgate.com/)
3. Choisir le type d'identifiant d'expéditeur : `sender_id: gMobile`.
4. Insérer la clé : `sender_id_value: KEY`, où vous obtenez la `KEY` depuis l'[application Mobile Connect sur le téléphone](#installation) que vous souhaitez utiliser pour envoyer le message.


**Exemple d'une requête complète HTTP Advanced API v2 (valable pour HTTP Advanced API v1 et v2 (transactionnelle et marketing) et 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"
      }
    }
}
```