For the complete documentation index, see llms.txt. This page is also available as Markdown.

Trabalhando com códigos promocionais

O bot permite não apenas fornecer códigos promocionais aos clientes, mas também verificar sua validade e controlar seu uso único

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

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

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

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.

#{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.

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

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ê 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

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

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.

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ê 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:

Atualizado