## O que é o Mobile Connect?

O Mobile Connect é uma **aplicação móvel para Android** que lhe permite ligar o seu telemóvel ao Portal BulkGate e utilizar o tarifário do seu telemóvel na comunicação empresarial com os seus clientes. Na prática, pode criar uma campanha SMS no Portal e depois enviá-la para o seu telemóvel selecionando o remetente adequado; o telemóvel distribui então a campanha SMS aos seus clientes a partir do seu tarifário móvel.

No caso da aplicação Mobile Connect, se o telemóvel não estiver a ser utilizado (ou seja, o ecrã estiver desligado), pode entrar em modo de suspensão (para poupar bateria), o que pode fazer com que as SMS não sejam enviadas a tempo ou de todo. O telemóvel tem de estar ativo durante a utilização — o que significa que a aplicação tem de estar ligada e ativa.

O modo de suspensão também pode estar definido por predefinição em alguns dispositivos (depende do fabricante, da distribuição do sistema operativo ou da agressividade com que o modo de suspensão desliga as aplicações).

Se enviar primeiro uma SMS MT (mensagem original), a SMS MO (mensagem recebida) é automaticamente atribuída à sua carteira.
Se pretender enviar a primeira SMS MO sem uma SMS MT, contacte-nos para que possamos atribuir a sua carteira predefinida no sistema. Assim, a SMS MO será automaticamente atribuída à conta correta.

> [!WARNING]
> Tenha em atenção que, ao utilizar a aplicação Mobile Connect, se trata de um serviço de envio automatizado de mensagens de texto. Em alguns países, os operadores móveis não permitem o envio automatizado de mensagens de texto. Respeite sempre os termos e condições do seu operador móvel. 

> [!WARNING]
> Por este motivo, não podemos garantir a entrega.

## Instalação

O primeiro passo é transferir a aplicação Android [aqui](/download/mobile-connect.apk).

Após a instalação, aparece o ecrã principal.

![ecrã inicial](helpdesk:mobile-connect-install/mobile_connect_en2)

Nele verá uma `Key` e um `PIN`, que introduzirá depois no Portal.

## Ligar a aplicação

1. Aceda a `Módulos e APIs` no menu à esquerda do [Portal BulkGate](https://portal.bulkgate.com/)
2. Selecione `Mobile Connect` na lista
3. Clique em `Criar API`

![ecrã inicial](helpdesk:mobile-connect-install/mobile_connect_portal1_en)

Agora introduza no portal, nos campos correspondentes, a `Key` e o `PIN` apresentados no ecrã do telemóvel e clique em `Salve`.

![ecrã inicial](helpdesk:mobile-connect-install/mobile_connect_portal2_en)

A instalação está concluída.

## Definições do remetente
1. Avance para o segundo passo da campanha SMS.
2. À direita do editor de texto da SMS, clique no menu `Tipo de remetente` e selecione `Mobile Connect`.
3. Aparece outro menu, `Conector móvel`
4. Selecione o conector que pretende utilizar


![Definição do remetente](helpdesk:mobile-connect-install/mobile-connect-sender-setting-en)


## Utilização

No ecrã principal existe um grande botão `Start` que liga e desliga o envio de mensagens.

![ecrã inicial](helpdesk:mobile-connect-install/mobile_connect_en3)

Após a ativação, a aplicação passa para o estado `Idle`, aguardando mensagens do Portal.

### Definições

A aplicação tem as seguintes definições:

- **Randomize delay** - Permite atrasar o envio de uma mensagem num intervalo de 1 s a 20 s (o utilizador define o intervalo, p. ex. 5 s a 18 s).
- **Process SMS replies** - Todas as respostas recebidas pelo telemóvel são transferidas para o Portal.
- **Support long messages** - As mensagens com mais de 160 caracteres (ou 70 em Unicode) são enviadas em lote (a mensagem é dividida em várias mensagens de 160/70 caracteres) e o telemóvel do destinatário recebe as várias partes da mensagem separadamente.
  
As estatísticas `Sent daily`/`Sent total` são calculadas de acordo com o número de mensagens de texto (ou seja, 1 mensagem recebida da API e dividida em várias SMS conta como 1 mensagem nas estatísticas).

### Envio

Para enviar SMS a partir da aplicação, é necessário selecionar o tipo de remetente `Mobile Connect` na campanha e, em seguida, o telemóvel pretendido. Depois, tudo decorre como numa campanha normal.
Quando a aplicação está a enviar, encontra-se no estado `Running`.

![ecrã inicial](helpdesk:mobile-connect-install/mobile_connect_en4)


## Notificações PUSH

A aplicação pode apenas receber mensagens no seu telemóvel, sem as reencaminhar. Clique no sino no menu superior direito para aceder à lista de mensagens recebidas.

![ecrã inicial](helpdesk:mobile-connect-install/mobile_connect_en5)

## Definições da API

Para começar a utilizar a API do Mobile Connect, precisa de:
1. Instalar a aplicação Mobile Connect. Transfira-a [aqui](/download/mobile-connect.apk).
2. Criar uma API no [Portal BulkGate](https://portal.bulkgate.com/)
3. Escolher o tipo de ID do remetente: `sender_id: gMobile`.
4. Inserir a chave: `sender_id_value: KEY`, em que obtém a `KEY` a partir da [aplicação Mobile Connect no telemóvel](#instalacao) que pretende utilizar para enviar a mensagem.


**Exemplo de um pedido completo da HTTP Advanced API v2 (aplica-se à HTTP Advanced API v1 e v2 (transacional e marketing) e à 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"
      }
    }
}
```