L'objet du canal SMS. Il se place dans l'objet `channel` sous la clé `sms` - voir [Cascade](https://www.bulkgate.com/fr/documentation/advanced-api/advanced-cascade/). Le SMS est également le canal utilisé lorsque `channel` est entièrement omis de la requête.

L'objet est le même pour [Advanced transactional](https://www.bulkgate.com/fr/documentation/advanced-api/advanced-transactional/2.0/) et [Advanced promotional](https://www.bulkgate.com/fr/documentation/advanced-api/advanced-promotional/2.0/).

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

## Objet SMS

| NOM DU PARAMÈTRE | VALEUR | OBLIGATOIRE | VALEUR PAR DÉFAUT |
|:----------------|:-------|:---------:|:-------------:|
| text            | Texte du message SMS (max. 612 caractères, ou 268 caractères si Unicode est utilisé), encodage UTF-8. Remplace le `text` de premier niveau, voir [Quel texte est utilisé](https://www.bulkgate.com/fr/documentation/advanced-api/advanced-cascade/) | Non | `null` |
| sender_id       | Type d'expéditeur, voir [Type d'expéditeur](#type-d-expediteur-sender-id) | Non | `gSystem` |
| sender_id_value | Valeur associée à `sender_id` - `gOwn` (par ex. « 420 777 777 777 »), `gText` (par ex. « BulkGate »), `gProfile` (par ex. « 423 »), `gMobile` ou `gPush` [(KEY)](https://www.bulkgate.com/fr/centre-d-aide/mobile-connect/installation-mobile-connect/) | Non | `null` |
| unicode         | `yes`/`true`/`1`/`on` pour un SMS Unicode, `no`/`false`/`0`/`off` pour un SMS 7 bits | Non | `false` |

Vous pouvez ajouter des variables du tableau `variables` dans `text` de la même manière que dans le texte de premier niveau : `Hello <first_name> <last_name>`.

### Type d'expéditeur `sender_id`

| VALEUR     | DESCRIPTION                                                          |
|:-----------|:---------------------------------------------------------------------|
| `gSystem`  | Numéro système                                                       |
| `gShort`   | Code court (Short Code)                                              |
| `gText`    | Expéditeur texte                                                     |
| `gMobile`  | [Mobile Connect](https://www.bulkgate.com/fr/centre-d-aide/mobile-connect/installation-mobile-connect/)                |
| `gPush`    | Mobile Connect push - envoie une notification dans l'application Mobile Connect |
| `gOwn`     | Numéro propre (nécessite la vérification du numéro)                  |
| `gProfile` | [ID de profil BulkGate](https://www.bulkgate.com/fr/centre-d-aide/sms/profil-d-expediteur/)              |
| `<int>`    | ID de profil BulkGate                                                |

Indiquer un nombre entier comme `sender_id` est un raccourci pour le profil : `"sender_id": 423` est interprété comme `"sender_id": "gProfile"` avec `"sender_id_value": "423"`.

> [!NOTE]
> Le paramètre `flash` est toujours accepté pour des raisons de rétrocompatibilité, mais il n'a aucun effet sur le message.

## Articles associés du centre d'aide

- [Type d'expéditeur](https://www.bulkgate.com/fr/centre-d-aide/sms/type-d-expediteur/) — numéro système, code court, expéditeur texte, numéro propre
- [Unicode](https://www.bulkgate.com/fr/centre-d-aide/sms/unicode/) — diacritiques et caractères spéciaux, et pourquoi ils limitent un message à 268 caractères
- [Concaténation des messages](https://www.bulkgate.com/fr/centre-d-aide/sms/concatenation-des-messages/) — comment un SMS long est découpé en parties et combien de caractères tiennent dans une seule

## Exemple de requête complète

Message à deux numéros, envoyé depuis un expéditeur texte et encodé en Unicode. `<first_name>` est remplacé à partir du tableau `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
		}
	}
}
```

Message à deux groupes du carnet d'adresses, envoyé depuis un [ID de profil](https://www.bulkgate.com/fr/centre-d-aide/sms/profil-d-expediteur/). `same_number` empêche l'envoi d'un second message à un numéro qui figure déjà dans la campagne.

```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 réponse est la même pour tous les canaux - voir [Advanced transactional](https://www.bulkgate.com/fr/documentation/advanced-api/advanced-transactional/2.0/) ou [Advanced promotional](https://www.bulkgate.com/fr/documentation/advanced-api/advanced-promotional/2.0/).