plugin.json

{
  "$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json",
  "name": "hoverbot",
  "version": "1.0.3",
  "description": "Read-only access to one HoverBot workspace: chatbots, knowledge sources, shopper conversations, unanswered questions, analytics and captured leads.",
  "author": {
    "name": "VGTech",
    "email": "hi@hoverbot.ai",
    "url": "https://www.hoverbot.ai/about"
  },
  "homepage": "https://www.hoverbot.ai",
  "license": "Proprietary",
  "keywords": [
    "chatbot",
    "customer support",
    "analytics",
    "knowledge base"
  ],
  "extensions": {
    "com.openai": {
      "interface": {
        "displayName": "HoverBot",
        "shortDescription": "See what your chatbot missed",
        "longDescription": "This plugin gives ChatGPT read-only access to one HoverBot workspace, so the people who run a support bot can ask about it in plain language instead of reading dashboards.\n\nIt answers questions like: what did shoppers ask about returns last week that the bot could not answer, how does this week's conversation volume compare to last week's, and which knowledge sources mention the refund window.\n\nHoverBot is an AI chatbot platform that answers customer questions from a company's own catalog, policies, and documentation.\n\nNine tools are available. list_chatbots and get_chatbot return the bots in the workspace and one bot's configuration, including its system prompt and knowledge libraries. list_knowledge_sources and search_knowledge cover the files, links, text and question-and-answer pairs that ground its replies. list_conversations and get_conversation return recent shopper conversations and full transcripts, with the retrieval confidence for each turn. get_unanswered_questions reports questions the bot answered from weak grounding and questions that produced no answer at all, each with its conversation id. get_analytics_summary returns conversation and message volume, active sessions, response rate and average response time, this week against last. list_leads returns the contact details the bots captured.\n\nEvery tool is read-only. The plugin cannot change a chatbot, edit a knowledge base, contact a lead, or alter any setting.\n\nAccess is granted by signing in to HoverBot, and the grant fixes which workspace the plugin can read. The workspace is never taken from a tool argument, so the plugin cannot reach another customer's data. Access tokens are listed in the HoverBot dashboard with the time each was last used, and revoking one takes effect on the next request.\n\nsearch_knowledge matches keywords rather than meaning; the chatbot's own answering uses semantic retrieval, and this tool does not.",
        "developerName": "VGTech",
        "category": "Data & Analytics",
        "capabilities": [
          "Find questions your chatbot could not answer",
          "Read shopper conversation transcripts",
          "Compare conversation volume week over week",
          "Search the chatbot's knowledge sources",
          "List leads captured by your chatbots"
        ],
        "websiteURL": "https://www.hoverbot.ai",
        "supportURL": "https://www.hoverbot.ai/guides/connect-ai-assistant",
        "privacyPolicyURL": "https://www.hoverbot.ai/privacy-policy",
        "termsOfServiceURL": "https://www.hoverbot.ai/terms-of-service",
        "defaultPrompt": [
          "What did shoppers ask about returns last week that we could not answer?",
          "Compare my conversation volume and response rate against last week.",
          "Which knowledge sources mention the refund window, and what do they say?"
        ],
        "brandColor": "#8a5a28",
        "brandColorDark": "#c2954f",
        "composerIcon": "./assets/logo.png",
        "logo": "./assets/logo.png"
      },
      "review": {
        "test_cases": {
          "positive": [
            {
              "description": "List the chatbots in the workspace",
              "prompt": "List my chatbots.",
              "tools_triggered": "list_chatbots",
              "expected_behavior": "Returns every chatbot in the reviewer workspace with its name, type and publish status."
            },
            {
              "description": "Find questions the bot could not answer",
              "prompt": "What did shoppers ask in the last 7 days that the bot could not answer?",
              "tools_triggered": "get_unanswered_questions",
              "expected_behavior": "Returns the questions the bot could not answer in the last 7 days, each with a reason (low confidence, fallback reply or no response) and a conversation id."
            },
            {
              "description": "Open one conversation transcript",
              "prompt": "Show me the full conversation for the first of those questions.",
              "tools_triggered": "get_conversation",
              "expected_behavior": "Returns that conversation's transcript in order, including the bot's fallback reply, with the retrieval confidence for each bot turn."
            },
            {
              "description": "Compare this week with last week",
              "prompt": "How did conversation volume this week compare to last week?",
              "tools_triggered": "get_analytics_summary",
              "expected_behavior": "Returns conversation and message volume for this week and last week. The reviewer workspace was created recently, so last week may be zero."
            },
            {
              "description": "Search the knowledge sources",
              "prompt": "Which knowledge sources mention returns?",
              "tools_triggered": "search_knowledge",
              "expected_behavior": "Returns the question-and-answer sources about returns and refunds, with an excerpt from each."
            }
          ],
          "negative": [
            {
              "description": "Write request. Every tool is read-only, so no tool can change a chatbot. The assistant should say the plugin cannot make changes and point to the HoverBot dashboard.",
              "prompt": "Change my bot's greeting to 'Hi there'."
            },
            {
              "description": "Outreach request. The plugin can list leads but cannot contact them. The assistant should decline to send anything.",
              "prompt": "Email every lead from this week a 10% discount code."
            },
            {
              "description": "Cross-tenant request. No tool takes a workspace argument, so only the signed-in workspace is reachable. The assistant should say it can only see this workspace.",
              "prompt": "Show me another company's chatbots."
            }
          ]
        },
        "commerce": false,
        "commerce_description": "HoverBot's plugin does not sell products or process payments.",
        "demo_recording_url": "https://www.hoverbot.ai/demos/hoverbot-openai-plugin-demo.mp4"
      },
      "publication": {
        "release_notes": "Initial release: nine read-only tools covering chatbots, knowledge sources, conversations, unanswered questions, analytics and leads."
      },
      "apps": "./.app.json"
    }
  }
}