O objeto do canal SMS. Coloca-se no objeto `channel`, na chave `sms` - consulte [Cascata](https://www.bulkgate.com/pt/documentacao/advanced-api/advanced-cascata-de-canais/). O SMS é também o canal utilizado quando `channel` é totalmente omitido do pedido.

O objeto é igual para [Advanced transactional](https://www.bulkgate.com/pt/documentacao/advanced-api/advanced-transactional/2.0/) e [Advanced promotional](https://www.bulkgate.com/pt/documentacao/advanced-api/advanced-promotional/2.0/).

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

## Objeto SMS

| NOME DO PARÂMETRO  | VALOR                                                                                                                                                                          | OBRIGATÓRIO | VALOR PREDEFINIDO |
|:----------------|:--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|:---------:|:-------------:|
| text            | Texto da mensagem SMS (máx. 612 caracteres, ou 268 caracteres se for utilizado Unicode), codificação UTF-8. Substitui o `text` de nível superior, consulte [Que texto é utilizado](https://www.bulkgate.com/pt/documentacao/advanced-api/advanced-cascata-de-canais/) |    Não     |    `null`     |
| sender_id       | Tipo de remetente, consulte [Tipo de remetente](#tipo-de-remetente-sender-id)                                                                                                                |    Não     |   `gSystem`   |
| sender_id_value | Valor correspondente a `sender_id` - `gOwn` (p. ex. "420 777 777 777"), `gText` (p. ex. "BulkGate"), `gProfile` (p. ex. "423"), `gMobile` ou `gPush` [(CHAVE)](https://www.bulkgate.com/pt/centro-de-ajuda/mobile-connect/instalacao-do-mobile-connect/) |    Não     |    `null`     |
| unicode         | `yes`/`true`/`1`/`on` para SMS Unicode, `no`/`false`/`0`/`off` para SMS de 7 bits                                                                                                     |    Não     |    `false`    |

Pode adicionar variáveis do array `variables` a `text` da mesma forma que ao texto de nível superior: `Olá <first_name> <last_name>`.

### Tipo de remetente `sender_id`

| VALOR      | DESCRIÇÃO                                                          |
|:-----------|:---------------------------------------------------------------------|
| `gSystem`  | Número do sistema                                                        |
| `gShort`   | Short Code                                                           |
| `gText`    | Remetente de texto                                                          |
| `gMobile`  | [Mobile Connect](https://www.bulkgate.com/pt/centro-de-ajuda/mobile-connect/instalacao-do-mobile-connect/)                |
| `gPush`    | Mobile Connect push - Envia uma notificação para a aplicação Mobile Connect |
| `gOwn`     | Número próprio (requer verificação do número)                            |
| `gProfile` | [ID de perfil BulkGate](https://www.bulkgate.com/pt/centro-de-ajuda/sms/perfil-de-remetente/)                |
| `<int>`    | ID de perfil BulkGate                                                  |

Indicar um número inteiro como `sender_id` é um atalho para o perfil: `"sender_id": 423` é interpretado como `"sender_id": "gProfile"` com `"sender_id_value": "423"`.

> [!NOTE]
> O parâmetro `flash` continua a ser aceite por motivos de retrocompatibilidade, mas não tem qualquer efeito na mensagem.

## Artigos relacionados do centro de ajuda

- [Tipo de remetente](https://www.bulkgate.com/pt/centro-de-ajuda/sms/tipos-de-remetente-sms/) — número do sistema, short code, remetente de texto, número próprio
- [Unicode](https://www.bulkgate.com/pt/centro-de-ajuda/sms/unicode/) — diacríticos e caracteres especiais, e porque reduzem uma mensagem para 268 caracteres
- [Concatenação de mensagens](https://www.bulkgate.com/pt/centro-de-ajuda/sms/concatenacao-de-mensagens/) — como um SMS longo é dividido em partes e quantos caracteres cabem em cada uma

## Exemplo de pedido completo

Mensagem para dois números, enviada a partir de um remetente de texto e codificada como Unicode. `<first_name>` é substituído a partir do array `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
		}
	}
}
```

Mensagem para dois grupos da agenda de contactos, enviada a partir de um [ID de perfil](https://www.bulkgate.com/pt/centro-de-ajuda/sms/perfil-de-remetente/). `same_number` impede uma segunda mensagem para um número que já consta da campanha.

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

A resposta é igual para todos os canais - consulte [Advanced transactional](https://www.bulkgate.com/pt/documentacao/advanced-api/advanced-transactional/2.0/) ou [Advanced promotional](https://www.bulkgate.com/pt/documentacao/advanced-api/advanced-promotional/2.0/).