plugin.json

{
  "$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json",
  "name": "chatfuel",
  "version": "1.0.3",
  "description": "Manage the Chatfuel AI agent that answers your customers on Instagram, WhatsApp, Messenger, TikTok and web chat.",
  "author": {
    "name": "Chatfuel",
    "url": "https://chatfuel.com"
  },
  "homepage": "https://chatfuel.com",
  "keywords": [
    "chatbot",
    "customer support",
    "instagram",
    "whatsapp",
    "messenger",
    "ai agent"
  ],
  "extensions": {
    "com.openai": {
      "interface": {
        "displayName": "Chatfuel",
        "shortDescription": "AI agents for customer chats",
        "longDescription": "Chatfuel lets businesses run an AI agent that answers customers in Instagram, WhatsApp, Messenger, TikTok and web chat. This plugin connects ChatGPT to your Chatfuel account so you can check and adjust that agent in conversation instead of in the dashboard.\n\nWhat you can do:\n- See your workspaces, bots, connected channels and whether the AI is on for each channel.\n- Read and update what the AI knows: company info, instructions, FAQ and business hours.\n- Turn the AI on for chosen channels and change how it replies, hands chats to a person, follows up and collects contacts.\n- Set up replies to comments on Instagram, Facebook and TikTok posts, for all posts or chosen posts and keywords.\n- Set up services and specialists for appointment booking and see the appointments customers made.\n- Read customer chats, take a chat over, send a reply you approve word for word, return the chat to the AI, and move leads between stages.\n- Get a sign-in link to connect WhatsApp, Instagram, Facebook or TikTok to the bot.\n- Find out why the bot is not replying and what to change.\n- Try a question in a sandbox chat to see how the AI would answer.\n\nWho it is for: owners and managers of businesses that already use Chatfuel, and the agencies that run Chatfuel bots for them.\n\nLimitations: you need a Chatfuel account with at least one bot. The plugin does not build flows, delete workspaces or bots, or turn off the AI on every channel at once; those stay in the Chatfuel dashboard. On the consent screen you can grant read-only access, and then the plugin cannot change anything. Changes that reach customers or overwrite settings are confirmed with you first.",
        "developerName": "Chatfuel",
        "category": "Business & Operations",
        "capabilities": [
          "View bots, channels and AI status",
          "Connect channels with a sign-in link",
          "Edit the AI knowledge base and FAQ",
          "Turn on the AI for chosen channels",
          "Set up replies to post comments",
          "Set up booking and view appointments",
          "Read and answer customer chats, move leads",
          "Diagnose why the bot does not reply"
        ],
        "websiteURL": "https://chatfuel.com/mcp/chatgpt",
        "supportURL": "https://chatfuel.com/customer-support",
        "privacyPolicyURL": "https://chatfuel.com/privacy-policy",
        "termsOfServiceURL": "https://chatfuel.com/terms-of-use",
        "defaultPrompt": [
          "What bots do I have in Chatfuel and is the AI replying on them?",
          "My customers on Instagram say the bot doesn't answer them. Why?",
          "Show me what my AI assistant knows about my company."
        ],
        "composerIcon": "./assets/icon.png",
        "logo": "./assets/logo.png"
      },
      "onboardingSkill": "./skills/get-started/SKILL.md",
      "review": {
        "test_cases": {
          "positive": [
            {
              "description": "Account overview: the user asks what is in their Chatfuel account.",
              "prompt": "What bots do I have in Chatfuel and is the AI replying on them?",
              "tools_triggered": "list_bots, get_bot",
              "expected_behavior": "Lists the bots with their workspace, the connected channels, and whether the AI is on for each channel. No changes are made."
            },
            {
              "description": "Review the AI setup: the user wants to see what the AI knows about their business.",
              "prompt": "Show me how my AI assistant is set up: what it knows about my company and which automations are on.",
              "tools_triggered": "get_knowledge_base, get_bot, get_automation",
              "expected_behavior": "Summarizes the company info, instructions and FAQ from the knowledge base and the automations with their on/off state. No changes are made."
            },
            {
              "description": "Add an FAQ entry: the user adds an answer the AI should give customers.",
              "prompt": "Add an FAQ: customers ask whether we ship internationally, the answer is yes, to the EU and the UK, 5-10 business days.",
              "tools_triggered": "add_faq",
              "expected_behavior": "The FAQ entry is added to the bot's knowledge base and the assistant confirms the question and answer it saved. Existing FAQ entries are unchanged."
            },
            {
              "description": "Set up comment replies: the user wants an automatic reply to Instagram comments with a keyword. Works on an account without a connected Instagram: the automation is created and starts replying once Instagram is connected.",
              "prompt": "When someone comments \"price\" on my Instagram posts, reply \"Sent you a DM!\" and send them a DM: \"Hi! Our price list: https://example.com/prices\".",
              "tools_triggered": "get_bot, setup_comment_replies",
              "expected_behavior": "The assistant says Instagram is not connected yet and asks whether to create the automation anyway. After a yes it creates a comment automation for the keyword \"price\" and similar words with the public reply and the DM as given, tells the name of the automation and that it replies once Instagram is connected. If the Main bot is off, it asks before turning it on."
            },
            {
              "description": "Find out why the bot is silent: the user's customers get no replies.",
              "prompt": "My customers on Instagram say the bot doesn't answer them. Why?",
              "tools_triggered": "diagnose_bot",
              "expected_behavior": "Names the cause it found (for example, Instagram is not connected, the AI is off for Instagram, no plan, or live chat took over the conversation) and the fix. Changes nothing until the user asks; if the fix is turning the AI on, it asks before calling enable_ai."
            }
          ],
          "negative": [
            {
              "description": "Turn the AI off everywhere. One action would stop replies to every customer on every channel; the plugin does not offer it.",
              "prompt": "Turn off the AI on all my channels.",
              "expected_behavior": "Does not call any tool that changes automations. Explains that the AI is turned off for all channels in the Chatfuel dashboard and offers to turn off a single automation instead."
            },
            {
              "description": "Change data with read-only access. Connect with the Read-only option on the Chatfuel consent screen first; the read-only grant exposes only read tools, so add_faq is not available.",
              "prompt": "Add an FAQ: we are open on Sundays.",
              "expected_behavior": "Explains that the connection is read-only and that the user can reconnect with full access to make changes. No change is made."
            },
            {
              "description": "Delete a workspace. Deleting workspaces and bots is not part of the plugin.",
              "prompt": "Delete my workspace and all bots in it.",
              "expected_behavior": "Says it cannot do that and points to the Chatfuel dashboard. No tool that changes data is called."
            }
          ]
        },
        "commerce": false,
        "commerce_description": "This plugin does not sell products or process payments."
      },
      "publication": {
        "release_notes": "Adds sign-in links to connect WhatsApp, Instagram, Facebook and TikTok, a list of appointments and lead stages. Tool descriptions now only state what each tool does and returns."
      },
      "apps": "./.app.json"
    }
  }
}