El objeto del canal SMS. Se incluye en el objeto `channel` bajo la clave `sms`; consulte [Cascada](https://www.bulkgate.com/es/documentacion/advanced-api/advanced-cascada-de-canales/). El SMS también es el canal que se utiliza cuando `channel` se omite por completo en la solicitud.

El objeto es el mismo para [Advanced transactional](https://www.bulkgate.com/es/documentacion/advanced-api/advanced-transactional/2.0/) y [Advanced promotional](https://www.bulkgate.com/es/documentacion/advanced-api/advanced-promotional/2.0/).

```json
{
	"sms": {
		"sender_id": "gText",
		"sender_id_value": "BulkGate"
	}
}
```

## Objeto SMS

| NOMBRE DEL PARÁMETRO | VALOR | OBLIGATORIO | VALOR PREDETERMINADO |
|:----------------|:--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|:---------:|:-------------:|
| text            | Texto del mensaje SMS (máx. 612 caracteres, o 268 caracteres si se utiliza Unicode), codificación UTF-8. Sustituye al `text` de nivel superior, consulte [Qué texto se utiliza](https://www.bulkgate.com/es/documentacion/advanced-api/advanced-cascada-de-canales/) |    No     |    `null`     |
| sender_id       | Tipo de ID de remitente, consulte [Tipo de ID de remitente](#tipo-de-id-de-remitente-sender-id) |    No     |   `gSystem`   |
| sender_id_value | Valor correspondiente a `sender_id`: `gOwn` (p. ej. "420 777 777 777"), `gText` (p. ej. "BulkGate"), `gProfile` (p. ej. "423"), `gMobile` o `gPush` [(KEY)](https://www.bulkgate.com/es/centro-de-ayuda/mobile-connect/instalacion-de-mobile-connect/) |    No     |    `null`     |
| unicode         | `yes`/`true`/`1`/`on` para SMS Unicode, `no`/`false`/`0`/`off` para SMS de 7 bits |    No     |    `false`    |

Puede añadir a `text` variables del array `variables` del mismo modo que al texto de nivel superior: `Hola <first_name> <last_name>`.

### Tipo de ID de remitente `sender_id`

| VALOR      | DESCRIPCIÓN                                                          |
|:-----------|:---------------------------------------------------------------------|
| `gSystem`  | Número del sistema                                                   |
| `gShort`   | Short Code                                                           |
| `gText`    | Remitente de texto                                                   |
| `gMobile`  | [Mobile Connect](https://www.bulkgate.com/es/centro-de-ayuda/mobile-connect/instalacion-de-mobile-connect/)                |
| `gPush`    | Mobile Connect push: envía una notificación a la aplicación Mobile Connect |
| `gOwn`     | Número propio (requiere la verificación del número)                  |
| `gProfile` | [ID de perfil de BulkGate](https://www.bulkgate.com/es/centro-de-ayuda/sms/perfil-de-remitente/)                |
| `<int>`    | ID de perfil de BulkGate                                             |

Indicar un número entero como `sender_id` es un atajo para el perfil: `"sender_id": 423` se interpreta como `"sender_id": "gProfile"` con `"sender_id_value": "423"`.

> [!NOTE]
> El parámetro `flash` se sigue aceptando por compatibilidad con versiones anteriores, pero no tiene ningún efecto sobre el mensaje.

## Artículos relacionados del centro de ayuda

- [Tipo de remitente](https://www.bulkgate.com/es/centro-de-ayuda/sms/tipos-de-remitente-de-sms/): número del sistema, short code, remitente de texto, número propio
- [Unicode](https://www.bulkgate.com/es/centro-de-ayuda/sms/unicode/): signos diacríticos y caracteres especiales, y por qué reducen el mensaje a 268 caracteres
- [Concatenación de mensajes](https://www.bulkgate.com/es/centro-de-ayuda/sms/concatenacion-de-mensajes/): cómo se divide un SMS largo en partes y cuántos caracteres caben en una

## Ejemplo de solicitud completa

Mensaje a dos números, enviado desde un remitente de texto y codificado como Unicode. `<first_name>` se sustituye por el valor del array `variables`.

```http-json
POST /api/2.0/advanced/transactional HTTP/1.1
Host: portal.bulkgate.com
Content-Type: application/json

{
	"application_id": 451,
	"application_token": "NKN02TWE6NfBkfl-your-secret-token-Wf05GaqLIWLW4aBj",
	"number": ["420777777777", "420777777778"],
	"text": "Hello <first_name>, your order has been shipped.",
	"variables": {"first_name": "John"},
	"country": "cz",
	"channel": {
		"sms": {
			"sender_id": "gText",
			"sender_id_value": "BulkGate",
			"unicode": true
		}
	}
}
```

Mensaje a dos grupos de la agenda de contactos, enviado desde un [ID de perfil](https://www.bulkgate.com/es/centro-de-ayuda/sms/perfil-de-remitente/). `same_number` evita que se envíe un segundo mensaje a un número que ya está en la campaña.

```http-json
POST /api/2.0/advanced/promotional HTTP/1.1
Host: portal.bulkgate.com
Content-Type: application/json

{
	"application_id": 451,
	"application_token": "NKN02TWE6NfBkfl-your-secret-token-Wf05GaqLIWLW4aBj",
	"groups": [974, 975],
	"text": "Hello <first_name>, our spring sale starts today.",
	"duplicates_check": "same_number",
	"channel": {
		"sms": {
			"sender_id": "gProfile",
			"sender_id_value": "423"
		}
	}
}
```

La respuesta es la misma para todos los canales: consulte [Advanced transactional](https://www.bulkgate.com/es/documentacion/advanced-api/advanced-transactional/2.0/) o [Advanced promotional](https://www.bulkgate.com/es/documentacion/advanced-api/advanced-promotional/2.0/).