Die Schnittstelle **Email to SMS** versendet eine SMS aus einer gewöhnlichen E-Mail, ohne dass Sie eine einzige Zeile Code schreiben müssen. Die Nummer des Empfängers bildet die Adresse, der Betreff enthält die Zugangsdaten und Parameter, und der Text der E-Mail ist der Nachrichtentext.

> [!NOTE]
> Die Schnittstelle muss zuerst im Portal aktiviert werden. Die Schritte und die Zugangsdaten sind in der [API-Verwaltung](https://www.bulkgate.com/de/dokumentation/api-verwaltung-und-tokens/api-verwaltung/) beschrieben.

## Empfängeradresse

Die Adresse, an die die E-Mail gesendet wird:

```url
Empfänger_Nummer@email2sms.bulkgate.com
```

Die Nummer des Empfängers muss im **internationalen Format** angegeben werden, ohne führende Null und ohne das Zeichen `+` — zum Beispiel `420777777777`.

## Format des Betreffs

Der Betreff enthält drei Pflichtparameter und zwei optionale Parameter, getrennt durch Semikolons:

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

Die optionalen Parameter werden von rechts weggelassen — ohne sie lautet der Betreff `wallet_id;email2sms_password;smstype`. Der Nachrichtentext gehört in den Text der E-Mail.

## Parametertabelle

| PARAMETERNAME      | WERT | PFLICHT | STANDARDWERT |
|:-------------------|:-----|:--------|:-------------|
| wallet_id          | Wallet-ID aus dem Portal (`Module und APIs` > `Email > SMS`) | **Ja** | - |
| email2sms_password | Passwort aus dem Portal (`Module und APIs` > `Email > SMS`) | **Ja** | - |
| smstype            | `1` — Text auf 160 Zeichen gekürzt, `10` — EMS mit Text bis zu 612 Zeichen | **Ja** | - |
| isms               | SMS-Gateway, Wert `0` – `4`. Pflicht für die Verwendung eines Textabsenders. | Nein | `0` |
| sender             | Absender der Nachricht — eine Nummer im internationalen Format (`420777777777`) oder Text mit bis zu 11 Zeichen (`eshop.com`) | Nein | Systemnummer |

> [!NOTE]
> Den Wert `isms` finden Sie in der Preisliste im Portal — er wird angezeigt, wenn Sie mit der Maus über das Schraubenschlüssel-Symbol für Entwickler fahren.

> [!NOTE]
> Unicode-SMS werden von dieser Schnittstelle nicht unterstützt.

## Beispiele

### Beispiel 1 — Standard-Gateway

Eine SMS mit bis zu 160 Zeichen an die Nummer `+420777777777` mit dem Text „Hallo, wie geht's?“, versendet über das Standard-Gateway (Systemnummer).

**Empfängeradresse:** `420777777777@email2sms.bulkgate.com`

**Betreff:** `bg180012091617000;MadeUpPassword;1`

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

**Text der E-Mail:** `Hallo, wie geht's?`

### Beispiel 2 — Textabsender

Dieselbe SMS, versendet über das Gateway `2` mit dem Textabsender `eshop.com`.

**Empfängeradresse:** `420777777777@email2sms.bulkgate.com`

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

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

**Text der E-Mail:** `Hallo, wie geht's?`

## Antwort

E-Mails werden jede Minute verarbeitet. Bei einem Fehler sendet Ihnen der Server eine E-Mail mit der Fehlernummer zurück.