## Qué son las credenciales de Email to SMS

`Email > SMS` no envía los mensajes a través de una API HTTP, sino por correo
electrónico. Por eso, en lugar de un Application ID y un token necesita dos
valores que el portal genera al crear la aplicación:

| Valor | Para qué sirve |
|:--|:--|
| `Recipiente` | La dirección a la que envía el correo electrónico. El número del destinatario va delante de la arroba |
| `Tema` | Identifica su aplicación y fija cuántos SMS puede ocupar el mensaje |

El asunto funciona también como credencial: cualquiera que lo conozca puede
enviar mensajes con su cuenta. Trátelo igual que un [token de API](https://www.bulkgate.com/es/documentacion/administracion-de-la-api/tokens-de-api/).

## Cómo crear la aplicación

1. En el menú del portal, haga clic en `Módulos y APIs`
2. En `Descubre nuestras APIs y módulos`, haga clic en el mosaico `Email > SMS`
3. Seleccione la `Billetera` desde la que se facturarán los mensajes y rellene el `Nombre`
4. Haga clic en `Crear API`

![Ventana para crear una aplicación Email > SMS](docs:email-to-sms-credentials/create-form_en)

Si no se ha seleccionado un monedero, el botón `Crear API` permanece desactivado.
Una vez creada, el portal le lleva directamente al detalle de la aplicación.

> [!IMPORTANT]
> Una aplicación nueva está desactivada: el interruptor `Habilitado` de la parte `Estado`,
> a la derecha, está apagado. Hasta que lo active, ningún correo electrónico se convierte en SMS.

## Dónde encontrar las credenciales

1. En el menú, haga clic en `Módulos y APIs`
2. En `Mis APIs y módulos`, haga clic en la tarjeta de su aplicación `Email > SMS`

La parte `Ajustes del correo electrónico` contiene tres filas. Al hacer clic en
un valor, este se copia al portapapeles.

![Parte Ajustes del correo electrónico con el destinatario y ambos asuntos](docs:email-to-sms-credentials/email-settings_en)

| Fila | Valor |
|:--|:--|
| `Recipiente` | `destinatario_number@email2sms.bulkgate.com` |
| `Asunto SMS corto` | `{monedero};{clave};1` |
| `Asunto SMS largo` | `{monedero};{clave};10` |

Encima de ellas figura `Wallet` con el identificador del monedero desde el que se
facturan los mensajes.

## Cómo se envía un mensaje

En el campo del destinatario del correo electrónico, sustituya `destinatario_number`
por el número de teléfono en formato internacional, sin el signo más ni espacios,
por ejemplo `420777123456`. La dirección resultante tiene este aspecto:

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

En el asunto del correo electrónico ponga uno de los valores preparados; el cuerpo
del correo electrónico es el propio mensaje.

El último número del asunto indica cuántos SMS puede ocupar el mensaje como máximo:
`1` para uno corto, `10` para uno largo. Un texto más largo se divide en varios
SMS consecutivos y se facturan todos.

> [!TIP]
> Si desea un límite distinto de 1 o 10, puede cambiar usted mismo el último número
> del asunto; deje el resto del asunto tal como está.

## Cómo recibir los informes de entrega

La parte `Informes de entrega de correo electrónico` empieza como `Inactivo`. El
icono `+` abre la ventana `Configuración de informes de entrega`, donde introduce
una dirección en el campo `Informes de entrega de correo electrónico` y confirma
con `Conjunto`.

La casilla `Informe solo cuando se produce un error`, debajo de la lista, limita
los informes únicamente a los mensajes fallidos.

Una vez configurada una dirección, el icono `+` se convierte en el menú de tres
puntos `Informes de entrega de acciones.`, que ofrece `Editar` y `Desactivar`. La
desactivación se confirma en la ventana `Eliminar configuraciones`, que advierte
de que perderá la configuración de sus informes de entrega.

## Cómo cambiar el nombre de la aplicación o eliminarla

El icono del engranaje en la esquina superior derecha del detalle ofrece
`Rebautizar` y `Borrar`.

> [!CAUTION]
> La eliminación es definitiva: el portal advierte de que la aplicación se
> eliminará y ya no se podrá utilizar. La dirección del destinatario y ambos
> asuntos también dejan de funcionar.