Grensesnittet **E-post til SMS** sender en SMS fra en vanlig e-post, uten at du trenger å skrive en eneste kodelinje. Mottakernummeret utgjør adressen, emnefeltet inneholder tilgangsopplysningene og parameterne, og selve e-posten er meldingsteksten.

> [!NOTE]
> Grensesnittet må først aktiveres i portalen. Fremgangsmåten og tilgangsopplysningene er beskrevet under [API-administrasjon](https://www.bulkgate.com/no/dokumentasjon/api-administrasjon/administrasjon-av-api/).

## Mottakeradresse

Adressen e-posten sendes til:

```url
mottakernummer@email2sms.bulkgate.com
```

Mottakernummeret må skrives i **internasjonalt format**, uten null foran og uten `+`-tegn — for eksempel `420777777777`.

## Format på emnefeltet

Emnefeltet inneholder tre obligatoriske og to valgfrie parametere, atskilt med semikolon:

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

De valgfrie parameterne utelates fra høyre — uten dem blir emnet `wallet_id;email2sms_password;smstype`. Meldingsteksten skrives i selve e-posten.

## Parametertabell

| PARAMETERNAVN      | VERDI                                                                                                       | OBLIGATORISK | STANDARDVERDI  |
|:-------------------|:--------------------------------------------------------------------------------------------------------------|:----------|:---------------|
| wallet_id          | Lommebok-ID fra portalen (`Moduler og APIer` > `Email > SMS`)                                               | **Ja**    | -              |
| email2sms_password | Passord fra portalen (`Moduler og APIer` > `Email > SMS`)                                                   | **Ja**    | -              |
| smstype            | `1` — tekst forkortet til 160 tegn, `10` — EMS med tekst på opptil 612 tegn                                 | **Ja**    | -              |
| isms               | SMS-gateway, verdi `0` – `4`. Obligatorisk ved bruk av tekstavsender.                                       | Nei       | `0`            |
| sender             | Avsender av meldingen — et nummer i internasjonalt format (`420777777778`) eller en tekst på opptil 11 tegn (`eshop.com`) | Nei | Systemnummer |

> [!NOTE]
> Verdien for `isms` finner du i prislisten i portalen — den vises når du holder musepekeren over skiftenøkkelikonet for utviklere.

> [!NOTE]
> Unicode-SMS støttes ikke av dette grensesnittet.

## Eksempler

### Eksempel 1 — standard gateway

En SMS på opptil 160 tegn til nummeret `+420777777777` med teksten «Hei, hvordan går det?», sendt via standard gateway (systemnummer).

**Mottakeradresse:** `420777777777@email2sms.bulkgate.com`

**Emne:** `bg180012091617000;OppdiktetPassord;1`

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

**Selve e-posten:** `Hei, hvordan går det?`

### Eksempel 2 — tekstavsender

Den samme SMS-en sendt via gateway `2` med tekstavsenderen `eshop.com`.

**Mottakeradresse:** `420777777777@email2sms.bulkgate.com`

**Emne:** `bg180012091249500;Passord12345;1;2;eshop.com`

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

**Selve e-posten:** `Hei, hvordan går det?`

## Svar

E-poster behandles hvert minutt. Ved feil sender serveren deg en e-post tilbake med feilnummeret.