# Trabalhando com códigos promocionais Você pode fornecer um código promocional a um cliente de uma de duas maneiras: 1. Prepare uma lista de códigos promocionais em uma planilha do Google, treine o Mavibot para encontrar um código disponível, entregá-lo ao cliente e, em seguida, marcá-lo como emitido na planilha. 2. Treine o Mavibot para gerar códigos promocionais com base em regras específicas, forneça o código ao cliente e, em seguida, registre-o na planilha. Você pode verificar a validade dos códigos usando o Google Sheets e suas solicitações de API. Saiba mais sobre esses processos abaixo: * [Como verificar um código promocional no Google Sheets](#how-to-check-the-promo-code-from-google-sheets) * [Como fornecer um código promocional do Google Sheets](#how-to-give-a-promo-code-from-google-sheets) * [Como gerar um código promocional com a ajuda do Salebot](#how-to-generate-a-promo-code-with-the-help-of-salebot) ## Como verificar um código promocional no Google Sheets Se o seu objetivo é limitar o acesso ao bot ou a ofertas especiais, você pode usar a função de verificação de códigos promocionais. Prepare uma Planilha Google na qual uma coluna será uma lista dos seus códigos promocionais. Defina a configuração de acesso como “Qualquer pessoa com este link pode editar”. Como fazer isso, leia em [este artigo](https://docs.salebot.ai/integrations/google-sheets) Veja como a função funciona: um cliente insere seu código promocional no bot. A função então verifica se o código existe na coluna designada que você criou. Se o código for encontrado, a frase "Código promocional foi usado" é adicionada à célula adjacente, e a função retorna esta resposta: `{"status": ‘’0’’}` Endereço da função: ; Para verificar o código, você precisa enviar estes parâmetros do bloco: `{"id":"1HfnHDbJYTGz68-3KWIcRISncTmdEn8v7Vf_OKvDMrOI", "promocode": "#{question}", "col_number": "1"}` **id** é o ID da sua Planilha Google que contém os códigos promocionais. Você pode encontrá-lo na URL do seu documento. Certifique-se de que as configurações de compartilhamento do documento permitam que qualquer pessoa com o link possa editar. ![](https://lh6.googleusercontent.com/cvcU-bsobIQ-uD5iqEzNsEbnTep8loKIyZrIlfPKkqUF7qTLewOTk8-L6RwUkXBlTGM8K_yQCn-jujDlBBuzH-_bIwhKvtOgRB-pkQnd5VpA108jCx75_UKlEV5mphSWkEsSwR5_7zrBwS9Sag) Se os códigos promocionais estiverem em *uma planilha separada*, então você precisa usar o parâmetro **list\_name**, no qual você deve inserir o nome dela, por exemplo: `{"id":"1HfnHDbJYTGz68-3KWIcRISncTmdEn8v7Vf_OKvDMrOI", "promocode": "#{question}", "col_number": "1", "list_name": "Sheet name"}` O próximo parâmetro é o código promocional que o cliente aplica. **col\_number** - o número da coluna que contém os códigos `{"status": ‘’1’’}`, depois disso você não pode aplicar o código pela segunda vez Se a função não encontrar o código promocional na planilha ou ele já tiver sido usado, então ela responde com `{"status": ‘’0’’}` Se você está se perguntando como usar isso e onde colocá-lo, confira a captura de tela abaixo. ![](https://lh5.googleusercontent.com/WqtuqryusiRuwOBWKF80lAl2Q4HC5EfWZoSxDMw367AzRceNWRf01XyDVO6mfvIxAXan1-Ejzvg8iYl36yDUzfmdqP62nMNe1xqNAuZ-BjON9_F1oC7gsFBb2Ta_GZZyoWZy3tFKtmQzUv3OSA) **#{custom\_answer}** - a resposta do servidor mencionada na aba "URL request". Use esta variável na aba de resposta para ver seu conteúdo. Se tudo estiver configurado corretamente, salve status->status e, então, nas setas abaixo da aba “Variable for comparison”, defina as condições como **"status == 0"** (respondendo ao usuário que o código já foi usado) ou **"status == 1"** (permitindo que o usuário prossiga). Um exemplo é mostrado abaixo. ![](https://lh3.googleusercontent.com/IBr66uuikrvi9s4hR82FHYxdxVpsRqtNVysc8obCZQzjFxMThrTz0jsbHWdgMCrv6iP0fU_9axov9EhL9CMeiUtZVFqNUK8Hk22grZ_x3Tr4JPVqI5oAxQmca_da1D2fta03u3e7Qy9tAwig3g) ## Como fornecer um código promocional do Google Sheets Prepare sua planilha como mostrado na imagem abaixo, com códigos promocionais na primeira coluna e a palavra "Available" na segunda coluna. Configure as permissões de acesso para “Qualquer pessoa na Internet com este link pode editar”. Como fazer isso, leia em [este artigo](https://docs.salebot.ai/integrations/google-sheets) ![](https://lh5.googleusercontent.com/XkxdMscLWR-5FE8V2c53KehWDsbt7XP6TAxVuVRsHrxSKlFPeM8xEAgvIENjRxWS_Z2bU8KtxEIQkz6NgExRYSr6qWu207cGuybkb_kAwDg_J0RotfpPSKRCQ4z8w3lFVLClEW9oYNFPnikWww) Você receberá um link semelhante a este: O texto em negrito aqui é o ID da sua página. Você vai precisar dele mais tarde. Crie um bloco no Mavibot e cole estes parâmetros em suas configurações: Tipo de solicitação: `POST-json` Solicitação de URL: `https://store.salebot.ai/function/findcell` Valores armazenados: `data->Código promocional;` \ `cell_number|row ->linha;` Parâmetros JSON: `{"id": "1HfnHDbJYTGz68-3KWIcRISncTmdEn8v7Vf_OKvDMrOI", "find": "Available", "col": 2, "return": 1}` onde você precisa colocar o ID da sua página em vez de 1HfnHDbJYTGz68-3KWIcRISncTmdEn8v7Vf\_OKvDMrOI ![](https://lh5.googleusercontent.com/hr0fmr7F_klICs6FDm8ay1majH0R_GQ3EDsxvzFq-IWYJhP_DhvaoSKfGhr7O5aZSY0xUzC6YLb8pzcryhs7IK9J_4ACyjfeEAT_0PApcS27OXKP3QPfeSmcq_rTNLw9EIFA99NADl5QipPWLg) Crie um bloco abaixo e clique em "Time settings" nas configurações de conexão. Na seção aberta, abaixo da **"Delay before answer"** aba, insira -1 para fazer a transição acontecer o mais rápido possível. No novo bloco, defina os parâmetros mencionados abaixo. Para mostrar ao cliente o código dele, digite **#{Promo\_code}** Tipo de solicitação: `POST-json` Solicitação de URL: `https://store.mavibot.ai/function/gsheets` Parâmetros JSON: `{"id": "1HfnHDbJYTGz68-3KWIcRISncTmdEn8v7Vf_OKvDMrOI", "write":{"b#{line}":"Usado"}}` \ onde você precisa colocar o ID da sua página em vez de 1HfnHDbJYTGz68-3KWIcRISncTmdEn8v7Vf\_OKvDMrOI ![](https://lh3.googleusercontent.com/PtlosYtM_SMivssLQ1toFXIoerd7SenhhPtw_Doy-KDgB6G4Ycp3P02IO4LQyYqK8wiLbP_q7zL81wcguaIeHDSBQGVSk-HpXPMnmgnRvbs7thEsarKGaT5xIt3n4T979FEaHz52pvEikeCyfA) ## Como gerar um código promocional com a ajuda do Mavibot Se um código promocional puder ser criado com certas regras, então você pode gerá-lo diretamente no Mavibot e anotá-lo no Google Sheets para verificação posterior. Você precisará de variáveis para isso. Por exemplo, para gerar um código promocional exclusivo, você pode usar a variável **#{client\_id}**. É uma variável no Mavibot que indica o número do seu cliente no sistema. Nas configurações do bloco, em Avançado -> Calculadora, anote: \ `Promocode = promo#{client_id}` Cole **#{Promo\_code}** no campo "Answer" \ Você obterá um código promocional promo1330882. Se você quiser adicionar mais *aleatório* ao seu código, então adicione a chamada da função **random()** \ `Promocode = 'promo' + '#{client_id}' + random(0,10)` \ Nesse caso, ele adiciona 1 número aleatório no final Agora vamos colá-lo em nossa planilha de códigos. Primeiro, crie uma nova Planilha Google em branco. Defina as permissões de compartilhamento como "Qualquer pessoa com o link pode editar." \ Depois, digite Códigos promocionais na célula A1. {% hint style="warning" %} Se a primeira célula estiver vazia, a função não vai funcionar. Você precisa ter certeza de preenchê-la! {% endhint %} Você receberá um link semelhante a este: O texto em negrito aqui é o ID da sua página. Você vai precisar dele mais tarde. Agora vamos voltar ao Mavibot e continuar trabalhando no seu bloco com o código promocional Tipo de solicitação: `POST-json` Solicitação de URL: `https://store.mavibot.ai/function/gsheets` Parâmetros JSON: `{"id": "1sl15vKFjo5TFD98GnVjF3AlLtdhr85-AkEjoeJkgDxE", "mapping":{"a":"#{Promo_code}"}}`\ onde você precisa colocar o ID da sua página em vez de 1HfnHDbJYTGz68-3KWIcRISncTmdEn8v7Vf\_OKvDMrOI Você deve criar algo assim: ![](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/pt/recursos-especiais/trabalhando-com-codigos-promocionais.md?ask= ``` 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.