InicioDocumentación

Integración del servidor MCP

ChatReact implementa el Model Context Protocol (MCP), lo que le permite conectar su cuenta de ChatReact a asistentes de IA como Claude Desktop, Cursor y otras herramientas compatibles con MCP.

¿Qué es MCP?

El Model Context Protocol es un estándar abierto que permite a los asistentes de IA interactuar con servicios y fuentes de datos externas. Con la integración MCP de ChatReact, usted puede:

  • Gestionar chatbots — crear, configurar (persona, idiomas, widget, comportamiento, restricciones), insertar y eliminar chatbots
  • Construir la base de conocimientos — añadir documentos, rastrear sitios web, gestionar páginas rastreadas e instrucciones principales
  • Gestionar FAQs — FAQs, categorías, sugerencias, traducciones y el widget de FAQ
  • Revisar chats — calificar conversaciones, asignar categorías de confianza, ejecutar el Improvement Agent
  • Trabajar con leads y formularios — leads, categorías de leads, ajustes de captura, formularios de contacto y envíos
  • Actuar como agente de chat en vivo — establecer su disponibilidad, hacerse cargo de chats en espera, responder y cerrar sesiones
  • Administrar su empresa — perfil, colores de marca, miembros del equipo e invitaciones
  • Usar el Email Assistant — conexiones de buzón, categorías, contactos y actividad
  • Leer analíticas y notificaciones

Todo lo que puede hacer en el panel está disponible mediante MCP (y la REST API); solo las acciones ligadas al navegador como pagos, OAuth de buzones, passkeys, eliminación de cuenta y gestión de claves API permanecen en el panel.

Primeros pasos

1. Genere una clave API

  1. Navegue a su Panel de control → Empresa → API pestaña
  2. Haga clic en Crear Clave API
  3. Dé a su clave un nombre descriptivo (p. ej., "Claude Desktop") y seleccione al menos un permiso
  4. Copie la clave generada (comienza con cr_)

Las claves API están disponibles en planes de pago — vea nuestra página de Precios.

Guarde su clave API de forma segura. No se puede recuperar después de crearla.

2. Configure su cliente MCP

El servidor MCP de ChatReact está alojado en https://www.chatreact.ai/api/mcp y se comunica por HTTP (JSON-RPC). Autentique con un encabezado Authorization: Bearer — también se acepta un encabezado X-API-Key con la misma clave.

Cursor IDE

Cursor admite servidores MCP remotos directamente. Añádalo a sus ajustes MCP de Cursor:

{
  "mcpServers": {
    "chatreact": {
      "url": "https://www.chatreact.ai/api/mcp",
      "headers": {
        "Authorization": "Bearer cr_your_api_key_here"
      }
    }
  }
}

Claude Desktop

El archivo de configuración de Claude Desktop admite servidores basados en comandos, así que use el puente estándar mcp-remote para conectarse al endpoint alojado:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "chatreact": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://www.chatreact.ai/api/mcp",
        "--header",
        "X-API-Key:cr_your_api_key_here"
      ]
    }
  }
}

Esta configuración requiere tener instalado Node.js. El ejemplo usa el encabezado X-API-Key porque algunos clientes no manejan bien los espacios en los argumentos.

3. Reinicie su asistente de IA

Después de guardar la configuración, reinicie Claude Desktop o Cursor para establecer la conexión.

Herramientas disponibles

ChatReact MCP expone las herramientas siguientes, agrupadas por área. La columna Scope muestra el permiso de la clave API que una herramienta requiere (any = toda clave válida). Las herramientas se ejecutan con los mismos permisos aplicables, límites del plan y efectos secundarios que las operaciones soportadas en el panel. Los flujos de trabajo ligados al navegador para pagos, autorización de buzón, passkeys, eliminación de cuenta y gestión de claves permanecen en el panel.

Las herramientas destructivas (eliminar, reiniciar, cerrar, fusionar) piden confirmación cuando se usan a través del Dashboard Assistant. Mediante clave API se ejecutan de inmediato.

Cuenta

ToolDescriptionScope
account_usage_getObtenga el plan actual (nivel, estado), los contadores de uso del periodo de facturación actual (empresas, chatbots, miembros del equipo, chats, tokens) y los límites del plan, además de los límites efectivos y flags de características de la empresa a la que la llamada está limitada.any
user_companiesListe todas las empresas a las que el usuario actual tiene acceso, con el rol del usuario en cada una.any
user_notification_mark_readMarque una de las notificaciones del usuario actual como leída.any
user_notification_preferences_getObtenga las preferencias de notificación del usuario actual: conmutadores globales email/push, frecuencia/hora/día de resumen, zona horaria, quiet hours y ajustes de canal por tipo.any
user_notification_preferences_updateActualice las preferencias globales de notificación del usuario actual (conmutadores email/push, horario de resumen, quiet hours).any
user_notification_type_setting_updateHabilite o deshabilite la entrega por email / en la app para un único tipo de notificación del usuario actual (por ejemploany
user_notification_types_listListe todos los tipos de notificación agrupados por categoría (chatbot, leads, live chat, knowledge, team, billing).any
user_notification_unread_countObtenga el número de notificaciones no leídas del usuario actual.any
user_notificationsListe las notificaciones del usuario actual, de la más nueva a la más antigua, con paginación por cursor.any
user_notifications_delete_oldTareas de mantenimiento: eliminar permanentemente las notificaciones del usuario actual que ya están leídas y tengan más de 30 días.any
user_notifications_mark_all_readMarcar todas las notificaciones del usuario actual como leídas.any
user_profileObtenga el perfil del usuario actual (id, nombre, email, rol, nivel de suscripción).any

Empresa y equipo

ToolDescriptionScope
company_chatbots_listListe todos los chatbots de una empresa específica con estadísticas resumidas.chatbots:read
company_getObtenga información detallada sobre una empresa: perfil, propietario, ajustes de marca (colores, email de notificaciones) y conteos.any
company_invite_cancelCancele (elimine) una invitación de equipo para que el enlace deje de funcionar.company:write
company_invite_resendReenvíe una invitación de equipo pendiente: emite un nuevo token, extiende la expiración 7 días y envía el email de invitación nuevamente.company:write
company_invites_listListe las invitaciones de equipo de una empresa (pendientes por defecto; establezca includeExpired para también devolver las expiradas).company:read
company_listListe todas las empresas a las que el usuario tiene acceso (las claves API y el Dashboard Assistant solo ven su propia empresa).any
company_logo_removeElimine el logo de la empresa (borra la imagen almacenada y limpia la URL del logo).company:write
company_member_inviteInvite a un miembro del equipo por email con un rol (ADMIN, MANAGER, AGENT o VIEWER).company:write
company_member_removeElimine un miembro del equipo de la empresa.company:write
company_member_update_roleCambie el rol de un miembro del equipo (ADMIN, MANAGER, AGENT o VIEWER).company:write
company_members_listListe los miembros de una empresa con sus roles (OWNER, ADMIN, MANAGER, AGENT, VIEWER).any
company_settings_updateActualice los ajustes de marca de la empresa: primaryColor / secondaryColor (#RRGGBB) y el notificationEmail para revisiones de chat.company:write
company_updateActualice el perfil de la empresa: nombre (2-100 caracteres), descripción (máx. 1000 caracteres) o sitio web (https:// se añade automáticamente; pase una cadena vacía para borrar sitio web/descrpción).company:write

Gestión de chatbots

ToolDescriptionScope
chatbot_add_instructionAñada una nueva instrucción principal a un chatbot (1-5000 caracteres).chatbots:write
chatbot_confirm_embedMarque un chatbot como insertado en el sitio web (oculta el recordatorio de configuración en el panel).chatbots:write
chatbot_createCree un nuevo chatbot (igual que el asistente del panel).chatbots:write
chatbot_deleteElimine permanentemente un chatbot con todas sus FAQs, documentos, chats, leads y formularios (no deshacer).chatbots:write
chatbot_delete_instructionElimine una instrucción principal de un chatbot.chatbots:write
chatbot_getObtenga información detallada sobre un chatbot: ajustes generales, personalidad (persona, tonalidad, idiomas, restricciones), ajustes del widget, chat en vivo, fase de aprendizaje, estado de inserción y conteos.chatbots:read
chatbot_get_embed_codeObtenga el fragmento HTML para instalar un chatbot en un sitio web (URL del script + etiqueta <script>) y si la inserción ha sido confirmada.chatbots:read
chatbot_get_instructionsObtenga todas las instrucciones principales de un chatbot.chatbots:read
chatbot_improve_instructionsReescriba el texto de una instrucción principal con el mejorador de IA de la plataforma (igual que "Improve with AI" del panel).chatbots:write
chatbot_learning_phase_getObtenga los ajustes de la fase de aprendizaje de un chatbot: preset de comportamiento (CAUTIOUS, BALANCED, CONFIDENT), prompt personalizado y si el bot aún está en fase de aprendizaje.chatbots:read
chatbot_learning_phase_updateEstablezca el preset de comportamiento de la fase de aprendizaje (CAUTIOUS = remitir a humano cuando no está seguro, BALANCED, CONFIDENT) y/o un prompt personalizado para la fase de aprendizaje.chatbots:write
chatbot_listListe todos los chatbots a los que el usuario tiene acceso, con estadísticas resumidas.chatbots:read
chatbot_reorder_instructionsEstablezca el orden de las instrucciones principales de un chatbot.chatbots:write
chatbot_templates_listListe las plantillas de chatbot (presets para persona, tonalidad, mensajes y comportamiento del widget) que pueden pasarse como templateId a chatbot_create, y si el plan de la empresa puede usarlas.chatbots:read
chatbot_toggle_activeActive o desactive un chatbot.chatbots:write
chatbot_toggle_learningFinalice (false) o vuelva a habilitar (true) la fase de aprendizaje de un chatbot.chatbots:write
chatbot_updateActualice los ajustes generales de un chatbot: nombre, descripción, isActive, live chat (liveChatEnabled/liveChatMode, característica del plan), showBranding (planes white-label), emails de revisión de chat, generación automática de FAQs, texto legacy de coreInstructions, fase de aprendizaje (isInLearningPhase, learningPhaseBehavior, learningPhaseCustomPrompt).chatbots:write
chatbot_update_instructionActualice una instrucción principal existente (content, isActive, channel, sortOrder).chatbots:write
chatbot_update_personalityActualice la personalidad de un chatbot: persona (usePersonaName, personaName, personaRole, personaBackground, communicationStyle), barras de tonalidad 1-5, idiomas (primaryLanguage, supportedLanguages, technicalLevel, timezone, formalAddress, speakAsCompany), mensajes (welcomeMessage, fallbackMessage, proactive greeting) y restricciones (blacklistTopics, complianceRules, maxResponseLength, human handoff).chatbots:write
widget_settings_getObtenga los ajustes actuales del widget para un chatbot (toda la apariencia, branding, comportamiento y campos de pre-chat).chatbots:read
widget_settings_updateActualice el widget de chat de un chatbot: posición (incl.chatbots:write
widget_translations_getObtenga las traducciones del widget por idioma de un chatbot: { '<lang>': { welcomeMessage, fallbackMessage, headerTitle, headerSubtitle, bubbleText } }.chatbots:read
widget_translations_updateEstablezca traducciones del widget por idioma.chatbots:write

Base de conocimientos

ToolDescriptionScope
crawler_job_cancelCancele un trabajo de rastreo PENDING o RUNNING; las páginas restantes se omiten.knowledge:write
crawler_job_getObtenga el estado de un trabajo de rastreo, progreso (pagesCrawled/pagesFound, tokensUsed) y el estado de cada página.knowledge:read
crawler_jobs_listListe los trabajos de rastreo de un chatbot (del más nuevo al más antiguo) con estado y progreso.knowledge:read
crawler_limitsObtenga los límites de rastreo del plan para un chatbot (máx. páginas por rastreo, tokens por página, rastreos por mes) y si se puede iniciar un nuevo rastreo este mes.knowledge:read
crawler_preview_scanEscanee un sitio web y liste sus páginas rastreables (url, title, isRecommended) sin importar nada.knowledge:write
crawler_startInicie un trabajo de rastreo que importe las URLs seleccionadas a la base de conocimientos del chatbot (procesado en segundo plano; sondee crawler_job_get).knowledge:write
knowledge_document_add_from_urlDescargue un documento (PDF, TXT, MD, CSV, JSON, DOCX; máx. 10 MB) desde una URL pública http(s) y añádalo a la base de conocimientos de un chatbot.knowledge:write
knowledge_document_add_textAñada un documento de texto o markdown a la base de conocimientos de un chatbot desde contenido inline (máx. 10 MB).knowledge:write
knowledge_document_deleteElimine un documento subido de la base de conocimientos.knowledge:write
knowledge_document_getObtenga detalles de un documento subido incluyendo el estado de procesamiento, mensaje de error y una URL de descarga de corta duración.knowledge:read
knowledge_documents_listListe los documentos subidos (PDF, TXT, MD, CSV, JSON, DOCX) en la base de conocimientos de un chatbot con estado y tamaño.knowledge:read
knowledge_page_addRastree una única URL y añádala a la base de conocimientos del chatbot (falla con CONFLICT cuando la URL ya está indexada, FORBIDDEN cuando se alcanza el límite de tokens).knowledge:write
knowledge_page_deleteElimine una página rastreada de la base de conocimientos (elimina su archivo de vector-store).knowledge:write
knowledge_page_getObtenga una página rastreada incluyendo el contenido en markdown que se indexó para el chatbot (útil para verificar lo que el bot sabe sobre una página).knowledge:read
knowledge_page_recrawlVuelva a obtener una página rastreada y reemplace su contenido indexado (p. ej.knowledge:write
knowledge_pages_deleteElimine varias páginas rastreadas de un chatbot a la vez.knowledge:write
knowledge_pages_listListe las páginas rastreadas en la base de conocimientos de un chatbot, opcionalmente filtradas por dominio, estado o término de búsqueda (URL/title).knowledge:read
knowledge_statsVisión general de la base de conocimientos de un chatbot: documentos (por estado, tamaño), páginas rastreadas y sitios web (por estado), trabajos de rastreo, instrucciones principales divididas por fuente (manual vs improvement agent), FAQs, estado/tamaño del vector store y uso de almacenamiento vs.knowledge:read
knowledge_website_deleteElimine todas las páginas rastreadas de un sitio web (dominio) de la base de conocimientos del chatbot.knowledge:write
knowledge_website_recrawlVuelva a rastrear todas las páginas de un sitio web (dominio) en la base de conocimientos del chatbot para refrescar su contenido.knowledge:write
knowledge_website_recrawl_cancelCancele una reindexación de sitio en curso: las páginas en cola (PENDING) del dominio se revierten a su estado indexado anterior.knowledge:write
knowledge_websites_listListe los sitios web (dominios) cuyas páginas están en la base de conocimientos de un chatbot, con conteos de páginas por estado y totales de tokens.knowledge:read

Gestión de precios

Estas herramientas gestionan borradores de precios estructurados y aprobaciones explícitas. Guardar un borrador está separado de aprobar la versión exacta; la elegibilidad también depende del estado y la validez. Las claves API existentes no obtienen permisos de precios automáticamente. Solo el propietario de la empresa puede otorgar prices:write o prices:approve. Las llamadas con clave API se ejecutan directamente, así que revise la entrada exacta antes de invocar una mutación. Consulte Prices & services para el flujo de trabajo del cliente.

ToolDescriptionScope
price_listPagine a través de price heads y la elegibilidad de versión aprobada por separado.prices:read
price_getLea el estado completo del ítem y sus revisiones.prices:read
price_detailLea el detalle del ítem con historial de revisiones paginado.prices:read
price_suggestions_listPagine a través de sugerencias de precio.prices:read
price_createCree un borrador con un ID de ítem generado por el servidor.prices:write
price_editCree un nuevo borrador desde una versión de ítem explícitamente esperada.prices:write
price_import_csvImporte borradores con un formato explícito y un ID de importación estable para reintentos seguros.prices:write
price_suggestion_applyAplique el candidato de sugerencia seleccionado como un borrador.prices:write
price_approveApruebe una versión de ítem explícitamente esperada.prices:approve
price_approve_manyApruebe una selección de ID/versiones explícitas de forma atómica; cualquier versión desactualizada rechaza toda la selección.prices:approve
price_archiveArchive un ítem en su versión explícitamente esperada.prices:approve

Las ediciones de borrador preservan la revisión aprobada anterior. El formato CSV y el separador decimal deben ser explícitos; el contenido CSV cambiado requiere un nuevo import ID. Todas las operaciones están ligadas a la empresa de la clave API y al chatbot especificado.

Gestión de FAQ

ToolDescriptionScope
faq_cache_purgeBorre los datos en caché del widget de FAQ en todos los sitios CMS conectados (plugin de WordPress).faqs:write
faq_categories_listListe las categorías de FAQ de un chatbot con sus conteos de FAQ, slugs, modo de orden y traducciones.faqs:read
faq_categories_reorderEstablezca el orden de las categorías de FAQ en el widget: la posición en categoryIds se convierte en sortOrder.faqs:write
faq_category_createCree una categoría de FAQ para un chatbot (el slug se genera a partir del nombre).faqs:write
faq_category_deleteElimine una categoría de FAQ.faqs:write
faq_category_translations_updateReemplace las traducciones de una categoría de FAQ, p. ej.faqs:write
faq_category_updateRenombre una categoría de FAQ o cambie su descripción, icono o modo de orden.faqs:write
faq_createCree una FAQ para un chatbot.faqs:write
faq_deleteElimine permanentemente una FAQ (también la remueve de la base de conocimientos del chatbot y purga las cachés del widget CMS).faqs:write
faq_embed_code_getObtenga los snippets de inserción para el widget de FAQ: etiqueta de script, shortcode de WordPress y snippet de Shopify Liquid, además de variantes por categoría (use categorySlug de faq_categories_list para insertar solo una categoría).chatbots:read
faq_getObtenga los detalles completos de una FAQ: pregunta, respuesta, categoría, estado de publicación, orden, traducciones, campos SEO y estadísticas de feedback.faqs:read
faq_listListe las FAQs de un chatbot (use chatbot_list para encontrar el chatbotId).faqs:read
faq_reorderEstablezca el orden de visualización de las FAQs en el widget.faqs:write
faq_suggestion_approveApruebe una sugerencia de FAQ en estado PENDING: crea una FAQ publicada (opcionalmente con pregunta/respuesta/categoría editadas) y marca la sugerencia como APPROVED.faqs:write
faq_suggestion_getObtenga los detalles completos de una sugerencia de FAQ (respuesta completa, razonamiento de la IA, categoría sugerida, estado de revisión).faqs:read
faq_suggestion_rejectRechace una sugerencia de FAQ PENDING con una razón opcional.faqs:write
faq_suggestions_generatePermita que la IA proponga nuevas FAQs desde la base de conocimientos del chatbot (páginas rastreadas / documentos subidos), opcionalmente para una categoría.faqs:write
faq_suggestions_listListe las sugerencias de FAQ generadas por IA de un chatbot (desde conversaciones de chat o faq_suggestions_generate).faqs:read
faq_translateTraduza la pregunta y respuesta de una FAQ con IA a los otros idiomas soportados por el chatbot (o a los targetLanguages dados) y guarde el resultado.faqs:write
faq_translations_updateGuarde traducciones de una FAQ por idioma, p. ej.faqs:write
faq_updateActualice la pregunta, respuesta, categoría, estado de publicación u orden manual de una FAQ.faqs:write
faq_widget_settings_getObtenga los ajustes de apariencia y comportamiento del widget de FAQ embebible (colores, radio de borde, título, espaciado, ancho máximo, allowMultipleOpen, autoOpenFirst, modo de orden, traducciones de título).chatbots:read
faq_widget_settings_updateActualice los ajustes del widget de FAQ: colores (hex), borderRadius 0-32, título (máx. 100) + showTitle, spacing compact|normal|relaxed, maxWidth 0-2000 (0 = ancho completo), allowMultipleOpen, autoOpenFirst, sortMode custom|date|name y traducciones de título por idioma.chatbots:write

Historial de chat y feedback

ToolDescriptionScope
chat_feedback_dismissMarque un chat como revisado sin calificarlo (lo elimina de la cola pendiente, no cambia la puntuación de confianza).chats:write
chat_feedback_getObtenga una revisión de chat (feedback) con análisis de IA, severidad, categoría de confianza, cambio de puntuación y la sesión de mejora vinculada.chats:read
chat_feedback_listListe las revisiones de chat (filas de feedback) de un chatbot con filtro por estado y conteos.chats:read
chat_feedback_set_severityAnule la clasificación de severidad (MINOR|MODERATE|MAJOR|CRITICAL) de un chat negativo revisado; la severidad pondera la caída de la puntuación de confianza.chats:write
chat_feedback_statsConteos de sesiones por bucket de revisión para un chatbot (total, none, pending, positive, negative, reviewed, improved) — las tarjetas de estadística de la página de chats del panel.chats:read
chat_feedback_submitCalifique una sesión de chat como Good (isPositive=true) o Needs Work (isPositive=false).chats:write
chat_session_getObtenga una sesión de chat con la transcripción completa (por mensaje token/model/latency/pageUrl), detalles del visitante, URL de la página iniciadora, categoría de confianza, feedback (severidad, análisis de IA, sesión de mejora vinculada) y etiquetas.chats:read
chat_session_searchBusque sesiones de chat de un chatbot por contenido de mensaje y/o email del visitante.chats:read
chat_session_set_categoryAsigne o cambie la categoría de confianza de una sesión de chat (corrige la categorización de la IA; la confianza por categoría se recalcula cuando el chat fue revisado).chats:write
chat_sessions_listListe las sesiones de chat de un chatbot, del más nuevo al más antiguo, con los mismos filtros de la cola de revisión que la página de chats del panel.chats:read

Improvement Agent

ToolDescriptionScope
confidence_categories_listListe las categorías de confianza de un chatbot con puntuación de confianza por categoría, conteo de revisiones y frecuencia de email de revisión.chats:read
confidence_category_createCree una categoría de confianza para un chatbot.chatbots:write
confidence_category_deleteElimine una categoría de confianza.chatbots:write
confidence_category_mergeFusione una categoría de confianza en otra del mismo chatbot: todos los chats/revisiones se mueven al objetivo, la fuente se elimina y las puntuaciones se recalculan.chatbots:write
confidence_category_updateRenombre una categoría de confianza y/o establezca su frecuencia de email de revisión (EVERY|HOURLY|DAILY|WEEKLY|NEVER; emailFrequencyHours 1-24 solo para HOURLY).chatbots:write
confidence_status_getEstado de confianza de un chatbot: puntuación, umbral de graduación, flag de fase de aprendizaje, comportamiento de fase de aprendizaje (CAUTIOUS|BALANCED|CONFIDENT) y prompt personalizado, conteos de revisión y puntuaciones de confianza por categoría.analytics:read
improvement_proposal_approveApruebe una propuesta de mejora PENDING y aplique el cambio al chatbot (agregar/actualizar instrucción principal, crear/actualizar FAQ o actualizar persona) — misma lógica y límites del plan que en el panel.chatbots:write
improvement_proposal_rejectRechace una propuesta de mejora PENDING.chatbots:write
improvement_proposal_simulateSimule cómo respondería el chatbot al mensaje problemático con una propuesta aplicada (original vs.chatbots:write
improvement_proposals_pendingListe las propuestas de mejora pendientes de revisión (estado PENDING) en la empresa o para un chatbot.chatbots:read
improvement_session_completeMarque una sesión de mejora como COMPLETED (el chat entonces cuenta como Improved en la cola de revisión).chatbots:write
improvement_session_createAbra el Improvement Agent para un chat calificado como Needs Work.chatbots:write
improvement_session_getObtenga una sesión de mejora con el chat original (los mensajes tienen un índice 1-based usable como targetMessageIndex), la conversación del agente, todas las propuestas (con su última simulación) y simulaciones.chatbots:read
improvement_session_resetReinicie una sesión de mejora: elimina todos los mensajes del agente, simulaciones y propuestas PENDING/REJECTED (las aplicadas se mantienen) y comienza una conversación nueva.chatbots:write
improvement_session_send_messageEnvíe un mensaje al Improvement Agent (describa qué falló en la respuesta del bot; opcionalmente targetMessageIndex = el índice 1-based del mensaje del bot en originalChat.messages).chatbots:write
improvement_sessions_listListe las sesiones de mejora (conversaciones del Improvement Agent iniciadas a partir de revisiones negativas) para un chatbot o toda la empresa, del más nuevo al más antiguo, con conteos de propuestas.chatbots:read
improvement_simulation_assessCalifique un resultado de simulación: isApproved=true cuando la respuesta simulada es buena (la propuesta puede aplicarse), false cuando necesita más trabajo (comentario 'almost' = casi correcta).chatbots:write

Chat en vivo

ToolDescriptionScope
live_chat_agents_availableObtenga la disponibilidad de chat en vivo del usuario actual, los agentes actualmente disponibles para chat en vivo (heartbeat reciente, la misma señal que usa el widget) y si el plan de la empresa incluye chat en vivo.chats:read
live_chat_heartbeatRefresque el heartbeat de presencia de chat en vivo del usuario actual (solo mientras esté marcado como disponible mediante live_chat_set_availability).chats:write
live_chat_message_sendEnvíe un mensaje al visitante como el agente asignado.chats:write
live_chat_queueObtenga la cola de chat en vivo: sesiones esperando un agente, de la más antigua a la más nueva (FIFO).chats:read
live_chat_session_assignTome una sesión de chat en vivo WAITING de la cola: la asigna al usuario actual (propietario de la empresa para claves API) y notifica al visitante que el agente se ha unido.chats:write
live_chat_session_closeFinalice una sesión de chat en vivo como agente (cualquier miembro de la empresa que no sea VIEWER).chats:write
live_chat_session_getObtenga una sesión de chat en vivo con información del visitante, agente asignado, todos los mensajes y la conversación previa del bot (contexto de handoff).chats:read
live_chat_sessions_listListe sesiones de chat en vivo (del más nuevo al más antiguo; sesiones WAITING las más antiguas primero) con filtros opcionales por chatbot, estado y agente asignado.chats:read
live_chat_set_availabilityAlterne el conmutador 'Available for Live Chat' del usuario actual para una empresa.chats:write

Leads

ToolDescriptionScope
lead_assignAsigne un lead a un miembro de la empresa o desasignelo (assignedToId: null).leads:write
lead_bulk_update_statusEstablezca el estado de varios leads (máx. 100) a la vez.leads:write
lead_categories_listListe las categorías de leads de un chatbot con conteos de leads y los miembros del equipo notificados por categoría.leads:read
lead_category_assign_userAñada un miembro de la empresa a la lista de notificación de una categoría de lead (o actualice sus flags de notificación).leads:write
lead_category_createCree una categoría de lead para un chatbot.leads:write
lead_category_deleteElimine una categoría de lead.leads:write
lead_category_remove_userQuite un miembro de la empresa de la lista de notificación de una categoría de lead.leads:write
lead_category_updateActualice el nombre, descripción y/o color de una categoría de lead.leads:write
lead_createCree un lead manualmente (p. ej.leads:write
lead_deleteElimine un lead permanentemente.leads:write
lead_field_config_getObtenga la configuración de captura de leads de un chatbot: campos (ids mapean a claves en lead.data), mensaje de confirmación, traducciones de campo/UI y ajustes de reconocimiento por IA.leads:read
lead_field_config_updateActualice la configuración de captura de leads de un chatbot.leads:write
lead_getObtenga detalles completos de un lead incluyendo asignado, categoría y la transcripción del chat fuente (paginada con messageOffset/messageLimit, por defecto los primeros 20 mensajes).leads:read
lead_listListe los leads de un chatbot (del más nuevo al más antiguo) con filtros opcionales por estado, categoría, asignado y búsqueda de texto libre (nombre/email/empresa).leads:read
lead_statsObtenga estadísticas de leads para un chatbot: conteos por estado, leads de los últimos 7 días y la tasa de conversión (porcentaje).leads:read
lead_updateActualice el estado, categoría, notas, datos capturados y/o asignado de un lead.leads:write

Formularios

ToolDescriptionScope
form_createCree un formulario de contacto para un chatbot (básicos, campos, diseño y ajustes anti-spam en una sola llamada).forms:write
form_deleteElimine permanentemente un formulario de contacto y TODOS sus envíos (en cascada).forms:write
form_getObtenga un formulario de contacto en su totalidad: campos, traducciones, estilo, ajustes anti-spam, estado activo, conteo de envíos y la etiqueta de inserción (embedCode).forms:read
form_listListe los formularios de contacto de un chatbot con conteo de campos, conteo de envíos y códigos de inserción.forms:read
form_statsConteos de envíos de un formulario de contacto: total, pending, approved, spam y rejected.forms:read
form_submission_deleteElimine permanentemente un envío de un formulario de contacto (p. ej.forms:write
form_submission_getObtenga un envío de formulario de contacto en su totalidad: datos de campos enviados, puntuación de spam y análisis de spam por IA, metadata IP/user agent/referrer y información de revisión.forms:read
form_submission_update_statusRevise un envío de formulario de contacto: establezca su estado a APPROVED, SPAM o REJECTED con una nota de revisión opcional.forms:write
form_submissions_listListe los envíos de un formulario de contacto, del más nuevo al más antiguo, opcionalmente filtrados por estado (PENDING, APPROVED, SPAM, REJECTED) y fecha de creación.forms:read
form_updateActualice un formulario de contacto: nombre, descripción, estado activo (isActive controla si el embed se renderiza), campos (reemplazo completo), diseño (colores, texto del botón, mensaje de éxito) y ajustes anti-spam (spamThreshold, autoRejectSpam, notificationEmail).forms:write
form_update_translationsReemplace las traducciones de campo y/o UI de un formulario de contacto.forms:write

Email Assistant

ToolDescriptionScope
email_activity_listListe el registro de actividad de email procesado de una conexión de buzón (del más nuevo al más antiguo): remitente, asunto, categoría asignada, resultado (CATEGORIZED, DRAFT_CREATED, SKIPPED_NO_RULE, SKIPPED_NO_KNOWLEDGE, SKIPPED_BY_TRIAGE, SKIPPED_QUOTA, ERROR) y outcomeDetail.email:read
email_categories_listListe las categorías de email de una conexión de buzón (ordenadas por sortOrder).email:read
email_category_createCree una categoría de email para una conexión de buzón (máx. 20 por conexión).email:write
email_category_deleteElimine una categoría de email.email:write
email_category_updateActualice una categoría de email (parcial: solo cambian los campos dados).email:write
email_connection_disconnectDesconecte un buzón de forma permanente.email:write
email_connection_getObtenga una conexión de buzón incl.email:read
email_connection_updateActualice una conexión de buzón: pausar/reanudar la sincronización (paused true/false; solo alterna ACTIVE<->DISABLED, nunca sobrescribe TOKEN_EXPIRED/ERROR), active/desactive la redacción de borradores (draftingEnabled) y la categorización/organización (organizingEnabled), re-apunte el chatbot que lo potencia (chatbotId de la misma empresa) o establezca la firma de respuesta HTML (signatureHtml, máx. 20000 caracteres; cadena vacía la borra).email:write
email_connections_listListe las conexiones de buzón del Email Assistant de la empresa (dirección, estado ACTIVE/DISABLED/TOKEN_EXPIRED/ERROR, última sincronización, último error, conmutadores drafting/organizing, chatbot que lo potencia, draftReadyCategoryCount = categorías que pueden generar borradores, baseRuleCount = reglas a nivel de chatbot "Chat + Email" aplicadas a cada borrador) junto con los límites del plan (emailAssistantEnabled, maxMailboxConnections, emailDraftsPerMonth).email:read
email_contact_deleteElimine un contacto de email aprendido (olvide el perfil del remitente, p. ej.email:write
email_contact_getObtenga un contacto de email aprendido con todos los hechos aprendidos, notas internas, relación, configuración de tratamiento formal/informal y estadísticas de email.email:read
email_contact_updateActualice un contacto de email aprendido.email:write
email_contacts_listListe los contactos de email aprendidos de la empresa (email más reciente primero) con relación, tratamiento formal/informal (formalAddress: true = formal 'Sie', false = informal 'Du', null = automático), conteo de hechos y vista previa de notas.email:read
email_folder_createCree una carpeta de correo bajo la bandeja de entrada (devuelve la existente si el nombre está tomado) para usarla como objetivo de movimiento de categoría.email:write
email_folders_listListe las carpetas a las que una categoría de email puede mover el correo, en vivo desde el buzón: subcarpetas de la bandeja, carpetas top-level personalizadas, archive, junk y trash (id 'deleteditems').email:read
email_general_rules_listListe las reglas a nivel de chatbot que se aplican a cada borrador de respuesta de un buzón: instrucciones principales activas con channel BOTH ("Chat + Email"), además de las legacy solo-email que todavía no se migraron a una categoría.email:read

Analíticas

ToolDescriptionScope
analytics_chat_volumeVolumen de chats (sesiones iniciadas) a lo largo del tiempo para gráficos y tendencias: periodo week/month/quarter/year, granularidad hour/day/week/month, opcionalmente para un chatbot.analytics:read
analytics_chatbot_statsRendimiento por chatbot de una empresa en una sola llamada (la tabla de rendimiento de chatbots del panel): id, nombre, slug, isActive, sesiones, mensajes, FAQs y leads por chatbot, ordenados por sesiones.analytics:read
analytics_formsEstadísticas de envíos de formularios de contacto para una empresa o un chatbot (widget de analíticas del panel): envíos por estado (pending/approved/rejected/spam), número de formularios, total, tasa de spam en porcentaje y la serie de envíos por día de los últimos 7 días.analytics:read
analytics_leadsEmbudo de leads para una empresa o un chatbot (widget de analíticas del panel): leads por estado (new/contacted/qualified/converted/lost), total, tasa de conversión en porcentaje y la serie de leads por día de los últimos 7 días.analytics:read
analytics_overviewVisión general de analíticas para una empresa o un chatbot: chats, mensajes, tasa de satisfacción y preguntas principales para un periodo rodante (day/week/month/year), además del widget de overview del panel (total chatbots/published FAQs/leads, sesiones hoy/esta semana/este mes, leads hoy/esta semana, envíos de formularios total/hoy/pending).analytics:read
dashboard_activityQué requiere atención actualmente (la vista principal del panel): por empresa, los chatbots con nuevos leads hoy, sugerencias de FAQ pendientes, envíos de formularios pendientes, chats en vivo en espera/activos o una fase de aprendizaje en curso.any

Ejemplos de flujos de trabajo

Añadir una instrucción principal

Pregúntele a su asistente de IA:

"Añada una instrucción principal a mi chatbot 'Support Bot': ofrecemos envío gratuito en pedidos superiores a €50"

El asistente usará chatbot_add_instruction con los parámetros adecuados.

Revisar sugerencias de mejora

"Muéstrame todas las propuestas de mejora pendientes para mi chatbot y explica qué cambios sugieren"

El asistente:

  1. Usará improvement_proposals_pending para obtener las propuestas
  2. Analizará y resumirá cada sugerencia
  3. Las aprobará o rechazará en su nombre con improvement_proposal_approve o improvement_proposal_reject

Analizar el rendimiento del chat

"Dame un informe semanal del volumen de chats y la satisfacción del cliente para mi chatbot"

El asistente usará analytics_overview y analytics_chat_volume para compilar un informe exhaustivo.

Importar un sitio web

"Escanee https://example.com, importe las páginas de producto y precios en mi 'Support Bot' y avíseme cuando el rastreo termine"

El asistente llamará a crawler_preview_scan, seleccionará las páginas relevantes, iniciará la importación con crawler_start y sondeará crawler_job_get hasta que el trabajo haya finalizado.

Revisar leads y envíos de formularios

"Muéstrame los nuevos leads de esta semana, asigne los cualificados a Anna y apruebe los envíos de formularios de contacto pendientes"

El asistente combina lead_list, lead_assign, form_submissions_list y form_submission_update_status.

Hacerse cargo de un chat en vivo

"Póngame disponible para chat en vivo y tome la conversación en espera más antigua"

El asistente usa live_chat_set_availability, live_chat_queue y live_chat_session_assign; las respuestas pasan por live_chat_message_send.

Seguridad

  • Las claves API están limitadas a su empresa y a los permisos que seleccione al crearlas (vea la columna Scope arriba)
  • Las claves se ejecutan con los permisos del propietario de la empresa; los límites del plan y las puertas de funciones aplican exactamente como en el panel
  • Las claves pueden revocarse en cualquier momento desde el panel
  • El acceso a la API está disponible en planes de pago — vea nuestra página de Precios

Resolución de problemas

Conexión fallida

  1. Verifique que su clave API es correcta
  2. Compruebe que la clave no haya sido revocada
  3. Asegúrese de que su plan incluya acceso a la API
  4. Reinicie su cliente MCP

Herramienta no encontrada

Reinicie su cliente MCP después de cambiar la configuración para que recargue las herramientas disponibles. Los nombres de las herramientas están en minúsculas con guiones bajos (p. ej., faq_list).


¿Necesita ayuda? Contacte con nuestro equipo de soporte →