SMS-kanalobjektet. Det legges i objektet `channel` under nøkkelen `sms` – se [Kaskade](https://www.bulkgate.com/no/dokumentasjon/advanced-api/advanced-kaskade/). SMS er også kanalen som brukes når `channel` er helt utelatt fra forespørselen.

Objektet er det samme for [Advanced transactional](https://www.bulkgate.com/no/dokumentasjon/advanced-api/advanced-transactional/2.0/) og [Advanced promotional](https://www.bulkgate.com/no/dokumentasjon/advanced-api/advanced-promotional/2.0/).

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

## SMS-objekt

| PARAMETERNAVN   | VERDI | OBLIGATORISK | STANDARDVERDI |
|:----------------|:------|:---------:|:-------------:|
| text            | Teksten i SMS-meldingen (maks. 612 tegn, eller 268 tegn hvis Unicode brukes), UTF-8-koding. Overstyrer `text` på toppnivå, se [Hvilken tekst som brukes](https://www.bulkgate.com/no/dokumentasjon/advanced-api/advanced-kaskade/) | Nei | `null` |
| sender_id       | Avsendertype, se [Avsendertype](#avsendertype-sender-id) | Nei | `gSystem` |
| sender_id_value | Verdi som hører til `sender_id` – `gOwn` (f.eks. «420 777 777 777»), `gText` (f.eks. «BulkGate»), `gProfile` (f.eks. «423»), `gMobile` eller `gPush` [(NØKKEL)](https://www.bulkgate.com/no/hjelpesenter/mobile-connect/mobile-connect-installasjon/) | Nei | `null` |
| unicode         | `yes`/`true`/`1`/`on` for Unicode-SMS, `no`/`false`/`0`/`off` for 7-bits SMS | Nei | `false` |

Du kan legge variabler fra matrisen `variables` inn i `text` på samme måte som i teksten på toppnivå: `Hei <first_name> <last_name>`.

### Avsendertype `sender_id`

| VERDI      | BESKRIVELSE                                                          |
|:-----------|:---------------------------------------------------------------------|
| `gSystem`  | Systemnummer                                                         |
| `gShort`   | Kortnummer (Short Code)                                              |
| `gText`    | Tekstavsender                                                        |
| `gMobile`  | [Mobile Connect](https://www.bulkgate.com/no/hjelpesenter/mobile-connect/mobile-connect-installasjon/)                |
| `gPush`    | Mobile Connect push – sender et varsel til Mobile Connect-appen      |
| `gOwn`     | Eget nummer (krever bekreftelse av nummeret)                         |
| `gProfile` | [BulkGate-profil-ID](https://www.bulkgate.com/no/hjelpesenter/sms/avsenderprofil/)                 |
| `<int>`    | BulkGate-profil-ID                                                   |

Et heltall som `sender_id` er en snarvei for profilen: `"sender_id": 423` leses som `"sender_id": "gProfile"` med `"sender_id_value": "423"`.

> [!NOTE]
> Parameteren `flash` godtas fortsatt av hensyn til bakoverkompatibilitet, men den har ingen effekt på meldingen.

## Relaterte artikler i hjelpesenteret

- [Avsendertype](https://www.bulkgate.com/no/hjelpesenter/sms/sms-avsendertyper/) — systemnummer, kortnummer, tekstavsender, eget nummer
- [Unicode](https://www.bulkgate.com/no/hjelpesenter/sms/unicode/) — diakritiske tegn og spesialtegn, og hvorfor de korter ned meldingen til 268 tegn
- [Sammenslåing av meldinger](https://www.bulkgate.com/no/hjelpesenter/sms/sammenkjedede-meldinger/) — hvordan en lang SMS deles opp i deler, og hvor mange tegn som får plass i én

## Eksempel på fullstendig forespørsel

Melding til to numre, sendt fra en tekstavsender og kodet som Unicode. `<first_name>` erstattes med verdien fra matrisen `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
		}
	}
}
```

Melding til to grupper fra adresseboken, sendt fra en [profil-ID](https://www.bulkgate.com/no/hjelpesenter/sms/avsenderprofil/). `same_number` hindrer at det sendes en melding til et nummer som allerede er med i kampanjen.

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

Svaret er det samme for alle kanaler – se [Advanced transactional](https://www.bulkgate.com/no/dokumentasjon/advanced-api/advanced-transactional/2.0/) eller [Advanced promotional](https://www.bulkgate.com/no/dokumentasjon/advanced-api/advanced-promotional/2.0/).