Puedes entregar un código promocional a un cliente de dos maneras:

  1. Preparar una lista de códigos promocionales en una Hoja de Google, entrenar a Mavibot para encontrar un código disponible, entregarlo al cliente y luego marcarlo como emitido en la hoja.
  2. Entrenar a Mavibot para generar códigos promocionales basados en reglas específicas, proporcionar el código al cliente y luego registrarlo en la hoja.

Puedes verificar la validez de los códigos usando Hojas de Google y sus solicitudes API.

Obtén más información sobre estos procesos a continuación:

Cómo verificar un código promocional desde Hojas de Google

Si tienes el objetivo de limitar el acceso al bot o a ofertas especiales, puedes usar la función de verificación de códigos promocionales.

Prepara una Hoja de Google en la que una columna sea una lista de tus códigos promocionales. Configura el ajuste de acceso a "Cualquier persona con el enlace puede editar". Cómo hacerlo, lee en este artículo

Así es como funciona la función: Un cliente ingresa su código promocional en el bot. La función luego verifica si el código existe en la columna designada que creaste. Si se encuentra el código, la frase "El código promocional fue usado" se agrega a la celda adyacente, y la función devuelve esta respuesta:

{“status”: ‘’0’’}

Dirección de la función: https://store.mavibot.ai/function/check-promocode

Para verificar el código, debes enviar estos parámetros desde el bloque:

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

id es el ID de tu Hoja de Google que contiene los códigos promocionales. Puedes encontrarlo en la URL de tu documento. Asegúrate de que la configuración de uso compartido del documento permita que cualquier persona con el enlace pueda editar.

Si los códigos promocionales están ubicados en una hoja separada, entonces necesitas usar el parámetro list_name, en el cual debes colocar su nombre, por ejemplo:

{"id":"1HfnHDbJYTGz68-3KWIcRISncTmdEn8v7Vf_OKvDMrOI", "promocode": "#{question}", "col_number": "1", "list_name": "Nombre de la hoja"}

El siguiente parámetro es el código promocional que el cliente aplica.

col_number - el número de columna que contiene los códigos

{“status”: ‘’1’’}, después de eso no puedes aplicar el código por segunda vez

Si la función no encuentra el código promocional en la hoja o ya ha sido usado, entonces responde con

{“status”: ‘’0’’}

Si te preguntas cómo usar esto y dónde colocarlo, consulta la captura de pantalla a continuación.

#{custom_answer} - la respuesta del servidor que se menciona en la pestaña "Solicitud URL".

Usa esta variable en la pestaña de respuesta para ver su contenido. Si todo está configurado correctamente, guarda status->status, luego en las flechas debajo de la pestaña "Variable para comparación", establece las condiciones en "status == 0" (respondiendo al usuario que el código ya ha sido usado) o "status == 1" (permitiendo al usuario continuar).

Se muestra un ejemplo a continuación.

Cómo entregar un código promocional desde Hojas de Google

Prepara tu hoja como se muestra en la imagen a continuación, con códigos promocionales en la primera columna y la palabra "Disponible" en la segunda columna. Configura los ajustes de acceso a "Cualquier persona en Internet con este enlace puede editar". Cómo hacerlo, lee en este artículo

Obtendrás un enlace similar a este: https://docs.google.com/spreadsheets/d/**1HfnHDbJYTGz68-3KWIcRISncTmdEn8v7Vf\\_OKvDMrOI**/edit?usp=sharing

El texto en negrita aquí es el ID de tu página. Lo necesitarás más tarde.

Crea un bloque en Mavibot y pega estos parámetros en su configuración:

Tipo de solicitud: POST-json

Solicitud URL: https://store.salebot.ai/function/findcell

Valores almacenados:

data->Código promocional;
cell_number|row ->line;

Parámetros JSON:

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

donde debes colocar tu propio ID de página en lugar de 1HfnHDbJYTGz68-3KWIcRISncTmdEn8v7Vf_OKvDMrOI

Crea un bloque debajo y haz clic en "Configuración de tiempo" en la configuración de conexión. En la sección abierta, debajo de la pestaña "Retraso antes de la respuesta", ingresa -1 para que la transición ocurra lo más rápido posible.

En el nuevo bloque, establece los parámetros mencionados a continuación.

Para mostrar al cliente su código, escribe #{Promo_code}

Tipo de solicitud: POST-json

Solicitud URL: https://store.mavibot.ai/function/gsheets

Parámetros JSON:

{"id": "1HfnHDbJYTGz68-3KWIcRISncTmdEn8v7Vf_OKvDMrOI", "write":{"b#{line}":"Usado"}}
donde debes colocar tu propio ID de página en lugar de 1HfnHDbJYTGz68-3KWIcRISncTmdEn8v7Vf_OKvDMrOI

Cómo generar un código promocional con la ayuda de Mavibot

Si se puede crear un código promocional con ciertas reglas, entonces puedes generarlo directamente en Mavibot y escribirlo en Hojas de Google para su posterior verificación.

Necesitarás variables para esto. Por ejemplo, para generar un código promocional único, puedes usar la variable #{client_id}. Es una variable en Mavibot que indica el número de tu cliente en el sistema.

En la configuración del bloque, en Avanzado -> Calculadora, escribe:
Promocode = promo#{client_id}

Pega #{Promo_code} en el campo "Respuesta"
Obtendrás un código promocional promo1330882.

Si deseas agregar más aspecto aleatorio a tu código, entonces agrega la llamada a la función random()
Promocode = 'promo' + '#{client_id}' + random(0,10)
En este caso, agrega 1 número aleatorio al final

Ahora peguémoslo en nuestra hoja de códigos.

Primero, crea una nueva Hoja de Google en blanco. Configura los permisos de uso compartido a "Cualquier persona con el enlace puede editar".
Luego, escribe Códigos promocionales en la celda A1.

¡Si la primera celda está vacía, la función no funcionará! ¡Asegúrate de llenarla!

Obtendrás un enlace similar a este:

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

El texto en negrita aquí es el ID de tu página. Lo necesitarás más tarde.

Ahora volvamos a Mavibot y continuemos trabajando en tu bloque con el código promocional

Tipo de solicitud: POST-json

Solicitud URL: https://store.mavibot.ai/function/gsheets

Parámetros JSON:

{"id": "1sl15vKFjo5TFD98GnVjF3AlLtdhr85-AkEjoeJkgDxE", "mapping":{"a":"#{Promo_code}"}}
Donde debes colocar tu propio ID de página en lugar de 1HfnHDbJYTGz68-3KWIcRISncTmdEn8v7Vf_OKvDMrOI

Deberías crear algo como esto: