A interface **Email to SMS** envia uma SMS a partir de um e-mail comum, sem escrever uma única linha de código. O número do destinatário forma o endereço, o assunto contém os dados de acesso e os parâmetros e o corpo do e-mail é o texto da mensagem.

> [!NOTE]
> A interface tem de ser ativada primeiro no Portal. Os passos e os dados de acesso estão descritos em [Administração da API](https://www.bulkgate.com/pt/documentacao/administracao-da-api/administracao-de-apis/).

## Endereço do destinatário

O endereço para onde o e-mail é enviado:

```url
recipient_number@email2sms.bulkgate.com
```

O número do destinatário tem de ser escrito no **formato internacional**, sem zero inicial e sem o sinal `+` — por exemplo `420777777777`.

## Formato do assunto

O assunto contém três parâmetros obrigatórios e dois opcionais, separados por ponto e vírgula:

```text
wallet_id;email2sms_password;smstype;isms;sender
```

Os parâmetros opcionais são omitidos a partir da direita — sem eles, o assunto é `wallet_id;email2sms_password;smstype`. O texto da mensagem vai no corpo do e-mail.

## Tabela de parâmetros

| NOME DO PARÂMETRO | VALOR | OBRIGATÓRIO | VALOR PREDEFINIDO |
|:-------------------|:--------------------------------------------------------------------------------------------------------------|:----------|:---------------|
| wallet_id          | ID da carteira no Portal (`Módulos e APIs` > `Email > SMS`) | **Sim** | - |
| email2sms_password | Palavra-passe no Portal (`Módulos e APIs` > `Email > SMS`) | **Sim** | - |
| smstype            | `1` — texto encurtado para 160 caracteres, `10` — EMS com texto até 612 caracteres | **Sim** | - |
| isms               | Gateway de SMS, valor `0` – `4`. Obrigatório para utilizar um ID de remetente de texto. | Não | `0` |
| sender             | Remetente da mensagem — um número em formato internacional (`420777777778`) ou um texto com até 11 caracteres (`eshop.com`) | Não | Número do sistema |

> [!NOTE]
> O valor `isms` encontra-se na tabela de preços no Portal — é apresentado quando passa o cursor sobre o ícone de chave inglesa para programadores.

> [!NOTE]
> Esta interface não suporta SMS Unicode.

## Exemplos

### Exemplo 1 — gateway predefinido

Uma SMS com até 160 caracteres para o número `+420777777777` com o texto “Olá, como está?”, enviada através do gateway predefinido (número do sistema).

**Endereço do destinatário:** `420777777777@email2sms.bulkgate.com`

**Assunto:** `bg180012091617000;MadeUpPassword;1`

```text
wallet_id;email2sms_password;smstype
```

**Corpo do e-mail:** `Olá, como está?`

### Exemplo 2 — ID de remetente de texto

A mesma SMS enviada através do gateway `2` com o ID de remetente de texto `eshop.com`.

**Endereço do destinatário:** `420777777777@email2sms.bulkgate.com`

**Assunto:** `bg180012091249500;Password12345;1;2;eshop.com`

```text
wallet_id;email2sms_password;smstype;isms;sender
```

**Corpo do e-mail:** `Olá, como está?`

## Resposta

Os e-mails são processados a cada minuto. Em caso de erro, o servidor envia-lhe de volta um e-mail com o número do erro.