# Travailler avec les codes promo

Vous pouvez donner un code promo à un client de l’une des deux façons suivantes :

1. Préparez une liste de codes promo dans une feuille Google Sheets, entraînez Mavibot à trouver un code disponible, transmettez-le au client, puis marquez-le comme attribué dans la feuille.&#x20;
2. Entraînez Mavibot à générer des codes promo selon des règles spécifiques, fournissez le code au client, puis enregistrez-le dans la feuille.

Vous pouvez vérifier la validité des codes à l’aide de Google Sheets et de ses requêtes API.

En savoir plus sur ces प्रक्रés ci-dessous :

* [Comment vérifier un code promo depuis Google Sheets](#how-to-check-the-promo-code-from-google-sheets)&#x20;
* [Comment donner un code promo depuis Google Sheets](#how-to-give-a-promo-code-from-google-sheets)&#x20;
* [Comment générer un code promo avec l’aide de Salebot](#how-to-generate-a-promo-code-with-the-help-of-salebot)

## Comment vérifier un code promo depuis Google Sheets

Si vous avez pour objectif de limiter l’accès au bot ou à des offres spéciales, vous pouvez utiliser la fonction de vérification des codes promo.

Préparez une feuille Google Sheets dans laquelle une colonne contiendra la liste de vos codes promo. Définissez le paramètre d’accès sur « Toute personne disposant de ce lien peut modifier ». Pour savoir comment faire, lisez dans [cet article](https://docs.salebot.ai/integrations/google-sheets)

Voici comment fonctionne la fonction : un client saisit son code promo dans le bot. La fonction vérifie ensuite si le code existe dans la colonne désignée que vous avez créée. Si le code est trouvé, la phrase « Le code promo a été utilisé » est ajoutée à la cellule adjacente, et la fonction renvoie cette réponse :

`{“status”: ‘’0’’}`

Adresse de la fonction : <https://store.mavibot.ai/function/check-promocode&#x20>;

Pour vérifier le code, vous devez envoyer ces paramètres depuis le bloc :

`{"id":"1HfnHDbJYTGz68-3KWIcRISncTmdEn8v7Vf_OKvDMrOI", "promocode": "#{question}", "col_number": "1"}`

**id** est l’ID de votre feuille Google Sheets contenant les codes promo. Vous pouvez le trouver dans l’URL de votre document. Assurez-vous que les paramètres de partage du document permettent à toute personne disposant du lien de le modifier.

![](https://lh6.googleusercontent.com/cvcU-bsobIQ-uD5iqEzNsEbnTep8loKIyZrIlfPKkqUF7qTLewOTk8-L6RwUkXBlTGM8K_yQCn-jujDlBBuzH-_bIwhKvtOgRB-pkQnd5VpA108jCx75_UKlEV5mphSWkEsSwR5_7zrBwS9Sag)

Si les codes promo se trouvent dans *une feuille séparée*, alors vous devez utiliser le paramètre **list\_name**, dans lequel vous devez indiquer son nom, par exemple :

`{"id":"1HfnHDbJYTGz68-3KWIcRISncTmdEn8v7Vf_OKvDMrOI", "promocode": "#{question}", "col_number": "1", "list_name": "Nom de la feuille"}`

Le paramètre suivant est le code promo appliqué par le client.

**col\_number** - le numéro de la colonne qui contient les codes

`{“status”: ‘’1’’}`, après cela, vous ne pouvez plus utiliser le code une deuxième fois

Si la fonction ne trouve pas le code promo dans la feuille ou s’il a déjà été utilisé, elle répond alors avec

`{“status”: ‘’0’’}`

Si vous vous demandez comment utiliser cela et où le placer, consultez la capture d’écran ci-dessous.

![](https://lh5.googleusercontent.com/WqtuqryusiRuwOBWKF80lAl2Q4HC5EfWZoSxDMw367AzRceNWRf01XyDVO6mfvIxAXan1-Ejzvg8iYl36yDUzfmdqP62nMNe1xqNAuZ-BjON9_F1oC7gsFBb2Ta_GZZyoWZy3tFKtmQzUv3OSA)

**#{custom\_answer}** - la réponse du serveur mentionnée dans l’onglet « Requête URL ».

Utilisez cette variable dans l’onglet de réponse pour voir son contenu. Si tout est correctement configuré, enregistrez status->status, puis dans les flèches sous l’onglet « Variable de comparaison », définissez les conditions sur **"status == 0"** (en répondant à l’utilisateur que le code a déjà été utilisé) ou **"status == 1"** (en permettant à l’utilisateur de continuer).

Un exemple est présenté ci-dessous.

![](https://lh3.googleusercontent.com/IBr66uuikrvi9s4hR82FHYxdxVpsRqtNVysc8obCZQzjFxMThrTz0jsbHWdgMCrv6iP0fU_9axov9EhL9CMeiUtZVFqNUK8Hk22grZ_x3Tr4JPVqI5oAxQmca_da1D2fta03u3e7Qy9tAwig3g)

## Comment donner un code promo depuis Google Sheets

Préparez votre feuille comme indiqué dans l’image ci-dessous, avec les codes promo dans la première colonne et le mot « Disponible » dans la deuxième colonne. Configurez les paramètres d’accès sur « Toute personne sur Internet disposant de ce lien peut modifier ». Pour savoir comment faire, lisez dans [cet article](https://docs.salebot.ai/integrations/google-sheets)

![](https://lh5.googleusercontent.com/XkxdMscLWR-5FE8V2c53KehWDsbt7XP6TAxVuVRsHrxSKlFPeM8xEAgvIENjRxWS_Z2bU8KtxEIQkz6NgExRYSr6qWu207cGuybkb_kAwDg_J0RotfpPSKRCQ4z8w3lFVLClEW9oYNFPnikWww)

Vous obtiendrez un lien similaire à celui-ci : <https://docs.google.com/spreadsheets/d/**1HfnHDbJYTGz68-3KWIcRISncTmdEn8v7Vf\\_OKvDMrOI**/edit?usp=sharing>

Le texte en gras ici est l’ID de votre page. Vous en aurez besoin plus tard.

Créez un bloc sur Mavibot et collez ces paramètres dans ses réglages :

Type de requête : `POST-json`

Requête URL : `https://store.salebot.ai/function/findcell`

Valeurs stockées :

`data->Code promo;` \
`cell_number|row ->ligne;`

Paramètres JSON :

`{"id": "1HfnHDbJYTGz68-3KWIcRISncTmdEn8v7Vf_OKvDMrOI", "find": "Available", "col": 2, "return": 1}`

où vous devez placer votre propre ID de page à la place de 1HfnHDbJYTGz68-3KWIcRISncTmdEn8v7Vf\_OKvDMrOI

![](https://lh5.googleusercontent.com/hr0fmr7F_klICs6FDm8ay1majH0R_GQ3EDsxvzFq-IWYJhP_DhvaoSKfGhr7O5aZSY0xUzC6YLb8pzcryhs7IK9J_4ACyjfeEAT_0PApcS27OXKP3QPfeSmcq_rTNLw9EIFA99NADl5QipPWLg)

Créez un bloc ci-dessous et cliquez sur « Paramètres de temps » dans les réglages de connexion. Dans la section ouverte, sous l’onglet **« Délai avant réponse »** , entrez -1 pour que la transition se fasse aussi rapidement que possible.

Dans le nouveau bloc, définissez les paramètres mentionnés ci-dessous.

Pour afficher son code au client, tapez **#{Promo\_code}**

Type de requête : `POST-json`

Requête URL : `https://store.mavibot.ai/function/gsheets`

Paramètres JSON :

`{"id": "1HfnHDbJYTGz68-3KWIcRISncTmdEn8v7Vf_OKvDMrOI", "write":{"b#{line}":"Used"}}` \
où vous devez placer votre propre ID de page à la place de 1HfnHDbJYTGz68-3KWIcRISncTmdEn8v7Vf\_OKvDMrOI

![](https://lh3.googleusercontent.com/PtlosYtM_SMivssLQ1toFXIoerd7SenhhPtw_Doy-KDgB6G4Ycp3P02IO4LQyYqK8wiLbP_q7zL81wcguaIeHDSBQGVSk-HpXPMnmgnRvbs7thEsarKGaT5xIt3n4T979FEaHz52pvEikeCyfA)

## Comment générer un code promo avec l’aide de Mavibot

Si un code promo peut être créé selon certaines règles, vous pouvez alors le générer directement dans Mavibot et l’inscrire dans Google Sheets pour une vérification ultérieure.

Vous aurez besoin de variables pour cela. Par exemple, pour générer un code promo unique, vous pouvez utiliser la variable **#{client\_id}**. C’est une variable dans Mavibot qui indique le numéro de votre client dans le système.

Dans les réglages du bloc, Avancé -> Calculatrice, écrivez : \
`Code promo = promo#{client_id}`&#x20;

Collez **#{Promo\_code}** dans le champ « Réponse » \
Vous obtiendrez un code promo promo1330882.

Si vous souhaitez ajouter un aspect plus *aléatoire* à votre code, ajoutez alors l’appel de fonction **random()** \
`Code promo = 'promo' + '#{client_id}' + random(0,10)` \
Dans ce cas, cela ajoute 1 nombre aléatoire à la fin

Maintenant, collons-le dans notre feuille de codes.

Tout d’abord, créez une nouvelle feuille Google Sheets vide. Définissez les autorisations de partage sur « Toute personne disposant du lien peut modifier ».\
Puis, saisissez Code promo dans la cellule A1.

{% hint style="warning" %}
Si la première cellule est vide, la fonction ne fonctionnera pas. Vous devez absolument la remplir !
{% endhint %}

Vous obtiendrez un lien similaire à celui-ci :

<https://docs.google.com/spreadsheets/d/**1HfnHDbJYTGz68-3KWIcRISncTmdEn8v7Vf\\_OKvDMrOI**/edit?usp=sharing>

Le texte en gras ici est l’ID de votre page. Vous en aurez besoin plus tard.

Revenons maintenant à Mavibot et continuons à travailler sur votre bloc avec le code promo

Type de requête : `POST-json`

Requête URL : `https://store.mavibot.ai/function/gsheets`

Paramètres JSON :

`{"id": "1sl15vKFjo5TFD98GnVjF3AlLtdhr85-AkEjoeJkgDxE", "mapping":{"a":"#{Promo_code}"}}`\
où vous devez placer votre propre ID de page à la place de 1HfnHDbJYTGz68-3KWIcRISncTmdEn8v7Vf\_OKvDMrOI

Vous devriez créer quelque chose comme ceci :

![](https://lh4.googleusercontent.com/Eivmw4kvkhay9Mt7Lc8pZiby50doKFXS8QDuFR75JJwP2UKLAs3EDUuB4IoWG0h8nl3f9xXk4TtEzfqNhxNhtAF6DQVg7QHCDy9bZRrAi9N2HAnWVv6gByBr46p0IzKg0338chEt1cWplmhvKg)


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.mavibot.ai/doc/fr/fonctionnalites-speciales/travailler-avec-les-codes-promo.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
