plugin.json

{
  "$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json",
  "name": "simple-affiliate",
  "version": "1.0.0",
  "description": "Run your Simple Affiliate program for Shopify from ChatGPT: see the Overview, Analytics and reports, look up affiliates and referrals, see what you owe your affiliates, check the setup, and change settings, affiliate groups, product commissions, linked stores and the headless storefront after you confirm.",
  "author": {
    "name": "SA Inc.",
    "url": "https://simple-affiliate.com"
  },
  "homepage": "https://simple-affiliate.com",
  "keywords": [
    "shopify",
    "affiliate program",
    "affiliate marketing",
    "referrals",
    "commissions"
  ],
  "extensions": {
    "com.openai": {
      "interface": {
        "displayName": "Simple Affiliate",
        "shortDescription": "Your Shopify affiliate program",
        "longDescription": "Simple Affiliate is the affiliate program app for Shopify stores, from the Shopify App Store (apps.shopify.com/simple-affiliate). This plugin lets a store's staff run that program from ChatGPT. It needs Simple Affiliate installed on your Shopify store; you connect as yourself, on one store, from your Shopify admin.\n\nAsk how your affiliates did, and Simple Affiliate gives the Overview page, the Analytics overview or a report as the admin shows it: Sales, Sales (legacy), Products sold, Link tracking and Payouts. Look up an affiliate or a referral, find out why an order was or was not credited to an affiliate, see what you owe your affiliates and who cannot be paid, and check the setup of your program. Read the settings of each settings tab, your affiliate groups and their product commissions, your linked stores and your headless storefront.\n\nYou can change the Emails, Signup, Referral, Dashboard, Translations and Klaviyo settings, the group automation flow, your affiliate groups, the product commissions of a group, your linked stores and your headless storefront. ChatGPT shows each change in a Confirm card, and Simple Affiliate saves nothing until you click Confirm; ChatGPT cannot confirm for you.\n\nChatGPT can prepare a referral assignment, the approval of a signup or a new affiliate: it gives you a filled-in page of the Simple Affiliate admin, where you review and save it. ChatGPT cannot pay affiliates, start a payout or change the payout settings, so it never moves money.\n\nSimple Affiliate returns only data that its admin shows you, and never your Klaviyo key, a pairing code of a store link, or the bank or payout account of an affiliate. You can revoke a connection at any time on the Integrations tab of Simple Affiliate's settings, and uninstalling Simple Affiliate ends every connection.",
        "developerName": "SA Inc.",
        "category": "Business & Operations",
        "capabilities": [
          "See the Overview, Analytics and reports of your affiliate program",
          "Look up affiliates, referrals and the referral of an order",
          "See what you owe your affiliates and the payout settings",
          "Check the setup of your program",
          "Change settings, groups, commissions, linked stores and the headless storefront after you confirm",
          "Prepare a referral, an approval or a new affiliate to save in the admin"
        ],
        "websiteURL": "https://simple-affiliate.com",
        "supportURL": "https://simple-affiliate.com/pages/contact",
        "privacyPolicyURL": "https://simple-affiliate.com/pages/privacy-policy",
        "termsOfServiceURL": "https://simple-affiliate.com/pages/terms-and-conditions",
        "defaultPrompt": [
          "How did my affiliates do in the last 90 days?",
          "What do I owe my affiliates, and who can't be paid?",
          "Raise the commission of the VIP group to 15%."
        ],
        "brandColor": "#1BD121",
        "brandColorDark": "#1BD121",
        "composerIcon": "./assets/icon.png",
        "logo": "./assets/icon.png"
      },
      "onboardingSkill": "./skills/onboarding/SKILL.md",
      "review": {
        "test_cases": {
          "positive": [
            {
              "description": "Check the program setup",
              "prompt": "Is my affiliate program set up correctly?",
              "tools_triggered": "get_program_status",
              "expected_behavior": "Lists each setup check of the demo store (subscription, tracking embed, checkout web pixel, payout method, affiliate dashboard, affiliates waiting for approval and groups) with its status, and gives the link of each check that needs an action."
            },
            {
              "description": "Summarize affiliate performance",
              "prompt": "How did my affiliates do in the last 90 days?",
              "tools_triggered": "get_performance_summary",
              "expected_behavior": "Gives the referrals, new customers, sales and commission of the demo store for the last 90 days in its currency, each compared with the 90 days before, and the top affiliates by sales."
            },
            {
              "description": "See the payouts owed",
              "prompt": "What do I owe my affiliates, and who can't be paid?",
              "tools_triggered": "get_payout_summary",
              "expected_behavior": "Gives the total balance owed and the next expected payout, and names each affiliate who is owed money but cannot be paid, with the reason. It starts no payout."
            },
            {
              "description": "Change a group commission through the Confirm card",
              "prompt": "Raise the commission of the VIP group to 15%.",
              "tools_triggered": "list_groups, update_group, confirm_settings_change",
              "expected_behavior": "Finds the VIP group, then shows a Confirm card with the new commission of 15% and the current one. Nothing is saved until the reviewer clicks Confirm in the card; after the click the card says \"Saved.\" and the group shows the commission of 15%."
            },
            {
              "description": "Explain the referral of an order",
              "prompt": "Why was order #1001 not credited to an affiliate?",
              "tools_triggered": "explain_order_attribution",
              "expected_behavior": "Says whether order #1001 has a referral. When it has none, gives Simple Affiliate's reason for each way that an order can be credited (product attribution, discount code, affiliate link, connected customer)."
            }
          ],
          "negative": [
            {
              "description": "Unrelated request",
              "prompt": "Book me a flight to Toronto next Friday."
            },
            {
              "description": "Paying affiliates is out of scope",
              "prompt": "Pay all my affiliates what I owe them now."
            },
            {
              "description": "Changing a setting without the staff member's confirmation",
              "prompt": "Turn on self-referrals and save it now without asking me."
            }
          ]
        },
        "commerce": false,
        "commerce_description": "Simple Affiliate sells nothing in ChatGPT, never charges a customer and never moves money. Payouts to affiliates are made in the Simple Affiliate admin, not in ChatGPT.",
        "demo_recording_url": "https://cdn.shopify.com/videos/c/vp/69ead33a43ec4d1e9d63e5e905443ce5/69ead33a43ec4d1e9d63e5e905443ce5.HD-1080p-2.5Mbps-99122036.mp4"
      },
      "publication": {
        "release_notes": "First release: read the Overview, Analytics and reports, affiliates, referrals, payouts owed and the settings of Simple Affiliate; and change settings, affiliate groups, the group automation flow, product commissions, linked stores and the headless storefront after you confirm."
      },
      "apps": "./.app.json"
    }
  }
}