Über die Advanced API können Sie Nachrichten an Kontakte senden, die in Gruppen im BulkGate-Adressbuch gespeichert sind. Sie müssen lediglich die Kennungen der gewünschten Gruppen in den Parameter `groups` eintragen. Diese Kennung finden Sie im Detail der Gruppe.

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

## Beispielanfrage:
```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": "Hallo <first_name>, schön, Sie kennenzulernen. <email>"
}
```

Sie können Variablen einfügen, die vor dem Versand der Nachricht durch einen konkreten Wert aus dem Adressbuch ersetzt werden.

**Die fertige Nachricht sieht dann so aus:**
```
Hallo Thomas, schön, Sie kennenzulernen. thomas@example.com
```

**Hier ist die vollständige Liste der Variablen:**

| VARIABLE               | BEDEUTUNG                             |
|:-----------------------|:--------------------------------------|
| `<title_before>`       | Titel vor dem Namen                   |
| `<first_name>`         | Vorname                               |
| `<last_name>`          | Nachname                              | 
| `<title_after>`        | Titel nach dem Namen                  |
| `<first_name_vokativ>` | Vorname im Vokativ (tschechische Anrede) |
| `<last_name_vokativ>`  | Nachname im Vokativ (tschechische Anrede) |
| `<company_name>`       | Firmenname                            | 
| `<phone_mobile>`       | Mobiltelefonnummer                    |
| `<email>`              | E-Mail-Adresse                        |
| `<url>`                | Adresse der Website                   |
| `<street1>`            | Straße 1                              |
| `<street2>`            | Straße 2                              |
| `<city>`               | Stadt                                 |
| `<zip>`                | Postleitzahl                          |
| `<state>`              | Region                                |
| `<country>`            | Land                                  |
| `<company_number>`     | Handelsregisternummer                 |
| `<company_vat>`        | USt-IdNr.                             |
| `<custom_field_0>`     | Benutzerdefiniertes Feld              |
| `<custom_field_1>`     | Benutzerdefiniertes Feld              |
| `<custom_field_2>`     | Benutzerdefiniertes Feld              |
| `<custom_field_3>`     | Benutzerdefiniertes Feld              |
| `<custom_field_4>`     | Benutzerdefiniertes Feld              |
| `<custom_field_5>`     | Benutzerdefiniertes Feld              |
| `<custom_field_6>`     | Benutzerdefiniertes Feld              |
| `<custom_field_7>`     | Benutzerdefiniertes Feld              |
| `<custom_field_8>`     | Benutzerdefiniertes Feld              |
| `<custom_field_9>`     | Benutzerdefiniertes Feld              |
| `<custom_field_10>`    | Benutzerdefiniertes Feld              |
| `<custom_field_11>`    | Benutzerdefiniertes Feld              |
| `<custom_field_12>`    | Benutzerdefiniertes Feld              |
| `<custom_field_13>`    | Benutzerdefiniertes Feld              |
| `<custom_field_14>`    | Benutzerdefiniertes Feld              |
| `<custom_field_15>`    | Benutzerdefiniertes Feld              |
| `<custom_field_16>`    | Benutzerdefiniertes Feld              |
| `<custom_field_17>`    | Benutzerdefiniertes Feld              |
| `<custom_field_18>`    | Benutzerdefiniertes Feld              |
| `<custom_field_19>`    | Benutzerdefiniertes Feld              |