Você pode dar um código promocional a um cliente de duas maneiras:

  1. Preparar uma lista de códigos promocionais em uma Planilha Google, treinar o Mavibot para encontrar um código disponível, entregá-lo ao cliente e marcá-lo como emitido na planilha.
  2. Treinar o Mavibot para gerar códigos promocionais com base em regras específicas, fornecer o código ao cliente e registrá-lo na planilha.

Você pode verificar a validade dos códigos usando o Planilhas Google e suas requisições de API.

Saiba mais sobre esses processos abaixo:

Como verificar um código promocional do Planilhas Google

Se você tem o objetivo de limitar o acesso ao bot ou a ofertas especiais, pode usar a função de verificação de códigos promocionais.

Prepare uma Planilha Google na qual uma coluna será uma lista de seus códigos promocionais. Defina a configuração de acesso para “Qualquer pessoa com o link pode editar”. Como fazer isso, leia neste artigo

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: https://store.mavibot.ai/function/check-promocode 

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 contendo 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 edite.

Se os códigos promocionais estiverem em uma planilha separada, então você precisa usar o parâmetro list_name, no qual você deve colocar seu nome, por exemplo:

{"id":"1HfnHDbJYTGz68-3KWIcRISncTmdEn8v7Vf_OKvDMrOI", "promocode": "#{question}", "col_number": "1", "list_name": "Nome da planilha"}

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 colocar, confira a captura de tela abaixo.

#{custom_answer} - a resposta do servidor que é mencionada na aba "Requisição de URL".

Use esta variável na aba de resposta para ver seu conteúdo. Se tudo estiver configurado corretamente, salve status->status, então nas setas abaixo da aba "Variável para comparação", defina as condições para "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.

Como dar um código promocional do Planilhas Google

Prepare sua planilha como mostrado na imagem abaixo, com códigos promocionais na primeira coluna e a palavra "Disponível" na segunda coluna. Configure as configurações de acesso para “Qualquer pessoa na Internet com este link pode editar”. Como fazer isso, leia neste artigo

Você receberá um link semelhante a este: https://docs.google.com/spreadsheets/d/**1HfnHDbJYTGz68-3KWIcRISncTmdEn8v7Vf\\_OKvDMrOI**/edit?usp=sharing

O texto em negrito aqui é o ID da sua página. Você precisará dele mais tarde.

Crie um bloco no Mavibot e cole estes parâmetros em suas configurações:

Tipo de requisição: POST-json

Requisiçã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": "Disponível", "col": 2, "return": 1}

onde você precisa colocar seu próprio ID de página em vez de 1HfnHDbJYTGz68-3KWIcRISncTmdEn8v7Vf_OKvDMrOI

Crie um bloco abaixo e clique em "Configurações de tempo" nas configurações de conexão. Na seção aberta, sob a aba "Atraso antes da resposta", digite -1 para que a transição ocorra o mais rápido possível.

No novo bloco, defina os parâmetros mencionados abaixo.

Para mostrar ao cliente seu código, digite #{Promo_code}

Tipo de requisição: POST-json

Requisição de URL: https://store.mavibot.ai/function/gsheets

Parâmetros JSON:

{"id": "1HfnHDbJYTGz68-3KWIcRISncTmdEn8v7Vf_OKvDMrOI", "write":{"b#{line}":"Usado"}}
onde você precisa colocar seu próprio ID de página em vez de 1HfnHDbJYTGz68-3KWIcRISncTmdEn8v7Vf_OKvDMrOI

Como gerar um código promocional com a ajuda do Mavibot

Se um código promocional pode ser criado com certas regras, então você pode gerá-lo diretamente no Mavibot e escrevê-lo no Planilhas Google para verificação posterior.

Você precisará de variáveis para isso. Por exemplo, para gerar um código promocional único, 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, escreva:
Promocode = promo#{client_id}

Cole #{Promo_code} no campo "Resposta"
Você obterá um código promocional promo1330882.

Se você quiser adicionar mais aleatoriedade ao seu código, adicione a chamada de função random()
Promocode = 'promo' + '#{client_id}' + random(0,10)
Neste caso, 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 para "Qualquer pessoa com o link pode editar."

Em seguida, digite Códigos promocionais na célula A1.

Se a primeira célula estiver vazia, a função não funcionará. Certifique-se de preenchê-la!

Você receberá um link semelhante a este:

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

O texto em negrito aqui é o ID da sua página. Você precisará dele mais tarde.

Agora vamos voltar ao Mavibot e continuar trabalhando em seu bloco com o código promocional

Tipo de requisição: POST-json

Requisição de URL: https://store.mavibot.ai/function/gsheets

Parâmetros JSON:

{"id": "1sl15vKFjo5TFD98GnVjF3AlLtdhr85-AkEjoeJkgDxE", "mapping":{"a":"#{Promo_code}"}}
Onde você precisa colocar seu próprio ID de página em vez de 1HfnHDbJYTGz68-3KWIcRISncTmdEn8v7Vf_OKvDMrOI

Você deve criar algo assim: