Via Advanced API kan du sende meldinger til kontakter som er lagret i grupper i BulkGate-adresseboken. Alt du trenger å gjøre, er å angi identifikatorene til de aktuelle gruppene i parameteren `groups`. Denne identifikatoren finner du i detaljene for gruppen.

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

## Eksempel på forespørsel:
```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": "Hei <first_name>, hyggelig å møte deg. <email>"
}
```

Du kan legge til variabler som erstattes med en konkret verdi fra adresseboken før meldingen sendes.

**Den endelige meldingen ser da slik ut:**
```
Hei Ola, hyggelig å møte deg. ola@example.com
```

**Her er den fullstendige listen over variabler:**

| VARIABEL               | BETYDNING |
|:-----------------------|:----------|
| `<title_before>`       | Tittel foran navnet |
| `<first_name>`         | Fornavn |
| `<last_name>`          | Etternavn | 
| `<title_after>`        | Tittel etter navnet |
| `<first_name_vokativ>` | Fornavn i vokativ for tsjekkisk |
| `<last_name_vokativ>`  | Etternavn i vokativ for tsjekkisk |
| `<company_name>`       | Firmanavn | 
| `<phone_mobile>`       | Mobiltelefonnummer |
| `<email>`              | E-postadresse |
| `<url>`                | Nettstedsadresse |
| `<street1>`            | Gate 1 |
| `<street2>`            | Gate 2 |
| `<city>`               | By |
| `<zip>`                | Postnummer |
| `<state>`              | Region |
| `<country>`            | Land |
| `<company_number>`     | Organisasjonsnummer |
| `<company_vat>`        | MVA-nummer |
| `<custom_field_0>`     | Egendefinert felt |
| `<custom_field_1>`     | Egendefinert felt |
| `<custom_field_2>`     | Egendefinert felt |
| `<custom_field_3>`     | Egendefinert felt |
| `<custom_field_4>`     | Egendefinert felt |
| `<custom_field_5>`     | Egendefinert felt |
| `<custom_field_6>`     | Egendefinert felt |
| `<custom_field_7>`     | Egendefinert felt |
| `<custom_field_8>`     | Egendefinert felt |
| `<custom_field_9>`     | Egendefinert felt |
| `<custom_field_10>`    | Egendefinert felt |
| `<custom_field_11>`    | Egendefinert felt |
| `<custom_field_12>`    | Egendefinert felt |
| `<custom_field_13>`    | Egendefinert felt |
| `<custom_field_14>`    | Egendefinert felt |
| `<custom_field_15>`    | Egendefinert felt |
| `<custom_field_16>`    | Egendefinert felt |
| `<custom_field_17>`    | Egendefinert felt |
| `<custom_field_18>`    | Egendefinert felt |
| `<custom_field_19>`    | Egendefinert felt |