Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| WAZION_API_KEY | Yes | WAzion API key for authentication |
Capabilities
Features and capabilities supported by this server
| Capability | Details |
|---|---|
| tools | {
"listChanged": false
} |
| resources | {
"subscribe": false,
"listChanged": false
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| get_shop_status | Consultar estado actual — Obtiene el estado actual de la tienda: idioma, creditos, configuracion basica [query] |
| update_language | Cambiar idioma — Cambia el idioma del dashboard y las respuestas de la IA [mutation] |
| update_timezone | Cambiar zona horaria — Cambia la zona horaria para mostrar fechas y horas correctamente [mutation] |
| update_date_format | Cambiar formato de fecha — Cambia el formato en que se muestran las fechas [mutation] |
| toggle_auto_translate | Activar/desactivar traduccion automatica — Activa o desactiva la traduccion automatica de mensajes [mutation] |
| update_store_url | Cambiar URL de la tienda — Actualiza la URL de tu tienda online [mutation] |
| update_business_name | Cambiar nombre del negocio — Actualiza el nombre publico de tu negocio. Se muestra en los mensajes de marketing y en la pagina de baja de WhatsApp. [mutation] |
| update_business_info | Actualizar informacion del negocio — Actualiza el tipo de negocio, tipo de venta y descripcion del negocio. Esta informacion ayuda a la IA a entender mejor tu negocio y dar respuestas mas relevantes. [mutation] |
| list_agents | Listar agentes — Lista todos los agentes del comercio con detalles de perfil y permisos [query] |
| create_agent | Crear agente — Crea un nuevo agente de atencion. Puede fallar si se ha alcanzado el limite de agentes del plan actual. [mutation] |
| update_agent | Editar agente — Modifica los datos de un agente existente [mutation] |
| delete_agent | Eliminar agente — Elimina un agente de atencion [mutation] (requiere confirmación: pasar confirm=true para ejecutar) |
| get_agent_permissions | Ver permisos de un agente — Obtiene los permisos configurados de un agente y el registro completo de permisos disponibles [query] |
| save_agent_permissions | Guardar permisos de un agente — Actualiza los permisos de un agente. Enviar null para dar todos los permisos, o un objeto con los permisos especificos en true/false [mutation] (requiere confirmación: pasar confirm=true para ejecutar) |
| get_usage_stats | Ver estadisticas de uso — Muestra el uso de creditos, tokens y costes de los ultimos dias [query] |
| get_analytics | Ver analytics — Muestra metricas de rendimiento: conversaciones, mensajes, actividad diaria [query] |
| toggle_analytics | Activar/desactivar analytics — Activa o desactiva el registro de analytics con structured outputs para esta tienda [mutation] |
| toggle_autolearning | Activar/desactivar auto-learning — Activa o desactiva el aprendizaje automatico de la IA [mutation] |
| toggle_web_search | Activar/desactivar busqueda web — Activa o desactiva la busqueda en internet de la IA. Cuando esta activa, la IA puede buscar informacion actualizada en internet para responder preguntas sobre tendencias, precios del mercado, noticias o datos que cambian frecuentemente. [mutation] |
| get_prompt | Ver prompt actual — Muestra el prompt actual de la IA [query] |
| get_prompt_history | Ver historial de prompts — Muestra las versiones anteriores del prompt [query] |
| connect_ecommerce | Conectar plataforma e-commerce — Conecta tu tienda online (Shopify, WooCommerce, PrestaShop o VTEX) para buscar productos, pedidos y clientes. Pregunta al usuario que plataforma usa. [mutation] (requiere confirmación: pasar confirm=true para ejecutar) |
| test_ecommerce_connection | Probar conexion e-commerce — Verifica que la conexion con la plataforma e-commerce (Shopify, WooCommerce, PrestaShop o VTEX) funciona correctamente. Usa las credenciales guardadas si no se proporcionan. [query] |
| verify_ecommerce_write_permission | Verificar permisos de escritura — Verifica si la conexion con la plataforma e-commerce tiene permisos de escritura para sincronizar FAQs. Requiere plataforma conectada Y plugin Product Q&A configurado. [query] |
| get_webhook_config | Ver configuracion de webhooks — Lee la configuracion actual de webhooks de la tienda: si estan activados, URL configurada, eventos suscritos y si tiene secret. Usa esta accion SIEMPRE antes de configurar o modificar webhooks, y cuando el usuario pregunte sobre su configuracion de webhooks. [query] |
| configure_webhooks | Configurar webhooks — Modifica la configuracion de webhooks. IMPORTANTE: Antes de llamar esta accion, llama SIEMPRE a get_webhook_config para ver la configuracion actual y confirmar con el usuario que datos quiere cambiar. Solo llama esta accion cuando tengas los datos concretos (URL, eventos, etc). Tras llamar esta accion, el sistema pedira confirmacion con botones - NO vuelvas a llamar a esta accion. [mutation] (requiere confirmación: pasar confirm=true para ejecutar) |
| test_webhook | Probar webhook — Envia un webhook de prueba. Usa automaticamente la URL y secret configurados en la tienda si no se proporcionan parametros. [mutation] |
| update_custom_functions | Configurar funciones personalizadas IA — Define APIs que la IA puede llamar durante conversaciones [mutation] (requiere confirmación: pasar confirm=true para ejecutar) |
| update_crm_endpoints | Configurar endpoints CRM — Define endpoints para sincronizar datos con tu CRM [mutation] (requiere confirmación: pasar confirm=true para ejecutar) |
| configure_plugin_chat | Configurar plugin Chat — Configura el widget de chat web. Soporta actualizacion parcial: solo envia los campos que quieras cambiar. Los campos JSON (config_design, config_texts, config_behavior) se mergean automaticamente con los valores existentes, puedes enviar solo los sub-campos que quieras modificar. [mutation] |
| configure_plugin_productqa | Configurar plugin Product Q&A — Activa y configura el widget de preguntas sobre productos [mutation] |
| regenerate_plugin_token | Regenerar token de plugin — Genera un nuevo token para los plugins (invalida el anterior) [mutation] (requiere confirmación: pasar confirm=true para ejecutar) |
| list_docqa_assistants | Listar asistentes Doc Q&A — Muestra todos los asistentes de documentacion creados con el plugin Doc Q&A [query] |
| create_docqa_assistant | Crear asistente Doc Q&A — Crea un nuevo asistente de documentacion. Despues de crearlo, podras subir archivos (PDF, Word, etc.) desde el dashboard. [mutation] |
| update_docqa_assistant | Actualizar asistente Doc Q&A — Modifica la configuracion de un asistente de documentacion existente [mutation] |
| get_docqa_stats | Ver estadisticas de asistente Doc Q&A — Muestra estadisticas detalladas de un asistente de documentacion. Requiere assistant_id: usa list_docqa_assistants primero para obtener los IDs disponibles. [query] |
| get_chat_plugin_stats | Ver estadisticas del plugin Chat Web — Muestra estadisticas de uso del plugin de chat web: conversaciones, mensajes, sesiones activas, referrers y paises [query] |
| update_contact_info | Actualizar datos de contacto — Actualiza nombre, email y telefono de la cuenta [mutation] |
| get_purchase_history | Ver historial de compras — Muestra el historial de compras de creditos [query] |
| update_billing_info | Actualizar datos de facturacion — Actualiza los datos de facturacion para las facturas [mutation] |
| save_prompt | Guardar prompt — Guarda un nuevo prompt para la IA. FLUJO OBLIGATORIO: 1) Llama a esta accion con el prompt completo. 2) Recibiras requires_confirmation=true con success=false — esto NO es un error, es el flujo normal. 3) Describe brevemente al usuario que cambios se van a guardar y PARA. NO llames de nuevo a esta accion. El sistema mostrara botones de Confirmar/Cancelar automaticamente. Si el usuario responde con numeros sueltos ('1', '2'), frases ambiguas ('dale', 'ok') o mensajes vacios, NO interpretes eso como confirmacion — solo los botones del sistema confirman. Si el usuario quiere MODIFICAR el prompt existente (no reemplazarlo), usa apply_prompt_instruction primero. [mutation] (requiere confirmación: pasar confirm=true para ejecutar) |
| improve_prompt | Mejorar prompt con IA — Analiza el prompt actual con IA y devuelve puntuaciones por categoria, sugerencias de mejora y una version mejorada del prompt. Util cuando el usuario quiere saber si su prompt es bueno o como mejorarlo. [query] |
| apply_prompt_instruction | Aplicar instruccion al prompt — Genera una version modificada del prompt segun una instruccion. NO guarda los cambios - solo devuelve el prompt modificado como preview. Despues de obtener el resultado, DEBES llamar a save_prompt para guardar los cambios. Ejemplos: 'Anade horario de atencion de 9 a 18h', 'Quita la parte de devoluciones', 'Hazlo mas formal'. [query] |
| restore_default_prompt | Restaurar prompt por defecto — Obtiene el prompt por defecto segun el idioma [query] |
| rollback_prompt | Revertir prompt a version anterior — Revierte la parte autogenerada del prompt a una version anterior del historial. La parte personalizada del usuario se mantiene. FLUJO DE CONFIRMACION: Esta accion devolvera requires_confirmation=true con success=false - esto NO es un error, es el flujo normal. Cuando recibas esto, describe brevemente al usuario que version se va a restaurar y PARA. NO llames de nuevo a esta accion. El sistema mostrara botones automaticamente. [mutation] (requiere confirmación: pasar confirm=true para ejecutar) |
| get_autolearning_metrics | Ver metricas de autolearning — Muestra las metricas del sistema de aprendizaje automatico. Se puede filtrar por estado de los snippets. [query] |
| apply_training_suggestion | Aplicar sugerencia de entrenamiento — Aplica una sugerencia de entrenamiento de IA. Segun el nivel, crea un snippet de conocimiento o actualiza el prompt del asistente. [mutation] (requiere confirmación: pasar confirm=true para ejecutar) |
| dismiss_training_suggestion | Descartar sugerencia de entrenamiento — Descarta una sugerencia de entrenamiento de IA con motivo opcional. [mutation] |
| list_knowledge_snippets | Listar snippets de conocimiento — Lista snippets de conocimiento filtrados por estado (pendiente, activo, en conflicto, obsoleto, rechazado) [query] |
| update_knowledge_snippet | Gestionar snippet de conocimiento — Permite aprobar, rechazar, editar o eliminar un dato aprendido. Usa filter=pending en list_knowledge_snippets para ver los pendientes de revision. IMPORTANTE: Esta accion requiere confirmacion - ver seccion confirmation_flow. [mutation] (requiere confirmación: pasar confirm=true para ejecutar) |
| smart_knowledge_update | Actualización inteligente de conocimiento — Busca y actualiza datos aprendidos que contradigan o estén desactualizados según la instrucción del usuario. Usa esto cuando el usuario dice cosas como 'ahora aceptamos PayPal', 'hemos cambiado el horario', 'ya no hacemos envíos a X', etc. Primero llama SIN confirm para ver preview, luego con confirm=true y selected_ids para ejecutar. [mutation] (requiere confirmación: pasar confirm=true para ejecutar) |
| configure_ecommerce_locales | Configurar idiomas de la plataforma — Configura como se manejan los idiomas y URLs de tu plataforma e-commerce [mutation] |
| update_customer_tags | Configurar etiquetas de clientes — Configura las etiquetas para clasificar clientes [mutation] |
| update_order_settings | Configurar pedidos — Configura prefijos de pedidos y telefonos/emails a ignorar [mutation] |
| get_plugin_conversations | Ver conversaciones del plugin — Muestra las conversaciones del plugin de chat web. Soporta filtros por periodo de tiempo. [query] |
| test_shopify_connection | Probar conexion Shopify — Valida la conexion con una tienda Shopify verificando las credenciales y los permisos OAuth. Si no se proporcionan credenciales, usa las almacenadas en la configuracion de la tienda. [query] |
| test_crm_endpoint | Probar endpoint CRM — Prueba la conectividad y respuesta de un endpoint CRM personalizado configurado en la tienda [query] |
| regenerate_api_key | Regenerar API key del dashboard — Genera una nueva API key (token_ext) para la tienda. Esto invalida la key actual e impide el acceso de cualquier conexion MCP o aplicacion que la use. Usar solo si el usuario lo pide explicitamente. [mutation] (requiere confirmación: pasar confirm=true para ejecutar) |
| get_api_key | Ver API key actual — Muestra la API key actual de la tienda (token_ext) y la URL del servidor MCP. Usa esta accion cuando el usuario pregunte por su API key, token, como conectar MCP, o como configurar Claude/Cursor/VS Code. [query] |
| get_product_qa_stats | Ver estadisticas de Product Q&A — Muestra estadisticas del plugin de preguntas sobre productos [query] |
| get_product_qa_questions | Ver preguntas de Product Q&A — Muestra las preguntas sobre productos. Soporta filtros por periodo de tiempo. [query] |
| publish_question_as_faq | Publicar pregunta como FAQ — Publica manualmente una pregunta del historial como FAQ en tu tienda online. Util para promover preguntas importantes que no fueron detectadas automaticamente. [mutation] |
| get_product_qa_faqs | Ver FAQs publicadas — Lista las FAQs publicadas del plugin Product Q&A, agrupadas por producto. Requiere que el plugin Product Q&A este configurado/activado. [query] |
| manage_faq | Gestionar FAQs — Permite despublicar, republicar o eliminar FAQs del plugin Product Q&A. Util para gestionar contenido que ya no es relevante. [mutation] (requiere confirmación: pasar confirm=true para ejecutar) |
| disconnect_ecommerce | Desconectar plataforma e-commerce — Desconecta la integracion con tu plataforma e-commerce (Shopify, WooCommerce, etc.) [mutation] (requiere confirmación: pasar confirm=true para ejecutar) |
| get_storage_status | Ver estado de almacenamiento — Muestra el uso actual de almacenamiento y el plan activo [query] |
| list_storage_files | Listar archivos de almacenamiento — Muestra la lista de archivos subidos a la base de conocimiento con su tamano y fecha [query] |
| get_credits_info | Ver informacion de creditos — Muestra informacion detallada sobre los creditos disponibles: gratuitos, comprados, porcentaje usado y fecha de renovacion. Usa esta accion cuando el usuario pregunte especificamente por creditos. [query] |
| send_support_ticket | Enviar ticket de soporte — Envia un mensaje al equipo de soporte de WAzion. Usa esta accion cuando el usuario tenga un problema que no puedas resolver, quiera reportar un bug, o necesite ayuda del equipo tecnico. [mutation] |
| list_whatsapp_workflows | Listar workflows de WhatsApp — Obtiene la lista de todos los workflows de automatizacion de WhatsApp. OBLIGATORIO llamar esta accion ANTES de cualquier operacion de eliminacion (delete_whatsapp_workflow, bulk_delete_workflows) para identificar workflows por nombre e ID y confirmar con el usuario cuales quiere eliminar. Tambien usar antes de 'unir' o 'combinar' workflows para entender la configuracion actual. [query] |
| create_whatsapp_workflow | Crear workflow de WhatsApp — Crea un nuevo workflow de automatizacion para respuestas de WhatsApp. Campos requeridos: name y actions. Si el usuario no especifica nombre, genera uno descriptivo automaticamente (ej: 'Respuesta IA fuera horario'). Si el usuario pide crearlo desactivado o para revision, usa status='disabled'. Por defecto se crea activo. LIMITE: maximo 10 workflows por tienda. Si recibes error de limite alcanzado, NO reintentes crear — en su lugar: 1) Llama a list_whatsapp_workflows para mostrar los existentes, 2) Sugiere al usuario eliminar workflows que ya no necesite o reutilizar uno existente con update_whatsapp_workflow. [mutation] |
| toggle_whatsapp_workflow | Activar/Pausar workflow — Activa o pausa un workflow de WhatsApp existente [mutation] |
| delete_whatsapp_workflow | Eliminar workflow — SOLO para BORRAR/ELIMINAR un workflow de WhatsApp de forma permanente. NO usar para editar, modificar, añadir palabras, simular, probar, unir, combinar ni reorganizar workflows. Si el usuario quiere cambiar algo, usar update_whatsapp_workflow. Si dice 'unir' o 'combinar' workflows, NO borrar ninguno — usar update_whatsapp_workflow para fusionar condiciones/acciones en uno existente. Antes de eliminar, SIEMPRE llama a list_whatsapp_workflows para confirmar con el usuario EXACTAMENTE cual workflow quiere borrar por nombre e ID. FLUJO DE CONFIRMACION OBLIGATORIO: Esta accion devolvera success=false con requires_confirmation=true — esto NO es un error, es el paso 1 del flujo normal de confirmacion. Cuando recibas esta respuesta: 1) Describe brevemente al usuario que workflow se eliminara, 2) PARA completamente, 3) NUNCA vuelvas a llamar a esta misma accion — hacerlo INVALIDA el token de confirmacion y rompe el flujo. Los botones de Confirmar/Cancelar aparecen automaticamente en la interfaz del usuario. [mutation] (requiere confirmación: pasar confirm=true para ejecutar) |
| get_whatsapp_conversation_history | Ver historial de conversacion WhatsApp — Muestra el historial de mensajes de WhatsApp con un telefono especifico [query] |
| list_knowledge_files | Listar archivos de base de conocimiento — Muestra todos los archivos subidos a la base de conocimiento (PDFs, documentos, etc.) [query] |
| get_whatsapp_workflow_logs | Ver logs de workflows WhatsApp — Obtiene el historial de ejecuciones de workflows de WhatsApp Auto con filtros de fecha [query] |
| delete_knowledge_file | Eliminar archivo de conocimiento — Elimina un archivo de la base de conocimiento (no permite eliminar archivos de sistema) [mutation] (requiere confirmación: pasar confirm=true para ejecutar) |
| toggle_knowledge_file | Activar/desactivar archivo de conocimiento — Activa o pausa un archivo sin eliminarlo (la IA solo usa archivos activos) [mutation] |
| create_knowledge_file | Crear archivo de conocimiento desde texto — Crea un nuevo archivo en la base de conocimiento a partir de contenido de texto. Ideal para anadir informacion como promociones, politicas, instrucciones, FAQs, etc. sin necesidad de subir un archivo manualmente. [mutation] |
| disconnect_whatsapp | Desconectar WhatsApp — Desconecta una sesion de WhatsApp y elimina los datos de autenticacion. Si hay multiples numeros, requiere session_id. [mutation] (requiere confirmación: pasar confirm=true para ejecutar) |
| reconnect_whatsapp | Reconectar WhatsApp — Intenta reconectar una sesion de WhatsApp existente (puede requerir escanear QR manualmente). Si hay multiples numeros, requiere session_id. [mutation] |
| sync_knowledge_now | Sincronizar conocimiento ahora — Fuerza la sincronizacion inmediata de los facts aprendidos al Vector Store (normalmente se hace automaticamente) [mutation] |
| update_knowledge_file | Actualizar archivo de conocimiento — Cambia el titulo, descripcion y/o contenido de un archivo de conocimiento. Para archivos de texto (txt, md, csv, json, html) tambien permite editar el contenido del archivo. [mutation] |
| list_whatsapp_agents | Listar agentes de atencion — Muestra todos los agentes disponibles para asignar en workflows de WhatsApp [query] |
| update_whatsapp_workflow | Editar workflow de WhatsApp — Modifica un workflow existente (cambiar condiciones, añadir/quitar palabras clave, editar acciones, renombrar, activar/desactivar). Soporta update parcial: solo se sobreescriben los campos que se envian, los demas se mantienen sin cambios. IMPORTANTE: el parametro 'id' es OBLIGATORIO y debe ser el ID numerico del workflow (obtenido de list_whatsapp_workflows). Si el usuario dice 'ajustalo', 'yes apply', 'hazlo' u otra respuesta de seguimiento, DEBES recordar el workflow_id del contexto previo de la conversacion y enviarlo. NUNCA enviar esta accion sin 'id'. Para cambiar solo el mensaje de una accion: SIEMPRE leer primero con list_whatsapp_workflows, copiar el array de actions completo preservando TODOS los valores originales (especialmente delay seconds), y enviar el array modificado. Si solo cambias name, conditions o status, NO envies 'actions' — se preservan automaticamente. [mutation] |
| get_onboarding_status | Ver estado del onboarding — Muestra el progreso de configuracion inicial del usuario (setup guide) [query] |
| get_plugin_embed_code | Obtener codigo embed de plugin — Genera el codigo de instalacion (embed code) para un plugin. Usalo cuando el usuario necesite el codigo para instalar Chat Web, Product Q&A o Doc Q&A en su web. [query] |
| update_whatsapp_session | Editar sesion de WhatsApp — Actualiza la etiqueta (nombre) de una sesion de WhatsApp conectada. Util para identificar numeros (ej: 'Soporte', 'Ventas'). [mutation] |
| get_whatsapp_qr | Obtener QR de WhatsApp — Obtiene el codigo QR de WhatsApp para que el usuario lo escanee. IMPORTANTE: Requiere que exista una sesion previa (estado qr_pending). Si no hay sesion, usa connect_whatsapp primero para crear una. Si ya esta conectado, informa del estado. Devuelve una URL de imagen que puedes mostrar inline con |
| toggle_auto_describe_images | Activar/desactivar lectura automatica de medios — Activa o desactiva el analisis automatico de imagenes, documentos PDF y audios enviados por clientes via WhatsApp. Afecta a todos los sistemas de IA (Piloto Automatico, WhatsApp Auto, respuestas manuales) [mutation] |
| get_mass_marketing_config | Obtener configuracion de marketing masivo — Obtiene la configuracion actual de marketing masivo (auto-respuesta, texto de baja, aprobacion) [query] |
| save_mass_marketing_config | Guardar configuracion de marketing masivo — Guarda la configuracion de marketing masivo: auto-respuesta, traduccion y opciones de envio [mutation] |
| list_contact_lists | Listar listas de contactos — Obtiene todas las listas de contactos de marketing masivo de la tienda [query] |
| create_contact_list | Crear lista de contactos — Crea una nueva lista de contactos para campanas de marketing masivo [mutation] |
| delete_contact_list | Eliminar lista de contactos — Elimina una lista de contactos y todos sus contactos asociados. Esta accion no se puede deshacer. [mutation] (requiere confirmación: pasar confirm=true para ejecutar) |
| list_campaigns | Listar campanas de marketing — Obtiene todas las campanas de marketing masivo de la tienda [query] |
| create_campaign | Crear campana de marketing — Crea una nueva campana de marketing masivo. Puede crearse como borrador o programarse para una fecha futura. Soporta variables de plantilla {nombre}, {telefono}, {tienda} en el mensaje. [mutation] |
| start_campaign | Iniciar campana de marketing — Inicia el envio de una campana de marketing masivo. Funciona con campanas en estado borrador o programadas. [mutation] (requiere confirmación: pasar confirm=true para ejecutar) |
| pause_campaign | Pausar campana — Pausa temporalmente una campana de marketing masivo en curso [mutation] |
| resume_campaign | Reanudar campana — Reanuda una campana de marketing masivo que fue pausada [mutation] |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
| Shop Profile | Current shop configuration, credits, WhatsApp status, and key metrics. Read this first to understand the shop context. |