Via l'Advanced API, vous pouvez envoyer un message aux contacts enregistrés dans les groupes du carnet d'adresses BulkGate. Il vous suffit d'indiquer les identifiants des groupes concernés dans le paramètre `groups`. Vous trouverez cet identifiant dans le détail du groupe.

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

## Exemple de requête :
```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": "Bonjour <first_name>, ravi de faire votre connaissance. <email>"
}
```

Il est possible d'ajouter des variables, qui seront remplacées avant l'envoi du message par une valeur précise issue du carnet d'adresses.

**Le message final ressemble alors à ceci :**
```
Bonjour Thomas, ravi de faire votre connaissance. thomas@example.com
```

**Voici la liste complète des variables :**

| VARIABLE               | SIGNIFICATION                         |
|:-----------------------|:--------------------------------------|
| `<title_before>`       | Titre avant le nom                    |
| `<first_name>`         | Prénom                                |
| `<last_name>`          | Nom                                   | 
| `<title_after>`        | Titre après le nom                    |
| `<first_name_vokativ>` | Prénom au vocatif (langue tchèque)    |
| `<last_name_vokativ>`  | Nom au vocatif (langue tchèque)       |
| `<company_name>`       | Nom de l'entreprise                   | 
| `<phone_mobile>`       | Numéro de téléphone mobile            |
| `<email>`              | Adresse e-mail                        |
| `<url>`                | Adresse du site web                   |
| `<street1>`            | Rue 1                                 |
| `<street2>`            | Rue 2                                 |
| `<city>`               | Ville                                 |
| `<zip>`                | Code postal                           |
| `<state>`              | Région                                |
| `<country>`            | Pays                                  |
| `<company_number>`     | Numéro d'immatriculation de l'entreprise (CRN) |
| `<company_vat>`        | Numéro de TVA                         |
| `<custom_field_0>`     | Champ personnalisé                    |
| `<custom_field_1>`     | Champ personnalisé                    |
| `<custom_field_2>`     | Champ personnalisé                    |
| `<custom_field_3>`     | Champ personnalisé                    |
| `<custom_field_4>`     | Champ personnalisé                    |
| `<custom_field_5>`     | Champ personnalisé                    |
| `<custom_field_6>`     | Champ personnalisé                    |
| `<custom_field_7>`     | Champ personnalisé                    |
| `<custom_field_8>`     | Champ personnalisé                    |
| `<custom_field_9>`     | Champ personnalisé                    |
| `<custom_field_10>`     | Champ personnalisé                    |
| `<custom_field_11>`     | Champ personnalisé                    |
| `<custom_field_12>`     | Champ personnalisé                    |
| `<custom_field_13>`     | Champ personnalisé                    |
| `<custom_field_14>`     | Champ personnalisé                    |
| `<custom_field_15>`     | Champ personnalisé                    |
| `<custom_field_16>`     | Champ personnalisé                    |
| `<custom_field_17>`     | Champ personnalisé                    |
| `<custom_field_18>`     | Champ personnalisé                    |
| `<custom_field_19>`     | Champ personnalisé                    |