# ConvoKraft ## Componentes de Ayuda -------------------------------------------------------------------------------- title: "SmartTrain" description: "Esta característica te permite entrenar tu bot de ConvoKraft usando datos personalizados agregándolos a través de URLs." last_updated: "2026-07-02T09:34:15.858Z" source: "https://docs.catalyst.zoho.com/es/convokraft/help/smarttrain/" service: "ConvoKraft" -------------------------------------------------------------------------------- # SmartTrain SmartTrain es una característica avanzada del servicio Catalyst ConvoKraft que te permite entrenar tu bot con datos personalizados, mejorando sus capacidades de aprendizaje más allá de la lógica de bot predefinida para las acciones configuradas. Con SmartTrain, puedes cargar datos de entrenamiento personalizados directamente a ConvoKraft a través de la consola de Catalyst. El sistema procesa los datos cargados y entrena automáticamente al bot, permitiéndole entregar respuestas inteligentes a las consultas de los usuarios basándose en el contenido entrenado. Catalyst proporciona un conjunto completo de APIs REST que puedes integrar en tus aplicaciones para aprovechar las funcionalidades de SmartTrain. Estas APIs te permiten habilitar o deshabilitar SmartTrain, agregar nuevos materiales de entrenamiento, recuperar detalles de datos de entrenamiento existentes, eliminar materiales de entrenamiento, y obtener respuestas del bot de ConvoKraft después de un entrenamiento exitoso con tus datos personalizados. Puedes consultar la documentación de la API para información más detallada. ### Upload Training Data Para entrenar tu bot de ConvoKraft con datos personalizados, primero debes habilitar la característica **SmartTrain**. Una vez habilitada, puedes cargar los datos para el entrenamiento, y el bot procesará y aprenderá automáticamente del contenido, mejorando su capacidad para entregar respuestas inteligentes. Puedes cargar tus datos de entrenamiento como URLs que enlazan a recursos basados en web en los siguientes formatos de archivo: * **.html** * **.txt** Las URLs deben contener la información que tu bot necesita aprender y usar para generar respuestas. El proceso de entrenamiento es completamente automatizado, con **SmartTrain** gestionando la complejidad de entender y organizar la información. No hay necesidad de estructurar o formatear manualmente el contenido. SmartTrain preserva el contexto y las relaciones dentro de los datos, permitiendo que tu bot entregue respuestas precisas y relevantes. Puedes crear un bot, luego habilitar SmartTrain y cargar datos de entrenamiento siguiendo los pasos a continuación: 1. Navega a la pestaña **SmartTrain** y haz clic en **Enable SmartTrain**. 2. En la ventana emergente de confirmación, haz clic en **Enable**. 3. Haz clic en **Add Training Data** para cargar tus datos personalizados. 4. Debajo de la sección **Add URL**, ingresa la URL de un recurso web en formato **.html** o **.txt** que contenga los datos de entrenamiento, luego haz clic en **Add**. Para fines de demostración, hemos agregado el enlace de la documentación de ayuda de Catalyst. 5. El material de entrenamiento será agregado y el bot comenzará a procesarlo automáticamente. 6. Una vez que el entrenamiento esté completo, el estado se actualizará a **Trained**. Ahora puedes probar el bot haciendo preguntas relacionadas con los datos personalizados cargados. En nuestro caso, el bot podrá responder cualquier consulta relacionada con Catalyst como se describe en la documentación de ayuda. Veremos cómo funciona esto en la siguiente sección. Nota: No necesitas entrenar el bot manualmente como lo haces cuando configuras acciones. Con **SmartTrain**, el entrenamiento ocurre automáticamente una vez que cargas el material de entrenamiento, permitiéndote proceder directamente a las pruebas. ### Probar el bot Después de cargar los datos de entrenamiento personalizados y completar el proceso de entrenamiento, puedes probar tu bot haciendo clic en el botón **Test the Bot** en la esquina inferior derecha, como se muestra en la captura de pantalla a continuación. Ahora puedes hacer al bot cualquier pregunta basada en los datos de entrenamiento personalizados que hayas cargado. El bot analizará la información, correlacionará detalles relevantes y generará una respuesta bien estructurada y comprensible. Ahora, hagamos una pregunta sobre nuestro servicio Catalyst ConvoKraft y veamos cómo responde el bot. Si haces una pregunta que no es parte de los datos de entrenamiento o está más allá de la comprensión del bot, responderá con el mensaje configurado en la función fallback handler. ### Delete Training Data Puedes eliminar los datos de entrenamiento cargados en cualquier momento directamente desde la consola de Catalyst. Sin embargo, ten en cuenta que una vez eliminados, el bot perderá todos los aprendizajes de esa fuente, y necesitarás volver a cargar los datos para entrenarlo nuevamente. 1. Haz clic en el ícono de puntos suspensivos junto al material de entrenamiento y selecciona **Delete**. 2. En la ventana emergente de confirmación, haz clic en **Delete**. ### Deshabilitar SmartTrain Puedes deshabilitar la característica **SmartTrain** si no quieres que el bot responda a preguntas basadas en datos de entrenamiento personalizados. Deshabilitar SmartTrain pausa temporalmente su funcionalidad, pero una vez rehabilitado, el bot reanudará la respuesta a consultas usando los datos de entrenamiento existentes. Si quieres eliminar los datos de entrenamiento permanentemente, asegúrate de eliminarlos como se explica en la sección anterior. 1. Para deshabilitar **SmartTrain**, haz clic en el ícono de puntos suspensivos, como se muestra en la captura de pantalla a continuación, y selecciona **Disable SmartTrain**. 2. En la ventana emergente de confirmación, haz clic en **Disable SmartTrain**. ### Acciones -------------------------------------------------------------------------------- title: "Crear una acción" description: "Conoce las acciones de Catalyst ConvoKraft que pueden configurarse para que los bots las ejecuten, como responder directamente a consultas o ejecutar una lógica de negocio para obtener datos o realizar una tarea." last_updated: "2026-07-02T09:34:15.859Z" source: "https://docs.catalyst.zoho.com/es/convokraft/help/actions/create-an-action/" service: "ConvoKraft" -------------------------------------------------------------------------------- # Crear una Acción En esta sección, discutiremos los pasos para crear una acción, configurar las oraciones de ejemplo y los parámetros para tu bot de ConvoKraft. Después de crear un bot, puedes agregarle una o más acciones. Para agregar una nueva acción en tu bot de ConvoKraft, sigue los pasos a continuación: 1. Después de crear un nuevo bot de ConvoKraft o hacer clic en un bot existente, se mostrará la página de detalles del bot como se muestra en la captura de pantalla a continuación. Haz clic en Create Action. 2. Proporciona un nombre significativo para la acción en la ventana emergente que aparece. Puedes elegir configurar la respuesta de la acción con una respuesta directa o basada en lógica de negocio. Haz tu selección y haz clic en Next. ### Responder con una respuesta directa Si eliges configurar la respuesta de la acción con una respuesta directa, sigue los pasos a continuación: 1. Ingresa las oraciones de ejemplo apropiadas sobre cómo se puede formular esta pregunta, es decir, las diferentes variaciones posibles de la pregunta que es probable que el usuario utilice al conversar con el bot de ConvoKraft. Puedes aprender más sobre las oraciones de ejemplo en esta página. Haz clic en Next. 2. En la sección What's the answer, ingresa el contenido que debe responderse como respuesta a la pregunta. Puedes seleccionar un texto específico en la respuesta y aplicarle estilos de formato haciendo clic en los diversos íconos de formato disponibles en la barra de herramientas. Aprende más sobre las diversas estructuras de formato en detalle en esta sección. Nota: La respuesta configurada aquí es universal y común para todos los usuarios independientemente de su región y zona horaria. 3. Haz clic en la opción Preview en la barra de herramientas del editor Markdown para ver una vista previa en vivo del contenido con los estilos de formato aplicados. Haz clic en Save. ### Construir respuesta ejecutando lógica de negocio Si eliges configurar la respuesta de la acción basándote en la ejecución de una lógica de negocio, ya sea obteniendo datos o realizando cualquier operación, sigue los pasos a continuación: 1. Define las oraciones de ejemplo para tu acción. 2. Configura los parámetros requeridos para tu acción. Nota: Solo puedes agregar parámetros cuando eliges configurar la respuesta de tu acción basándote en una lógica de negocio. * Para agregar un nuevo parámetro a una acción: Haz clic en la opción New Params en la sección PARAMS 3. Elige el tipo de parámetro requerido de la lista de tipos de datos soportados por ConvoKraft y verás un nuevo cuadro de diálogo para configurar más detalles. Aprende más sobre los atributos de cada tipo de parámetro en parámetros. #### String Primero crearemos un nuevo parámetro de tipo String. Puedes configurar los siguientes detalles para los parámetros: 1. Ingresa el mensaje de solicitud para la entrada del usuario y un mensaje de error para mostrar en caso de entradas inválidas. 2. Habilita Allow to skip, si es necesario. Nota: Los atributos mencionados anteriormente son aplicables a todos los tipos de parámetros en ConvoKraft. #### Lista de selección única/múltiple A continuación, crearemos otro parámetro de tipo Single selection list: 1. Cuando configuras un parámetro de lista de selección única/múltiple, puedes agregar las opciones aplicables haciendo clic en el botón New Option como se muestra en la imagen a continuación. Para aprender más sobre este tipo de parámetro, consulta esta página. Nota: También puedes permitir valores en tiempo de ejecución distintos a los valores configurados, habilitando la casilla de verificación allow values. 2. Opcionalmente, también puedes configurar un botón personalizado para realizar operaciones adicionales con las opciones seleccionadas haciendo clic en la opción Add Button junto a la etiqueta Submission Buttons. Aparecerá la pantalla Configure Buttons. Ingresa los valores para los campos requeridos de cada botón. Para aprender más sobre estos campos, consulta esta página. Para agregar otro botón, haz clic en New Button y una vez que los botones requeridos se hayan agregado exitosamente, haz clic en DONE. 3. Elige el modo de entrada como Textual o Visual, según tu requerimiento. 4. Asocia un parámetro con frases específicas en las oraciones de ejemplo seleccionando el texto requerido. Selecciona uno de los parámetros configurados de la lista mostrada y asócialo con el texto de inmediato. También puedes hacer clic en New param para crear un nuevo parámetro. Nota: Si no has asociado ningún parámetro con las oraciones de ejemplo, entonces los parámetros se invocarán en la conversación en el mismo orden exacto en que fueron definidos. 5. Después de configurar las oraciones de ejemplo y los parámetros requeridos para la acción, haz clic en Save. Puedes editar las configuraciones haciendo clic en el botón Edit. Para aprender más sobre cómo ver y gestionar una acción, consulta esta página. -------------------------------------------------------------------------------- title: "Definir Oraciones de Ejemplo" description: "Conoce las acciones de Catalyst ConvoKraft que pueden configurarse para que los bots las ejecuten, como responder directamente a consultas o ejecutar una lógica de negocio para obtener datos o realizar una tarea." last_updated: "2026-07-02T09:34:15.859Z" source: "https://docs.catalyst.zoho.com/es/convokraft/help/actions/define-sample-sentences/" service: "ConvoKraft" -------------------------------------------------------------------------------- # Definir Oraciones de Ejemplo ## Introducción Las oraciones de ejemplo son las invocaciones de ejemplo que agregas cuando configuras una acción para tu bot de ConvoKraft. Estas oraciones son de naturaleza conversacional y pueden configurarse según cómo es probable que un usuario interactúe con tu bot. Puedes agregar múltiples oraciones de ejemplo para una acción particular. Cuando el usuario interactúa con el bot, el bot de ConvoKraft busca invocaciones similares en las oraciones de ejemplo y activa la acción correspondiente asociada con la invocación. Si no se encuentran coincidencias con ninguna oración de ejemplo configurada existente, el bot responderá basándose en las configuraciones realizadas en el fallback handler. Nota: Si has elegido desarrollar tu bot logic usando Deluge, consulta esta página para información detallada sobre las funciones del fallback handler. Si la plataforma de desarrollo elegida es Catalyst Functions o webhooks, tendrás que manejar los escenarios de fallo en tu código fuente por tu cuenta. Las oraciones de ejemplo se aplican a todas las ejecuciones de acciones, tanto para respuestas directas como para ejecución de lógica de negocio. En ambos casos de ejecución de acciones, necesitarás definir oraciones de ejemplo para el bot que crees. * Si has elegido configurar la respuesta basándote en una respuesta directa, entonces puedes definir las oraciones de ejemplo que es probable que el usuario utilice de forma conversacional. ConvoKraft comprende la intención de las oraciones de ejemplo configuradas usando su capacidad NLP y cuando un usuario plantea una consulta similar, el bot responde con la respuesta directa configurada. * Si has elegido configurar la respuesta para ejecutar una lógica de negocio, entonces junto con la configuración de oraciones de ejemplo, cualquier texto escrito en la oración de ejemplo puede seleccionarse y marcarse como un parámetro. El parámetro con el valor proporcionado por el usuario se pasará entonces a la lógica de negocio para su procesamiento posterior. Puedes aprender más sobre la implementación y uso de oraciones de ejemplo al crear una acción. ## Definir una oración de ejemplo En esta sección, discutiremos algunos escenarios de ejemplo para explicar el uso de las oraciones de ejemplo en una acción de ConvoKraft: Supongamos que estás creando una acción que se invocará para responder consultas sobre los detalles de un modelo particular de un teléfono móvil. Basándose en las entradas, por ejemplo un nombre o número de modelo, la lógica de negocio correspondiente se ejecutará para obtener los detalles de ese modelo particular. El usuario probablemente podría hacer preguntas similares a estas: **"I need to know the specs of Iphone 14"** **"Iphone 13 specs"** **"Tell me everything about Iphone 14 Pro Max"** **"Tech specifications of Iphone 14"** **"Iphone SE2 technical specs"** La respuesta a la pregunta se obtendrá basándose en las entradas del usuario. Supongamos que el usuario consulta sobre el Iphone 14, la respuesta sería algo como lo siguiente. <table class="content-table"> <thead> <tr> <th>Technical Spec</th> <th>iPhone 14</th> </tr> </thead> <tbody> <tr> <td>Processor</td> <td>Apple A15 Bionic</td> </tr> <tr> <td>Storage</td> <td>128GB, 256GB, 512GB</td> </tr> <tr> <td>Pixel density</td> <td>460 ppi</td> </tr> <tr> <td>Display size resolution</td> <td>6.1-inch OLED; 2,532x1,170 pixels</td> </tr> </tbody> </table> Consideremos otro ejemplo donde la acción proporciona detalles sobre Zoho Corporation. En este caso, la respuesta a la pregunta relacionada con Zoho se configurará directamente en la acción. Imagina las preguntas que el usuario podría hacer y las diferentes variaciones de las mismas, y configúralas como oraciones de ejemplo. Algunas preguntas pueden ser: **"What is Zoho?"** **"What does the company Zoho Corporation do?"** **"Tell me something about Zoho Corp"** El bot respondería con la respuesta configurada: **"Zoho Corporation is an Indian multinational technology company that makes computer software and web-based business tools. It is best known for the online office suite offering Zoho Office Suite. The company was founded in 1996 by Sridhar Vembu and Tony Thomas and has a presence in seven locations with global headquarters in Chennai, Tamil Nadu, India."** Para obtener una comprensión más detallada sobre la implementación y uso de oraciones de ejemplo al crear una acción para tu bot de ConvoKraft, consulta esta página. -------------------------------------------------------------------------------- title: "Definir Parámetros" description: "Conoce el uso y los casos de uso de los parámetros al configurar acciones en el bot de ConvoKraft." last_updated: "2026-07-02T09:34:15.859Z" source: "https://docs.catalyst.zoho.com/es/convokraft/help/actions/define-params/" service: "ConvoKraft" -------------------------------------------------------------------------------- # Definir Parámetros # Introducción Los datos de entrada recibidos de un usuario durante una conversación con un bot se describen como parámetros de una acción. Si consideramos la ejecución de una acción como algo análogo a completar un formulario, entonces los campos del formulario pueden considerarse como los parámetros de la acción. Por ejemplo, los parámetros para una acción de crear un evento serían típicamente: * Título del evento * Hora de inicio del evento * Hora de finalización del evento Los usuarios pueden proporcionar valor a cada uno de estos parámetros de forma conversacional en su lenguaje natural. Según los parámetros configurados para una acción, ConvoKraft comprenderá automáticamente la intención del mensaje y extraerá el valor apropiado de los parámetros. Nota: El flujo conversacional de un bot depende del orden de los parámetros definidos. Después de que se detecta una acción, el bot solicitará todos los parámetros sin completar uno por uno con sus respectivos mensajes de solicitud, en el orden en que fueron definidos. ConvoKraft usa su capacidad NLP para establecer una coincidencia entre las configuraciones realizadas a la acción y la entrada del usuario en tiempo de ejecución. Convertirá la entrada del usuario en un valor computacional según el tipo de datos declarado del parámetro específico. Discutiremos más sobre los tipos de datos soportados de un parámetro más adelante en esta página. Estos parámetros a su vez se utilizarán en la lógica de negocio para realizar las operaciones requeridas del bot. Puedes aprender más sobre la implementación y uso de parámetros al crear una acción. Nota: * Definir parámetros será aplicable solo si has elegido configurar tu acción para ejecutar una lógica de negocio. * Una acción puede tener un máximo de 20 parámetros. ### Atributos de un parámetro En esta sección, discutiremos los diversos atributos de un parámetro en detalle: 1. **Nombre del parámetro** Un nombre válido para el parámetro debe cumplir con los siguientes puntos: * Comenzar con minúscula * Solo se permiten números y letras * Contener un máximo de 50 caracteres * Debe ser único para cada acción * Los siguientes nombres no pueden usarse como parámetro, ya que son palabras reservadas en ConvoKraft como userInput, previousParam, additionalParams, sessionData, broadcast, previousUserMsgs, cache, org y user 2. **Tipo de parámetro** Puedes elegir el tipo de datos requerido para tu parámetro de la lista de tipos soportados en ConvoKraft: <table class="content-table"> <thead> <tr> <th>Tipo de Datos</th> <th>Descripción</th> </tr> </thead> <tbody> <tr> <td>String</td> <td>Una entrada única de tipo String</td> </tr> <tr> <td>Integer Number</td> <td>Una entrada única de tipo Integer</td> </tr> <tr> <td>Integer Number Range</td> <td>Dos entradas que representan el rango de inicio y fin de enteros</td> </tr> <tr> <td>Decimal Number</td> <td>El número de dígitos a redondear para un número decimal. La precisión máxima permitida es cinco.</td> </tr> <tr> <td>Decimal Number Range</td> <td>Dos entradas que representan el rango de inicio y fin de decimales.</td> </tr> <tr> <td>Date</td> <td>Una entrada única de tipo Date</td> </tr> <tr> <td>Date Range</td> <td>Dos entradas que representan el rango de inicio y fin de fecha</td> </tr> <tr> <td>Date/Time</td> <td>Una entrada única de tipo Date/Time</td> </tr> <tr> <td>Date/Time Range</td> <td>Dos entradas que representan el rango de inicio y fin de Date/Time</td> </tr> <tr> <td>Boolean</td> <td>Una entrada de SÍ o NO</td> </tr> <tr> <td>Email</td> <td>Una entrada única de tipo Email</td> </tr> <tr> <td>Amount</td> <td>Entrada de monto con código de moneda / símbolo de moneda</td> </tr> <tr> <td>File</td> <td>Un archivo para subir como entrada del usuario. Para este parámetro, puedes especificar qué tipos de archivo puede subir el usuario. Los tipos de archivo soportados se mencionan a continuación. </td> </tr> <tr> <td>Single selection list</td> <td>Una lista de opciones disponibles de las cuales el usuario puede seleccionar una. Los detalles se proporcionan a continuación.</td> </tr> <tr> <td>Multiple selection list</td> <td>Una lista de opciones disponibles de las cuales el usuario puede seleccionar más de una. Los detalles se proporcionan a continuación.</td> </tr> </tbody> </table> Nota: * Una acción no puede tener parámetros de fecha u hora si ya tiene un parámetro de rango de fecha u hora. * Una acción no puede tener parámetros de entero o decimal si ya tiene un parámetro de rango de entero o decimal. Para el parámetro de archivo, puedes definir los tipos de archivo soportados de la siguiente manera: <table class="content-table"> <thead> <tr> <th>Formatos</th> <th>Tipos de Archivo Soportados</th> </tr> </thead> <tbody> <tr> <td>IMAGE</td> <td>image/png, image/jpeg,image/bmp, image/tiff, image/vnd.microsoft.icon</td> </tr> <tr> <td>DOCUMENTS</td> <td>text/plain, text/csv, application/rtf, application/msword, application/vnd.openxmlformats-officedocument.wordprocessingml.document, application/vnd.oasis.opendocument.text</td> </tr> <tr> <td>PDF</td> <td>application/pdf</td> </tr> <tr> <td>PRESENTATION</td> <td>application/mspowerpoint, application/vnd.ms-powerpoint, application/vnd.ms-powerpoint, application/vnd openxmlformatsofficedocument.presentationml .presentation, application/vnd.oasis.opendocument.presentation</td> </tr> <tr> <td>SPREADSHEET</td> <td>application/vnd.ms-excel, application/vnd.msexcel, application/vnd.openxmlformats-officedocument.spreadsheetml.sheet, application/vnd.oasis.opendocument.spreadsheet</td> </tr> <tr> <td>AUDIO</td> <td>audio/mpeg , audio/wav, audio/midi, audio/x-midi, audio/aac</td> </tr> <tr> <td>VIDEO</td> <td>video/mpeg, video/x-msvideo ,video/x-flv, video/mp4, video/quicktime</td> </tr> <tr> <td>COMPRESSION</td> <td>application/zip, application/x-tar, application/gzip</td> </tr> </tbody> </table> ### Lista de Selección Única y Múltiple Para los parámetros de lista de selección única y múltiple, necesitas ingresar la siguiente información adicional: 1. **Opciones**: Estas son la lista de opciones disponibles de las cuales el usuario puede seleccionar una o múltiples opciones. Puedes configurar las opciones de forma estática sin usar código. Se recomienda dar a cada opción un valor distinto que pueda ser entendido por el usuario. Cada opción tiene un ID, que se usa para identificar de forma única una opción programáticamente. Puedes ingresar el ID para cada opción manualmente o usar el ID generado automáticamente mientras escribes las opciones. Un nombre e ID válidos para las opciones de la lista de selección deben cumplir con los siguientes puntos: * El ID solo soporta caracteres alfanuméricos, guiones y guiones bajos * El nombre de la opción puede tener un máximo de 150 caracteres * Un parámetro de lista de selección puede tener hasta 50 opciones 2. **Botones**: Los botones representan las acciones que se ejecutarán sobre las opciones de la lista de selección elegidas. La acción predeterminada es enviar las opciones de la lista de selección seleccionadas, si no se configuran botones personalizados. Las propiedades de un botón incluyen las siguientes: * **Label** - El texto que se muestra en el botón. * **ID** - Un identificador para que la lógica de negocio identifique de forma única qué botón se eligió durante la conversación. * **Theme** - El esquema de colores que refleja la apariencia del botón en la conversación. Se soportan los siguientes tres temas. 1. **Positive** 2. **Negative** 3. **Neutral** Un nombre e ID válidos para los botones deben cumplir con los siguientes puntos: * El nombre y el ID de un botón pueden incluir todos los caracteres alfanuméricos y símbolos especiales. * Pueden contener un máximo de 150 caracteres. * Un parámetro de lista de selección puede tener hasta tres botones. 3. **Permitir valores distintos a estas opciones**: Esta opción permite al usuario enviar sus propios valores en lugar de seleccionar de la lista de opciones que definiste. Si esta opción está habilitada, los IDs de dichos valores se establecerán como null. 4. **Modo de entrada**: Esto especifica la forma en que un usuario puede proporcionar un valor al parámetro. Puede ser Textual o Visual. Si se elige Textual, el usuario podrá escribir el valor preferido que desea asignar al parámetro. En el caso de Visual, el usuario debe seleccionar su entrada de las opciones visuales disponibles. Las opciones se mostrarán como un botón de radio (en caso de selección única), casilla de verificación (en caso de selección múltiple) o un selector de fecha/hora (en caso de rango de fecha/hora). 5. **Mensaje de solicitud**: La pregunta que el bot le haría al usuario para obtener la entrada del parámetro como parte de una conversación del bot con el usuario. Por ejemplo, para obtener el valor de la hora de inicio de un evento en la acción de crear evento, el mensaje de solicitud podría ser **"What time does the event start at?"** o **"When is the event?"**. Este campo no puede dejarse vacío y debe cumplir con los siguientes puntos: * Puede incluir todos los caracteres alfanuméricos y símbolos especiales excepto #, /, \, &, *, +, = y (). * Puede contener un máximo de 255 caracteres. Para parámetros que involucran un rango, el campo de mensaje de solicitud se divide en: * Start of the Range: Mensaje de solicitud para obtener el valor de inicio del rango. * End of the Range: Mensaje de solicitud para obtener el valor final del rango. 6. **Mensaje de solicitud en caso de fallo de validación**: El mensaje personalizado que se mostrará al usuario cuando la entrada del usuario sea inválida para el parámetro solicitado. Este campo es opcional. 7. **Permitir omitir**: Permite al usuario omitir la respuesta de un parámetro mientras conversa con un bot. ### Definir un parámetro En esta sección, discutiremos algunos escenarios de ejemplo para explicar el uso de parámetros en una acción de ConvoKraft: * Consideremos un escenario donde el usuario necesita iniciar una solicitud de devolución para un pedido en línea. El usuario diría algo como esto: **"I would like to return my order"** **"Return my order"** **"Return this product and request refund"** Puedes crear un parámetro order id para obtener los detalles del usuario al iniciar una solicitud de devolución y asociar el parámetro con cualquier frase en tus invocaciones de ejemplo. De modo que cuando el usuario consulte sobre la devolución, el bot solicitará inmediatamente el número de pedido. * Discutamos otro escenario para programar una reunión en el calendario. El usuario escribiría algo como esto: **"Schedule a meeting in my calendar at 5pm tomorrow"** **"Add a meeting for tomorrow"** En este caso, puedes crear parámetros como eventname(String), eventtype(Single selection list), eventdays(Multi-selection list), eventtime(Date/Time Range). Para aprender sobre la configuración de un parámetro al crear una acción para tu bot de ConvoKraft, consulta crear una acción. -------------------------------------------------------------------------------- title: "Definir Respuestas del Bot" description: "Conoce las acciones de Catalyst ConvoKraft que pueden configurarse para que los bots las ejecuten, como responder directamente a consultas o ejecutar una lógica de negocio para obtener datos o realizar una tarea." last_updated: "2026-07-02T09:34:15.859Z" source: "https://docs.catalyst.zoho.com/es/convokraft/help/actions/define-bot-responses/" service: "ConvoKraft" -------------------------------------------------------------------------------- # Definir Respuestas del Bot Esta sección proporciona información detallada sobre las diversas estructuras de respuesta que pueden configurarse en el bot de ConvoKraft. Puedes configurar respuestas para acciones que proporcionen respuestas directas o basadas en lógica de negocio definida. Discutiremos los tipos de respuestas y su sintaxis en esta sección. ### Respuesta Directa Cuando creas una acción que responde basándose en la respuesta directa configurada, puedes dar formato a la respuesta según tus necesidades específicas usando las opciones listadas a continuación. * **Bold** * **Italics** * **Underline** * **Strikethrough** * **Highlight** * **Heading** * **Bullet list** * **Numbered List** * **Image** * **Blockquote** * **Table** Puedes usar los menús de formato justo arriba del editor, simplemente haz clic en ellos para aplicar el formato particular. La captura de pantalla a continuación muestra una respuesta formateada con todos los estilos aplicables. Click on **Preview** to view the output text of the formatted response. # Responder basándose en una lógica de negocio Al crear una acción que responde basándose en la lógica de negocio configurada, puedes configurar diversas respuestas en la Catalyst Integration Function, Deluge, o Webhooks usando las sintaxis a continuación. Exploremos los diferentes tipos de respuestas y sus estructuras en detalle. ### Texto Plano Para enviar un mensaje de texto simple como respuesta a una consulta del usuario en el bot de ConvoKraft, utiliza la siguiente estructura. #### JSON { "message": "This is a sample message response" } #### Java public class ExecuteHandler { public JSONObject handleExecuteRequest(JSONObject reqBody) { JSONObject jsonResponse = new JSONObject(); jsonResponse.put("message", "This is a sample message response"); } return jsonResponse; } #### Node.js export default function handleExecute(request) { let result={}; result.message="This is a sample message response"; return result; } #### Python def handle_execute_request(req_body): result = {} result['message'] = "This is a sample message response" return result La respuesta se ve así: ### Tarjeta Para configurar una respuesta de tarjeta en el bot de ConvoKraft, sigue las siguientes estructuras a continuación. Puedes aprender más sobre la configuración de una respuesta de tarjeta específicamente en la función de Deluge, en this section. **Tarjeta simple con título y nota** Este fragmento de código te permite definir un mensaje simple en la tarjeta que incluye un título y una nota. #### JSON { "message": "Plain Card response", "card": [ { "type": "title", "content": "This is a card with title" }, { "type": "note", "content": "This is a card with note" } ] } #### Java public class ExecuteHandler { public JSONObject handleExecuteRequest(JSONObject reqBody) { JSONObject jsonResponse = new JSONObject(); jsonResponse.put("card", new JSONArray() .put(new JSONObject().put("type", "title").put("content", "This is a card with title")) .put(new JSONObject().put("type", "note").put("content", "This is a card with note")));} return jsonResponse; } #### Node.js export default function handleExecute(request) { let result={}; result.card=[]; result.card.push({ "type":"title", "content":"This is a card with title" }) result.card.push({ "type":"note", "content":"This is a card with note" }) return result; } #### Python def handle_execute_request(req_body): result = {} result['card'] = [ {"type": "title", "content": "This is a card with title"}, {"type": "note", "content": "This is a card with note"} ] return result La respuesta se ve así: #### Tarjeta con Lista de Viñetas Este fragmento de código te permite definir una lista de viñetas dentro de la tarjeta en la respuesta de ConvoKraft. #### JSON { "message": "Bullet List RESPONSE", "card": [ { "type": "title", "content": "This is a title card for Bullet List" }, { "type": "list", "format": "bullet", "elements": [ { "label": "ABC" }, { "label": "DEF" } ] } ] } #### Java public class ExecuteHandler { public JSONObject handleExecuteRequest(JSONObject reqBody) { JSONObject jsonResponse = new JSONObject(); jsonResponse.put("card", new JSONArray() .put(new JSONObject().put("type", "title").put("content", "This is a title card for Bullet List")) .put(new JSONObject().put("type", "list").put("format", "bullet").put("elements", new JSONArray() .put(new JSONObject().put("label", "ABC")) .put(new JSONObject().put("label", "DEF")))));return jsonResponse; } #### Node.js export default function handleExecute(request) { let result={}; result.card=[]; result.card.push({ "type":"title", "content":"This is a title card for Bullet List" }) result.card.push({ "type":"list", "format":"bullet", "elements":[ { "label":"ABC" }, { "label":"DEF" } ] }); return result; } #### Python def handle_execute_request(req_body): result = {} result['card'] = [ {"type": "title", "content": "This is a title card for Bullet List"}, {"type": "list", "format": "bullet", "elements": [{"label": "ABC"}, {"label": "DEF"}]} ] return result La respuesta en el bot se ve así: #### Tarjeta con Lista Numerada Este fragmento de código te permite definir una lista numerada dentro de la tarjeta en la respuesta de ConvoKraft. #### JSON { "message": "Numbered List RESPONSE", "card": [ { "type": "note", "content": "This is a note card with Numbered List" }, { "type": "list", "format": "numbered", "elements": [ { "label": "point no. 1" }, { "label": "point no. 2" } ] } ] } #### Java public class ExecuteHandler { public JSONObject handleExecuteRequest(JSONObject reqBody) { JSONObject jsonResponse = new JSONObject(); jsonResponse.put("card", new JSONArray() .put(new JSONObject().put("type", "note").put("content", "This is a note card with Numbered List")) .put(new JSONObject().put("type", "list").put("format", "numbered").put("elements", new JSONArray() .put(new JSONObject().put("label", "point no. 1")) .put(new JSONObject().put("label", "point no. 2"))))); return jsonResponse; } #### Node.js export default function handleExecute(request) { let result={}; result.card=[]; result.card.push({ "type":"note", "content":"This is a note card with Numbered List" }) result.card.push({ "type":"list", "format":"numbered", "elements":[ { "label":"point no. 1" }, { "label":"point no. 2" } ] }); return result; } #### Python def handle_execute_request(req_body): result = {} result['card'] = [ {"type": "note", "content": "This is a note card with Numbered List"}, {"type": "list", "format": "numbered", "elements": [{"label": "point no. 1"}, {"label": "point no. 2"}]} ] return result La respuesta en el bot se ve así: ### Respuesta con Enlace Este fragmento de código te permite enviar un hipervínculo dentro de la tarjeta en la respuesta de ConvoKraft. #### JSON { "message": "LINK RESPONSE", "card": [ { "type": "link", "text": "Click Here to Know about ZOHO", "content": "https://www.zoho.com" } ] } #### Java public class ExecuteHandler { public JSONObject handleExecuteRequest(JSONObject reqBody) { JSONObject jsonResponse = new JSONObject(); jsonResponse.put("card", new JSONArray() .put(new JSONObject().put("type", "link").put("text", "Click Here to Know about ZOHO").put("content", "https://www.zoho.com"))); return jsonResponse; } #### Node.js export default function handleExecute(request) { let result={}; result.card=[]; result.card.push({ "type":"link", "text":"Click Here to Know about ZOHO", "content":"https://www.zoho.com" }) return result; } #### Python def handle_execute_request(req_body): result = {} result['card'] = [ {"type": "link", "text": "Click Here to Know about ZOHO", "content": "https://www.zoho.com"} ] return result La respuesta en el bot se ve así: ### Respuesta con Tabla Este fragmento de código te permite mostrar una tabla con valores dentro de la tarjeta en la respuesta de ConvoKraft. #### JSON { "message": "TABLE RESPONSE", "card": [ { "type": "table", "heading": "Convokraft Dummy Table", "columns": [ "Name", "AGE", "CITY" ], "rows": [ [ "BOB", "25", "SFO" ], [ "Evan", "28", "NY" ] ] } ] } #### Java public class ExecuteHandler { public JSONObject handleExecuteRequest(JSONObject reqBody) { JSONObject jsonResponse = new JSONObject(); jsonResponse.put("card", new JSONArray() .put(new JSONObject().put("type", "table").put("heading", "Convokraft Dummy Table").put("columns", new JSONArray() .put("Name").put("AGE").put("CITY")).put("rows", new JSONArray() .put(new JSONArray().put("BOB").put("25").put("SFO")) .put(new JSONArray().put("Evan").put("28").put("NY"))))); return jsonResponse; } #### Node.js export default function handleExecute(request) { let result={}; result.card=[]; result.card.push({ "type":"table", "heading":"Convokraft Dummy Table ", "columns":[ "Name", "AGE", "CITY" ], "rows":[ [ "BOB", "25", "SFO" ], [ "Evan", "28", "NY" ] ] }) return result; } #### Python def handle_execute_request(req_body): result = {} result['card'] = [ {"type": "table", "heading": "Convokraft Dummy Table", "columns": ["Name", "AGE", "CITY"], "rows": [["BOB", "25", "SFO"], ["Evan", "28", "NY"]]} ] return result La respuesta en el bot se ve así: ### Respuesta VCard Este fragmento de código te permite definir información de contacto incluyendo nombre, apellido, nombre de la empresa y sitio web dentro de la tarjeta en la respuesta de ConvoKraft. #### JSON { "message": "VCard Response", "card": [ { "type": "vcard", "info": { "image": "https://contacts.zoho.com/file?ID=53157432", "fields": [ { "First Name": "Prashaanth" }, { "Last Name": "Ramesh" }, { "Company": "Zoho" }, { "Website": "https://www.zoho.com" } ] } } ] } #### Java public class ExecuteHandler { public JSONObject handleExecuteRequest(JSONObject reqBody) { JSONObject jsonResponse = new JSONObject(); jsonResponse.put("card", new JSONArray() .put(new JSONObject().put("type", "vcard").put("info", new JSONObject().put("image", "https://contacts.zoho.com/file?ID=53157432").put("fields", new JSONArray() .put(new JSONObject().put("First Name", "Prashaanth")) .put(new JSONObject().put("Last Name", "Ramesh")) .put(new JSONObject().put("Company", "Zoho")) .put(new JSONObject().put("Website", "https://www.zoho.com")))))); return jsonResponse; } #### Node.js export default function handleExecute(request) { let result={}; result.card=[]; result.card.push({ "type":"vcard", "info":{ "image":"https://contacts.zoho.com/file?ID=53157432", "fields":[ { "First Name":"Prashaanth" }, { "Last Name":"Ramesh" }, { "Company":"Zoho" }, { "Website":"https://www.zoho.com" } ] } }) return result; } #### Python def handle_execute_request(req_body): result = {} result['card'] = [ {"type": "vcard", "info": {"image": "https://contacts.zoho.com/file?ID=53157432", "fields": [{"First Name": "Prashaanth"}, {"Last Name": "Ramesh"}, {"Company": "Zoho"}, {"Website": "https://www.zoho.com"}]}} ] return result La respuesta en el bot se ve así: ### Respuesta con Archivo Este fragmento de código te permite enviar un archivo dentro de la tarjeta en la respuesta de ConvoKraft. #### JSON { "message": "FILE Response", "card": [ { "type": "file", "name": "SamplePDF", "format": "pdf", // Extensión de archivo "content": "https://pdfobject.com/pdf/sample.pdf" } ] } #### Java public class ExecuteHandler { public JSONObject handleExecuteRequest(JSONObject reqBody) { JSONObject jsonResponse = new JSONObject(); jsonResponse.put("card", new JSONArray() .put(new JSONObject().put("type", "file").put("name", "SamplePDF").put("format", "pdf").put("content", "https://pdfobject.com/pdf/sample.pdf")));return jsonResponse; } #### Node.js export default function handleExecute(request) { let result={}; result.card=[]; result.card.push({ "type":"file", "name":"SamplePDF", "format":"pdf", // Extensión de archivo "content":"https://pdfobject.com/pdf/sample.pdf" }) return result; } #### Python def handle_execute_request(req_body): result = {} result['card'] = [ {"type": "file", "name": "SamplePDF", "format": "pdf", "content": "https://pdfobject.com/pdf/sample.pdf"} ] return result La respuesta en el bot se ve así: -------------------------------------------------------------------------------- title: "Gestionar una acción" description: "Conoce las acciones de Catalyst ConvoKraft que pueden configurarse para que los bots las ejecuten, como responder directamente a consultas o ejecutar una lógica de negocio para obtener datos o realizar una tarea." last_updated: "2026-07-02T09:34:15.860Z" source: "https://docs.catalyst.zoho.com/es/convokraft/help/actions/manage-an-action/" service: "ConvoKraft" -------------------------------------------------------------------------------- # Ver una acción Una acción es una capacidad individual o una tarea que el bot realiza cuando das una instrucción como parte de tu conversación. Para crear una acción, consulta esta página. Las acciones creadas se mostrarán en la sección Actions en la página de detalles del Bot como se muestra en la captura de pantalla a continuación. Estas acciones pueden segregarse de la siguiente manera usando el filtro de la sección Actions: * **Active**: Acciones que están creadas y disponibles para usar, que se moverán a producción al hacer clic en el botón deploy. * **Inactive**: Acciones que no están disponibles para usar en el entorno de desarrollo tras su desactivación, pero están disponibles para chat en el entorno de producción, si fueron publicadas anteriormente antes de desactivarlas. # Gestionar una acción Una vez que hayas configurado las oraciones de ejemplo y los parámetros requeridos para una acción, puedes editar la acción desde la página de detalles de la acción como se muestra en la captura de pantalla a continuación: También puedes desactivar una acción de tu bot pasando el cursor sobre el ícono de puntos suspensivos y haciendo clic en Deactivate. -------------------------------------------------------------------------------- title: "Seguimientos de Acciones" description: "Conoce las acciones de Catalyst ConvoKraft que pueden configurarse para que los bots las ejecuten, como responder directamente a consultas o ejecutar una lógica de negocio para obtener datos o realizar una tarea." last_updated: "2026-07-02T09:34:15.860Z" source: "https://docs.catalyst.zoho.com/es/convokraft/help/actions/action-followups/" service: "ConvoKraft" -------------------------------------------------------------------------------- # Seguimientos de Acciones Los seguimientos de acciones definen lo que el bot debe recomendar al usuario después de ejecutar una acción, con el fin de mantener al usuario involucrado en la conversación. El bot puede mostrar una lista de sugerencias o preguntar si debe invocar otra acción, que podría ser contextualmente útil para el usuario después de completar una acción específica. Las acciones configuradas como seguimientos pueden ser la misma acción o acciones diferentes, siempre que las acciones respectivas estén configuradas para ese bot de ConvoKraft correspondiente. Al configurar seguimientos de acciones, se puede hacer que el bot sugiera proactivamente más formas en que el usuario puede interactuar con el bot de ConvoKraft. Esto puede facilitar que el usuario active fácilmente la siguiente acción que sería contextualmente útil, después de la ejecución de una acción. Al configurar tales acciones contextualmente útiles como seguimientos, el bot mostrará inmediatamente una lista de sugerencias predefinidas cuando se complete la ejecución de la acción actual. Cuando el usuario selecciona una sugerencia apropiada, la acción configurada para esa sugerencia se invocará como la siguiente acción. **Ejemplo:** Considera un bot creado para una aplicación de gestión de tareas. Después de crear una nueva tarea, sería contextualmente apropiado mostrar las siguientes sugerencias al usuario: **"Start this task"**, **"Show my open tasks"**, **"Mark this task as Important"** y así sucesivamente. Si el usuario hace clic en **"Mark this task as Important"**, se invocaría la acción para actualizar el estado de la tarea. Puedes configurar los seguimientos de acciones ya sea proporcionando directamente la lista de acciones o obteniendo las acciones dinámicamente durante la ejecución. La funcionalidad de seguimientos de acciones se aplica de la misma manera a las acciones configuradas para responder con una respuesta directa y ejecutar una lógica de negocio. <br> ### Sugerencias de seguimiento estáticas Si deseas configurar los seguimientos de acciones de forma estática sin usar código, sigue los pasos a continuación: 1. Haz clic en una acción existente en la consola, se mostrará la página de detalles de la acción. Puedes consultar esta página para crear una acción. Haz clic en Add Followup Suggestions en la sección Followup Suggestions. 2. En la ventana emergente de Followup Suggestions, haz lo siguiente: * Ingresa los textos de sugerencia apropiados en el cuadro de texto de la sección Suggestions. * Haz clic en el desplegable de la sección Mapped Actions y selecciona la acción apropiada para mapear con el texto de sugerencia dado. Esto permitirá que la acción se ejecute cuando el usuario haga clic en la sugerencia. También puedes agregar más sugerencias y mapearlas con sus acciones apropiadas. Nota: Se puede agregar un máximo de cinco sugerencias como sugerencias de seguimiento a una acción. 3. Haz clic en el botón Update después de configurar los textos de sugerencia requeridos y sus acciones mapeadas. Las sugerencias de seguimiento configuradas se listarán en la sección Followup Suggestions. 4. Para realizar cambios en la lista de sugerencias de seguimiento existente, haz clic en Configure en la sección Followup Suggestions. Desde allí, puedes actualizarlas según sea necesario. Nota: Si una acción particular configurada como sugerencia de seguimiento fue desactivada/eliminada, entonces esa acción se eliminará de la lista de Followup Suggestions automáticamente. Las sugerencias de seguimiento aparecerían en la ventana de chat como se muestra a continuación: <br> ### Sugerencias de seguimiento dinámicas Para hacer que tu bot de ConvoKraft muestre una lista de sugerencias dinámicamente en tiempo de ejecución como seguimiento, necesitarás pasarlas como un valor de mapa a la clave followup de la salida de la función Execution, como se muestra a continuación: También puedes establecer los valores de parámetros para la acción de seguimiento para que no se soliciten nuevamente al usuario durante la ejecución de esa acción. { "followup":{ "suggestions":[ { "message":"//sugerencia de chat que se mostrará al usuario", "action":{ "name":"//espacio de nombres de la acción a invocar", "params":[ { "name":"//nombre_del_parámetro", "value":"//valor_del_parámetro" } //agregar otros parámetros según sea necesario ] } } //agregar otras sugerencias según sea necesario ] } } <br> ### Solicitar la invocación de otra acción En algunos casos, una acción sería más apropiada de ejecutar después de una acción en lugar de múltiples acciones. Al configurar esta acción con las sugerencias predefinidas como seguimiento, el bot mostraría esa acción específica junto con una lista de sugerencias predefinidas y le preguntaría al usuario con un mensaje de solicitud para invocar la siguiente acción. El usuario puede seleccionar la sugerencia requerida o responder a la solicitud con un mensaje apropiado, y continuar con la conversación. **Ejemplo:** Considera un bot de gestión de tareas. El usuario podría querer ver su siguiente tarea. Después de ver la siguiente tarea, sería contextual preguntarle, **"Would you like to start this task?"** junto con las sugerencias apropiadas para esta solicitud como, **"Yes, mark this task as started"**, **"No thanks"**, **"No, I'll start this task later"**. El usuario puede seleccionar una sugerencia apropiada o responder a esta solicitud con un mensaje apropiado para invocar la acción que iniciaría esa tarea. Si la acción de seguimiento tiene muchos parámetros, y deseas que tu bot solicite un parámetro particular por su valor como primero entre otros parámetros, entonces puedes especificar ese nombre de parámetro en la configuración de la acción de seguimiento. También puedes establecer los valores de parámetros para la acción de seguimiento para que no se soliciten nuevamente al usuario durante la ejecución de esa acción. Nota: Se puede configurar un máximo de cinco sugerencias en la lista de sugerencias. Para hacer que tu bot de ConvoKraft solicite al usuario invocar cualquier acción particular como seguimiento, debes pasar los detalles de la acción como un valor de mapa a la clave followup de la salida de la función Execution como se muestra en el formato a continuación: { "followup":{ "prompt":{ "message":"//mensaje que se le debe solicitar al usuario", "suggestions":["//suggestion_text1", "//suggestion_text2", ... "//suggestion_text5"], "reject_message":"//mensaje que se muestra cuando el usuario responde con una frase negativa para cancelar el prompt", "param":"//nombre del parámetro cuyo valor se solicita primero al ejecutar esta acción", "action":{ "name":"//espacio de nombres de la acción a invocar", "params":[ { "name":"//nombre_del_parámetro", "value":"//valor_del_parámetro" } //agregar otros parámetros según sea necesario ] } } } } -------------------------------------------------------------------------------- title: "Probar una acción" description: "Aprende cómo probar una acción configurada para tu bot de ConvoKraft simplemente interactuando con él en inglés conversacional." last_updated: "2026-07-02T09:34:15.861Z" source: "https://docs.catalyst.zoho.com/es/convokraft/help/actions/test-an-action/" service: "ConvoKraft" -------------------------------------------------------------------------------- # Probar una Acción Para asegurarte de que tu acción no tenga problemas funcionales, debes probar tu acción antes de desplegarla a producción. Además, también puedes verificar la experiencia del usuario y asegurarte de que funcione como se espera. Para probar tu acción antes de desplegarla, puedes hacer clic en Test this bot para usar la ventana de chat de ejemplo en el panel lateral derecho de la página Edit Execution Functions. Esta ventana de chat de ejemplo se vería similar a la ventana de chat real de tu bot en producción. Usando esto, puedes probar solo la acción actual. Si la oración de invocación dada es irrelevante para la acción actual, el bot no podrá comprenderla y responderá con un mensaje indicando que no entiende tu mensaje. Nota: Solo puedes probar la acción actual en esta ventana, y no todas las acciones configuradas de tu bot. ### Override Session Data Si tus funciones usan el argumento sessionData en su lógica de negocio, entonces puedes probar tu acción con diferentes conjuntos de datos de sesión simulados usando la opción Override Session Data disponible en la esquina superior derecha de la ventana de chat. Por ejemplo, si has escrito alguna lógica de código específica para el cliente web, puedes establecer los valores de datos de sesión apropiados y simular cómo funcionaría la lógica si el bot estuviera siendo accedido desde un cliente web real en producción. Una vez que proporciones valores apropiados a los atributos y los guardes, los valores configurados se pasarán al argumento sessionData de la siguiente conversación. #### Descripción General -------------------------------------------------------------------------------- title: "Introducción" description: "Conoce las acciones de Catalyst ConvoKraft que pueden configurarse para que los bots las ejecuten, como responder directamente a consultas o ejecutar una lógica de negocio para obtener datos o realizar una tarea." last_updated: "2026-07-02T09:34:15.861Z" source: "https://docs.catalyst.zoho.com/es/convokraft/help/actions/overview/introduction/" service: "ConvoKraft" -------------------------------------------------------------------------------- # Actions - Introducción ### Descripción general Una acción es una capacidad individual o una tarea que el bot realiza cuando das una instrucción como parte de tu conversación. Por ejemplo, puedes pedirle al bot que obtenga tus citas del día o que programe una reunión en tu calendario. Para completar una acción, el bot puede hacer algunas preguntas que son necesarias para cumplir la acción. Por ejemplo, la conversación de una acción típica de programar reunión se ve así: User : Schedule a meeting to discuss about the Zylker deal by 11 AM tomorrow. <br> ConvoKraft Bot : Sure, when would the meeting get over? <br> User : By 12 PM. <br> ConvoKraft Bot : Where is the meeting happening? <br> User : At the headquarters. <br> ConvoKraft Bot : Okay, I have added the meeting to your calendar. Por lo tanto, una acción no es necesariamente un solo intercambio de mensajes entre el usuario y el bot. Puede tener múltiples mensajes intercambiados entre el usuario y el bot para lograr una sola tarea. En el ejemplo mencionado anteriormente, el bot programaría una reunión ejecutando la lógica de negocio configurada. <br> ### Tipos de acciones Según la intención, las acciones pueden clasificarse en dos tipos: #### Responder directamente una pregunta Estas acciones dan una respuesta directa a una pregunta estática formulada sin realizar ninguna operación ni ejecutar una lógica de negocio. Generalmente se resuelven con un solo intercambio conversacional y son universales, de modo que sus respuestas serían las mismas para todos los usuarios, zonas horarias, regiones o cualquier parámetro. **Pregunta de ejemplo: ¿Qué es ConvoKraft?** La respuesta a esta pregunta sería directa y la misma para cualquier usuario que haga la pregunta, sin involucrar ninguna lógica de negocio específica. Puedes configurar estas acciones definiendo oraciones de ejemplo relevantes para las acciones y las respuestas a preguntas específicas. Cuando el usuario interactúa con el bot de ConvoKraft, el bot buscará estas acciones configuradas y si hay una coincidencia con la consulta del usuario, responderá con la respuesta directa configurada. #### Ejecutar una lógica de negocio Estas acciones instruirán al bot para construir dinámicamente la respuesta a la entrada del usuario obteniendo datos relevantes de las fuentes de datos especificadas. Esto implica ejecutar una lógica de negocio específica para la acción, y la respuesta puede variar según los datos y la lógica ejecutada. La ejecución de la lógica de negocio puede involucrar la realización de operaciones especificadas, generalmente para obtener, agregar, modificar o eliminar datos en una fuente de datos particular. La conversación también puede extenderse a múltiples mensajes para recopilar más entradas, dependiendo de la complejidad de la lógica de negocio. Puedes configurar estas acciones definiendo oraciones de ejemplo aplicables y los parámetros relevantes para las acciones de tu bot de ConvoKraft. **Preguntas de ejemplo:** 1. **¿Qué hay en mi agenda hoy?** Para responder esta pregunta, el bot obtendría datos de tu calendario y construiría su respuesta dependiendo de los datos obtenidos. 2. **Programar una reunión** Para programar una reunión, el bot solicitaría y obtendría los datos de entrada relevantes del usuario y crearía un evento en tu calendario. ### Flujo de ejecución de acciones 1. Cada vez que un bot recibe una entrada del usuario, ConvoKraft intenta comprenderla para detectar la intención de la entrada del usuario. Cuando entrenas un bot, las acciones configuradas serán utilizadas por ConvoKraft para formar nuevos modelos NLP y mejorar los modelos existentes que ayudan a potenciar la capacidad intelectual del bot para comprender la intención de cada acción. 2. El bot buscará las oraciones de ejemplo configuradas definidas para la acción. Si la intención de la entrada del usuario coincide con cualquiera de las intenciones de las acciones configuradas, entonces el bot puede solicitar al usuario más información para asociar valores a los parámetros que son necesarios para cumplir esa acción a través de una lógica de negocio, o puede proporcionar una respuesta directa en forma de conversación. 3. Si el usuario pide realizar una tarea que no tiene coincidencia con ninguna de las acciones del bot, entonces responderá basándose en la lógica configurada en la función Fallback message handler. 4. Según la lógica de negocio configurada, ConvoKraft invocará la URL del Webhook, la Deluge Function, o la Catalyst Integration Function asociada con la acción particular, que a su vez ejecutará la lógica. 5. Finalmente, la respuesta a la acción se envía como respuesta al usuario en el bot de ConvoKraft de forma conversacional. -------------------------------------------------------------------------------- title: "Modelos de Acción" description: "Conoce las acciones de Catalyst ConvoKraft que pueden configurarse para que los bots las ejecuten, como responder directamente a consultas o ejecutar una lógica de negocio para obtener datos o realizar una tarea." last_updated: "2026-07-02T09:34:15.861Z" source: "https://docs.catalyst.zoho.com/es/convokraft/help/actions/overview/models/" service: "ConvoKraft" -------------------------------------------------------------------------------- # Modelos de Acción Un bot de ConvoKraft puede configurarse para realizar acciones mientras conversa con el usuario. Una acción de un bot se caracteriza por sus oraciones de ejemplo, parámetros y bot logic. Las acciones configuradas para responder con una respuesta directa se definen con sus oraciones de ejemplo relevantes. Por otro lado, las acciones que ejecutan bot logic pueden requerir entradas del usuario para realizar ciertas operaciones, lo que requiere que configures parámetros para las acciones junto con las oraciones de ejemplo. ### Oraciones de ejemplo Las oraciones de ejemplo son las invocaciones de ejemplo que los usuarios finales dirían para invocar una acción particular en su lenguaje conversacional. Estas oraciones de ejemplo ayudan a mejorar la inteligencia de ConvoKraft para comprender mejor la entrada del usuario. A continuación se enumeran algunas oraciones de ejemplo típicas que pueden configurarse para crear un evento: * **"Create an event"** * **"Schedule a meeting"** En la práctica, los usuarios mencionarán datos como parte de las instrucciones de invocación, por lo que las oraciones de ejemplo también pueden incluir ciertos valores de parámetros. Como en los ejemplos a continuación, un usuario puede mencionar el título del evento, la hora de inicio y la hora de finalización como parte de su oración de invocación inicial al intentar programar un evento. * **"Create an event from 5 PM to 6 PM to discuss about the Zylker deal."** * **"Schedule a meeting with John at 5 PM."** Si la oración de invocación no contiene todos los parámetros requeridos, el bot solicitará al usuario esos valores de parámetros requeridos. Las oraciones de ejemplo definen la intención de una acción particular, y los parámetros definen las entidades que serían necesarias para cumplir esa acción. Así, el modelo de datos de cualquier acción de ConvoKraft se obtiene usando la combinación de oraciones de ejemplo y parámetros. Para aprender más sobre las oraciones de ejemplo y su importancia en la configuración de acciones, consulta esta página. ### Params Los parámetros son los datos de entrada necesarios para cumplir o ejecutar una acción. Por ejemplo, los parámetros de una acción configurada para crear un evento en tu calendario serían típicamente el título del evento, la hora de inicio, la hora de finalización, el lugar del evento, y más. Para aprender más sobre los parámetros y sus tipos, consulta aquí. ### Bot logic El flujo conversacional y la ejecución de una acción depende de la lógica de negocio (o bot logic) definida para ella. ConvoKraft soporta las siguientes plataformas de desarrollo para definir el bot logic de una acción: * Catalyst Functions * Deluge Functions * Webhooks Todos los parámetros declarados de una acción se pasan a la lógica de negocio para ejecutar la acción. Además de los parámetros declarados, otros datos del entorno (como detalles sobre el usuario o la aplicación cliente) que serían necesarios para ejecutar la lógica de negocio también se pasarán como argumentos de entrada a estas funciones. 1. **Catalyst Functions** Las Catalyst Functions son estructuras de código personalizadas que contienen la lógica de negocio compleja de tu aplicación de Catalyst. Las Catalyst Integration Functions te permiten codificar y usar una función de Catalyst como backend de otros servicios de Catalyst o Zoho y establecer una integración con ellos. Cuando invocas la acción en ConvoKraft, esta invocará automáticamente la Integration Function configurada a través de una llamada HTTP. Al usar Catalyst Functions, tu lógica de negocio puede definirse en los siguientes entornos de programación: * **Java** * **Node.js** * **Python** Puedes crear una Catalyst Function navegando al servicio Serverless en tu consola o incluso usar el Catalyst CLI para crear y codificar tus funciones desde el entorno local. Las Catalyst Functions son altamente escalables y eficientes. La infraestructura del servidor en la que se alojan las funciones es manejada completamente por Catalyst, eliminando la necesidad de que gestiones el backend y permitiéndote solo trabajar en el desarrollo de la lógica de negocio. Además de proporcionar backends potentes para tus aplicaciones, las Catalyst Functions son robustas y confiables por naturaleza, proporcionando una integración fluida con ConvoKraft. Para aprender más sobre el uso de Catalyst Functions para definir la lógica de negocio de tus acciones de ConvoKraft, consulta aquí. 2. **Deluge Functions** Deluge es el lenguaje de scripting en línea nativo del entorno en la nube de Zoho. Tiene una sintaxis amigable que permite una integración fluida entre dos servicios de Zoho, o con un servicio de terceros. La lógica de negocio de las acciones de ConvoKraft debe escribirse en Deluge a través de las siguientes plantillas de funciones predefinidas: * Execution (obligatoria): Esta es la función principal involucrada en la ejecución de todas las acciones de un bot de ConvoKraft. * Context Handler (opcional): Esta función se invoca para cada entrada del usuario durante una acción. Puede usarse para cambiar el orden de los parámetros en el flujo conversacional, omitirlos si es necesario, o incluso realizar validaciones personalizadas. * Button Click (opcional): Esta función puede usarse para definir la lógica de negocio de una tarjeta de botón. Es parte del tipo de función de ejecución que se enfoca en la implementación de botones personalizados. Estas funciones se alojan en la nube de Zoho y se ejecutarán en sus respectivos puntos de invocación durante la ejecución de una acción. Similar a las Catalyst Functions, las funciones de Deluge también son altamente eficientes, y su alojamiento y mantenimiento son manejados completamente por Zoho. Puedes aprender más sobre el uso de funciones de Deluge para definir la lógica de negocio de tus acciones de ConvoKraft aquí. 3. **Webhooks** En el caso de los webhooks, puedes codificar la lógica backend en una plataforma externa e invocarla a través de los webhooks configurados dentro de ConvoKraft. La lógica de negocio de las acciones debe construirse, gestionarse y alojarse externamente en un servidor público que sea accesible para ConvoKraft. Se te requerirá usar APIs REST para acceder a la lógica desde los bots que construyas. La URL del Webhook configurada será invocada por ConvoKraft en los puntos de invocación apropiados durante la ejecución de la acción. Al usar webhooks, tu lógica de negocio puede definirse en cualquier lenguaje de programación conveniente de tu elección. Pero, a diferencia de Deluge y Catalyst Functions, al usar webhooks tendrás que gestionar la configuración y setup de la infraestructura completamente por tu cuenta. Aprende más sobre el uso de webhooks para definir la lógica de negocio de tus acciones de ConvoKraft en esta página. #### Lógica del bot -------------------------------------------------------------------------------- title: "Funciones de integración de Catalyst" description: "Conoce las Catalyst Integration Functions y úsalas para codificar la lógica de negocio de tu bot de ConvoKraft." last_updated: "2026-07-02T09:34:15.864Z" source: "https://docs.catalyst.zoho.com/es/convokraft/help/actions/bot-logic/catalyst-integration-functions/" service: "ConvoKraft" -------------------------------------------------------------------------------- # Catalyst Integration Functions # Introducción Las Catalyst Integration Functions te permiten codificar la lógica de negocio de otros servicios de Zoho o Catalyst, y usarlas como backend para establecer una integración entre ambos. Cuando se accede a una funcionalidad particular en el servicio asociado, se invocará automáticamente la ejecución de la Integration Function codificada en Catalyst a través de una llamada HTTP. Puedes codificar la lógica de negocio de la funcionalidad backend del servicio en las siguientes plataformas soportadas por Catalyst: * **Java** * **Node.js** * **Python** La lógica de negocio que construyes con Catalyst Functions para tus bots de ConvoKraft se llama bot logic, y es del tipo Integration Function. Puedes inicializar una Catalyst Integration Function desde el CLI, trabajar en ella en tu entorno local, servirla para probarla, o desplegarla en la consola remota. La función puede entonces asociarse con el bot que crees. Al usar Catalyst Integration Functions, también podrás aprovechar otras funcionalidades de Catalyst que te permiten ver los logs o informes de las ejecuciones de funciones a través de Catalyst Logs o Application Performance Monitoring. Puedes aprender más sobre las Catalyst Integration Functions en detalle en esta página. <br> ### Integración con ConvoKraft Las Integration Functions de ConvoKraft te permiten codificar la lógica de negocio de tus bots de ConvoKraft y la agrupan a través de los siguientes handlers de ConvoKraft: **1. Welcome Message Handler**: Te permite configurar la respuesta que se mostrará al abrir una nueva sesión de chat. **2. Fallback Handler**: Te permite configurar la respuesta que se mostrará cuando el bot no logre comprender las entradas del usuario. **3. Failure Handler**: Te permite configurar la respuesta que se mostrará cuando ocurra una excepción en el mensaje del usuario en la conversación. ### Estructura de la función Cuando creas una Integration Function, Catalyst proporciona un código de plantilla base sobre el cual puedes construir tu lógica de negocio. Puedes usar las plantillas respectivas para construir tu lógica de negocio en los entornos de programación Java, Node.js y Python. Para aprender más sobre la estructura completa del directorio de funciones para todos los stacks soportados en Catalyst, consulta esta página. Discutiremos más sobre cómo crear una Integration Function en Catalyst más adelante en esta página. ## Java La estructura de archivos de Java contiene el archivo Java principal, el archivo ExecuteHandler que contiene la lógica de negocio principal de las ejecuciones de acciones, y también los otros archivos de handler y configuración. Los archivos mencionados anteriormente y el código de plantilla base estarán disponibles automáticamente en tu directorio de funciones cuando inicialices una Java Integration Function de tipo ConvoKraft desde el CLI. Para aprender más sobre la inicialización de una función de Catalyst desde el CLI, consulta aquí. Una vez completada la inicialización, puedes proceder a codificar tu bot logic, probarla localmente y luego desplegar la función de Catalyst. ## Node.js La estructura de archivos de Node contiene un archivo de función principal junto con los archivos de handler, los módulos de node y los archivos de configuración. Los archivos mencionados anteriormente y el código de plantilla base estarán disponibles automáticamente en tu directorio de funciones cuando inicialices una Node.js Integration Function de tipo ConvoKraft desde el CLI o la consola. Puedes crear una Integration Function de ConvoKraft desde la consola de Catalyst siguiendo los pasos mencionados aquí. Para aprender más sobre la inicialización de una función de Catalyst desde el CLI, consulta aquí. Una vez completada la inicialización, puedes proceder a codificar tu bot logic, probarla localmente y luego desplegar la función de Catalyst. ## Python Similar a Java y Node.js, la estructura de archivos de Python contiene archivos de función principales, archivos de funciones handler, archivos de configuración y adicionalmente los archivos de módulos de Python. El archivo requirements.txt contiene la lista de dependencias instaladas que son necesarias para implementar la función de Python de Catalyst. Puedes aprender más sobre el uso del archivo requirements.txt en esta página. Similar a las funciones de Java, puedes inicializar una función de Python desde el Catalyst CLI. Una vez que inicialices una Python Integration Function de tipo ConvoKraft, los archivos mencionados anteriormente y el código de plantilla base estarán disponibles automáticamente en el directorio de funciones correspondiente en tu entorno local. Una vez completada la inicialización, puedes proceder a codificar tu bot logic, probarla localmente y luego desplegar la función de Catalyst. Nota: No podrás codificar funciones de Java y Python directamente desde el editor de la consola. Solo podrás trabajar con funciones de Node.js desde el editor. Alternativamente, puedes trabajar con funciones de Java y Python desde un entorno local, y subir el paquete de código correspondiente a la consola. <br> ### Formato de solicitud ConvoKraft envía la solicitud en el siguiente formato a la Catalyst Integration Function: { "todo": "prompt || execute || fallback || button", "bot" : "", "action" : "", "button_id" : "", "environment" : "development || production" "params":{ }, "userInput" : "", "previousParam" : "", "user" : {}, "org" : {}, "broadcast" : {}, "cache" : {}, "sessionData" : {} "clientData" : {} } <br> ### Formato de respuesta ConvoKraft espera que la respuesta esté en el siguiente formato desde la Catalyst Integration Function, para que pueda comprender y transmitir la respuesta prevista al usuario. ConvoKraft soporta múltiples tipos de respuesta para mostrar contenido en diversos formatos. Debes asegurarte de seguir los estándares definidos al configurar las respuestas. Para más información sobre las estructuras de respuesta, consulta esta sección. **Caso 1**: Cuando se debe solicitar un parámetro de entrada al usuario { "status" : "prompt", "prompt" : { "param_name" : "leave_type", "options":[ { "id" : "111" ,"label" : "", "image" : "image_url"}, {"id" : "112" ,"label" :"" ,"image" : "image_url"} ], "buttons" : [] }, "message" : "You don't have enough casual leaves. Please choose some other leave type.", "data" : {} } **Caso 2**: Cuando se debe mostrar un mensaje de salida al usuario { "status" : "execution", "message":"Please check your screen.", "card":[], "data":{}, "broadcast":{}, "trigger":{}, "followup" : {} } Hay algunas restricciones a considerar con las respuestas recibidas de la Catalyst Integration Function, tales como: * El tamaño máximo de la respuesta es 3 MB. * La duración máxima del tiempo de espera de la solicitud es 15 segundos. Si la respuesta no cumple con las directrices anteriores, se enviará un mensaje de fallo como respuesta al usuario. <br> ### Implementación Puedes crear una Catalyst Integration Function ya sea desde la consola de Catalyst o el CLI. Asegúrate de seguir los pasos a continuación para crear una Integration Function desde la consola. Puedes consultar esta página para los pasos para crear una función desde el CLI. 1. Para crear una Catalyst Integration Function directamente desde la consola de Catalyst, navega al ícono de Serverless en el panel izquierdo de la consola de Catalyst y haz clic en Create Function. 2. Proporciona un nombre significativo para la función y elige Integration como el tipo de función y selecciona ConvoKraft como el servicio de Zoho. Puedes elegir codificar tu lógica en los entornos de programación Java, Node.js o Python. Haz clic en Create para crear una nueva Catalyst Integration Function. Nota: No podrás codificar funciones de Java y Python desde el editor de la consola. Solo podrás trabajar con funciones de Node.js. Puedes trabajar con funciones de Java y Python desde un entorno local, y subir el paquete de código correspondiente a la consola usando la opción File Upload 3. Puedes cambiar a la pestaña Code tab para comenzar a escribir la lógica de negocio de tu bot. Después de codificar la lógica de negocio, haz clic en Save. Una vez que hayas desarrollado la lógica de negocio de tu bot de ConvoKraft, puedes mapear la Catalyst Integration Function apropiada como la plataforma de desarrollo al crear un bot o incluso después desde la página de detalles del Bot. La Integration Function asociada se ejecutará al invocar las acciones configuradas en el bot. -------------------------------------------------------------------------------- title: "Webhooks" description: "Conoce los webhooks y úsalos para acceder a la lógica de negocio de tu bot de ConvoKraft codificada en cualquier servidor externo de acceso público." last_updated: "2026-07-02T09:34:15.864Z" source: "https://docs.catalyst.zoho.com/es/convokraft/help/actions/bot-logic/webhooks/" service: "ConvoKraft" -------------------------------------------------------------------------------- # Webhooks # Introducción Los webhooks son activadores automatizados iniciados entre dos aplicaciones ante la ocurrencia de un evento predefinido. En nuestro caso, si eliges tener tu lógica de negocio en cualquier servidor externo, puedes optar por webhooks como la plataforma de desarrollo. Debes asegurarte de que el servidor externo sea accesible públicamente para ConvoKraft a través de una API REST. Para ejecutar la lógica de negocio, la URL del Webhook configurada será invocada por ConvoKraft en los puntos de invocación correspondientes durante la ejecución de la acción. El servidor de Webhook debe cumplir con los siguientes formatos de solicitud y respuesta para el funcionamiento correcto del bot de ConvoKraft. ### Formato de Solicitud ConvoKraft envía la solicitud en el siguiente formato a la URL de Webhook configurada. { "todo": "prompt || execute || fallback || button", "bot" : "", "action" : "", "button_id" : "", "environment" : "development || production" "params":{ }, "userInput" : "", "previousParam" : "", "user" : {}, "org" : {}, "broadcast" : {}, "cache" : {}, "sessionData" : {} "clientData" : {} } ### Formato de Respuesta ConvoKraft espera que la respuesta esté en el siguiente formato desde la URL del Webhook, para que pueda comprender y transmitir la respuesta prevista al usuario. ConvoKraft soporta múltiples tipos de respuesta para mostrar contenido en diversos formatos. Debes asegurarte de seguir los estándares definidos al configurar las respuestas. Para más información sobre las estructuras de respuesta, consulta esta sección. **Caso 1**: Cuando se debe solicitar un parámetro de entrada al usuario { "status" : "prompt", "prompt" : { "param_name" : "leave_type", "options":[ { "id" : "111" ,"label" : "", "image" : "image_url"}, {"id" : "112" ,"label" :"" ,"image" : "image_url"} ], "buttons" : [] }, "message" : "You don't have enough casual leaves. Please choose some other leave type.", "data" : {} } **Caso 2**: Cuando se debe mostrar un mensaje de salida al usuario { "status" : "execution", "message":"Please check your screen.", "card":[], "data":{}, "broadcast":{}, "trigger":{}, "followup" : {} } Hay algunas restricciones a considerar con las respuestas recibidas de las URLs de Webhook, tales como: * El tamaño máximo de la respuesta es 100 KB. * La duración máxima del tiempo de espera de la solicitud es 5 segundos. Si la respuesta no cumple con las directrices anteriores, se enviará un mensaje de fallo como respuesta al usuario. ### Proteger las Llamadas de Webhook Las solicitudes de Webhook pueden protegerse para que el servidor de Webhook pueda validar si la solicitud proviene de ConvoKraft, evitando así el procesamiento de solicitudes no confiables. ConvoKraft usa el criptosistema Digital Signature Algorithm (DSA) para generar claves de seguridad, que deben ser utilizadas por el servidor de Webhook para validar la solicitud. # Flujo de validación de seguridad 1. Una vez que optas por proteger tus llamadas de webhook al elegir la plataforma de desarrollo, ConvoKraft genera automáticamente una clave privada y una clave pública basadas en el criptosistema DSA. Ambas claves se cifran y se almacenarán en los servidores de ConvoKraft, y solo la clave pública se expondrá al desarrollador en la consola de Catalyst. 2. Al enviar una solicitud al servidor de Webhook, ConvoKraft genera una firma digital usando la clave privada almacenada y envía la firma en el encabezado de la solicitud X-CONVOKRAFT-SIGNATURE. Cuando el usuario escribe un mensaje en la ventana de chat, el mensaje se cifra con la clave privada y se envía en el cuerpo de la solicitud al servidor de webhook junto con la firma digital en el encabezado. 3. Cuando el servidor de Webhook recibe este mensaje, hace una comparación de la firma digital recibida en la solicitud y la firma original creada usando la clave pública cifrada. Si se encuentra una discrepancia, significa que el mensaje ha sido manipulado. ### Implementación Una vez que creas un bot, puedes elegir webhooks como la plataforma de desarrollo y seguir los pasos a continuación: 1. Ingresa la URL del webhook de tu servidor externo en el que reside el código de la lógica de negocio. Al ejecutar las acciones configuradas del bot, se accederá a esta URL. 2. Puedes elegir invocar la URL del webhook ya sea al final de cada mensaje del usuario en la conversación o cada vez que termina un contexto particular de la conversación. 3. Una vez creado el bot, podrás ver la página de detalles del Bot que lista la información crucial de tu bot de ConvoKraft. Para ver la clave pública generada, haz clic en el botón Show key en la página de detalles del Bot. Al hacer clic en la opción Show key, la ventana emergente Security Key mostrará la clave pública. Esta clave pública se utilizará en el entorno de desarrollo inmediatamente. Se utilizará en el entorno de producción una vez que despliegues tu proyecto de Catalyst. ##### Funciones de Deluge -------------------------------------------------------------------------------- title: "Definir Deluge Functions" description: "Aprende sobre las Deluge functions y úsalas para codificar la lógica de negocio de tu bot de ConvoKraft." last_updated: "2026-07-02T09:34:15.864Z" source: "https://docs.catalyst.zoho.com/es/convokraft/help/actions/bot-logic/deluge-functions/defining-deluge-functions/" service: "ConvoKraft" -------------------------------------------------------------------------------- # Definir Deluge Functions Deluge es el lenguaje de scripting en línea nativo del entorno en la nube de Zoho. Puedes usar Deluge para escribir tu lógica de negocio y automatizar acciones en múltiples aplicaciones de Zoho, así como habilitar la integración con un servicio externo de terceros. También contienen un paquete de funciones integradas para realizar tareas comunes, con las cuales podrías construir rápidamente la lógica de tu aplicación y facilitar características mejoradas en tus aplicaciones. Deluge tiene una sintaxis amigable que te permite construir aplicaciones potentes de manera rápida. Puedes codificar sin problemas la lógica del backend de tus bots de ConvoKraft usando Deluge functions. Obtén más información sobre los tipos de datos soportados por las Deluge functions en esta página. ConvoKraft proporciona las siguientes Deluge functions predefinidas, cada una con su propio propósito y puntos de invocación, para definir la lógica de negocio de tus bots. * Execution function * Context Handler function * Button Click function <br> ### System-Defined Input Arguments Los siguientes argumentos de entrada definidos por el sistema están disponibles para todos los tipos de Deluge function predefinidos: <table class="content-table"> <thead> <tr> <th>Argumento</th> <th>Tipo de dato Deluge</th> <th>Descripción</th> </tr> </thead> <tbody> <tr> <td>sessionData</td> <td>Map</td> <td>Contiene los detalles del cliente que aloja la sesión de chat actual. Para obtener más información sobre este argumento, consulta aquí.</td> </tr> <tr> <td>cache</td> <td>Map</td> <td>Una variable de almacenamiento temporal que se usa para pasar datos entre funciones a lo largo del ciclo de ejecución de la acción. Para obtener más información sobre este argumento, consulta aquí.</td> </tr> <tr> <td>broadcast</td> <td>Map</td> <td>Una variable de almacenamiento que se usa para pasar datos entre diferentes acciones mientras el usuario interactúa con el bot. Para obtener más información sobre este argumento, consulta aquí.</td> </tr> </tbody> </table> Además de los argumentos definidos por el sistema listados anteriormente, todos los params estáticos definidos en la consola para la acción también estarán disponibles como argumentos de entrada individualmente para cada Deluge function. ConvoKraft completará los valores apropiados para todas las variables y los pasará como argumentos de entrada para todas las funciones. <br> # Codificar Deluge Functions Puedes codificar las Deluge Functions en el editor integrado proporcionado por ConvoKraft. Discutiremos en más detalle sobre el editor, su uso y características en esta sección. ### Overview of the Code Editor El editor de Deluge en ConvoKraft proporciona una experiencia unificada donde puedes realizar operaciones desde básicas hasta complejas, todo en el mismo lugar. Permite la creación de scripts arrastrando tareas y soltándolas en el área de scripting del editor. Provee acceso rápido para establecer variables, agregar declaraciones de información o comentarios, y también agregar declaraciones condicionales incluyendo if, else if y else. Adicionalmente, el editor te permite enviar notificaciones por correo electrónico y también publicar como notificaciones en Zoho Cliq (una plataforma de comunicación impulsada por Zoho). También puedes integrar con otros servicios de Zoho o con aplicaciones alojadas en servidores externos usando webhooks. Puedes crear colecciones, insertar datos en colecciones, obtener datos, actualizar, eliminar o recuperar cada elemento de la colección. Puedes obtener más información sobre el editor de Deluge en esta página. <br> # Validación de funciones ConvoKraft valida las Deluge functions en el editor automáticamente en cuanto a la corrección de sintaxis y valores de retorno. ### Syntax Validation La validación de sintaxis ocurre cada vez que intentas guardar una Deluge function. Si la validación de sintaxis falla debido a errores en tiempo de compilación, la función no se guardará y se mostrará un mensaje de error apropiado. Los errores en tiempo de compilación incluyen sintaxis incorrecta, puntuación, falta de inicialización de variables, entre otros. <br> ### Return Value Validation Además de las validaciones de sintaxis, los valores de retorno de las Deluge functions también serán validados para cada ejecución de función en el editor de código de ConvoKraft. Puedes aprender sobre el formato definido de valor de retorno para las Deluge functions en esta página. La validación de valores de retorno ocurre cuando ejecutas la acción probándola usando la ventana de chat del bot en la consola. Haz clic en Test this bot para comenzar a interactuar con él. ConvoKraft valida el tipo de dato de las claves en la respuesta tales como message,card,broadcast y followup. Asegúrate de cumplir obligatoriamente con todos los valores en el mapa de retorno de las Deluge functions para el funcionamiento adecuado de tu acción. Si el valor de retorno de tu función viola el formato especificado, se mostrará un mensaje de error con el elemento JSON que comete el error en la ventana de Logs. <br> ### Function Logs Cada log contiene al menos una de las siguientes etiquetas: * **INFO**: Muestra la depuración e imprime lo que se indica en el código. * **WARNING**: Muestra textos de advertencia cuando se detecta algo incorrecto o inusual. Por ejemplo, el uso de cualquier sintaxis obsoleta en el código. Las advertencias se ignorarán durante la ejecución de la acción. * **ERROR**: Muestra los errores que ocurren cuando se ejecuta el código. Por ejemplo, cualquier discrepancia de sintaxis o excepciones no manejadas. Los errores interrumpirán la ejecución de una acción y se lanzará un mensaje apropiado como respuesta. Puedes alternar entre los varios niveles de log en el editor para ver solo los logs respectivos. Nota: Los errores cometidos en todas las funciones en el flujo de una acción se mostrarán aquí, junto con los errores cometidos en la función que se está ejecutando. -------------------------------------------------------------------------------- title: "Referencia de objetos Deluge" description: "Aprende sobre las Deluge functions y úsalas para codificar la lógica de negocio de tu bot de ConvoKraft." last_updated: "2026-07-02T09:34:15.864Z" source: "https://docs.catalyst.zoho.com/es/convokraft/help/actions/bot-logic/deluge-functions/deluge-object-reference/" service: "ConvoKraft" -------------------------------------------------------------------------------- # Referencia de objetos Deluge La documentación de referencia de objetos Deluge tiene como objetivo dar una idea detallada sobre los diversos elementos de las Deluge functions en ConvoKraft. Los objetos principales soportados por ConvoKraft incluyen los objetos de acceso a datos, objetos de entrada y objetos de respuesta. Discutiremos cada uno de ellos en detalle en esta sección. # Objetos de acceso a datos ### sessionData Los detalles sobre la sesión de chat actual del cliente. Estos datos estarán disponibles para todas las funciones bajo el argumento sessionData. <table class="content-table"> <thead> <tr> <th>Tipo de dato Deluge</th> <th>Disponibilidad</th> </tr> </thead> <tbody> <tr> <td>Map</td> <td>En todas las funciones</td> </tr> </tbody> </table> Este argumento comprende las siguientes claves: <table class="content-table"> <thead> <tr> <th>Nombre de la clave</th> <th>Tipo de dato Deluge</th> <th>Descripción</th> <th>Valor de ejemplo</th> </tr> </thead> <tbody> <tr> <td>medium</td> <td>Text</td> <td>El modo de comunicación a través del cual el usuario interactúa con el bot. Los valores posibles son call o chat. </td> <td>chat</td> </tr> <tr> <td>client_host</td> <td>Text</td> <td>La naturaleza de la aplicación cliente que aloja el bot. Los valores posibles son mobile o web.</td> <td>web</td> </tr> <tr> <td>client_identifier</td> <td>Text</td> <td>El identificador único del cliente. <br> La URL de la aplicación web, si client_identifier es web. <br> El nombre del paquete o identificador del bundle de la aplicación móvil, si client_identifier es mobile. </td> <td>https://zylker.com</td> </tr> <tr> <td>client_data</td> <td>Map</td> <td>Los datos pasados desde el cliente a ConvoKraft al inicio de la sesión.</td> <td>{ "user_email": "todd@hmail.com" }</td> </tr> </tbody> </table> ### cache El objeto cache actúa como una variable de almacenamiento temporal. Cualquier dato almacenado en este objeto en forma de par clave-valor será accesible a través de todas las funciones de la acción en ejecución actual hasta que esa ejecución de acción se complete. <table class="content-table"> <thead> <tr> <th>Tipo de dato Deluge</th> <th>Disponibilidad</th> </tr> </thead> <tbody> <tr> <td>Map</td> <td>En todas las funciones</td> </tr> </tbody> </table> ### broadcast Si quieres que tu bot recuerde cualquier información relacionada con la acción en ejecución actual, la información puede almacenarse en el objeto broadcast. Este valor se retendrá incluso después de la ejecución de la acción actual, y estará disponible para todas las acciones subsiguientes hasta que la sesión de chat actual termine. Las acciones subsiguientes pueden usar este valor, según lo requiera la lógica de negocio. <table class="content-table"> <thead> <tr> <th>Tipo de dato Deluge</th> <th>Disponibilidad</th> </tr> </thead> <tbody> <tr> <td>Map</td> <td>En todas las funciones</td> </tr> </tbody> </table> #### messageData El objeto messageData contiene el mensaje personalizado enviado por el cliente para cada solicitud de transcript (un mensaje en la conversación del bot) en la clave data. <table class="content-table"> <thead> <tr> <th>Tipo de dato Deluge</th> <th>Disponibilidad</th> </tr> </thead> <tbody> <tr> <td>Map</td> <td>En todas las funciones</td> </tr> </tbody> </table> # Objetos de entrada ### param Los valores de entrada proporcionados por el usuario para cada param estático serían capturados bajo los objetos con el mismo nombre de param a través de las Deluge functions. <table class="content-table"> <thead> <tr> <th>Tipo de dato Deluge</th> <th>Disponibilidad</th> </tr> </thead> <tbody> <tr> <td>Tipo de dato correspondiente al param</td> <td>En la Context handler function y la Action execution function</td> </tr> </tbody> </table> ### previousParam El objeto previousParam contiene el param que fue solicitado por última vez al usuario. La última respuesta del usuario se establecerá como valor para este param. <table class="content-table"> <thead> <tr> <th>Tipo de dato Deluge</th> <th>Disponibilidad</th> </tr> </thead> <tbody> <tr> <td>Tipo de dato correspondiente al param</td> <td>Solo en la Context Handler function</td> </tr> </tbody> </table> # Objetos de respuesta ### card La card puede usarse para dar un mensaje con formato visual como respuesta al usuario. Una card es una colección de elementos visuales, como tablas e imágenes. El valor de esta clave es una lista de objetos de mapa. Cada objeto de mapa representa un elemento de UI en la card. Una sola card puede contener más de un elemento del mismo tipo. Cada elemento en la card se mostrará uno debajo del otro en el mensaje de respuesta. Las opciones de formato en línea como Bold, Italic, Underline, Strikethrough, Link y Highlight también son aplicables a los elementos de la card. Por lo tanto, cualquiera de estas opciones de formato mencionadas anteriormente puede usarse en los valores de texto en cualquiera de las cards siguientes. Los siguientes elementos de UI son soportados en la card de mensaje de respuesta de ConvoKraft: <table class="content-table"> <thead> <tr> <th class="w90p">Elemento</th> <th class="w70p">Formato</th> </tr> </thead> <tbody> <tr> <td>Note</td> <td> { "type" : "note", "content" : "&lt;Text content that needs to be displayed as a note.&gt;" } </td> </tr> <tr> <td>Title</td> <td> { "type" : "title", "content" : "&lt;Text content that needs to be displayed as the title&gt;" }</td> </tr> <tr> <td>List - Bullet & Numbered</td> <td> { "type" : "list", "format" : "bullet" or "numbered" "elements" : [ { "label" : "&lt;element_label&gt;" "preview" : { "header" : { "title" : "&lt;title_content&gt;" "description" : "&lt;description_content&gt;", "subheading" : "&lt;subheading_content&gt;", "image" : { "url" :"&lt;image_url&gt;" } }, "fields" :[ { "label" : "&lt;field labels&gt;" "value" : "&lt;field values&gt;" } //add other fields as necessary ] } } //add other elements as necessary ] } Nota: En la card list, se puede configurar un máximo de siete fields para un objeto preview. </td> </tr> <tr> <td>Table</td> <td> { "type": "table", "heading" : "&lt;Table Heading&gt;", "columns": [ "&lt;column1 header&gt;". "&lt;column2 header&gt;" "&lt;column3 header&gt;" ], "rows": [ [ "&lt;value al&gt;" "&lt;value a2&gt;" "&lt;value a3&gt;" ], [ "&lt;value b1&gt;" "&lt;value b2&gt;" "&lt;value b3&gt;" ] ] } </td> </tr> <td>Image</td> <td> { "type" : "image", "content" : "&lt;image url&gt;" } </td> </tr> <tr> <td>File</td> <td> { "type" : "file", "name" : "&lt;file_name&gt;", "format" : "pdf", //file extension "content": "&lt;file url&gt;" } </td> </tr> <tr> <td>Contact card</td> <td> { "type" : "vcard", "info" : { "image" : "<image url>", "fields" : [ { "First Name" : "Smith" }. { "Last Name" : "Gibbs" }, { "Company": "ABC Corp" }, { "Website" : "https://" } ] } } </td> </tr> <tr> <td>Link</td> <td> { "type" : "label", "content" : "&lt;URL link&gt;" } </td> </tr> <tr> <td>Button</td> <td> { "type" : "button", "label" : "&lt;button label&gt;". "theme" : "&lt;button theme&gt;" "id" : "&lt;button id&gt;", "onclick" : { "execute" : "function (or)clienthook", "function":"&lt;button click function name&gt;", "data" : {} } } 1. Para la clave theme, el valor puede ser positive, negative o neutral. 2. Para la clave execute, el valor puede ser cualquiera de los siguientes: * function - para ejecutar la Button Click function definida. * clienthook - para ejecutar el hook implementado por la aplicación cliente. Si clienthook se establece como valor de la clave execute, entonces la clave function no es requerida. 4. Para la clave data, establece cualquier valor que necesite ser pasado a la button click function. Nota: Se puede configurar un máximo de tres buttons para una acción usando la card button. </td> </tr> </tbody> </table> -------------------------------------------------------------------------------- title: "Función de ejecución" description: "Aprende sobre las Deluge functions y úsalas para codificar la lógica de negocio de tu bot de ConvoKraft." last_updated: "2026-07-02T09:34:15.866Z" source: "https://docs.catalyst.zoho.com/es/convokraft/help/actions/bot-logic/deluge-functions/execution-function/" service: "ConvoKraft" -------------------------------------------------------------------------------- # Execution Function # Introducción La Execution function es el punto final de la ejecución de una acción. Define el cumplimiento de una acción. Maneja la ejecución real de la acción y da un mensaje final de éxito o fallo al usuario, después de la finalización de una acción. La respuesta al usuario puede ser texto o elementos visuales como una colección de tarjetas. ### Invocation Point La Execution function se invoca en el punto final de una acción. Por defecto, el punto final de una acción viene después de que todos los valores de los params son solicitados y se completan con valores apropiados. Alternativamente, el punto final también puede ser activado desde la context handler function ("todo" : "execute"). Después de que la execution function es invocada, la acción se completa y cualquier conversación posterior del usuario se considerará como una nueva acción. # Input Arguments Los argumentos de entrada definidos por el sistema solo están disponibles como argumentos de entrada de la Execution function. ### Return Values La execution function retorna un mapa en el siguiente formato: { "message" : "The reply message.", "card" : { }, "broadcast" : { }, "followup" : { } } Las claves presentes en el mapa retornado por la execution function se explican a continuación: ### message Esto da un mensaje de texto como respuesta al usuario y esta clave es obligatoria. Las siguientes opciones de formato de texto son soportadas por ConvoKraft. Cualquiera de estas opciones puede ser usada en el mensaje de texto. <table class="content-table"> <thead> <tr> <th>Opción de formato</th> <th>Sintaxis</th> </tr> </thead> <tbody> <tr> <td>Bold</td> <td>*text*</td> </tr> <tr> <td>Italic</td> <td>_text_</td> </tr> <tr> <td>Underline</td> <td>__text__</td> </tr> <tr> <td>Strikethrough</td> <td>~text~</td> </tr> <tr> <td>Link</td> <td>[label](URL_link)</td> </tr> <tr> <td>Highlight</td> <td>`text`</td> </tr> <tr> <td>Heading</td> <td>h1 - #Heading h2 - ##Heading h3 - ###Heading h4 - ####Heading h5 - #####Heading</td> </tr> <tr> <td>Bullet list</td> <td>* first_item \n * second_item \n * third_item</td> </tr> <tr> <td>Numbered list</td> <td>1. first_item \n 2. second_item \n 3. third_item</td> </tr> <tr> <td>Image</td> <td>![alternate_text](image_URL)</td> </tr> <tr> <td>Blockquote</td> <td>!text</td> </tr> <tr> <td>Table</td> <td>| header1 | header2 | header3 | \n |------------|------------|------------| \n | value1 | value2 | value3 | \n | value1 | value2 | value3 |</td> </tr> </tbody> </table> El siguiente es un valor de ejemplo del argumento message: message : "Your event has been created successfully" ### card Esto da un mensaje con formato visual como respuesta al usuario. Una card es una colección de elementos visuales como tablas, imágenes y más. El valor de esta clave es una lista de objetos de mapa. Cada objeto de mapa representa un elemento de UI en la tarjeta. Una sola tarjeta puede contener más de un elemento del mismo tipo. Cada elemento en la tarjeta se mostrará uno debajo del otro en el mensaje de respuesta y esta clave es opcional. Para obtener más información sobre la lista de elementos de UI que son soportados en la card de mensaje de respuesta de ConvoKraft, consulta esta página. El siguiente es un valor de ejemplo del argumento card: "card" : { "type" : "note", "content" : "Your event details are displayed below" { "type" : "image", "image" : "event_details.png" } //agregar objetos de mapa } ### broadcast Esto pasará cualquier dato que el bot deba recordar después de ejecutar la acción actual. El valor debe estar en formato de mapa y estará disponible para todas las acciones consecutivas durante toda la sesión. Esta clave es opcional. Puedes obtener más información sobre broadcast en esta página. El siguiente es un valor de ejemplo del argumento broadcast. "broadcast" : { "user_level" : "admin", "status" : "booked" } ### followup Puedes configurar si el bot debe mostrar una lista de sugerencias o solicitar al usuario que invoque cualquier acción particular como seguimiento, después de completar la ejecución de la acción actual. Esta clave es opcional. Obtén más información sobre Action Followups y la estructura del valor de esta clave en esta página. El siguiente es un valor de ejemplo del argumento card: "followup":{ "suggestions":[ { "message":"Would you like to set a reminder for this event", "action":{ "name":"schedule remainder", "params":[ { "name":"event time", "value":"11:00 am" } //agregar otros parámetros según sea necesario ] } } ### Implementación Una vez que crees una acción para tu bot de ConvoKraft y elijas configurar la respuesta basada en una lógica de negocio, debes definir las oraciones de ejemplo y los params respectivos para ella. Asegúrate de seguir los pasos listados a continuación para implementar la Execution function: 1. Después de configurar y guardar las oraciones de ejemplo y params requeridos para una acción, se mostrará la página de detalles de la acción. Cambia a la pestaña Functions y haz clic en Edit Function en la sección Execution function. 2. Se abrirá el editor de Deluge de ConvoKraft donde puedes codificar tu lógica de negocio y guardar el script. Obtén más información sobre el editor de Deluge en esta página. Puedes probar los cambios en paralelo usando la función Test this bot. -------------------------------------------------------------------------------- title: "Función de controlador de contexto" description: "Aprende sobre las Deluge functions y úsalas para codificar la lógica de negocio de tu bot de ConvoKraft." last_updated: "2026-07-02T09:34:15.867Z" source: "https://docs.catalyst.zoho.com/es/convokraft/help/actions/bot-logic/deluge-functions/context-handler-function/" service: "ConvoKraft" -------------------------------------------------------------------------------- # Context handler function # Introducción La Context handler function se usa para controlar el flujo conversacional de una acción. Puedes cambiar el orden en que los params se solicitan a los usuarios en tiempo de ejecución. También puedes omitir algunos params, hacer validaciones personalizadas de los valores de los params, y también pedir una confirmación antes de la ejecución de la acción en tiempo de ejecución. La Context handler function puede anular el orden en que se definen los params estáticos. Si la context handler function está habilitada, el bot solicitará los parámetros en el orden dictado por la context handler function y no por el orden que declaraste al definir los params en la consola de Catalyst. Nota: La Context Handler function solo puede usarse si has elegido la plataforma de desarrollo de tu bot de ConvoKraft como Deluge. ### Invocation Point Una vez que ConvoKraft detecta la acción del input del usuario, se detectarán los posibles valores de params que están presentes en el input del usuario, luego el bot solicitará el primer param faltante al usuario. Cuando un usuario responde a la solicitud del param, ConvoKraft invocará la context handler function. La context handler function se invoca para cada param que se solicita en la conversación. Si una acción no tiene params, la context handler function se ejecutará una vez antes de la execution function. ### Input Arguments Además de los argumentos de entrada definidos por el sistema, los siguientes argumentos de entrada también están disponibles para la Context handler function: <table class="content-table"> <thead> <tr> <th>Argumento</th> <th>Tipo de dato Deluge</th> <th>Descripción</th> </tr> </thead> <tbody> <tr> <td>userInput</td> <td>String</td> <td>Última respuesta del usuario</td> </tr> <tr> <td>previousParam</td> <td>Map</td> <td>El param que se solicitó por última vez al usuario. La última respuesta del usuario es un valor para este param.</td> </tr> </tbody> </table> ### Return Value La Context handler function retorna un mapa en el siguiente formato: { "todo":"prompt", "prompt":{ "param_name":"&lt;name of the param to be prompted&gt;", "prompt_msg":"&lt;the text to be displayed as a prompt message&gt;", "validation_failure_message":"&lt;the text to be displayed if the user submits invalid input&gt;", "options":[ ], "buttons":[ ], "fields":[ ], }, "confirm":{ "message":"Are you sure you want to cancel?" }, "assign":{ "clientData":{ "&lt;key1&gt;":"&lt;value1&gt;", "&lt;key2&gt;":"&lt;value2&gt;" //Añadir los datos del cliente según sea necesario } } } Como se muestra arriba, las siguientes claves pueden estar presentes en el mapa retornado por la Context handler function: ### todo Esta clave se usa para indicar qué debe hacer un bot de ConvoKraft después de la ejecución de la context handler function. Solo puede tomar uno de los siguientes valores. También, ten en cuenta que esta clave es obligatoria. * **prompt**: Instruye al bot para solicitar un param al usuario. * **confirm**: Instruye al bot para pedir una confirmación final para invocar la Execution function de la acción. * **execute**: Instruye a ConvoKraft para invocar la Execution function. ### prompt Esta clave contiene un mapa que especifica qué param se debe solicitar al usuario y se usa solo si todo está establecido como prompt. Si esta clave no se proporciona aunque todo esté establecido como prompt, el bot solicitará el siguiente param según el orden de los params definidos en la consola. Por lo tanto, esta clave puede omitirse si se debe usar el orden predeterminado de la definición de params. El valor de mapa de esta clave contiene los siguientes atributos: 1. **param_name**: El nombre del param a solicitar. El nombre del param debe ser uno de los params existentes definidos en la consola. 2. **prompt_msg**: Se puede usar para anular el mensaje de solicitud del param definido al crear el param en la consola de Catalyst. **validation_failure_message**: El mensaje personalizado a mostrar si el input dado por el usuario es inválido para el param solicitado. Esta clave es opcional. 3. **options**: La lista de opciones de los params de lista de selección única y múltiple, de las cuales el usuario puede hacer una elección. * **id**: El ID único de la opción. * **label**: El texto a mostrar como etiqueta de la opción. * **preview**: La información adicional a mostrar para las opciones en los params de lista de selección única y múltiple. Las vistas previas de opciones estarán disponibles solo cuando el modo de entrada de los params de lista de selección única y múltiple sea Visual. La clave preview es opcional. * **header**: El header lista las propiedades de las opciones de params de lista de selección única y múltiple. El objeto header debe contener los siguientes atributos en el formato que se muestra a continuación: { "id":"&lt;the unique id for the option&gt;", "label":"&lt;the text to be displayed as the options label&gt;", "preview":{ "header":{ "title":"&lt;the text to be displayed as the option previews title&gt;", "description":"&lt;the text to be displayed as the option previews description&gt;", "subheading":"&lt;the text to be displayed as the subheading to the options preview&gt;", "image":{ "url":"&lt;the url of the preview image&gt;" } } } } Si el objeto header está configurado con estos atributos apropiados para las opciones, entonces la vista previa se mostrará cuando el usuario haga clic en el ícono de información en cada opción. Cuando haces clic en el ícono de información, se mostrarán la imagen, el nombre y la URL configurados. * **fields**: El objeto fields lista las propiedades adicionales sobre las opciones. El objeto fields debe contener los siguientes atributos en el formato que se muestra a continuación. Esto es obligatorio solo si se configura el preview. [ { "label":"&lt;the text to be displayed as the field name&gt;", "value":"&lt;the text to be displayed as the field value&gt;" } ] Nota: Se puede configurar un máximo de siete fields para una opción. Los elementos clave de la clave preview son, header y fields. Si el objeto fields está configurado junto con la clave preview, entonces las vistas previas apropiadas se mostrarán cuando el usuario pase el cursor sobre las opciones respectivas y no habrá ícono de información mostrado en este caso. 4. **buttons**: Los buttons se usan para configurar las operaciones a realizar sobre las opciones definidas en los params de lista de selección única y múltiple. La clave buttons debe contener los siguientes atributos en el formato que se muestra a continuación. [ { "id":"the unique id for the button", "label":"the text to be displayed as the button's label", "theme":"&lt;positive | neutral | negative&gt;" } ] Nota: Los params de lista de selección única y múltiple pueden tener hasta 3 buttons. ### confirm Esto contiene un Map que especifica el mensaje de confirmación para la ejecución de la acción que debe ser solicitado al usuario. Es obligatorio solo si todo está establecido como confirm. El valor del mapa solo puede contener la clave listada a continuación: * **message**: El mensaje de confirmación que debe ser solicitado al usuario. ### assign El valor de la clave assign es de tipo Map. Se puede usar para cambiar los valores de todos los params estáticos y los argumentos definidos por el sistema en tiempo de ejecución. * **clientData**: Se usa para actualizar los valores de datos del cliente basándose en los datos de sesión en tiempo de ejecución. ### Implementación Una vez que crees una acción para tu bot de ConvoKraft y elijas configurar la respuesta basada en una lógica de negocio, debes definir las oraciones de ejemplo y los params respectivos para ella. Asegúrate de seguir los pasos listados a continuación para implementar la Context handler function: 1. Después de configurar y guardar las oraciones de ejemplo y params requeridos para una acción, se mostrará la página de detalles de la acción. Cambia a la pestaña Functions y habilita la Context Handler function. 2. Se te mostrará el siguiente mensaje, haz clic en OK para continuar. 3. Se abrirá el editor de Deluge de ConvoKraft donde puedes codificar tu lógica de negocio y guardar el script. Obtén más información sobre el editor de Deluge en esta página. Puedes probar los cambios en paralelo usando la función Test this bot. -------------------------------------------------------------------------------- title: "Función de clic de botón" description: "Aprende sobre las Deluge functions y úsalas para codificar la lógica de negocio de tu bot de ConvoKraft." last_updated: "2026-07-02T09:34:15.867Z" source: "https://docs.catalyst.zoho.com/es/convokraft/help/actions/bot-logic/deluge-functions/button-click-function/" service: "ConvoKraft" -------------------------------------------------------------------------------- # Button Click Functions # Introducción ConvoKraft te permite configurar botones personalizados en las respuestas mientras interactúas con el usuario junto con el botón Submit predeterminado. Cuando defines params de lista de selección única/múltiple para una acción, si necesitas realizar operaciones personalizadas adicionales usando las opciones seleccionadas como entrada, puedes codificar la lógica en las Button click functions. Estos botones pueden crearse definiendo la tarjeta button en la Execution function. Nota: 1. La Button Click Function solo puede usarse si has elegido la plataforma de desarrollo de tu bot de ConvoKraft como Deluge. 2. Puedes configurar un máximo de tres Button Click functions para una acción. ### Invocation Point Una vez que se hace clic en los botones personalizados configurados en la respuesta del Execution Handler, se invocará la Button Click function correspondiente configurada para ese botón. ### Input Arguments Además de los argumentos de entrada definidos por el sistema, el siguiente argumento de entrada también está disponible para la Button Click Function: <table class="content-table"> <thead> <tr> <th>Argumento</th> <th>Tipo de dato Deluge</th> <th>Descripción</th> </tr> </thead> <tbody> <tr> <td>data</td> <td>Map</td> <td>El valor establecido en la clave data para la tarjeta button en la Execution function </td> </tr> </tbody> </table> ### Return Value La Button click function retorna un mapa en el siguiente formato: { "message" : "The reply message.", "card" : { }, "broadcast" : { }, "followup" : { } } Para obtener más información sobre las claves retornadas por la Button Click Function, consulta esta página. ### Implementación Una vez que crees una acción para tu bot de ConvoKraft y elijas configurar la respuesta basada en una lógica de negocio, debes definir las oraciones de ejemplo y los params respectivos para ella. Asegúrate de seguir los pasos listados a continuación para implementar la Button Click function: 1. Cuando creas una acción, necesitarás configurar las oraciones de ejemplo y params requeridos para ella. Haz clic en New param y selecciona Single/Multi selection list. 2. En el cuadro de diálogo del param, debajo de Submission Buttons, haz clic en Add Button para crear un nuevo botón personalizado. 3. Proporciona un nombre de acción significativo para tu botón como Label y define un nombre que debe ser referenciado en tu Execution function para este botón personalizado como Id. 4. Cuando guardes los cambios realizados en las oraciones de ejemplo y los params, podrás ver la pestaña Functions. Debajo de Button Click Functions, aparecerá el botón personalizado que creaste. Haz clic en Edit Function para codificar la lógica de negocio de la invocación del botón. También puedes crear nuevas funciones haciendo clic en Add Function. 5. Comienza a escribir tu lógica en el editor de Deluge de ConvoKraft y guarda el script una vez terminado. El editor también te permite cambiar entre funciones de inmediato. Haz clic en el botón Test this Bot para interactuar con el bot y validar los cambios que realizaste. Para obtener más información sobre los elementos y uso del editor de ConvoKraft, consulta esta página. ### Bots -------------------------------------------------------------------------------- title: "Introducción" description: "Conoce los bots de Catalyst ConvoKraft que proporcionan asistencia conversacional a los usuarios finales de tu aplicación." last_updated: "2026-07-02T09:34:15.869Z" source: "https://docs.catalyst.zoho.com/es/convokraft/help/bots/introduction/" service: "ConvoKraft" -------------------------------------------------------------------------------- # Bots - Introducción ### Descripción general Los bots de ConvoKraft son los asistentes conversacionales que construyes para que sirvan como la interfaz conversacional de tu aplicación de Catalyst. Técnicamente, los bots son instancias que creas en el servicio ConvoKraft, con sus capacidades de Comprensión del Lenguaje Natural (NLU) y conversacionales intactas. Puedes crear un bot para tu aplicación de Catalyst desde la consola de Catalyst. Necesitarás configurar el conjunto de tareas que realizará tu bot como acciones. Un bot de ConvoKraft puede configurarse para realizar acciones mientras conversa con el usuario. Las respuestas de cada acción pueden basarse en las necesidades específicas de tu aplicación. Cada acción puede configurarse para responder con una respuesta directa o ejecutar una lógica de negocio en tu aplicación. Puedes elegir desarrollar la lógica de negocio de tus bots de ConvoKraft usando cualquiera de las siguientes plataformas: * Catalyst Integration Functions: Las Catalyst Serverless Integration Functions son estructuras de código personalizadas que se alojan en los servidores de Catalyst. Consulta aquí para aprender más sobre las Catalyst Integration Functions. * Deluge: Deluge es el lenguaje de scripting en línea nativo de Zoho, que se aloja en el entorno en la nube de Zoho. Consulta aquí para aprender más sobre Deluge. * Webhooks: Los Webhooks son funciones callback que pueden usarse para acceder a los endpoints de tu servidor personalizado cuando el bot invoca acciones específicas. También puedes optar por proteger tus URLs de Webhook, si es necesario. Puedes crear múltiples bots de ConvoKraft para tu aplicación, según tus necesidades. Después de configurar las acciones requeridas para el bot de ConvoKraft, este podrá responder a las conversaciones usando sus capacidades conversacionales nativas y realizar las tareas requeridas basándose en su comprensión de las acciones configuradas. <br> ### Capacidades de un bot de ConvoKraft Un bot de Catalyst ConvoKraft tiene las siguientes capacidades incorporadas de forma predeterminada: * **Análisis de intención**: Comprender la intención de una oración para realizar la acción requerida. * **Mantenimiento de contexto**: Comprender la relación entre una oración y su oración anterior o siguiente. * **Extracción de entidades**: Extraer información como datos programables de una oración conversacional. Estas capacidades nativas complementan las capacidades personalizadas o acciones en cada bot construido usando el servicio ConvoKraft. <br> ### Flujo de trabajo de un bot de ConvoKraft Después de crear un bot de ConvoKraft, necesitarás configurar las acciones requeridas para él basándote en los diferentes casos de uso de tu aplicación. Entonces el bot podrá responder a todos los mensajes de los usuarios relacionados con esa acción en particular. Cuando se recibe un mensaje de entrada, ConvoKraft comparará el mensaje de entrada con las invocaciones de ejemplo de las acciones configuradas del bot. Si el mensaje no parece coincidir con ninguna de las acciones configuradas, el bot responderá que no puede entender el mensaje. Si ConvoKraft logró hacer coincidir el mensaje de entrada con una acción preconfigurada del bot, solicitará al usuario los datos necesarios para cumplir esa acción como entrada, de forma conversacional. Por ejemplo, si estás intentando reservar un evento, el bot puede hacer preguntas para obtener los detalles, como el nombre del evento, la hora de inicio, la hora de finalización y la ubicación. Después de que se obtengan todos los datos requeridos como entrada, ConvoKraft ejecutará la lógica de negocio definida para esa acción o responderá con una respuesta directa, dependiendo de la respuesta configurada para esa acción. -------------------------------------------------------------------------------- title: "Crear un Bot" description: "Conoce los bots de Catalyst ConvoKraft que proporcionan asistencia conversacional a los usuarios finales de tu aplicación." last_updated: "2026-07-02T09:34:15.870Z" source: "https://docs.catalyst.zoho.com/es/convokraft/help/bots/create-a-bot/" service: "ConvoKraft" -------------------------------------------------------------------------------- # Crear un Bot El primer paso para trabajar con el servicio ConvoKraft es crear un bot. Puedes crear un bot y agregarle las acciones apropiadas desde la consola de Catalyst. Sigue los pasos a continuación para crear un nuevo bot de ConvoKraft. 1. Haz clic en el **ícono de ConvoKraft** en el panel de navegación izquierdo de la consola de Catalyst en tu proyecto y navega al servicio. Esto abrirá la página *Bots*. 2. Haz clic en **Create New Bot**. 3. En la ventana emergente, proporciona un nombre para el bot. Opcionalmente, también puedes agregar una breve descripción y un ícono para el bot. 4. Haz clic en **Save**. Una vez creado el bot exitosamente, serás redirigido a la página de detalles del Bot. Puedes editar el bot o agregar acciones para el bot desde esta página. Ahora, necesitarás elegir una de las siguientes plataformas de desarrollo para construir tu lógica de negocio: Catalyst Integration Functions, Webhooks, o Deluge. * Si eliges codificar tu lógica de negocio usando Catalyst Integration Functions, selecciona **Function** y asocia la función de Catalyst requerida con el bot de ConvoKraft desde la lista desplegable. Todas las funciones del tipo **Bot Logic** presentes en tu proyecto se listarán aquí. También puedes elegir invocar la función al final de una acción o justo después de cada intercambio de mensajes en la conversación. Puedes aprender más sobre el uso de Catalyst Integration Functions en esta página. Nota: Necesitarás crear y configurar la Catalyst Integration Function para tu bot de antemano. Luego podrás asociar el bot con la función. * Si eliges codificar tu lógica de negocio de forma independiente y alojarla en cualquier servidor público externo que sea accesible por ConvoKraft, selecciona **Webhook**. Asegúrate de ingresar la URL válida de los endpoints de tu servidor. Similar a las Catalyst Integration Functions, puedes elegir invocar el webhook al final de cada acción o después de cada mensaje en la conversación del bot. También puedes optar por proteger tus llamadas de webhook, si es necesario. Para conocer más sobre el uso de webhooks en detalle, consulta esta página. * Si eliges codificar tu lógica de negocio en Deluge, selecciona **Deluge**. Se te proporcionará un editor de código incorporado en la consola para codificar tus funciones de Deluge. Para aprender más sobre el uso de las funciones de Deluge y el editor, consulta esta página. Después de hacer tu selección, haz clic en **Save**. Una vez creado el bot de ConvoKraft, puedes configurar las acciones que el bot necesita realizar. ### Controladores -------------------------------------------------------------------------------- title: "Controlador de mensaje de bienvenida" description: "Aprende sobre los Welcome message handlers que te permiten configurar las respuestas de saludo de tu bot de ConvoKraft." last_updated: "2026-07-02T09:34:15.870Z" source: "https://docs.catalyst.zoho.com/es/convokraft/help/handlers/welcome-message-handler/" service: "ConvoKraft" -------------------------------------------------------------------------------- # Welcome Message Handler # Introducción Cuando un bot de ConvoKraft es abierto por el usuario para una nueva sesión de chat, el bot responderá con un mensaje de bienvenida. Si deseas personalizar este mensaje de respuesta predeterminado para dar una respuesta propia, puedes configurarlo en la función Welcome Message handler. La función Welcome message handler retorna un mapa cuya estructura es similar al mapa de retorno de una Execution function. Nota: Si la plataforma de desarrollo elegida de tu bot de ConvoKraft es Catalyst functions o Webhooks, puedes habilitar el handler desde la consola y definir la lógica de tus funciones de handler ya sea en la Integration Function o en el código asociado con la URL del webhook configurado respectivamente. Para obtener más información sobre la definición de funciones de handler en Deluge, consulta esta página. Si has elegido tu plataforma de desarrollo como Functions, puedes usar los siguientes códigos de ejemplo para los stacks de Java, Node.js y Python: ### Java import org.json.JSONObject; import java.io.*; import java.util.logging.Logger; public class WelcomeHandler { Logger LOGGER = Logger.getLogger(WelcomeHandler.class.getName()); public JSONObject handleWelcomeRequest(JSONObject reqBody) throws Exception{ LOGGER.info("Welcome Handler: : TODO : "+ reqBody.get("todo")); JSONObject welcomeResponse = new JSONObject(); welcomeResponse.put("message", "Welcome to your Bot. Please ask your queries"); JSONObject jsonResponse = new JSONObject(); jsonResponse.put("welcome_response", welcomeResponse); return jsonResponse; } } ### Node.js import logger from "./logger.js"; // Manejar la funcionalidad de bienvenida export default function handleWelcome() { logger.info('Handling welcome request'); return { "welcome_response": { "message": "Welcome to your Bot. Please ask your queries" } }; } ### Python import logging def handle_welcome_request(): # Este es tu manejador de mensajes de bienvenida. # Debes escribir el mensaje de bienvenida predeterminado con el que quieres que tu bot salude a los usuarios. # La forma de devolver el mensaje de bienvenida es la siguiente: # { # 'welcome_response': { # 'message': 'Welcome to your Bot. Please ask your queries' # } # } # El código de ejemplo para configurarlo está disponible a continuación. logging.info('Handling welcome request') return { 'welcome_response': { 'message': 'Welcome to your Bot. Please ask your queries' } } -------------------------------------------------------------------------------- title: "Controlador de respaldo" description: "Aprende sobre los Fallback handlers que te permiten configurar las respuestas del bot para escenarios cuando ConvoKraft no puede comprender los mensajes del usuario." last_updated: "2026-07-02T09:34:15.870Z" source: "https://docs.catalyst.zoho.com/es/convokraft/help/handlers/fallback-handler/" service: "ConvoKraft" -------------------------------------------------------------------------------- # Fallback Handler # Introducción Cuando un bot recibe un mensaje de entrada que no puede entender, responderá con un mensaje configurado en la función Fallback handler. Si deseas personalizar el mensaje de respuesta predeterminado para dar una respuesta propia, puedes configurar la función fallback handler según las necesidades específicas de tu bot. Además de los argumentos de entrada definidos por el sistema de una Execution function, la función Fallback Handler incluye un argumento personalizado llamado userInput de tipo de dato String, que almacena la última respuesta del usuario en la sesión de chat actual. La función Fallback handler retorna un mapa cuya estructura es similar al mapa de retorno de una Execution function. Nota: 1. Si la plataforma de desarrollo elegida de tu bot de ConvoKraft es Catalyst functions o Webhooks, puedes habilitar el handler desde la consola y definir la lógica de tus funciones de handler ya sea en la Integration function o en el código asociado con la URL del webhook configurado respectivamente. 2. El estado de respuesta para escenarios de éxito de la función fallback handler debe configurarse como handled. Si no, el estado se considerará como fallo. La respuesta de retorno de la función depende de la lógica configurada en el fallback function handler. Esto aplica tanto para Catalyst functions como para Webhooks. Para obtener más información sobre la definición de funciones de handler en Deluge, consulta esta página. Si has elegido tu plataforma de desarrollo como Functions, puedes usar los siguientes códigos de ejemplo para los stacks de Java, Node.js y Python: ### Java import org.json.JSONObject; import java.io.*; import java.util.logging.Logger; public class FallbackHandler { Logger LOGGER = Logger.getLogger(FallbackHandler.class.getName()); public JSONObject handleFallbackRequest(JSONObject reqBody) throws Exception{ JSONObject jsonResponse = new JSONObject(); LOGGER.info("Fallback Handler : : TODO : "+ reqBody.get("todo")); jsonResponse.put("message", "Fallback Response: Please define this question and try again"); return jsonResponse; } } ### Node.js import logger from "./logger.js"; // Manejar la funcionalidad de respaldo export default function handleFallback() { logger.info('Handling fallback request'); return { "message": "Fallback Response: Please define this question and try again" }; } ### Python import logging def handle_fallback_request(): # Este es tu manejador de respuestas de reserva. # Debes escribir la respuesta de reserva cuando el bot no sabe qué responder a los usuarios. # La forma de devolver el mensaje de reserva es la siguiente: # { # 'message': 'Fallback Response: Please define this question and try again' # } # El código de ejemplo para configurarlo está disponible a continuación. logging.info('Handling fallback request') return { 'message': 'Fallback Response: Please define this question and try again' } -------------------------------------------------------------------------------- title: "Codificar Deluge Handlers" description: "Aprende sobre la codificación de Deluge handlers usando el editor integrado en ConvoKraft." last_updated: "2026-07-02T09:34:15.870Z" source: "https://docs.catalyst.zoho.com/es/convokraft/help/handlers/code-deluge-handlers/" service: "ConvoKraft" -------------------------------------------------------------------------------- # Codificar Deluge Handlers # Implementación Para configurar cualquier Deluge handler para tu bot de ConvoKraft, sigue los pasos listados a continuación: 1. Después de crear un bot de ConvoKraft y configurar las acciones requeridas para él, navega a la pestaña Handlers y habilita el handler requerido, lo que te permitirá editar la función del handler posteriormente. Nota: Podrás editar la función del handler desde la consola solo si has elegido la plataforma de desarrollo de tu bot de ConvoKraft como Deluge. 2. Una vez que hayas habilitado la función del handler, haz clic en Edit Function y serás redirigido a la página de la función del handler. 3. Guarda el código de la función y haz clic en DONE después de construir la respuesta basándote en las necesidades específicas de tu bot. -------------------------------------------------------------------------------- title: "Controlador de fallos" description: "Aprende sobre los Failure handlers que te permiten configurar la lógica del bot para manejar escenarios de excepciones durante la ejecución de acciones." last_updated: "2026-07-02T09:34:15.870Z" source: "https://docs.catalyst.zoho.com/es/convokraft/help/handlers/failure-handler/" service: "ConvoKraft" -------------------------------------------------------------------------------- # Failure Handler # Introducción Cuando ocurre una excepción para el mensaje de entrada del usuario, el bot responderá con un mensaje configurado en la función Failure handler. Si deseas personalizar el mensaje de respuesta predeterminado para dar una respuesta propia, puedes configurar la función Failure Handler según las necesidades específicas de tu bot. Además de los argumentos de entrada definidos por el sistema de una execution function, la función Failure handler incluye un argumento personalizado llamado userInput de tipo de dato String, que almacena la última respuesta del usuario en la sesión de chat actual. La función Failure handler retorna un mapa cuya estructura es similar al mapa de retorno de una Execution function. Nota: Si la plataforma de desarrollo elegida de tu bot de ConvoKraft es Catalyst functions o Webhooks, puedes habilitar el handler desde la consola y definir la lógica de tus funciones de handler ya sea en la Integration function o en el código asociado con la URL del webhook configurado respectivamente. Para obtener más información sobre la definición de funciones de handler en Deluge, consulta esta página. Si has elegido tu plataforma de desarrollo como Functions, puedes usar los siguientes códigos de ejemplo para los stacks de Java, Node.js y Python: ### Java import org.json.JSONObject; import java.io.*; import java.util.logging.Logger; public class FailureHandler { Logger LOGGER = Logger.getLogger(FailureHandler.class.getName()); public JSONObject handleFailureRequest(JSONObject reqBody) throws Exception{ JSONObject jsonResponse = new JSONObject(); LOGGER.info("Failure Handler : : TODO : " + reqBody.get("todo")); jsonResponse.put("message", "Failure Response: Please define this question and try again"); return jsonResponse; } } ### Node.js import logger from "./logger.js"; // Manejar la funcionalidad de fallo export default function handleFailure() { logger.info('Handling failure request'); return { "message": "Failure Response: Please define this question and try again" }; } ### Python import logging def handle_failure_request(): # Este es tu manejador de respuestas de fallo. # Debes escribir la respuesta de fallo cuando el bot falle durante la ejecución de la función. # La forma de devolver el mensaje de fallo es la siguiente: # { # 'message': 'Sorry, Something went wrong' # } # El código de ejemplo para configurarlo está disponible a continuación. logging.info('Handling failure request') return { 'message': 'Failure Response: Please define this question and try again' } ### Gestionar un bot -------------------------------------------------------------------------------- title: "Entrenar un bot" description: "Aprende sobre el proceso de entrenamiento de un bot de ConvoKraft y la importancia fundamental de entrenarlos antes del despliegue." last_updated: "2026-07-02T09:34:15.870Z" source: "https://docs.catalyst.zoho.com/es/convokraft/help/manage-a-bot/train-a-bot/" service: "ConvoKraft" -------------------------------------------------------------------------------- # Entrenar el bot Después de crear o modificar las acciones de tu bot de ConvoKraft en el entorno de desarrollo, necesitarás entrenar al bot con las operaciones configuradas. Cuando creas una acción, defines las oraciones de ejemplo y las respuestas esperadas para ellas. Ahora, cuando el usuario inicia una conversación con el bot para realizar cualquier tarea, el bot primero hará una comparación rápida del mensaje del usuario con las oraciones de ejemplo predefinidas. Si hay una coincidencia con cualquiera de las acciones configuradas, entonces el bot responde con una respuesta prevista. Al entrenar el bot, este podrá analizar los patrones comunes de invocación y las configuraciones realizadas en las acciones específicas, y luego llegará a una lógica de NLP. Esto generará automáticamente y entrenará los modelos correspondientes de Procesamiento de Lenguaje Natural (NLP). Estos modelos a su vez ayudarán al bot a llegar a una correlación entre diferentes variaciones de la misma consulta del usuario, y responder de manera inteligente. Al entrenar el bot, podrías evitar los esfuerzos que consumen tiempo invertidos en definir oraciones de ejemplo para múltiples variaciones de la misma consulta del usuario. Después de entrenar tu bot, puedes probar instantáneamente tu bot iniciando conversaciones con respecto a las configuraciones actualizadas. Considera una situación donde defines oraciones de ejemplo para una acción que construye respuestas obteniendo detalles sobre un evento, como para consultas como **"What is the venue of the event"**, **"When is the event being conducted"** y **"Who are the keynote speakers for the event"**. Ahora, si un usuario hace preguntas al bot como **"Where is the event venue?"** o **"What time is the event?"** de manera conversacional, el bot reconocería la intención de estos mensajes y buscaría cualquier patrón de invocación almacenado en los modelos NLP disponibles. El bot asociaría estas preguntas con las oraciones de ejemplo que ya definiste, lo que contribuye a entender mejor la intención del input del usuario. Por eso es importante que entrenes un bot antes de desplegarlo. Puedes entrenar el bot desde la página de detalles del bot en la consola después de configurar las acciones para él. Esto iniciará el proceso de entrenamiento por Catalyst en segundo plano. Después de que el bot haya sido entrenado exitosamente, se te mostrará un mensaje de estado. Nota: Si encuentras algún problema de red en medio del proceso de entrenamiento, hay posibilidades de fallo en el entrenamiento. En ese caso, puedes entrenar el bot una vez más y luego proceder con su despliegue. El bot será desplegado a producción una vez que despliegues tu proyecto de Catalyst. Puedes consultar esta página para los pasos para desplegar tu proyecto. -------------------------------------------------------------------------------- title: "Probar un bot" description: "Aprende a probar tu bot de ConvoKraft interactuando con él de manera conversacional basándote en las configuraciones de acciones del bot." last_updated: "2026-07-02T09:34:15.870Z" source: "https://docs.catalyst.zoho.com/es/convokraft/help/manage-a-bot/test-a-bot/" service: "ConvoKraft" -------------------------------------------------------------------------------- # Probar el bot Puedes probar tu bot de ConvoKraft justo después de entrenarlo simplemente interactuando con él directamente desde la consola de Catalyst, de manera conversacional con consultas relacionadas con los últimos cambios realizados en las acciones. Nota: Recomendamos que entrenes obligatoriamente y pruebes el bot en el entorno de desarrollo antes de desplegarlo a producción, para evitar cualquier problema crítico en el bot en vivo en el entorno de producción. El bot será desplegado a producción una vez que despliegues tu proyecto de Catalyst. Puedes consultar esta página para los pasos para desplegar tu proyecto. # Interactuar con el bot Puedes interactuar con cualquier bot construido en Catalyst ConvoKraft en inglés conversacional, tal como hablas o envías mensajes de texto a un ser humano. El bot entiende tu lenguaje natural e intentará responder tus preguntas o llevar a cabo tus instrucciones. Una vez que abras la ventana de chat del bot, se mostrará la pantalla de bienvenida con una lista de acciones que el bot puede realizar. Si el bot no tiene una pantalla de bienvenida personalizada configurada, entonces "Hi, how may I help you?" se mostrará como mensaje de bienvenida cuando se abra el bot. Puedes elegir una de la lista o escribir tu mensaje personalizado en el cuadro de texto para interactuar con el bot de ConvoKraft. Cuando envías un mensaje al bot a través de la ventana de chat, el bot responderá con una respuesta. La respuesta será una contestación a la pregunta realizada o el resultado de la instrucción dada. En caso de que el bot necesite más información para responder la pregunta o realizar la operación, podría solicitar información adicional de manera conversacional. Por ejemplo, si estás intentando reservar un evento, entonces el bot puede hacer preguntas para obtener los detalles, como el nombre del evento, el tipo de evento, los días del evento, etc. Para ciertas preguntas, el bot muestra opciones de las cuales puedes seleccionar una o varias según tus requisitos. Después de seleccionar, haz clic en el botón apropiado (si está disponible) para continuar con la instrucción. Si no se muestran botones, la opción seleccionada se enviará inmediatamente al bot. Por ejemplo, para la pregunta del día del evento, el bot puede proporcionarte opciones como lunes, martes, miércoles, etc. * **Selección de entrada única** * **Selección de entrada múltiple** * **Selector de fecha** A veces el bot de ConvoKraft te permite omitir ciertas preguntas que se consideran opcionales para procesar esa instrucción. Entonces, si no estás dispuesto a responder una pregunta particular, haz clic en la opción Skip giving this input. De manera similar, si la respuesta que das tiene un formato inválido o si el bot no puede inferir datos significativos de tu mensaje, entonces el bot solicitará el mismo input repetidamente, hasta que obtenga una respuesta válida. En cualquier momento, si no deseas continuar con el contexto actual de la conversación, puedes hacer clic en la opción Start a new conversation. Esto hará que el bot descarte el contexto actual en la conversación y puedas comenzar de nuevo la conversación con alguna otra instrucción. Al recibir todos los detalles requeridos, el bot realiza la operación deseada y muestra la salida final. La salida puede ser un mensaje simple, tabla, imagen, una lista con viñetas y más, según las configuraciones realizadas. Puedes continuar tu conversación con el bot haciendo otras preguntas o dando instrucciones adicionales. El bot también mostrará sugerencias relacionadas con la instrucción anterior. Puedes seleccionar una de las sugerencias o ingresar un nuevo mensaje y continuar la interacción. Similar a mostrar sugerencias, el bot también puede hacer una pregunta de seguimiento, junto con las sugerencias para continuar con la conversación. Puedes responder esa pregunta seleccionando una de las sugerencias mostradas o escribiendo la respuesta adecuada como respuesta. -------------------------------------------------------------------------------- title: "Desplegar un bot" description: "Aprende sobre el proceso de despliegue de un bot de ConvoKraft después de entrenarlo y probarlo en el entorno de desarrollo." last_updated: "2026-07-02T09:34:15.871Z" source: "https://docs.catalyst.zoho.com/es/convokraft/help/manage-a-bot/deploy-a-bot/" service: "ConvoKraft" -------------------------------------------------------------------------------- # Desplegar a producción Cualquier cambio realizado al bot o sus acciones subyacentes solo se guarda en el entorno de desarrollo de ConvoKraft. Estos cambios no estarán disponibles instantáneamente en el bot en el entorno de producción. Para que el bot en vivo entienda la adición de nuevas acciones, eliminación o modificaciones realizadas en las acciones existentes, el bot debe ser desplegado a producción. Esto es necesario para asegurar que puedas hacer cambios sin interrupciones a un bot en el entorno de desarrollo, que ya está siendo utilizado por los usuarios en el entorno de producción. Para desplegar un bot a producción, haz clic en el botón Deploy to Production en la página de detalles del bot. Nota: El botón Deploy to Production solo estará activo si hay cambios realizados en cualquiera de las acciones subyacentes que hayas configurado para el bot. Una vez que hagas clic en el botón Deploy to Production, se mostrará una ventana emergente con las siguientes secciones: * **Choose Actions**: Todas las acciones que fueron modificadas desde el despliegue anterior serán listadas categóricamente bajo esta sección. Selecciona una acción para desplegar sus cambios a producción. Cualquier cambio realizado en las acciones no seleccionadas no será desplegado. * **Release Type**: Elige el tipo de release apropiado según tus cambios. Tu despliegue recibirá un número de versión apropiado basándose en esta elección. * **Release Notes**: Puedes dejar notas significativas sobre los cambios realizados para tu referencia futura. Después de mencionar todos los valores requeridos, haz clic en el botón Deploy. Tras un despliegue exitoso, cualquier cambio realizado en las acciones subyacentes se reflejará en el bot de producción. Puedes cambiar al entorno de producción eligiéndolo desde el menú desplegable. Puedes incrustar el bot de ConvoKraft en tu aplicación web navegando a la pestaña Clients en la consola, copiar el código mostrado en la captura de pantalla a continuación y pegarlo en el archivo index.html del código fuente de tu aplicación. Además, personaliza el bot de ConvoKraft para tus requisitos específicos usando el paquete ConvoKraft JS SDK. -------------------------------------------------------------------------------- title: "Estadísticas de uso" description: "Aprende sobre las diversas estadísticas de uso de tu bot de ConvoKraft que pueden verse en la consola de Catalyst." last_updated: "2026-07-02T09:34:15.871Z" source: "https://docs.catalyst.zoho.com/es/convokraft/help/manage-a-bot/usage-stats/" service: "ConvoKraft" -------------------------------------------------------------------------------- # Usage Stats Cuando un bot recibe un mensaje de entrada, invoca la acción como respuesta o no logra entender el mensaje en primer lugar. La acción iniciada también puede haber sido detenida por el usuario en medio de la conversación o fallar debido a algunos problemas técnicos. La pestaña Usage Stats proporciona un análisis del uso del bot, y también desglosa el conteo a nivel de acción. # Invocaciones por acción En términos generales, el reporte de estadísticas de uso clasifica el conteo de todos los mensajes procesados por un bot de ConvoKraft en las siguientes categorías: * Responded With Actions: Número de invocaciones que fueron respondidas por las acciones configuradas del bot. * Responded By ConvoKraft: Número de invocaciones que fueron respondidas por los handlers configurados del bot. * Missed To Understand: Número de invocaciones que no fueron entendidas por el bot. El número de invocaciones respondidas con acciones se clasifica adicionalmente según las acciones que son invocadas. El conteo total de invocaciones de cada acción se divide en tres categorías: * COMPLETED - Número de invocaciones en las que la acción se completó exitosamente. * CANCELLED - Número de invocaciones en las que la acción fue cancelada en medio de la conversación. * FAILED - Número de invocaciones en las que la acción falló debido a problemas técnicos en tu lógica de negocio. Nota: 1. La pestaña Usage Stats será visible solo cuando despliegues tu bot a producción. 2. Puedes ver las estadísticas de uso para varios períodos de tiempo y también ordenarlas basándote en cualquiera de las columnas. ## Primeros pasos -------------------------------------------------------------------------------- title: "Introducción" description: "Conoce el servicio Catalyst ConvoKraft que proporciona la capacidad de integrar potentes asistentes de bots conversacionales en tu aplicación de Catalyst." last_updated: "2026-07-02T09:34:15.871Z" source: "https://docs.catalyst.zoho.com/es/convokraft/getting-started/introduction/" service: "ConvoKraft" -------------------------------------------------------------------------------- # Catalyst ConvoKraft ### Introducción ConvoKraft es un servicio impulsado por IA que se puede utilizar para crear bots conversacionales para tu aplicación de Catalyst que conversan a través de texto. Puedes interactuar con los bots creados en ConvoKraft en inglés conversacional, de manera similar a como interactúas con una persona. Para comprender la intención de tu mensaje, los bots de ConvoKraft están ampliamente entrenados con algoritmos de Comprensión del Lenguaje Natural (NLU). Esta capacidad de NLU les ayuda a comprender los mensajes y responder de forma conversacional. ConvoKraft es parte de la plataforma de desarrollo Catalyst que agrupa múltiples servicios de desarrollo bajo demanda. Cada uno de estos servicios completamente funcionales está compuesto por múltiples componentes. Cuando creas una aplicación de Catalyst y construyes bots para ella, la configuración y gestión de los recursos de servidor utilizados por la aplicación es manejada completamente por Catalyst, eliminando así por completo los costos y esfuerzos de infraestructura y mantenimiento de tu parte. Puedes usar el componente de funciones serverless de Catalyst (Integration functions) para codificar la lógica de negocio de tus bots de ConvoKraft en los entornos de programación **Java**, **Node.js** o **Python**. También puedes aprovechar el servicio Catalyst DevOps para monitorear continuamente y obtener los detalles de ejecución de tus funciones de Catalyst. Los servicios de Catalyst pueden usarse de forma independiente o integrarse entre sí para crear aplicaciones y microservicios altamente funcionales y robustos de cualquier escala. Nota: Puedes explorar todos los demás componentes de Catalyst en los diversos servicios de Catalyst, como Catalyst Cloud Scale, Catalyst Serverless, Catalyst DevOps, y más. También puedes codificar la lógica de negocio de tus bots de ConvoKraft usando Deluge, el lenguaje de scripting en línea nativo de Zoho. Estas funciones se alojarán en el entorno serverless de Zoho. Alternativamente, ConvoKraft te permite desarrollar la lógica de negocio en cualquier lenguaje de programación de tu elección, alojada en un servidor público, y pueden ser accedidas dentro de ConvoKraft a través de webhooks. Los bots desarrollados deben integrarse en el frontend de tu aplicación (por ejemplo, una aplicación web) para que los usuarios de tu aplicación puedan usarlos. Catalyst ofrece el paquete de JavaScript Client SDK de ConvoKraft para crear e integrar bots en tus aplicaciones web con facilidad. Puedes utilizar el Client SDK para conectar el bot que construyes en el frontend de tu aplicación o sitio web, y obtener una experiencia de construcción de bots fluida e integral. Después de codificar la lógica de negocio para tus bots e integrarlos en tu aplicación, puedes entrenarlos y probarlos en el entorno de desarrollo y luego desplegarlo a producción. Puedes configurar permisos para cada perfil de Catalyst para acceder y actualizar los bots en tu proyecto de Catalyst. También puedes familiarizarte con Catalyst ConvoKraft y otros servicios de Catalyst probando este tutorial. Puedes comenzar rápidamente con Catalyst ConvoKraft usando esta guía de inicio rápido. -------------------------------------------------------------------------------- title: "Funcionalidades de Catalyst ConvoKraft" description: "Conoce las funcionalidades de Catalyst ConvoKraft que proporciona la capacidad de integrar potentes asistentes de bots conversacionales en tu aplicación de Catalyst." last_updated: "2026-07-02T09:34:15.872Z" source: "https://docs.catalyst.zoho.com/es/convokraft/getting-started/features-of-convokraft/" service: "ConvoKraft" -------------------------------------------------------------------------------- # Funcionalidades de Catalyst ConvoKraft El asistente conversacional disponible 24/7 que puede integrarse en tu aplicación web de Catalyst. Las tareas programadas que puede realizar un bot de ConvoKraft durante las interacciones con los usuarios a través del chat. Lógica de negocio construida con Catalyst Functions, Deluge o accedida mediante Webhooks. <br /> Como se muestra arriba, las funcionalidades de Catalyst ConvoKraft te ayudan a crear un flujo de trabajo de automatización conversacional en forma de bots para tu aplicación de Catalyst. Veamos en detalle cada una de las funcionalidades: ### Bots Los bots de ConvoKraft son asistentes conversacionales programados que tienen la capacidad de comprender la intención de un mensaje, procesarlo y responder al usuario. Los bots pueden configurarse con el conjunto requerido de tareas según su uso en tu aplicación. Pueden configurarse para dar la bienvenida al usuario, responder sus consultas o realizar cualquier operación en tu aplicación. Los bots obtienen respuestas directas de las respuestas configuradas previamente, obtienen datos o realizan operaciones en la aplicación ejecutando la lógica de negocio. Una vez realizadas las configuraciones, puedes entrenarlos para mejorar su capacidad NLP predeterminada, probarlos directamente en la consola de Catalyst y luego integrar los bots en tu aplicación de Catalyst antes de desplegarlos a producción. ### Actions Una acción es una capacidad o un conjunto de tareas que se puede configurar para que un bot de ConvoKraft las ejecute. Cuando un usuario de la aplicación inicia una conversación con el bot, este comprende la intención a través de sus capacidades de NLU y decide las acciones a realizar en ese caso. Puedes configurar las acciones del bot para responder con una respuesta directa preconfigurada, obtener datos relevantes o realizar una operación en la aplicación ejecutando la lógica de negocio. ### Bot Logic Bot logic es la lógica backend que construyes para que tus bots de ConvoKraft realicen diversas acciones. Puedes desarrollar tu lógica de bot usando cualquiera de las siguientes plataformas y asociarla con un bot que crees. La lógica de bot elegida se ejecutará al invocar las acciones configuradas. Puedes desarrollar la lógica de bot de cualquiera de estas formas: * **Catalyst Functions**: Puedes codificar tu lógica de negocio a través de Catalyst Integration Functions que se alojan en los servidores de Catalyst. ConvoKraft proporciona paquetes de SDK relevantes para codificar Integration Functions en los entornos de programación Java, Node.js o Python. * **Deluge Functions**: Puedes escribir tu código en Deluge Functions que se alojarán en el entorno en la nube de Zoho. * **Webhooks**: Usando cualquier lenguaje de programación de tu elección, puedes codificar tu lógica de bot y alojarla en cualquier dominio personalizado de un servidor público y acceder a ella mediante webhooks. -------------------------------------------------------------------------------- title: "Beneficios" description: "Conoce los múltiples beneficios de Catalyst ConvoKraft que proporciona la capacidad de integrar potentes asistentes de bots conversacionales en tu aplicación de Catalyst." last_updated: "2026-07-02T09:34:15.872Z" source: "https://docs.catalyst.zoho.com/es/convokraft/getting-started/benefits/" service: "ConvoKraft" -------------------------------------------------------------------------------- # Beneficios A continuación se enumeran algunas de las ventajas clave que obtendrás al usar el servicio Catalyst ConvoKraft: 1. **Alta disponibilidad y mayor interacción con el cliente**: Los bots de ConvoKraft están disponibles para brindar servicio las 24 horas del día, los 7 días de la semana. La mayor disponibilidad mejora la experiencia del cliente en gran medida. Los bots pueden responder instantáneamente las consultas de los clientes y atender a cualquier cantidad de clientes en paralelo. Esto ayuda a impulsar la retención de clientes y reduce las tasas de abandono de tu aplicación debido a consultas de clientes no atendidas en un período determinado. 2. **Configuración fluida de bots**: Puedes configurar tus bots de ConvoKraft para realizar cualquier acción requerida, ya sea configurando directamente respuestas a las consultas de los usuarios o ejecutando la lógica del bot. Puedes codificar la lógica de tu bot según las necesidades de tu aplicación usando cualquiera de las plataformas de desarrollo proporcionadas por ConvoKraft. Por ejemplo, puedes usar cualquier entorno de programación compatible con Catalyst para crear Integration Functions, o usar Deluge Functions para escribir tu código, o incluso alojar la lógica en servidores personalizados y acceder a ella mediante webhooks. También puedes probar y monitorear la ejecución de las funciones de Catalyst usando los componentes del servicio Catalyst DevOps. 3. **Tiempo de respuesta más rápido y mayor eficiencia**: Usar bots de ConvoKraft en tu aplicación puede reducir el tiempo total que toma la resolución de una consulta de cliente. Los bots de ConvoKraft pueden dar servicio las 24 horas, contribuyendo a la confiabilidad y disponibilidad de tu marca. Cuando los bots están configurados eficientemente, reducen los errores que podrían ocurrir por intervención humana y brindan un servicio más satisfactorio a tus clientes. 4. **Reducción de la sobrecarga operativa al automatizar tareas redundantes**: Usar bots de ConvoKraft minimiza la sobrecarga de entrenamientos manuales de modelos y la curación de algoritmos por parte del desarrollador, ya que estos bots cuentan con capacidades NLP predeterminadas y también pueden mejorarse entrenándolos con configuraciones de acciones personalizadas realizadas al bot de ConvoKraft. Integrar bots en tu aplicación para asistir a tus clientes en diversas áreas puede ayudarte a minimizar los costos operativos involucrados en desplegar recursos humanos o construir lógica extensa en una amplia gama de escenarios. Con los bots de ConvoKraft operando de forma independiente, puedes reducir los costos significativamente y contribuir positivamente a los ingresos generales. También pueden ayudar al personal de soporte al cliente a dedicar menos tiempo a tareas o interacciones repetitivas, y enfocarse más en resolver problemas complejos y críticos. 5. **Recopilación ideal de datos y retroalimentación del cliente**: Los bots de ConvoKraft pueden ayudarte a mejorar tu recorrido de ventas y generación de leads en su totalidad. Pueden ayudarte a recopilar información útil del cliente simplemente interactuando con los clientes mientras usan tu aplicación. Los datos de los clientes pueden analizarse y usarse para rastrear sus intereses, obtener insights y llegar a tendencias de clientes que pueden usarse para mejorar tu aplicación aún más. 6. **Fácil integración en tu aplicación**: Catalyst ofrece paquetes del SDK de ConvoKraft que pueden implementarse en el código frontend de tu aplicación para integrar rápidamente los bots en tu aplicación. Estos paquetes del SDK para diversas plataformas proporcionan fragmentos de código de ejemplo para personalizar el diseño y la funcionalidad de los bots dentro de tu aplicación. 7. **Infraestructura confiable con provisión de auto-escalado**: Catalyst ConvoKraft viene con potentes capacidades de auto-escalado que permiten un uso eficiente de los recursos proporcionados por Catalyst. Catalyst maneja toda la gestión del servidor backend, que está construida sobre la infraestructura probada y comprobada de Zoho, eliminando así completamente los esfuerzos de configuración y mantenimiento de tu parte. -------------------------------------------------------------------------------- title: "Casos de Uso" description: "Conoce los diversos casos de uso de Catalyst ConvoKraft que proporciona la capacidad de integrar potentes asistentes de bots conversacionales en tu aplicación de Catalyst." last_updated: "2026-07-02T09:34:15.872Z" source: "https://docs.catalyst.zoho.com/es/convokraft/getting-started/usecases/" service: "ConvoKraft" -------------------------------------------------------------------------------- # Casos de Uso A continuación se enumeran algunos casos de uso comunes en tiempo real de los bots de ConvoKraft y las ventajas clave de usarlos en tu aplicación de Catalyst: 1. Un bot de comercio electrónico que sirve como asistente de venta minorista en línea para tu negocio, ayudando a los clientes a gestionar sus pedidos de compras en línea. Puedes configurar el bot para responder a los clientes consultas simples y directas, como rastrear pedidos, obtener el historial de compras o cualquier información sobre los productos de la compra actual, o recuperar detalles sobre los productos más vendidos de la temporada o las ofertas aplicables en los artículos del carrito, y más. También puedes configurar el bot para que los clientes puedan iniciar un procedimiento de cancelación o cambio de productos directamente, interactuando con el bot y proporcionando los detalles del pedido apropiados. 2. Un asistente virtual de recepción que ayuda a interactuar con los visitantes del sitio web de tu negocio, proporcionando la información que buscan y generando leads. Considera una empresa financiera que otorga préstamos hipotecarios y educativos. El sitio web de la empresa proporciona las especificaciones de los préstamos y los detalles de elegibilidad. En este caso, un bot de ConvoKraft puede usarse para presentar la información requerida bajo consulta, y para recopilar detalles de los usuarios que ayudarán al personal de ventas a realizar seguimientos y conversiones de leads. 3. Un bot de tickets que sirve como personal de mostrador para responder consultas de los clientes sobre próximos eventos, su lugar, duración, fecha y hora, agenda, ponentes principales y más. Puedes configurar el bot para reservar entradas en la aplicación en nombre de los clientes y enviar una copia de la entrada al cliente. El bot también puede permitir al cliente cancelar o iniciar reembolsos de las entradas reservadas. 4. Un bot de preguntas frecuentes sencillo para el sitio web de tu producto puede ayudar a los usuarios a obtener rápidamente lo que necesitan simplemente interactuando con el bot de ConvoKraft en lugar de buscar en la documentación de preguntas frecuentes cada vez. También puedes configurar el bot para mostrar los enlaces apropiados de la documentación de ayuda cuando el usuario consulte sobre una funcionalidad específica del producto. Esto ahorra un tiempo inmenso al equipo de soporte al cliente para evitar atender las preguntas directas que consumen tiempo, y concentrarse solo en los tickets más complejos. 5. Un bot de programación de citas en el sitio web de tu hospital, que consulta sobre el problema del paciente, recopila detalles al respecto y programa una cita con el profesional médico correspondiente y disponible. El bot también puede interactuar con el paciente, verificar si ya ha consultado en este hospital específico, obtener los registros del historial del paciente y enviarlos al profesional médico antes de la hora programada de la cita para permitir una experiencia de consulta fluida para los pacientes. -------------------------------------------------------------------------------- title: "Guía de Inicio Rápido" description: "Conoce los pasos para comenzar con Catalyst ConvoKraft que proporciona la capacidad de integrar potentes asistentes de bots conversacionales en tu aplicación de Catalyst." last_updated: "2026-07-02T09:34:15.872Z" source: "https://docs.catalyst.zoho.com/es/convokraft/getting-started/quick-start-guide/" service: "ConvoKraft" -------------------------------------------------------------------------------- # Guía de Inicio Rápido Esta sección cubre el proceso general involucrado en el uso del servicio Catalyst ConvoKraft, desde la creación de un proyecto de Catalyst, la construcción de un bot de ConvoKraft, la configuración de la lógica de negocio del bot, el entrenamiento y prueba del bot, hasta su integración en tu aplicación de Catalyst y su posterior despliegue a producción. Hay algunos prerrequisitos y postrequisitos que deben completarse en la plataforma Catalyst al usar el servicio ConvoKraft. Por ejemplo, necesitarás crear un proyecto en la plataforma Catalyst para tu aplicación y luego construir bots para esa aplicación. Después de haber construido el bot y sincronizado en tu aplicación, necesitarás desplegar el proyecto de Catalyst en su totalidad desde la consola de Catalyst para que el bot esté activo en producción. Veamos los pasos en detalle: 1. **Crear un proyecto de Catalyst** - Accede a la consola de Catalyst para crear un nuevo proyecto. Una vez creado el proyecto, podrás acceder a todos los servicios de Catalyst desde la propia consola. 2. **Crear y configurar el bot** - Puedes crear un bot directamente accediendo al servicio ConvoKraft en la consola de Catalyst y configurar las acciones que realizará el bot. Las acciones del bot de ConvoKraft pueden configurarse ya sea para ejecutar una lógica de negocio subyacente o para responder con respuestas directas preconfiguradas. Puedes consultar esta página para más detalles sobre la creación de acciones, la definición de oraciones de ejemplo y parámetros para las acciones. 3. **Construir la lógica de negocio** - Si eliges configurar acciones para realizar cualquier operación en tu aplicación ejecutando la lógica de negocio, puedes elegir codificar la lógica usando Catalyst Functions o Deluge. También puedes codificar la lógica y alojarla en tu servidor, y referenciarla a través de Webhooks. 4. **Probar y entrenar el bot** - Una vez que crees y configures el bot con las acciones requeridas, puedes entrenar el bot. Al entrenarlo, puedes mejorar las capacidades NLP predeterminadas de tu bot y personalizarlo según tus necesidades, basándote en tus configuraciones y el historial de conversación del bot. Una vez entrenado el bot, puedes probarlo instantáneamente desde la consola simplemente interactuando con él. Puedes consultar esta página para obtener una comprensión más detallada sobre el entrenamiento del bot y el proceso de pruebas. 5. **Integrar el bot en tu aplicación** - Una vez que hayas probado tu bot, puedes integrarlo en tu aplicación de Catalyst y personalizarlo según las necesidades específicas de tu aplicación. Por ejemplo, puedes alterar el tamaño, posición y apariencia de la ventana del bot según sea necesario y más. Para usar los bots en tu aplicación, simplemente puedes conectar el paquete de JavaScript SDK de ConvoKraft en tu base de código. 6. **Alojar la aplicación** - Necesitas alojar tu aplicación de Catalyst en el entorno de desarrollo en paralelo a través del componente de alojamiento de cliente web del servicio Catalyst Cloud Scale. Puedes usar los componentes del servicio Catalyst DevOps para monitorear la ejecución de la lógica de negocio en Catalyst Integration Functions y también verificar sus logs. 7. **Desplegar la aplicación a producción** - Después de probar tu aplicación en el entorno de desarrollo, puede ser migrada a producción como se describe en esta página. Una vez que despliegues el proyecto de Catalyst, podrás acceder a tus bots e interactuar directamente con ellos desde la interfaz de cliente de la aplicación en producción. ## SDK ### JS SDK -------------------------------------------------------------------------------- title: "Descripción general" description: "Aprende sobre el paquete JS SDK proporcionado por el servicio Catalyst ConvoKraft que tiene la capacidad de integrar potentes asistentes de chatbot en tu aplicación de Catalyst." last_updated: "2026-07-02T09:34:15.872Z" source: "https://docs.catalyst.zoho.com/es/convokraft/sdk/js/overview/" service: "ConvoKraft" -------------------------------------------------------------------------------- # ConvoKraft JavaScript Client SDK ### Descripción general Un bot de ConvoKraft puede ser agregado a tu aplicación web fácilmente usando el ConvoKraft JavaScript SDK, para que los usuarios puedan interactuar directamente con el bot a través de la ventana de chat programada. Esta documentación proporciona información detallada sobre los pasos para integrar el JavaScript SDK con tu aplicación web de Catalyst y personalizar el bot de ConvoKraft según los requisitos específicos de tu aplicación. Este SDK soporta todos los navegadores web modernos, incluyendo las siguientes versiones mínimas: <table class="content-table"> <thead> <tr> <th>Navegador</th> <th>Versión</th> </tr> </thead> <tbody> <tr> <td>Microsoft Edge</td> <td>12+</td> </tr> <tr> <td>Mozilla Firefox</td> <td>21+</td> </tr> <tr> <td>Google Chrome</td> <td>23+</td> </tr> <tr> <td>iOS Safari</td> <td>6+</td> </tr> </tbody> </table> ### Integración del SDK Agrega el siguiente fragmento de código en el archivo index.html del código fuente de tu aplicación web para conectar el ConvoKraft JS SDK a tu aplicación: &lt;script src="https://console.catalyst.zoho.com/convokraft/assets/js/convokraft-chat-sdk.js"&gt; &lt;/script&gt; Asegúrate de incluir el siguiente fragmento de código en tu aplicación web para que la ventana de chat aparezca en la posición tradicional de chatbot, es decir, en la esquina inferior derecha de la pantalla de tu aplicación web de Catalyst. Puedes modificar el tamaño, posición, apariencia y personalizar la ventana de chat completamente según sea necesario. Los discutiremos en detalle en esta sección. &lt;div class="anchor_convokraft_toBottom"&gt; &lt;convokraft-chat-bot bot-name="test" project-id="6687000000009014" org-id="74535893"&gt;&lt;/convokraft-chat-bot&gt; &lt;/div&gt; Style - &lt;style&gt; div.anchor_convokraft_toBottom { width: 330px; height: 450px; position: fixed; bottom: 0; right: 0; } &lt;/style&gt; Nota: 1. Asegúrate de que **convokraft-chat-sdk.js** se incluya después de la etiqueta **&lt;convokraft-chat-bot/&gt;**. 2. Este SDK funciona mejor con posicionamiento fijo, así que asegúrate de que el contenedor alrededor de la etiqueta **&lt;convokraft-chat-bot/&gt;** tenga posición fija. -------------------------------------------------------------------------------- title: "Personalización de un bot" description: "Aprende sobre el paquete JS SDK proporcionado por el servicio Catalyst ConvoKraft que tiene la capacidad de integrar potentes asistentes de chatbot en tu aplicación de Catalyst." last_updated: "2026-07-02T09:34:15.872Z" source: "https://docs.catalyst.zoho.com/es/convokraft/sdk/js/customization-of-a-bot/" service: "ConvoKraft" -------------------------------------------------------------------------------- # Personalización del bot El ConvoKraft JS SDK soporta la personalización de varios elementos de la ventana de chat para adaptarse a los requisitos específicos de tu aplicación. Los siguientes atributos deben usarse en la etiqueta **&lt;convokraft-chat-bot&gt;** dentro del archivo index.html del código fuente de tu aplicación web: * lt-prop-convokraft-title * show-convokraft-header * bot-name * lt-prop-conversation * show-help * show-typing-suggestions * show-action-suggestions * lt-prop-styles ### lt-prop-convokraft-title Este atributo ayuda a establecer el título de la UI de la ventana de chat. **Código de ejemplo:** &lt;convokraft-chat-bot lt-prop-bot-title="Ask convokraft"&gt; &lt;/convokraft-chat-bot&gt; ### show-convokraft-header Este atributo se usa para indicar al bot de ConvoKraft si el encabezado de la ventana de chat debe mostrarse o no. El valor de este atributo puede ser true o false según tu requisito. Por defecto, está establecido en true. Y si el valor se establece en false, el encabezado de la ventana de chat no se mostrará. **Código de ejemplo:** &lt;convokraft-chat-bot lt-prop-convokraft-title="Ask convokraft" show-convokraft-header="false"&gt; &lt;/convokraft-chat-bot&gt; ### bot-name Al proporcionar cualquier nombre de bot específico (namespace del bot) como valor de este atributo, ConvoKraft conversará solo con ese bot particular. **Código de ejemplo:** &lt;convokraft-chat-bot lt-prop-convokraft-title="Ask convokraft" bot-name = "ecommercebot" &gt;&lt;/convokraft-chat-bot&gt; ### lt-prop-conversation Este atributo ayuda a establecer la alineación de los mensajes en la conversación del bot. El valor de este atributo puede establecerse como true o false. * Si es true, todas las conversaciones de mensajes dentro de la ventana de chat se convertirán a la vista de conversación (los mensajes del usuario se alinean a la derecha y las respuestas de ConvoKraft se alinean a la izquierda de la ventana de chat). **Código de ejemplo:** &lt;convokraft-chat-bot lt-prop-convokraft-title="Ask convokraft" bot-name = "aqualordappointmentbooker" lt-prop-conversation="true"&gt; &lt;/convokraft-chat-bot&gt; * Si es false, todas las conversaciones de mensajes dentro de la ventana de chat se alinearán a la izquierda. **Código de ejemplo:** &lt;convokraft-chat-bot lt-prop-convokraft-title="Ask convokraft" bot-name = "aqualordappointmentbooker" lt-prop-conversation="false"&gt; &lt;/convokraft-chat-bot&gt; ### show-help Este atributo puede usarse para habilitar un ícono de ayuda adyacente al área de escritura en la ventana de chat. Al hacer clic en el ícono de ayuda, se mostrará una pantalla de bienvenida. La pantalla de bienvenida contiene las oraciones de ejemplo o sugerencias de acciones configuradas para ese bot de ConvoKraft. El valor para este atributo puede ser true o false. Por defecto, está establecido como false. **Código de ejemplo:** &lt;convokraft-chat-bot lt-prop-convokraft-title="Ask convokraft" bot-name = "aqualordappointmentbooker" show-help="true"&gt; &lt;/convokraft-chat-bot&gt; ### show-typing-suggestions Este atributo se usa para mostrar las sugerencias de acciones simultáneamente mientras escribes cualquier mensaje en el área de escritura. El valor de este atributo puede ser true o false. **Código de ejemplo:** &lt;convokraft-chat-bot lt-prop-convokraft-title="Ask convokraft" bot-name = "aqualordappointmentbooker" show-help="true" show-history="true" show-typing-suggestions="true"&gt; &lt;/convokraft-chat-bot&gt; ### show-action-suggestions Este atributo puede usarse para mostrar las sugerencias de acciones al final de cada conversación de chat. El valor de este atributo puede ser true o false. Si este atributo está habilitado, el atributo show-typing-suggestions se habilitará automáticamente. **Código de ejemplo:** &lt;convokraft-chat-bot lt-prop-convokraft-title="Ask convokraft" bot-name = "aqualordappointmentbooker" show-help="true" show-history="true" show-action-suggestions="true"&gt; &lt;/convokraft-chat-bot&gt; ### lt-prop-styles Este atributo ayuda a configurar los estilos de los diversos elementos en la UI de la ventana de chat. Los estilos pueden configurarse de la siguiente manera: <table class="content-table"> <thead> <tr> <th>Nombre del atributo</th> <th>Uso</th> <th>Valor</th> <th>Ejemplo</th> </tr> </thead> <tbody> <tr> <td>headerBg</td> <td>Para establecer el color de fondo del encabezado de la ventana de chat.</td> <td>El valor para este estilo puede ser cualquier valor de color.</td> <td>#5acc42</td> </tr> <tr> <td>headerText</td> <td>Para establecer el color del texto del encabezado de la ventana de chat.</td> <td>El valor para este estilo puede ser cualquier valor de color.</td> <td>black</td> </tr> <tr> <td>headerFont</td> <td>Para establecer la familia de fuentes del texto del encabezado de la ventana de chat.</td> <td>El valor para este estilo puede ser cualquier nombre de familia de fuentes.</td> <td>sans-serif</td> </tr> <tr> <td>userBg</td> <td>Para establecer el color de fondo del contenedor de mensajes del usuario en la ventana de chat.</td> <td>El valor para este estilo puede ser cualquier valor de color.</td> <td>#5acc42</td> </tr> <tr> <td>userText</td> <td>Para establecer el color del texto en el contenedor de mensajes del usuario.</td> <td>El valor para este estilo puede ser cualquier valor de color.</td> <td>black</td> </tr> <tr> <td>userFont</td> <td>Para establecer la familia de fuentes de los textos en el contenedor de mensajes del usuario.</td> <td>El valor para este estilo puede ser cualquier nombre de familia de fuentes.</td> <td>Comic Sans MS</td> </tr> <tr> <td>botBg</td> <td>Para establecer el color de fondo del contenedor de mensajes de ConvoKraft en la ventana de chat.</td> <td>El valor para este estilo puede ser cualquier valor de color.</td> <td>#ddd</td> </tr> <tr> <td>botText</td> <td>Para establecer el color del texto en el contenedor de mensajes de ConvoKraft.</td> <td>El valor para este estilo puede ser cualquier valor de color.</td> <td>#222</td> </tr> <tr> <td>botFont</td> <td>Para establecer la familia de fuentes de los textos en el contenedor de mensajes de ConvoKraft.</td> <td>El valor para este estilo puede ser cualquier nombre de familia de fuentes.</td> <td>Arial</td> </tr> <tr> <td>bodyBg</td> <td>Para establecer el color de fondo del cuerpo de la ventana de chat.</td> <td>El valor para este estilo puede ser cualquier valor de color.</td> <td>#ddd</td> </tr> </tbody> </table> Para el atributo lt-prop-styles, los estilos y sus valores deben proporcionarse en formato JSON, como se muestra en el código de ejemplo a continuación: &lt;convokraft-chat-bot lt-prop-conversation="true" lt-prop-styles='{"headerBg":"#5acc42", "headerText":"black", "headerFont":"sans-serif", "userBg":"#5acc42", "userText":"black", "botBg":"#ddd", "botText":"#222", "userFont":"Comic Sans MS", "botFont":"Arial", "bodyBg":"#ddd"}'&gt; &lt;/convokraft-chat-bot&gt; -------------------------------------------------------------------------------- title: "Ganchos" description: "Aprende sobre el paquete JS SDK proporcionado por el servicio Catalyst ConvoKraft que tiene la capacidad de integrar potentes asistentes de chatbot en tu aplicación de Catalyst." last_updated: "2026-07-02T09:34:15.872Z" source: "https://docs.catalyst.zoho.com/es/convokraft/sdk/js/hooks/" service: "ConvoKraft" -------------------------------------------------------------------------------- # Hooks Los hooks de ConvoKraft son funciones que pueden ser configuradas por los desarrolladores en el ámbito global de una aplicación web de Catalyst y pueden ser accedidas usando el objeto ConvoKraft. El ConvoKraft JS SDK proporciona los siguientes hooks: * handleResponse * handleMissed * handleError * minimizeChat * didConnect * setOnBoarding * setOnBoardingSentences * setClientSessionData * handleUpload * handleWelcome ### handleResponse Basándote en la respuesta proporcionada por ConvoKraft para cualquier acción, puedes manejar los datos y personalizar la representación visual de la respuesta según tus requisitos específicos. La respuesta original enviada será enviada en la clave data de una Deluge function desde tu aplicación web. Para personalizar la respuesta, necesitas pasar el valor de data al siguiente hook junto con el elemento HTML, dentro del cual la aplicación web puede renderizar la respuesta original de ConvoKraft. **Sintaxis** convokraft.handleResponse=function(actionName,data,element,responseHandled,fromHistory,fromPagination) { //Ingresa la lógica aquí return true; } La siguiente tabla proporciona detalles sobre los diversos elementos de la función: <table class="content-table"> <thead> <tr> <th>Elemento</th> <th>Descripción</th> </tr> </thead> <tbody> <tr> <td>actionName</td> <td>El namespace de la acción invocada.</td> </tr> <tr> <td>data</td> <td>Contiene los datos personalizados que se envían desde Deluge al hook.</td> </tr> <tr> <td>element</td> <td>Contiene el elemento de respuesta personalizado de ConvoKraft que se mostrará en la ventana de chat. </td> </tr> <tr> <td>responseHandled</td> <td>Esta es una función de callback obligatoria, que ayuda al bot a saber que las operaciones DOM están completas y puede hacer scroll del div del chat hacia arriba.</td> </tr> <tr> <td>fromHistory</td> <td>Esta clave contiene un valor booleano que representa si el mensaje actual que se está construyendo es de la sesión actual o de sesiones anteriores.</td> </tr> <tr> <td>fromPagination</td> <td>Esta clave contiene un valor booleano que representa si el mensaje actual que se está construyendo es un mensaje después de una llamada de paginación. Si es true, no es aconsejable llamar a responseHandled(), para que los mensajes no se desplacen completamente hacia abajo.</td> </tr> </tbody> </table> **Código de ejemplo** convokraft.handleResponse = function(actionName,data,element,responseHandled,fromHistory,fromPagination) { if(actionName=="schedule_event") { element.innerHTML="This is a test function from "+data.name; element.style.padding="10px"; responseHandled(); return false; //Renderiza la respuesta construida anteriormente } return true; //Renderiza la respuesta original de ConvoKraft } ### handleMissed Si el mensaje del usuario no coincide con ninguna de las acciones configuradas de tu bot, y en ese caso si has definido el hook convokraft.handleMissed() en el ámbito global de tu aplicación web, entonces ConvoKraft mostrará la respuesta personalizada renderizada a través de este hook. **Sintaxis** convokraft.handleMissed = function(element, responseHandled, fromHistory, fromPagination) { //Ingresa la lógica del elemento que se renderizará como respuesta de convokraft } La siguiente tabla describe los elementos de la sintaxis y sus descripciones: <table class="content-table"> <thead> <tr> <th>Elemento</th> <th>Descripción</th> </tr> </thead> <tbody> <tr> <td>element</td> <td>Contiene el elemento de respuesta personalizado de ConvoKraft que se mostrará en la ventana de chat. </td> </tr> <tr> <td>responseHandled</td> <td>Esta es una función de callback obligatoria, que ayuda al bot a saber que las operaciones DOM están completas y puede hacer scroll del div del chat hacia arriba.</td> </tr> <tr> <td>fromHistory</td> <td>Esta clave contiene un valor booleano que representa si el mensaje actual que se está construyendo es de la sesión actual o de sesiones anteriores.</td> </tr> <tr> <td>fromPagination</td> <td>Esta clave contiene un valor booleano que representa si el mensaje actual que se está construyendo es un mensaje después de una llamada de paginación. Si es true, no es aconsejable llamar a responseHandled(), para que los mensajes no se desplacen completamente hacia abajo.</td> </tr> </tbody> </table> **Código de ejemplo** convokraft.handleMissed= function(element,responseHandled,fromHistory){ element.innerHTML = "<div class='wrapped_not_found'>Sorry! Not found!<br/><br/><img src='https://www.zylker.com/files/2020/06/iStock-872962368-chat-bots.webp'></img></div>"; responseHandled(); return false; } ### handleError Si ocurre algún error de API mientras se ejecuta una acción, puedes usar este hook para mostrar una respuesta de error personalizada definiendo convokraft.handleError en el ámbito global de tu aplicación web de Catalyst. **Sintaxis** convokraft.handleError = function(element, responseHandled, fromHistory, fromPagination) { //Ingresa la lógica para personalizar el mensaje de error } La siguiente tabla describe los elementos de la sintaxis y sus descripciones: <table class="content-table"> <thead> <tr> <th>Elemento</th> <th>Descripción</th> </tr> </thead> <tbody> <tr> <td>element</td> <td>Contiene el elemento de respuesta personalizado de ConvoKraft que se mostrará en la ventana de chat. </td> </tr> <tr> <td>responseHandled</td> <td>Esta es una función de callback obligatoria, que ayuda al bot a saber que las operaciones DOM están completas y puede hacer scroll del div del chat hacia arriba.</td> </tr> <tr> <td>fromHistory</td> <td>Esta clave contiene un valor booleano que representa si el mensaje actual que se está construyendo es de la sesión actual o de sesiones anteriores.</td> </tr> <tr> <td>fromPagination</td> <td>Esta clave contiene un valor booleano que representa si el mensaje actual que se está construyendo es un mensaje después de una llamada de paginación. Si es true , no es aconsejable llamar a responseHandled(), para que los mensajes no se desplacen completamente hacia abajo.</td> </tr> </tbody> </table> **Código de ejemplo** convokraft.handleError= function(element,responseHandled){ if(typeof data !== "undefined"){ messageString = data.data.code; } else{ messageString = "Api Error!"; } element.innerHTML = "<div class='wrapped_not_found'>Sorry! "+messageString+"<br/><br/><img src='https://www.zylker.com/files/2020/06/iStock-872962368-chat-bots.webp'></img></div>"; responseHandled(); } ### minimizeChat Este hook permite al usuario minimizar o maximizar la ventana de chat cuando se hace clic en su encabezado. **Sintaxis** convokraft.minimizeChat=function() { //obtener tu div de chat y aplicar animación de minimizar y estilos según necesites } **Código de ejemplo** convokraft.minimizeChat=function() { if(document.getElementById("zdivid").style.marginBottom=="-400px"||document.getElementById("zdivid").style.marginBottom=="") { document.getElementById("zdivid").style.marginBottom="-0px"; } else { document.getElementById("zdivid").style.marginBottom="-400px"; } } ### didConnect Este hook se usa para notificar a la aplicación web de Catalyst que el chat se ha cargado completamente. **Sintaxis** convokraft.didConnect=function() { //Ingresa la lógica aquí } **Código de ejemplo** convokraft.didConnect=function() { var loadingDiv=document.getElementById("loadingDiv"); if(loadingDiv) { loadingDiv.style.display='none'; } } ### setOnBoarding Si no hay historial de chat, entonces la pantalla de bienvenida se mostrará por defecto. Este hook puede definirse en el ámbito global de tu aplicación web para personalizar la pantalla de bienvenida del bot de ConvoKraft según tus requisitos. **Sintaxis** convokraft.setOnBoarding=function(element,sentences,placeholders) { //construir HTML y estilos según tu necesidad y agregarlo al elemento } La siguiente tabla explica los elementos de la sintaxis y sus descripciones: <table class="content-table"> <thead> <tr> <th>Elemento</th> <th>Descripción</th> </tr> </thead> <tbody> <tr> <td>element</td> <td>Contiene el elemento HTML que necesita ser personalizado. </td> </tr> <tr> <td>sentences</td> <td>Contiene las oraciones de ejemplo de esa acción particular.</td> </tr> <tr> <td>placeholders</td> <td>Es un array de strings que puede usarse para contener diferentes parámetros para las oraciones mostradas en la pantalla de bienvenida</td> </tr> </tbody> </table> **Código de ejemplo** convokraft.setOnBoarding=function(element,sentences,placeholders) { var html="<div style='font-weight:bold;font-family:'proxima_nova_ltsemibold'>This is a custom onboarding screen by client app and here are the list of sentences:</div><br/><br/><ul style='list-style:none;margin-left:-15px'>"; sentences.forEach(function(item) { html+="<li class='onboard_item' onclick='convokraftvoice.sendMessage(\""+item+"\")'>"+item+"</li>"; }) html+="</ul>"; element.innerHTML=html; element.style.padding="10px"; } ### setOnBoardingSentences Este hook se usa para personalizar las oraciones de bienvenida o las sugerencias de acciones que aparecen cuando abres una ventana de chat de ConvoKraft. Por defecto, la ventana de chat muestra las sugerencias basadas en las oraciones de ejemplo configuradas de las acciones de ConvoKraft. Se puede pasar un array de objetos en formato JSON como argumentos a este hook como se lista a continuación. También ten en cuenta que con la ayuda de las oraciones en el JSON, se pueden establecer y retornar diferentes valores para los placeholders. [ { "id": "1", "sentence": "Apply leave for {{fromdate}} and {{todate}}", "actual_sentence": "Apply leave for today and tomorrow" }, { "id": "2", "sentence": "What is the {{property}} of {{country}}?", "actual_sentence": "What is the capital of India?" } ] //Filtrar o modificar las oraciones que se mostrarán en la pantalla de incorporación **Sintaxis** convokraft.setOnBoardingSentences=function(sentences) { //definir HTML y estilos según tu necesidad y agregarlo al elemento } **Código de ejemplo** convokraft.setOnBoardingSentences=function(sentences) { sentences.splice(0,8); return sentences; } Nota: * Este hook se considerará solo cuando el hook setOnBoarding no esté aplicado. * Si quieres oraciones personalizadas en el hook setOnBoarding, aplica el mismo proceso para las oraciones en el hook setOnBoarding. ### setClientSessionData Este hook se usa para obtener los datos de sesión del cliente personalizado de tu aplicación web de Catalyst. Asegúrate de definirlo en el ámbito global de tu aplicación web de Catalyst para que ConvoKraft pueda acceder a él. **Sintaxis** convokraft.setClientSessionData=function() { //Devolver un objeto JSON } **Código de ejemplo** convokraft.setClientSessionData=function() { return { portal_name: "zylker", ui_version: "2.0" } } Nota: * Asegúrate de retornar los datos de sesión como un objeto JSON. * Cuando usas una Deluge function, los datos JSON que se retornan desde este handle pueden obtenerse usando sessionData.set("client_data"). ### handleUpload Este hook se usa para definir las operaciones a realizar después de cargar un archivo. Si la plataforma de desarrollo elegida es Deluge o Function, entonces el archivo se cargará en el entorno en la nube de Catalyst. En caso de Webhooks, necesitarás definir tu propia ruta de archivo en el atributo file. Puedes configurar los mensajes respectivos en los argumentos de callback onSucces y onFailure, según tus requisitos específicos. **Sintaxis** convokraft.handleUpload = function(input){ //haz lo que desees con el elemento que se renderizará como respuesta de convokraft } Los siguientes atributos son soportados para este hook: <table class="content-table"> <thead> <tr> <th>Nombre del atributo</th> <th>Uso</th> </tr> </thead> <tbody> <tr> <td>sessionId</td> <td>El ID de la sesión de transcript actual.</td> </tr> <tr> <td>param</td> <td>La información del param del prompt actual como nombre del param, tipo y mensaje del prompt.</td> </tr> <tr> <td>file</td> <td>El objeto de archivo proporcionado por el usuario.</td> </tr> <tr> <td>action</td> <td>El namespace de la acción de la conversación actual.</td> </tr> <tr> <td>bot</td> <td>El namespace del bot de la conversación actual.</td> </tr> <tr> <td>onSuccess</td> <td>El callback obligatorio que acepta el ID del archivo como entrada.</td> </tr> <tr> <td>onProgressChange</td> <td>El callback obligatorio que acepta el porcentaje de carga calculado como parámetro. Esto debe llamarse cada vez que el porcentaje de carga cambie. Si la carga está completa, establece el porcentaje a 100 y un mensaje para mostrar el estado de éxito como onProgressChange(100,"File upload completed");</td> </tr> <tr> <td>onFailure</td> <td>El callback obligatorio que acepta una entrada de string con un mensaje indicando la razón del fallo de la carga.</td> </tr> </tbody> </table> **Código de ejemplo** convokraft.handleUpload=function(uploadObject){ let percentage = 20; let onSuccess = uploadObject.onSuccess; let onFailure = uploadObject.onFailure; var percentageInterval = setInterval(function() { if(percentage === 100){ clearInterval(percerntageInterval); uploadObject.updateProgress(100,"Your file is being processed. Please wait..."); setTimeout(function() { if(zia.fileUploadCount > 1){ onSuccess((Date.now()).toString()); } else{ onFailure("Your file is over 2MB. Please upload a file of less size."); } }, 5000); return; } percentage+=20; uploadObject.onProgressChange(percentage); }, 500); } ### handleWelcome Este hook se usa para modificar el mensaje de bienvenida (el primer mensaje mostrado en la sesión de chat). Este hook puede usarse cuando necesitas personalizar solo la UI. Si necesitas que se ejecute una lógica de backend para mostrar el mensaje de bienvenida, entonces usa la función welcome message handler. **Sintaxis** convokraft.handleWelcome = function(config){ //haz lo que desees con el elemento que se renderizará como respuesta de convokraft } **Código de ejemplo** convokraft.handleWelcome = function(config) { config.element.innerHTML = `Hello Guest! Here are few things I can do for you. &lt;div class='suggestion'&gt;Raise a ticket&lt;/div&gt; &lt;div class='suggestion'&gt;List my inventory and assets&lt;/div&gt;`; } -------------------------------------------------------------------------------- title: "Métodos" description: "Aprende sobre el paquete JS SDK proporcionado por el servicio Catalyst ConvoKraft que tiene la capacidad de integrar potentes asistentes de chatbot en tu aplicación de Catalyst." last_updated: "2026-07-02T09:34:15.873Z" source: "https://docs.catalyst.zoho.com/es/convokraft/sdk/js/methods/" service: "ConvoKraft" -------------------------------------------------------------------------------- # Métodos del ConvoKraft JS SDK El ConvoKraft JS SDK expone los siguientes métodos a la aplicación web para realizar un conjunto de operaciones básicas: * sendMessage() * pushTranscript() ### sendMessage() El método sendMessage() se usa para configurar tu aplicación cliente para enviar un mensaje de chat al servidor de ConvoKraft. Es decir, cuando un usuario hace clic en una opción mostrada en la ventana de chat, el mensaje configurado correspondiente a la opción se mostrará al usuario en la ventana de chat instantáneamente. Los argumentos para este método incluyen un string que contiene el mensaje que se mostrará en la conversación del chat, que es obligatorio, y otro string que contiene el option_id, que es el id de la opción elegida en caso de params de tipo array. El argumento option_id es opcional. { convokraft.sendMessage(messageString,option_id); } ### pushTranscript() Este método puede usarse para insertar un transcript personalizado (un mensaje individual en la conversación del usuario) para un usuario mientras conversa con el bot de ConvoKraft. El mensaje se mostrará solo en el chatbot para esa sesión particular. Se debe pasar datos de transcript como se menciona a continuación a la función. Este método es útil en escenarios de insertar un recordatorio. { "message": "Reminder to call Bob at 11am", "id": "1", "sender": "user", "time": "1523356878103" } convokraft.pushTranscript(transcriptObject); Aquí, transcriptObject es el objeto de mensaje que se mostrará en la conversación. --- ## API Reference — ConvoKraft -------------------------------------------------------------------------------- title: "Habilitar o deshabilitar SmartTrain" description: "Esta API se usa para habilitar o deshabilitar la función SmartTrain en ConvoKraft." last_updated: "2026-07-02T09:34:15.876Z" source: "https://docs.catalyst.zoho.com/es/api/code-reference/convokraft/enable-or-disable-smarttrain/" service: "ConvoKraft" -------------------------------------------------------------------------------- # Catalyst ConvoKraft Catalyst ConvoKraft es un servicio impulsado por IA que te permite construir chatbots inteligentes y desplegarlos en tus aplicaciones de Catalyst. Estos bots aprovechan la Comprensión del Lenguaje Natural (NLU) para interpretar mensajes y responder naturalmente en inglés conversacional. Puedes personalizar el bot configurando tu propia lógica, proporcionando pares simples de pregunta-respuesta, o entrenándolo con recursos personalizados, según los requisitos de tu aplicación. SmartTrain es un componente del servicio Catalyst ConvoKraft que te permite entrenar tu chatbot usando tus propios recursos. Puedes hacer esto configurando URLs web donde están alojados los recursos. Esto permite que el bot proporcione rápidamente respuestas precisas a las consultas de los usuarios relacionadas con el contenido entrenado. Puedes consultar esta documentación de ayuda para obtener más información sobre el servicio Catalyst ConvoKraft. # Habilitar o deshabilitar SmartTrain Esta API habilita o deshabilita **SmartTrain** en el servicio Catalyst ConvoKraft. Cuando está habilitado, puedes agregar materiales de entrenamiento para mejorar las respuestas del bot. Deshabilitarlo pausa temporalmente el conocimiento entrenado del bot, evitando que responda consultas basadas en los datos de entrenamiento. Una vez rehabilitado, el entrenamiento se restaura automáticamente, permitiendo que el bot responda usando los materiales cargados previamente. Puedes introducir esta funcionalidad en tu aplicación de Catalyst usando la API a continuación. ### Detalles de la solicitud #### URL de solicitud <p>{api-domain}/convokraft/api/v1/bots/{botid}? type=DEVELOPED El dominio específico del DC para acceder a Catalyst API El ID único del proyecto en el que se ha creado el bot El ID único del bot de ConvoKraft Nota: 1. El parámetro de consulta type=DEVELOPED se usa para indicar que el bot está en estado de desarrollo dentro del servicio ConvoKraft. 2. Puedes obtener el botid directamente desde la URL en el servicio ConvoKraft cuando el entorno está configurado en Development en la consola. Por ejemplo : <span style="pointer-events: none;word-break: break-all;">https://console.catalyst.zoho.com/baas/v1/project/183272829220/Development#/convokraft/bots/3828281991118</span> <br> Aquí, **3828281991118** es el botid. #### Scope ZIAPlatform.Convokraft.RAG.UPDATE #### Encabezados de solicitud **Authorization:** Zoho-oauthtoken {oauth_token} <br> Content-Type: application/json <br> CATALYST-ORG: {org_id} <br> X-CATALYST-projectid: {project id} <br> X-CATALYST-Environment: Development <br> Nota: El encabezado de solicitud CATALYST-Environment: Development indica que la operación de la API debe realizarse en el bot dentro del entorno de desarrollo de Catalyst. #### Propiedades JSON de la solicitud Pasa el valor como true para habilitar la función RAG y false para deshabilitarla. <br> Predeterminado: true. ### Detalles de la respuesta La respuesta devolverá el estado de la operación de habilitar o deshabilitar SmartTrain, junto con un mensaje de estado y código de estado. <br> <br> curl -X PATCH \ https://api.catalyst.zoho.com/baas/v1/project/4000000006007/convokraft/api/v1/bots/92738220219110?type=DEVELOPED \ -H 'Authorization: Zoho-oauthtoken 1000.910*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*16.2f*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*57' \ -H 'Content-Type: application/json' \ -H 'CATALYST-ORG: 372822922' \ -H 'X-CATALYST-projectid: 2728172727718' \ -H 'X-CATALYST-Environment: "Development"' \ -\-data '{ "bots": { "is_rag_enabled": true } }' { "status": "SUCCESS", "code": "SUCCESS", "message": "Updated Successfully." } -------------------------------------------------------------------------------- title: "Agregar material de entrenamiento" description: "Esta API se usa para agregar URLs de entrenamiento a la función SmartTrain en ConvoKraft." last_updated: "2026-07-02T09:34:15.878Z" source: "https://docs.catalyst.zoho.com/es/api/code-reference/convokraft/add-training-material/" service: "ConvoKraft" -------------------------------------------------------------------------------- # Agregar material de entrenamiento Esta API te permite cargar materiales de entrenamiento personalizados a SmartTrain, permitiendo que el bot de ConvoKraft se entrene automáticamente. Puedes proporcionar URLs web de los materiales de entrenamiento alojados en cualquier plataforma de terceros en formato HTML o TXT. Una vez cargados, el bot procesa el contenido y lo usa para responder a consultas relevantes. Puedes introducir esta funcionalidad en tu aplicación de Catalyst usando la API a continuación. ### Detalles de la solicitud #### URL de solicitud <p>{api-domain}/convokraft/api/v1/bots/{botid}/rag_training_data?type=DEVELOPED El dominio específico del DC para acceder a Catalyst API El ID único del proyecto en el que se ha creado el bot El ID único del bot de ConvoKraft Nota: 1. El parámetro de consulta type=DEVELOPED se usa para indicar que el bot está en estado de desarrollo dentro del servicio ConvoKraft. 2. Puedes obtener el botid directamente desde la URL en el servicio ConvoKraft cuando el entorno está configurado en Development en la consola. Por ejemplo : <span style="pointer-events: none;word-break: break-all;">https://console.catalyst.zoho.com/baas/v1/project/183272829220/Development#/convokraft/bots/3828281991118</span> <br> Aquí, **3828281991118** es el botid. #### Scope ZIAPlatform.Convokraft.RAG.CREATE #### Encabezados de solicitud **Authorization:** Zoho-oauthtoken {oauth_token} <br> Content-Type: application/json <br> CATALYST-ORG: {org_id} <br> X-CATALYST-projectid: {project id} <br> X-CATALYST-Environment: Development <br> Nota: El encabezado de solicitud CATALYST-Environment: Development indica que la operación de la API debe realizarse en el bot dentro del entorno de desarrollo de Catalyst. #### Propiedades JSON de la solicitud Proporciona la URL completa del material de entrenamiento apuntando a **.html** o **.txt**. Proporciona el título del material de entrenamiento. ### Detalles de la respuesta Esta API proporciona el estado del proceso de carga del material de entrenamiento, incluyendo el código de estado y el mensaje. También devuelve las URLs de los materiales cargados junto con un ID único asignado por ConvoKraft para cada URL. <br> <br> curl -X POST \ https://api.catalyst.zoho.com/baas/v1/project/4000000006007/convokraft/api/v1/bots/92738220219110/rag_training_data?type=DEVELOPED \ -H 'Authorization: Zoho-oauthtoken 1000.910*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*16.2f*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*57' \ -H 'Content-Type: application/json' \ -H 'CATALYST-ORG: 372822922' \ -H 'X-CATALYST-projectid: 2728172727718' \ -H 'X-CATALYST-Environment: "Development"' \ -\-data '{ "rag_training_data": [ { "url": "https://www.apple.com/iphone-15", "title": "Iphone 15 Specifications" }, { "url": "https://www.apple.com/iphone-11/", "title": "Iphone 11 Specifications" } ] }' { "status": "SUCCESS", "code": "SUCCESS", "message": "File upload in progress", "info": { "files": [ { "id": "2000000028005", "url": "https://www.apple.com/iphone-15/" }, { "id": "2000000028007", "url": "https://www.apple.com/iphone-11/" }, ] } } -------------------------------------------------------------------------------- title: "Obtener materiales de entrenamiento" description: "Esta API se usa para obtener los materiales de entrenamiento cargados a la función SmartTrain en ConvoKraft." last_updated: "2026-07-02T09:34:15.878Z" source: "https://docs.catalyst.zoho.com/es/api/code-reference/convokraft/get-training-materials/" service: "ConvoKraft" -------------------------------------------------------------------------------- # Obtener materiales de entrenamiento Esta API te permite obtener los detalles y los metadatos de los materiales de entrenamiento asociados con un bot de ConvoKraft particular. Puedes integrar esta funcionalidad en tu aplicación de Catalyst usando la API proporcionada a continuación. ### Detalles de la solicitud #### URL de solicitud <p>{api-domain}/convokraft/api/v1/bots/{botid}/rag_training_data?type=DEVELOPED El dominio específico del DC para acceder a Catalyst API El ID único del proyecto en el que se ha creado el bot El ID único del bot de ConvoKraft Nota: 1. El parámetro de consulta type=DEVELOPED se usa para indicar que el bot está en estado de desarrollo dentro del servicio ConvoKraft. 2. Puedes obtener el botid directamente desde la URL en el servicio ConvoKraft cuando el entorno está configurado en Development en la consola. Por ejemplo : <span style="pointer-events: none;word-break: break-all;">https://console.catalyst.zoho.com/baas/v1/project/183272829220/Development#/convokraft/bots/3828281991118</span> <br> Aquí, **3828281991118** es el botid. #### Scope ZIAPlatform.Convokraft.RAG.READ #### Encabezados de solicitud **Authorization:** Zoho-oauthtoken {oauth_token} <br> Content-Type: application/json <br> CATALYST-ORG: {org_id} <br> X-CATALYST-projectid: {project id} <br> X-CATALYST-Environment: Development <br> Nota: El encabezado de solicitud CATALYST-Environment: Development indica que la operación de la API debe realizarse en el bot dentro del entorno de desarrollo de Catalyst. ### Detalles de la respuesta Esta API proporciona los detalles y los metadatos de todos los materiales de entrenamiento asociados con el bot, incluyendo el ID único generado por ConvoKraft, el título, la URL y el estado de cada material de entrenamiento. También incluye información sobre la creación y modificación de los materiales, como la dirección de correo electrónico del usuario, zona horaria, ZUID, rol y otros detalles relevantes, junto con las marcas de tiempo de creación y modificación. curl -X GET \ https://api.catalyst.zoho.com/baas/v1/project/4000000006007/convokraft/api/v1/bots/92738220219110/rag_training_data?type=DEVELOPED \ -H 'Authorization: Zoho-oauthtoken 1000.910*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*16.2f*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*57' \ -H 'Content-Type: application/json' \ -H 'CATALYST-ORG: 372822922' \ -H 'X-CATALYST-projectid: 2728172727718' \ -H 'X-CATALYST-Environment: "Development"' \ { "rag_training_data": [ { "id": "67799000000085007", "title": "Iphone 15 Specifications", "url": "https://www.apple.com/iphone-15/", "source": "URL", "created_by": { "id": "76859507", "email": "amelia.burrows@zylker.com", "username": "amelia.burrows", "timezone": "Asia/Calcutta", "nickname": "amelia", "locale": "en_IN", "role": "SUPER_ADMIN", "zuid": "76859507" }, "created_time": "1732880033148", "modified_by": { "id": "76859507", "email": "amelia.burrows@zylker.com", "username": "amelia.burrows", "timezone": "Asia/Calcutta", "nickname": "nivetha.raja", "locale": "en_IN", "role": "SUPER_ADMIN", "zuid": "76859507" }, "modified_time": "1732880389581", "status": "TRAINED" }, { "id": "67799000000085009", "title": "Iphone 11 Specifications", "url": "https://www.apple.com/iphone-11/", "source": "URL", "created_by": { "id": "76859507", "email": "amelia.burrows", "username": "amelia.burrows", "timezone": "Asia/Calcutta", "nickname": "amelia", "locale": "en_IN", "role": "SUPER_ADMIN", "zuid": "76859507" }, "created_time": "1732880131250", "modified_by": { "id": "76859507", "email": "amelia.burrows@zylker.com", "username": "amelia.burrows", "timezone": "Asia/Calcutta", "nickname": "amelia", "locale": "en_IN", "role": "SUPER_ADMIN", "zuid": "76859507" }, "modified_time": "1732880131250", "status": "TRAINED" } ] } -------------------------------------------------------------------------------- title: "Eliminar material de entrenamiento" description: "Esta API se usa para eliminar los materiales de entrenamiento cargados de la función SmartTrain en ConvoKraft." last_updated: "2026-07-02T09:34:15.878Z" source: "https://docs.catalyst.zoho.com/es/api/code-reference/convokraft/delete-training-material/" service: "ConvoKraft" -------------------------------------------------------------------------------- # Eliminar material de entrenamiento Esta API te permite eliminar los materiales de entrenamiento personalizados cargados a la función SmartTrain en el bot de ConvoKraft proporcionando el ID único asignado a cada material en la solicitud. También puedes eliminar múltiples materiales a la vez pasando los IDs separados por comas. Ten en cuenta que eliminar el material de entrenamiento eliminará automáticamente el conocimiento entrenado en el bot, y no podrá responder consultas basadas en el material de entrenamiento eliminado. Puedes integrar esta funcionalidad en tu aplicación de Catalyst usando la API proporcionada a continuación. ### Detalles de la solicitud #### URL de solicitud <p>{api-domain}/convokraft/api/v1/bots/{botid}/rag_training_data?type=DEVELOPED El dominio específico del DC para acceder a Catalyst API El ID único del proyecto en el que se ha creado el bot El ID único del bot de ConvoKraft Nota: 1. El parámetro de consulta type=DEVELOPED se usa para indicar que el bot está en estado de desarrollo dentro del servicio ConvoKraft. 2. Puedes obtener el botid directamente desde la URL en el servicio ConvoKraft cuando el entorno está configurado en Development en la consola. Por ejemplo : <span style="pointer-events: none;word-break: break-all;">https://console.catalyst.zoho.com/baas/v1/project/183272829220/Development#/convokraft/bots/3828281991118</span> <br> Aquí, **3828281991118** es el botid. #### Scope ZIAPlatform.Convokraft.RAG.DELETE #### Encabezados de solicitud **Authorization:** Zoho-oauthtoken {oauth_token} <br> Content-Type: application/json <br> CATALYST-ORG: {org_id} <br> X-CATALYST-projectid: {project id} <br> X-CATALYST-Environment: Development <br> Nota: El encabezado de solicitud CATALYST-Environment: Development indica que la operación de la API debe realizarse en el bot dentro del entorno de desarrollo de Catalyst. #### Propiedades JSON de la solicitud Proporciona el ID único del material de entrenamiento generado por ConvoKraft. ### Detalles de la respuesta Esta API devuelve el estado de la operación de eliminación junto con su código de estado y mensaje.<br> <br> curl -X DELETE \ https://api.catalyst.zoho.com/baas/v1/project/4000000006007/convokraft/api/v1/bots/92738220219110/rag_training_data?type=DEVELOPED \ -H 'Authorization: Zoho-oauthtoken 1000.910*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*16.2f*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*57' \ -H 'Content-Type: application/json' \ -H 'CATALYST-ORG: 372822922' \ -H 'X-CATALYST-projectid: 2728172727718' \ -H 'X-CATALYST-Environment: "Development"' \ -\-data '{ "rag_training_data": [ { "id": "67799000000084013" } ] }' { "status": "SUCCESS", "code": "SUCCESS", "message": "Updated Successfully." } -------------------------------------------------------------------------------- title: "Obtener respuesta del bot" description: "Esta API se usa para obtener respuestas del bot entrenado después de habilitar SmartTrain en ConvoKraft." last_updated: "2026-07-02T09:34:15.878Z" source: "https://docs.catalyst.zoho.com/es/api/code-reference/convokraft/fetch-answer-from-bot/" service: "ConvoKraft" -------------------------------------------------------------------------------- # Obtener respuesta del bot Esta API te permite recuperar una respuesta del bot de ConvoKraft enviando una consulta de transcripción. El bot entenderá la pregunta y responderá con una respuesta basada en su entrenamiento. Puedes integrar esta funcionalidad en tu aplicación de Catalyst usando la API proporcionada a continuación. ### Detalles de la solicitud #### URL de solicitud <p>{api-domain}/convokraft/api/v1/bots/{production_botid}/answer El dominio específico del DC para acceder a Catalyst API El ID único del proyecto en el que se ha creado el bot El ID único del bot de ConvoKraft en el entorno de producción Nota: Puedes obtener el production_botid directamente desde la URL en el servicio ConvoKraft cuando el entorno está configurado en Production en la consola. Por ejemplo : <span style="pointer-events: none;word-break: break-all;">https://console.catalyst.zoho.com/baas/v1/project/183272829220/Production#/convokraft/bots/3828281991118</span> <br> Aquí, **3828281991118** es el production_botid. #### Scope ZIAPlatform.Convokraft.RAG.CREATE #### Encabezados de solicitud **Authorization:** Zoho-oauthtoken {oauth_token} <br> Content-Type: application/json <br> CATALYST-ORG: {org_id} <br> X-CATALYST-projectid: {project id} <br> X-CATALYST-Environment: Development <br> Nota: El encabezado de solicitud CATALYST-Environment: Production indica que la operación de la API debe realizarse en el bot dentro del entorno de producción de Catalyst. ### Detalles de la respuesta La API devuelve la respuesta proporcionada por ConvoKraft basándose en el material de entrenamiento, junto con el estado del proceso de recuperación de la respuesta. <br> curl -X POST \ https://api.catalyst.zoho.com/convokraft/api/v1/bots/92738220219110/answer \ -H 'Authorization: Zoho-oauthtoken 1000.910*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*16.2f*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*57' \ -H 'Content-Type: application/json' \ -H 'CATALYST-ORG: 372822922' \ -H 'X-CATALYST-projectid: 2728172727718' \ -H 'X-CATALYST-Environment: "Production"' \ -\-data '{ "transcript": { "message": "Explain Iphone 11 Specifications" } }' { "transcript": { "message": "The iPhone 11 is a sleek and powerful smartphone from Apple, featuring a 6.1-inch Liquid Retina HD display that offers vibrant colors and sharp detail. It's powered by the A13 Bionic chip, which ensures fast performance and smooth multitasking. Whether you're gaming, editing photos, or using apps, the iPhone 11 can handle it with ease. One of the standout features of the iPhone 11 is its camera system. It has a dual-camera setup, with a 12MP wide and ultra-wide lens, making it great for capturing detailed photos and videos. The Night Mode feature helps take clearer pictures in low-light environments, and it also supports 4K video recording at 60fps, allowing you to shoot high-quality videos.", "status": "action_completion" } } --- ## FAQ — ConvoKraft # General Catalyst ConvoKraft es un servicio impulsado por IA que se usa para crear bots conversacionales que se pueden configurar para comprender el mensaje del usuario, su intención y responder de forma conversacional en inglés. Puedes configurar la lógica backend de los bots de ConvoKraft usando Catalyst Integration Functions o Deluge. También puedes codificarlo en cualquier lenguaje de programación de tu elección, almacenarlo en cualquier servidor externo de acceso público y acceder a él en ConvoKraft usando Webhooks. Los bots creados en ConvoKraft no están autenticados y no podrás obtener los detalles del usuario actualmente conectado desde tu aplicación de Catalyst. # Bots Proporcionamos un paquete JavaScript Client SDK que te permite integrar el bot de ConvoKraft en tu aplicación fácilmente. Contiene elementos para personalizar la ventana del chat como el encabezado, título, alineación, etc. Consulta esta página para conocer más sobre los diversos elementos y su uso. Sí, necesitarás hacer clic en el botón Train en la consola y entrenar el bot cada vez después de hacer un cambio. Esto ayudará al bot a analizar patrones de invocación comunes y entrenar los modelos de procesamiento de lenguaje natural en el backend. Estos modelos ayudan a desarrollar correlaciones fuertes entre diferentes variaciones de la misma consulta del usuario y responder al usuario de forma inteligente. Sí, podrás obtener las estadísticas de uso de la interacción de tu bot desde la consola de Catalyst en el entorno de producción del bot. Sí, podrás entrenar el bot basándote en una lógica de negocio así como en una respuesta directa. Necesitas proporcionar los diferentes conjuntos de preguntas y respuestas de ejemplo para entrenar el bot. Una vez entrenado, el bot responderá las consultas basándose en los datos de entrenamiento. Puedes activar/desactivar el bot temporalmente directamente desde la consola de Catalyst. # Actions Puedes codificar tu handler de fallos ya sea en Deluge o integrar una función de Catalyst para manejar el fallo y también notificarte enviando un correo electrónico sobre el evento de fallo desde tu función. Sí, puedes usar la función invokeURL() de Deluge para hacer una llamada API al endpoint de la función de Catalyst y obtener la respuesta. # Handlers Puedes codificar tus diversos handlers como welcome handlers, failure handlers desde la consola usando el lenguaje de scripting propio de Zoho, Deluge, directamente desde la consola y también probar la función. También puedes asociar una función de integración de Catalyst al bot para una acción particular. Cada vez que se acceda al bot para la acción particular, tu función de integración se llamará automáticamente y la respuesta se devolverá al usuario a través del bot. Si eliges desarrollar la lógica del bot de tus bots de ConvoKraft usando Catalyst Integration Functions o acceder a la lógica backend codificada en cualquier servidor externo usando Webhooks, entonces puedes simplemente habilitar los handlers requeridos (Welcome Message Handler, Fallback Handler, Failure Handler) y luego codificar la lógica en las funciones de handler respectivas en tu base de código. Puedes obtener más información sobre esto en esta página.