Das Objekt des SMS-Kanals. Es gehört in das Objekt `channel` unter den Schlüssel `sms` - siehe [Kanalkaskade](https://www.bulkgate.com/de/dokumentation/advanced-api/advanced-kaskade/). SMS ist auch der Kanal, der verwendet wird, wenn `channel` in der Anfrage ganz fehlt.

Das Objekt ist für [Advanced – transaktionale Nachrichten](https://www.bulkgate.com/de/dokumentation/advanced-api/advanced-transactional/2.0/) und [Advanced – Werbenachrichten](https://www.bulkgate.com/de/dokumentation/advanced-api/advanced-promotional/2.0/) gleich.

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

## SMS-Objekt

| PARAMETERNAME   | WERT                                                                                                                                                                           | PFLICHT   | STANDARDWERT  |
|:----------------|:--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|:---------:|:-------------:|
| text            | Text der SMS-Nachricht (max. 612 Zeichen bzw. 268 Zeichen bei Verwendung von Unicode), Kodierung UTF-8. Überschreibt den `text` der obersten Ebene, siehe [Welcher Text verwendet wird](https://www.bulkgate.com/de/dokumentation/advanced-api/advanced-kaskade/) |    Nein   |    `null`     |
| sender_id       | Absendertyp, siehe [Absendertyp](#absendertyp-sender-id)                                                                                                                       |    Nein   |   `gSystem`   |
| sender_id_value | Wert zu `sender_id` - `gOwn` (z. B. "420 777 777 777"), `gText` (z. B. "BulkGate"), `gProfile` (z. B. "423"), `gMobile` oder `gPush` [(KEY)](https://www.bulkgate.com/de/hilfe-center/mobile-connect/mobile-connect-installation/) |    Nein   |    `null`     |
| unicode         | `yes`/`true`/`1`/`on` für Unicode-SMS, `no`/`false`/`0`/`off` für 7-Bit-SMS                                                                                                    |    Nein   |    `false`    |

Variablen aus dem Array `variables` können Sie in `text` genauso einfügen wie in den Text der obersten Ebene: `Guten Tag <first_name> <last_name>`.

### Absendertyp `sender_id`

| WERT       | BESCHREIBUNG                                                         |
|:-----------|:---------------------------------------------------------------------|
| `gSystem`  | Systemnummer                                                         |
| `gShort`   | Short Code                                                           |
| `gText`    | Textabsender                                                         |
| `gMobile`  | [Mobile Connect](https://www.bulkgate.com/de/hilfe-center/mobile-connect/mobile-connect-installation/)                |
| `gPush`    | Mobile Connect Push - sendet eine Benachrichtigung an die App Mobile Connect |
| `gOwn`     | Eigene Nummer (erfordert eine Verifizierung der Nummer)              |
| `gProfile` | [BulkGate Profile ID](https://www.bulkgate.com/de/hilfe-center/sms/absenderprofil/)                |
| `<int>`    | BulkGate Profile ID                                                  |

Die Übergabe einer ganzen Zahl als `sender_id` ist eine Abkürzung für das Profil: `"sender_id": 423` wird als `"sender_id": "gProfile"` mit `"sender_id_value": "423"` gelesen.

> [!NOTE]
> Der Parameter `flash` wird aus Gründen der Abwärtskompatibilität weiterhin akzeptiert, hat aber keine Auswirkung auf die Nachricht.

## Verwandte Artikel der Hilfe

- [Absendertyp](https://www.bulkgate.com/de/hilfe-center/sms/sms-absendertypen/) — Systemnummer, Short Code, Textabsender, eigene Nummer
- [Unicode](https://www.bulkgate.com/de/hilfe-center/sms/unicode/) — Diakritika und Sonderzeichen und warum sie eine Nachricht auf 268 Zeichen kürzen
- [Verkettung von Nachrichten](https://www.bulkgate.com/de/hilfe-center/sms/nachrichtenverkettung/) — wie eine lange SMS in Teile aufgeteilt wird und wie viele Zeichen in einen Teil passen

## Beispiel einer vollständigen Anfrage

Nachricht an zwei Nummern, gesendet von einem Textabsender und als Unicode kodiert. `<first_name>` wird aus dem Array `variables` ersetzt.

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

Nachricht an zwei Gruppen aus dem Adressbuch, gesendet von einer [Profile ID](https://www.bulkgate.com/de/hilfe-center/sms/absenderprofil/). `same_number` verhindert eine zweite Nachricht an eine Nummer, die bereits in der Kampagne enthalten ist.

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

Die Antwort ist für alle Kanäle gleich - siehe [Advanced – transaktionale Nachrichten](https://www.bulkgate.com/de/dokumentation/advanced-api/advanced-transactional/2.0/) bzw. [Advanced – Werbenachrichten](https://www.bulkgate.com/de/dokumentation/advanced-api/advanced-promotional/2.0/).