L'interface **Email to SMS** envoie un SMS à partir d'un e-mail ordinaire, sans écrire une seule ligne de code. Le numéro du destinataire constitue l'adresse, l'objet contient les identifiants et les paramètres, et le corps de l'e-mail est le texte du message.

> [!NOTE]
> L'interface doit d'abord être activée dans le portail. Les étapes et les identifiants sont décrits dans l'[administration des API](https://www.bulkgate.com/fr/documentation/administration-api-et-tokens/administration-api/).

## Adresse du destinataire

L'adresse à laquelle l'e-mail est envoyé :

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

Le numéro du destinataire doit être écrit au **format international**, sans zéro initial ni signe `+` — par exemple `420777777777`.

## Format de l'objet

L'objet contient trois paramètres obligatoires et deux facultatifs, séparés par un point-virgule :

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

Les paramètres facultatifs s'omettent en partant de la droite — sans eux, l'objet est `wallet_id;email2sms_password;smstype`. Le texte du message se place dans le corps de l'e-mail.

## Tableau des paramètres

| NOM DU PARAMÈTRE   | VALEUR | OBLIGATOIRE | VALEUR PAR DÉFAUT |
|:-------------------|:-------|:------------|:------------------|
| wallet_id          | ID du portefeuille dans le portail (`Modules et API` > `Email > SMS`) | **Oui** | - |
| email2sms_password | Mot de passe dans le portail (`Modules et API` > `Email > SMS`) | **Oui** | - |
| smstype            | `1` — texte raccourci à 160 caractères, `10` — EMS avec un texte jusqu'à 612 caractères | **Oui** | - |
| isms               | Passerelle SMS, valeur `0` – `4`. Obligatoire pour utiliser un expéditeur texte. | Non | `0` |
| sender             | Expéditeur du message — un numéro au format international (`420777777777`) ou un texte de 11 caractères maximum (`eshop.com`) | Non | Numéro système |

> [!NOTE]
> Vous trouverez la valeur `isms` dans les tarifs du portail — elle s'affiche lorsque vous survolez l'icône de clé à molette destinée aux développeurs.

> [!NOTE]
> Les SMS Unicode ne sont pas pris en charge par cette interface.

## Exemples

### Exemple 1 — passerelle par défaut

Un SMS de 160 caractères maximum au numéro `+420777777777` avec le texte « Bonjour, comment allez-vous ? », envoyé par la passerelle par défaut (numéro système).

**Adresse du destinataire :** `420777777777@email2sms.bulkgate.com`

**Objet :** `bg180012091617000;MotDePasseFictif;1`

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

**Corps de l'e-mail :** `Bonjour, comment allez-vous ?`

### Exemple 2 — expéditeur texte

Le même SMS envoyé par la passerelle `2` avec l'expéditeur texte `eshop.com`.

**Adresse du destinataire :** `420777777777@email2sms.bulkgate.com`

**Objet :** `bg180012091249500;MotDePasse12345;1;2;eshop.com`

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

**Corps de l'e-mail :** `Bonjour, comment allez-vous ?`

## Réponse

Les e-mails sont traités toutes les minutes. En cas d'erreur, le serveur vous renvoie un e-mail contenant le numéro de l'erreur.