Rozhraní **Email to SMS** odešle SMS z běžného e-mailu, bez psaní jediné řádky kódu. Adresu tvoří číslo příjemce, předmět nese přístupové údaje a parametry, tělo e-mailu je text zprávy.

> [!NOTE]
> Rozhraní je potřeba nejdřív aktivovat v Portálu. Postup i přístupové údaje najdete v [administraci API](https://www.bulkgate.com/cs/dokumentace/api-administrace-a-tokeny/administrace-api/).

## Adresa příjemce

Adresa, na kterou se e-mail odesílá:

```url
cislo_prijemce@email2sms.bulkgate.com
```

Číslo příjemce musí být v **mezinárodním formátu**, bez nuly na začátku i bez znaménka `+` — například `420603123456`.

## Formát předmětu

Předmět nese tři povinné a dva nepovinné parametry oddělené středníkem:

```text
id_penezenky;heslo_na_email2sms;smstype;isms;sender
```

Nepovinné parametry se vynechávají zprava — bez nich zůstane `id_penezenky;heslo_na_email2sms;smstype`. Text zprávy patří do těla e-mailu.

## Tabulka s parametry

| NÁZEV PARAMETRU    | HODNOTA                                                                                                          | POVINNÝ | VÝCHOZÍ HODNOTA  |
|:-------------------|:------------------------------------------------------------------------------------------------------------------|:--------|:-----------------|
| id_penezenky       | ID peněženky z Portálu (`Moduly a API` > `Email > SMS`)                                                          | **Ano** | -                |
| heslo_na_email2sms | Heslo z Portálu (`Moduly a API` > `Email > SMS`)                                                                 | **Ano** | -                |
| smstype            | `1` — text zkrácený na 160 znaků, `10` — EMS s textem až 612 znaků                                               | **Ano** | -                |
| isms               | SMS brána, hodnota `0` – `4`. Pro textového odesílatele povinná.                                                 | Ne      | `0`              |
| sender             | Odesílatel zprávy — číslo v mezinárodním formátu (`420772423914`), nebo text s maximálně 11 znaky (`eshop.cz`)   | Ne      | Systémové číslo  |

> [!NOTE]
> Hodnotu parametru `isms` najdete v Portálu v ceníku — zobrazí se po najetí na ikonu klíče pro vývojáře.

> [!NOTE]
> Unicode SMS rozhraní nepodporuje.

## Příklady

### Příklad 1 — výchozí brána

SMS do 160 znaků na číslo `+420603123456` s textem „Ahoj, jak se vede?“, odeslaná přes výchozí bránu (systémové číslo).

**Adresa příjemce:** `420603123456@email2sms.bulkgate.com`

**Předmět:** `bg180012091617000;VymysleneHeslo;1`

```text
id_penezenky;heslo_na_email2sms;smstype
```

**Tělo e-mailu:** `Ahoj, jak se vede?`

### Příklad 2 — textový odesílatel

Tatáž SMS odeslaná přes bránu `2` s textovým odesílatelem `eshop.cz`.

**Adresa příjemce:** `420603123456@email2sms.bulkgate.com`

**Předmět:** `bg180012091249500;Heslo12345;1;2;eshop.cz`

```text
id_penezenky;heslo_na_email2sms;smstype;isms;sender
```

**Tělo e-mailu:** `Ahoj, jak se vede?`

## Odpověď

E-maily se zpracovávají každou minutu. V případě chyby vám server pošle zpět e-mail s číslem chyby.