Através da Advanced API, pode enviar mensagens para contactos guardados em grupos da agenda de contactos do BulkGate. Basta indicar os identificadores dos grupos pretendidos no parâmetro `groups`. Encontra este identificador no detalhe do grupo.

![ID do grupo](docs:advanced-promotional-groups/group_id)

## Exemplo do pedido:
```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": "Olá <first_name>, é um prazer conhecê-lo. <email>"
}
```

É possível acrescentar variáveis que, antes do envio da mensagem, são substituídas por um valor concreto da agenda.

**A mensagem final tem então este aspeto:**
```
Olá Tomás, é um prazer conhecê-lo. tomas@example.com
```

**Esta é a lista completa de variáveis:**

| VARIÁVEL               | SIGNIFICADO                               |
|:-----------------------|:--------------------------------------|
| `<title_before>`       | Título antes do nome |
| `<first_name>`         | Nome próprio |
| `<last_name>`          | Apelido | 
| `<title_after>`        | Título depois do nome |
| `<first_name_vokativ>` | Vocativo do nome próprio para a língua checa |
| `<last_name_vokativ>`  | Vocativo do apelido para a língua checa |
| `<company_name>`       | Nome da empresa | 
| `<phone_mobile>`       | Número de telemóvel |
| `<email>`              | Endereço de e-mail |
| `<url>`                | Endereço do website |
| `<street1>`            | Rua 1 |
| `<street2>`            | Rua 2 |
| `<city>`               | Cidade |
| `<zip>`                | Código postal |
| `<state>`              | Região |
| `<country>`            | País |
| `<company_number>`     | Número de registo da empresa |
| `<company_vat>`        | NIF/IVA |
| `<custom_field_0>`     | Campo personalizado |
| `<custom_field_1>`     | Campo personalizado |
| `<custom_field_2>`     | Campo personalizado |
| `<custom_field_3>`     | Campo personalizado |
| `<custom_field_4>`     | Campo personalizado |
| `<custom_field_5>`     | Campo personalizado |
| `<custom_field_6>`     | Campo personalizado |
| `<custom_field_7>`     | Campo personalizado |
| `<custom_field_8>`     | Campo personalizado |
| `<custom_field_9>`     | Campo personalizado |
| `<custom_field_10>`    | Campo personalizado |
| `<custom_field_11>`    | Campo personalizado |
| `<custom_field_12>`    | Campo personalizado |
| `<custom_field_13>`    | Campo personalizado |
| `<custom_field_14>`    | Campo personalizado |
| `<custom_field_15>`    | Campo personalizado |
| `<custom_field_16>`    | Campo personalizado |
| `<custom_field_17>`    | Campo personalizado |
| `<custom_field_18>`    | Campo personalizado |
| `<custom_field_19>`    | Campo personalizado |