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

Trabajo con códigos promocionales

El bot no solo permite dar códigos promocionales a los clientes, sino también comprobar su validez y controlar su uso único

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

  1. Prepara una lista de códigos promocionales en una hoja de Google, entrena a Mavibot para encontrar un código disponible, entrégaselo al cliente y luego márcalo como emitido en la hoja.

  2. Entrena a Mavibot para generar códigos promocionales basados en reglas específicas, proporciona el código al cliente y luego regístralo en la hoja.

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

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

Cómo comprobar 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 comprobació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 permiso de acceso en “Cualquiera con este enlace puede editar”. Cómo hacerlo, léelo en este artículo

Así funciona la función: un cliente introduce su código promocional en el bot. Luego, la función comprueba si el código existe en la columna designada que creaste. Si se encuentra el código, la frase "El código promocional fue utilizado" se añade 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 comprobar el código, necesitas 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 cualquiera con el enlace pueda editarlo.

Si los códigos promocionales están situados en una hoja separada, entonces necesitas usar el parámetro list_name, en el que 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 aplica el cliente.

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

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

Si la función no encuentra el código promocional en la hoja o ya se ha 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 de URL".

Usa esta variable en la pestaña de respuesta para ver su contenido. Si todo está configurado correctamente, guarda status->status y 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 utilizado) o "status == 1" (permitiendo que el usuario continúe).

A continuación se muestra un ejemplo.

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

Prepara tu hoja como se muestra en la imagen de abajo, con los códigos promocionales en la primera columna y la palabra "Disponible" en la segunda columna. Configura los permisos de acceso en “Cualquiera en Internet con este enlace puede editar”. Cómo hacerlo, léelo 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 adelante.

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

Tipo de solicitud: POST-json

Solicitud de 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": "Available", "col": 2, "return": 1}

donde necesitas colocar el ID de tu propia página en lugar de 1HfnHDbJYTGz68-3KWIcRISncTmdEn8v7Vf_OKvDMrOI

Crea un bloque abajo y haz clic en "Configuración de tiempo" en la configuración de conexión. En la sección que se abre, debajo de la "Retraso antes de responder" pestaña, introduce -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 mostrarle al cliente su código, escribe #{Promo_code}

Tipo de solicitud: POST-json

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

Parámetros JSON:

{"id": "1HfnHDbJYTGz68-3KWIcRISncTmdEn8v7Vf_OKvDMrOI", "write":{"b#{line}":"Usado"}} donde necesitas colocar el ID de tu propia 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 registrarlo en Hojas de Google para comprobarlo más adelante.

Para esto necesitarás variables. 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 quieres añadir más aleatorio al aspecto de tu código, entonces añade la llamada a la función random() Promocode = 'promo' + '#{client_id}' + random(0,10) En este caso, añade 1 número aleatorio al final

Ahora vamos a pegarlo en nuestra hoja de códigos.

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

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

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

Tipo de solicitud: POST-json

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

Parámetros JSON:

{"id": "1sl15vKFjo5TFD98GnVjF3AlLtdhr85-AkEjoeJkgDxE", "mapping":{"a":"#{Promo_code}"}} donde necesitas colocar el ID de tu propia página en lugar de 1HfnHDbJYTGz68-3KWIcRISncTmdEn8v7Vf_OKvDMrOI

Deberías crear algo como esto:

Última actualización