Objekt SMS kanálu. Vkládá se do objektu `channel` pod klíč `sms` - viz [Kaskáda](https://www.bulkgate.com/cs/dokumentace/advanced-api/advanced-kaskada/). SMS je zároveň kanál, který se použije, když objekt `channel` v requestu neuvedete vůbec.

Objekt je stejný pro [Advanced transactional](https://www.bulkgate.com/cs/dokumentace/advanced-api/advanced-transactional/2.0/) i [Advanced promotional](https://www.bulkgate.com/cs/dokumentace/advanced-api/advanced-promotional/2.0/).

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

## SMS objekt

| NÁZEV PARAMETRU | HODNOTA                                                                                                                                                                                | POVINNÝ | VÝCHOZÍ HODNOTA |
|:----------------|:-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|:-------:|:---------------:|
| text            | Text SMS zprávy (max. 612 znaků nebo 268 znaků, jestliže je aktivován Unicode), UTF-8 kódování. Má přednost před textem na nejvyšší úrovni, viz [Který text se použije](https://www.bulkgate.com/cs/dokumentace/advanced-api/advanced-kaskada/) |   Ne    |     `null`      |
| sender_id       | Typ odesílatele, viz [Typ odesílatele](#typ-odesilatele-sender-id)                                                                                                                     |   Ne    |    `gSystem`    |
| sender_id_value | Hodnota patřící k `sender_id` - `gOwn` (např. "420 777 777 777"), `gText` (např. "BulkGate"), `gProfile` (např. "423"), `gMobile` nebo `gPush` [(KEY)](https://www.bulkgate.com/cs/centrum-napovedy/mobile-connect/instalace-aplikace-mobile-connect/) |   Ne    |     `null`      |
| unicode         | `yes`/`true`/`1`/`on` pro Unicode SMS, `no`/`false`/`0`/`off` pro 7bit SMS                                                                                                             |   Ne    |     `false`     |

Do `text` můžete vkládat proměnné z pole `variables` stejně jako do textu na nejvyšší úrovni: `Dobrý den <first_name> <last_name>`.

### Typ odesílatele `sender_id`

| HODNOTA    | VÝZNAM                                                             |
|:-----------|:---------------------------------------------------------------------|
| `gSystem`  | Systémové číslo                                                      |
| `gShort`   | Short Code                                                           |
| `gText`    | Textový odesílatel                                                   |
| `gMobile`  | [Mobile Connect](https://www.bulkgate.com/cs/centrum-napovedy/mobile-connect/instalace-aplikace-mobile-connect/)                |
| `gPush`    | Mobile Connect push - odešle notifikaci do aplikace Mobile Connect   |
| `gOwn`     | Vlastní číslo (vyžaduje ověření čísla)                               |
| `gProfile` | [BulkGate Profile ID](https://www.bulkgate.com/cs/centrum-napovedy/sms/profil-odesilatele/)                |
| `<int>`    | BulkGate Profile ID                                                  |

Zadání celého čísla jako `sender_id` je zkratka pro profil: `"sender_id": 423` se čte jako `"sender_id": "gProfile"` s `"sender_id_value": "423"`.

> [!NOTE]
> Parametr `flash` se kvůli zpětné kompatibilitě stále přijímá, ale na zprávu nemá žádný vliv.

## Související články v Nápovědě

- [Typ odesílatele](https://www.bulkgate.com/cs/centrum-napovedy/sms/typ-odesilatele/) — systémové číslo, short code, textový odesílatel, vlastní číslo
- [Unicode](https://www.bulkgate.com/cs/centrum-napovedy/sms/unicode/) — diakritika a speciální znaky, a proč zkracují zprávu na 268 znaků
- [Zřetězení zpráv](https://www.bulkgate.com/cs/centrum-napovedy/sms/zretezeni-zprav/) — jak se dlouhá SMS dělí na části a kolik znaků se vejde do jedné

## Příklad kompletního requestu

Zpráva na dvě čísla, odeslaná z textového odesílatele a zakódovaná jako Unicode. `<first_name>` se nahradí z pole `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
		}
	}
}
```

Zpráva do dvou skupin z adresáře, odeslaná z [Profile ID](https://www.bulkgate.com/cs/centrum-napovedy/sms/profil-odesilatele/). `same_number` zabrání druhé zprávě na číslo, které už v kampani je.

```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"
		}
	}
}
```

Odpověď je pro všechny kanály stejná - viz [Advanced transactional](https://www.bulkgate.com/cs/dokumentace/advanced-api/advanced-transactional/2.0/) nebo [Advanced promotional](https://www.bulkgate.com/cs/dokumentace/advanced-api/advanced-promotional/2.0/).