Pomocou Advanced API môžete posielať správy na kontakty uložené v skupinách BulkGate adresára. Stačí zadať konkrétne identifikátory skupín do parametra `groups`. Tento identifikátor nájdete v detaile skupiny.

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

## Príklad požiadavky:
```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": "Ahoj <first_name>, rád ťa spoznávam. <email>"
}
```

Do textu môžete zadať premenné/zástupné frázy, ktoré sa pred odoslaním správy nahradia konkrétnou hodnotou z adresára.

**Výsledná správa potom vyzerá takto:**
```
Ahoj Tomáš, rád ťa spoznávam. tomas@example.com
```

**Tu je kompletný zoznam premenných:**

| PREMENNÁ               | VÝZNAM                   |
|:-----------------------|:-------------------------|
| `<title_before>`       | Titul pred menom         |
| `<first_name>`         | Meno                     |
| `<last_name>`          | Priezvisko               | 
| `<title_after>`        | Titul za menom           |
| `<first_name_vokativ>` | České oslovenie menom    |
| `<last_name_vokativ>`  | České oslovenie priezviskom |
| `<company_name>`       | Názov spoločnosti        | 
| `<phone_mobile>`       | Číslo mobilného telefónu |
| `<email>`              | E-mailová adresa         |
| `<url>`                | Adresa webovej stránky   |
| `<street1>`            | Ulica 1                  |
| `<street2>`            | Ulica 2                  |
| `<city>`               | Mesto                    |
| `<zip>`                | Poštové smerovacie číslo |
| `<state>`              | Štát/Kraj                |
| `<country>`            | Krajina/Štát             |
| `<company_number>`     | IČO                      |
| `<company_vat>`        | DIČ                      |
| `<custom_field_0>`     | Voliteľné pole           |
| `<custom_field_1>`     | Voliteľné pole           |
| `<custom_field_2>`     | Voliteľné pole           |
| `<custom_field_3>`     | Voliteľné pole           |
| `<custom_field_4>`     | Voliteľné pole           |
| `<custom_field_5>`     | Voliteľné pole           |
| `<custom_field_6>`     | Voliteľné pole           |
| `<custom_field_7>`     | Voliteľné pole           |
| `<custom_field_8>`     | Voliteľné pole           |
| `<custom_field_9>`     | Voliteľné pole           |
| `<custom_field_10>`    | Voliteľné pole           |
| `<custom_field_11>`    | Voliteľné pole           |
| `<custom_field_12>`    | Voliteľné pole           |
| `<custom_field_13>`    | Voliteľné pole           |
| `<custom_field_14>`    | Voliteľné pole           |
| `<custom_field_15>`    | Voliteľné pole           |
| `<custom_field_16>`    | Voliteľné pole           |
| `<custom_field_17>`    | Voliteľné pole           |
| `<custom_field_18>`    | Voliteľné pole           |
| `<custom_field_19>`    | Voliteľné pole           |