# Trabajar con códigos promocionales 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](#how-to-check-the-promo-code-from-google-sheets) * [Cómo dar un código promocional desde Hojas de Google](#how-to-give-a-promo-code-from-google-sheets) * [Cómo generar un código promocional con la ayuda de Salebot](#how-to-generate-a-promo-code-with-the-help-of-salebot) ## 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](https://docs.salebot.ai/integrations/google-sheets) 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: ; 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. ![](https://lh6.googleusercontent.com/cvcU-bsobIQ-uD5iqEzNsEbnTep8loKIyZrIlfPKkqUF7qTLewOTk8-L6RwUkXBlTGM8K_yQCn-jujDlBBuzH-_bIwhKvtOgRB-pkQnd5VpA108jCx75_UKlEV5mphSWkEsSwR5_7zrBwS9Sag) 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. ![](https://lh5.googleusercontent.com/WqtuqryusiRuwOBWKF80lAl2Q4HC5EfWZoSxDMw367AzRceNWRf01XyDVO6mfvIxAXan1-Ejzvg8iYl36yDUzfmdqP62nMNe1xqNAuZ-BjON9_F1oC7gsFBb2Ta_GZZyoWZy3tFKtmQzUv3OSA) **#{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. ![](https://lh3.googleusercontent.com/IBr66uuikrvi9s4hR82FHYxdxVpsRqtNVysc8obCZQzjFxMThrTz0jsbHWdgMCrv6iP0fU_9axov9EhL9CMeiUtZVFqNUK8Hk22grZ_x3Tr4JPVqI5oAxQmca_da1D2fta03u3e7Qy9tAwig3g) ## 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](https://docs.salebot.ai/integrations/google-sheets) ![](https://lh5.googleusercontent.com/XkxdMscLWR-5FE8V2c53KehWDsbt7XP6TAxVuVRsHrxSKlFPeM8xEAgvIENjRxWS_Z2bU8KtxEIQkz6NgExRYSr6qWu207cGuybkb_kAwDg_J0RotfpPSKRCQ4z8w3lFVLClEW9oYNFPnikWww) Obtendrás un enlace similar a este: 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 ![](https://lh5.googleusercontent.com/hr0fmr7F_klICs6FDm8ay1majH0R_GQ3EDsxvzFq-IWYJhP_DhvaoSKfGhr7O5aZSY0xUzC6YLb8pzcryhs7IK9J_4ACyjfeEAT_0PApcS27OXKP3QPfeSmcq_rTNLw9EIFA99NADl5QipPWLg) 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 ![](https://lh3.googleusercontent.com/PtlosYtM_SMivssLQ1toFXIoerd7SenhhPtw_Doy-KDgB6G4Ycp3P02IO4LQyYqK8wiLbP_q7zL81wcguaIeHDSBQGVSk-HpXPMnmgnRvbs7thEsarKGaT5xIt3n4T979FEaHz52pvEikeCyfA) ## 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. {% hint style="warning" %} Si la primera celda está vacía, la función no funcionará. ¡Debes asegurarte de completarla! {% endhint %} Obtendrás un enlace similar a este: 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: ![](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/es/funciones-especiales/trabajar-con-codigos-promocionales.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.