Objekt SMS kanála. Vkladá sa do objektu `channel` pod kľúč `sms` - pozrite [Kaskáda](https://www.bulkgate.com/sk/dokumentacia/advanced-api/advanced-kaskada/). SMS je zároveň kanál, ktorý sa použije, keď objekt `channel` v requeste vôbec neuvediete.

Objekt je rovnaký pre [Advanced transactional](https://www.bulkgate.com/sk/dokumentacia/advanced-api/advanced-transactional/2.0/) aj [Advanced promotional](https://www.bulkgate.com/sk/dokumentacia/advanced-api/advanced-promotional/2.0/).

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

## SMS objekt

| NÁZOV PARAMETRA | HODNOTA                                                                                                                                                                                | POVINNÝ | PREDVOLENÁ HODNOTA |
|:----------------|:-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|:-------:|:------------------:|
| text            | Text SMS správy (max. 612 znakov alebo 268 znakov, ak je aktivovaný Unicode), kódovanie UTF-8. Má prednosť pred textom na najvyššej úrovni, pozrite [Ktorý text sa použije](https://www.bulkgate.com/sk/dokumentacia/advanced-api/advanced-kaskada/) |   Nie   |     `null`      |
| sender_id       | Typ odosielateľa, pozrite [Typ odosielateľa](#typ-odosielatela-sender-id)                                                                                                              |   Nie   |    `gSystem`    |
| sender_id_value | Hodnota patriaca k `sender_id` - `gOwn` (napr. "420 777 777 777"), `gText` (napr. "BulkGate"), `gProfile` (napr. "423"), `gMobile` alebo `gPush` [(KEY)](https://www.bulkgate.com/sk/centrum-pomoci/mobile-connect/instalacia-aplikacie-mobile-connect/) |   Nie   |     `null`      |
| unicode         | `yes`/`true`/`1`/`on` pre Unicode SMS, `no`/`false`/`0`/`off` pre 7bit SMS                                                                                                             |   Nie   |     `false`     |

Do `text` môžete vkladať premenné z poľa `variables` rovnako ako do textu na najvyššej úrovni: `Dobrý deň <first_name> <last_name>`.

### Typ odosielateľa `sender_id`

| HODNOTA    | VÝZNAM                                                               |
|:-----------|:---------------------------------------------------------------------|
| `gSystem`  | Systémové číslo                                                      |
| `gShort`   | Short Code                                                           |
| `gText`    | Textový odosielateľ                                                  |
| `gMobile`  | [Mobile Connect](https://www.bulkgate.com/sk/centrum-pomoci/mobile-connect/instalacia-aplikacie-mobile-connect/)                |
| `gPush`    | Mobile Connect push - odošle notifikáciu do aplikácie Mobile Connect |
| `gOwn`     | Vlastné číslo (vyžaduje overenie čísla)                              |
| `gProfile` | [BulkGate Profile ID](https://www.bulkgate.com/sk/centrum-pomoci/sms/profil-odosielatela/)                |
| `<int>`    | BulkGate Profile ID                                                  |

Zadanie celého čísla ako `sender_id` je skratka pre profil: `"sender_id": 423` sa číta ako `"sender_id": "gProfile"` so `"sender_id_value": "423"`.

> [!NOTE]
> Parameter `flash` sa kvôli spätnej kompatibilite stále prijíma, ale na správu nemá žiadny vplyv.

## Súvisiace články v Nápovede

- [Typ odosielateľa](https://www.bulkgate.com/sk/centrum-pomoci/sms/typ-odosielatela/) — systémové číslo, short code, textový odosielateľ, vlastné číslo
- [Unicode](https://www.bulkgate.com/sk/centrum-pomoci/sms/unicode/) — diakritika a špeciálne znaky, a prečo skracujú správu na 268 znakov
- [Zreťazenie správ](https://www.bulkgate.com/sk/centrum-pomoci/sms/zretazenie-sprav/) — ako sa dlhá SMS delí na časti a koľko znakov sa zmestí do jednej

## Príklad kompletného requestu

Správa na dve čísla, odoslaná z textového odosielateľa a zakódovaná ako Unicode. `<first_name>` sa nahradí z poľa `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
		}
	}
}
```

Správa do dvoch skupín z adresára, odoslaná z [Profile ID](https://www.bulkgate.com/sk/centrum-pomoci/sms/profil-odosielatela/). `same_number` zabráni druhej správe na číslo, ktoré 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"
		}
	}
}
```

Odpoveď je pre všetky kanály rovnaká - pozrite [Advanced transactional](https://www.bulkgate.com/sk/dokumentacia/advanced-api/advanced-transactional/2.0/) alebo [Advanced promotional](https://www.bulkgate.com/sk/dokumentacia/advanced-api/advanced-promotional/2.0/).