## Ce que sont les identifiants d'accès Email to SMS

`Email > SMS` n'envoie pas les messages via une API HTTP, mais par e-mail. Au lieu
d'un Application ID et d'un token, vous avez donc besoin de deux valeurs, que le
portail génère lors de la création de l'application :

| Valeur | À quoi elle sert |
|:--|:--|
| `Destinataire` | L'adresse à laquelle vous envoyez l'e-mail. Le numéro du destinataire se place avant l'arobase |
| `Sujet` | Identifie votre application et fixe le nombre de SMS que le message peut occuper |

Le sujet fait aussi office d'identifiant — quiconque le connaît peut envoyer des
messages depuis votre compte. Traitez-le de la même manière qu'un [token d'API](https://www.bulkgate.com/fr/documentation/administration-api-et-tokens/tokens-d-api/).

## Comment créer l'application

1. Dans le menu du portail, cliquez sur `Modules et API`
2. Dans la partie `Découvrez nos API et modules`, cliquez sur la tuile `Email > SMS`
3. Choisissez le `Portefeuille` sur lequel les messages seront facturés et renseignez le `Nom`
4. Cliquez sur `Créer API`

![La fenêtre de création d'une application Email > SMS](docs:email-to-sms-credentials/create-form_en)

Tant qu'aucun portefeuille n'est sélectionné, le bouton `Créer API` reste désactivé. Une fois
l'application créée, le portail vous conduit directement à son détail.

> [!IMPORTANT]
> Une nouvelle application est désactivée — l'interrupteur `Activé` dans la partie `Statut`
> à droite est éteint. Tant que vous ne l'activez pas, aucun e-mail n'est converti en SMS.

## Où trouver les identifiants d'accès

1. Dans le menu, cliquez sur `Modules et API`
2. Dans la partie `Mes API et modules`, cliquez sur la carte de votre application `Email > SMS`

La partie `Paramètres e-mail` contient trois lignes. Un clic sur une valeur la copie
dans le presse-papiers.

![La partie Paramètres e-mail avec le destinataire et les deux sujets](docs:email-to-sms-credentials/email-settings_en)

| Ligne | Valeur |
|:--|:--|
| `Destinataire` | `destinataire_numéro@email2sms.bulkgate.com` |
| `Sujet SMS raccourci` | `{wallet};{key};1` |
| `Sujet Long SMS` | `{wallet};{key};10` |

Au-dessus figure `Portefeuille` avec l'identifiant du portefeuille sur lequel les
messages sont facturés.

## Comment un message est envoyé

Dans le champ destinataire de l'e-mail, remplacez `destinataire_numéro` par le numéro
de téléphone au format international, sans le signe plus ni espaces — par exemple
`420777123456`. L'adresse obtenue ressemble à ceci :

```url
420777123456@email2sms.bulkgate.com
```

Indiquez l'une des valeurs préparées dans le sujet de l'e-mail ; le corps de
l'e-mail constitue le message lui-même.

Le dernier nombre du sujet indique le nombre maximal de SMS que le message peut
occuper — `1` pour un message court, `10` pour un message long. Un texte plus long
est découpé en plusieurs SMS consécutifs, qui sont tous facturés.

> [!TIP]
> Si vous souhaitez une autre limite que 1 ou 10, vous pouvez modifier vous-même le
> dernier nombre du sujet — laissez le reste du sujet tel quel.

## Comment recevoir les rapports de livraison

La partie `Rapports de livraison par e-mail` est d'abord à l'état `Inactif`. L'icône `+` ouvre la
fenêtre `Paramètres des rapports de livraison`, dans laquelle vous saisissez une adresse dans le
champ `Rapports de livraison par e-mail` et confirmez par `Définir`.

La case à cocher `Prévenir en cas d 'erreur` sous la liste limite les rapports aux
seuls messages en échec.

Une fois l'adresse définie, l'icône `+` est remplacée par le menu à trois points
`Actions des rapports de livraison`, qui propose `Modifier` et `Désactiver`. La désactivation se
confirme dans la fenêtre `Effacer les paramètres`, qui vous avertit que vous perdrez
vos paramètres de rapports de livraison.

## Comment renommer ou supprimer l'application

L'icône d'engrenage dans le coin supérieur droit du détail propose `Renommer` et `Effacer`.

> [!CAUTION]
> La suppression est définitive — le portail vous avertit que l'application sera
> supprimée et ne pourra plus être utilisée. L'adresse du destinataire et les deux
> sujets cessent également de fonctionner.