plugin.json

{
  "$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json",
  "name": "solomon",
  "version": "1.0.0",
  "description": "Solomon e-commerce analytics in ChatGPT and Codex: sales, orders, products, stock, ad spend, marketing attribution and site analytics from your Solomon account, plus Solomon dashboards.",
  "author": {
    "name": "Solomon",
    "email": "marcos.foloni@solomon.com.br",
    "url": "https://www.solomon.com.br"
  },
  "homepage": "https://www.solomon.com.br/conector-ia",
  "keywords": [
    "analytics",
    "ecommerce",
    "attribution",
    "marketing",
    "roas"
  ],
  "extensions": {
    "com.openai": {
      "interface": {
        "displayName": "Solomon",
        "shortDescription": "E-commerce sales and ROAS",
        "longDescription": "Solomon is the analytics and marketing attribution platform for e-commerce stores. This plugin connects ChatGPT and Codex to your Solomon account so you can ask about your store in plain language and get the same numbers you see on the Solomon platform.\n\nWhat you can ask:\n- Sales and revenue: revenue, orders, average ticket and profit by day, channel, product or coupon, compared with other periods.\n- Media and attribution: spend, ROAS and CPA by campaign, ad set and ad on Meta, Google, TikTok and other platforms, under Solomon's attribution models.\n- Products and stock: best-selling products and variants, margin per product, stock levels and stockouts.\n- Site and funnel: sessions, purchase funnel, site searches and traffic sources measured by the Solomon pixel.\n- Influencers: sales, coupons and cost of each influencer.\n- Dashboards: build and edit Solomon dashboards, always at your request.\n\nHow it works:\n- You sign in on the Solomon login page with email and password or with Google. ChatGPT never sees your password.\n- After signing in, you choose which company to connect. The plugin only queries companies you already have access to in Solomon, and access is checked on every query. You can switch companies later by asking in the conversation.\n- The plugin reads your company's data and only creates, changes or deletes items in your Solomon account (saved dashboards, task board cards) when you ask. Every tool declares whether it only reads or changes something.\n- Your buyers' name, phone, CPF and date of birth are never sent through the plugin; when an email shows up, it is partially hidden.\n\nRequirements: a Solomon account with an active company. Setup guide: https://www.solomon.com.br/conector-ia",
        "developerName": "Solomon",
        "category": "Data & Analytics",
        "capabilities": [
          "Read",
          "Write"
        ],
        "defaultPrompt": [
          "How did my store's revenue this week compare with last week?",
          "Which Meta Ads campaigns had the best ROAS in the last 30 days?",
          "What are my 10 best-selling products this month?"
        ],
        "brandColor": "#080B0C",
        "brandColorDark": "#19C27E",
        "websiteURL": "https://www.solomon.com.br",
        "supportURL": "https://www.solomon.com.br/conector-ia",
        "privacyPolicyURL": "https://www.solomon.com.br/politica-de-privacidade",
        "termsOfServiceURL": "https://www.solomon.com.br/termos-e-condicoes",
        "logo": "./assets/logo.png",
        "composerIcon": "./assets/composer-icon.png"
      },
      "review": {
        "test_cases": {
          "positive": [
            {
              "description": "Revenue comparison between two periods for the connected company.",
              "prompt": "What was my store's revenue and number of orders in the week of July 21-27, 2025, compared with the week before?",
              "tools_triggered": "cube_describe, cube_query",
              "expected_behavior": "Queries the connected company's orders for July 21-27, 2025 and July 14-20, 2025 and answers with revenue, number of orders and the percentage change, stating the dates used."
            },
            {
              "description": "Ad performance by campaign with Solomon's attribution.",
              "prompt": "Which Meta Ads campaigns had the best ROAS from July 1 to July 31, 2025? Show spend, revenue and ROAS.",
              "tools_triggered": "cube_describe, cube_query",
              "expected_behavior": "Returns the Meta Ads campaigns of July 2025 ranked by ROAS, with spend, attributed revenue and ROAS for each, and names the attribution model used."
            },
            {
              "description": "Best-selling products in a month.",
              "prompt": "What were my 10 best-selling products in July 2025, with units sold and revenue?",
              "tools_triggered": "cube_query",
              "expected_behavior": "Returns up to 10 products of July 2025 ranked by units sold, with units and revenue for each."
            },
            {
              "description": "Shows which Solomon company the conversation is connected to.",
              "prompt": "Which Solomon company am I connected to, and which other companies can I access?",
              "tools_triggered": "solomon_login",
              "expected_behavior": "Lists the companies the signed-in account can access and marks the active one. It does not ask for email or password, since the user is already signed in through OAuth."
            },
            {
              "description": "Creates a dashboard in the user's Solomon account (write action, done only on request).",
              "prompt": "Create a Solomon dashboard called 'Daily overview' with revenue, ad spend and ROAS per day from July 1 to July 31, 2025.",
              "tools_triggered": "cube_describe, cube_dashboard_create",
              "expected_behavior": "Creates the dashboard in the connected company's Solomon account and returns a link to open it in Solomon. Because the tool is marked as a write, the user is asked to confirm before it runs."
            }
          ],
          "negative": [
            {
              "description": "Buyers' personal data. The plugin must not return names, phones, CPF or birth dates of the store's buyers: the server blocks these fields. Expected: decline and offer aggregated numbers instead (e.g. orders or revenue by city).",
              "prompt": "Give me the full names, phone numbers and CPF of the customers who bought on July 30, 2025."
            },
            {
              "description": "Data from a company the user has no access to. The plugin only queries companies the signed-in account can access. Expected: say there is no access to that company and list the companies that are available.",
              "prompt": "Show me last month's revenue of my competitor, the store Acme Fashion."
            },
            {
              "description": "Request unrelated to the store's data. Expected: answer without calling any Solomon tool.",
              "prompt": "Write a short poem about the ocean."
            }
          ]
        },
        "commerce": false,
        "demo_recording_url": "https://www.youtube.com/watch?v=zItm4DS5-NA"
      },
      "publication": {
        "release_notes": "First public release. Ask about sales, orders, products, stock, ad spend, marketing attribution, site analytics and influencers from your Solomon account, and build Solomon dashboards. Sign in with your Solomon account (email and password or Google).",
        "translations": {
          "pt-BR": {
            "subtitle": "Vendas e ROAS do e-commerce",
            "description": "A Solomon \u00e9 a plataforma de analytics e atribui\u00e7\u00e3o de marketing para lojas de e-commerce. Este plugin conecta o ChatGPT e o Codex \u00e0 sua conta da Solomon: voc\u00ea pergunta sobre a sua loja em linguagem natural e recebe os mesmos n\u00fameros das telas da plataforma.\n\nO que voc\u00ea pode perguntar:\n- Vendas e receita: faturamento, pedidos, ticket m\u00e9dio e lucro por dia, canal, produto ou cupom, comparando com outros per\u00edodos.\n- M\u00eddia e atribui\u00e7\u00e3o: gasto, ROAS e CPA por campanha, conjunto e an\u00fancio na Meta, no Google, no TikTok e em outras plataformas, nos modelos de atribui\u00e7\u00e3o da Solomon.\n- Produtos e estoque: produtos e variantes mais vendidos, margem por produto, estoque e rupturas.\n- Site e funil: sess\u00f5es, funil de compra, buscas no site e origem do tr\u00e1fego, medidos pelo pixel da Solomon.\n- Influenciadores: vendas, cupons e custo de cada influenciador.\n- Dashboards: monta e altera dashboards na Solomon, sempre a seu pedido.\n\nComo funciona:\n- Voc\u00ea entra pela p\u00e1gina de login da Solomon, com e-mail e senha ou com o Google. O ChatGPT nunca v\u00ea a sua senha.\n- Depois do login, voc\u00ea escolhe a empresa. O plugin s\u00f3 consulta empresas a que voc\u00ea j\u00e1 tem acesso na Solomon, e isso \u00e9 conferido a cada consulta. Para trocar de empresa depois, \u00e9 s\u00f3 pedir na conversa.\n- O plugin l\u00ea os dados da sua empresa e s\u00f3 cria, altera ou apaga itens na sua conta da Solomon (pain\u00e9is salvos, cards do quadro de tarefas) a seu pedido. Cada ferramenta informa se s\u00f3 l\u00ea ou se altera algo.\n- Nome, telefone, CPF e data de nascimento dos seus compradores nunca saem pelo plugin; o e-mail, quando aparece, vem parcialmente oculto.\n\nRequisitos: uma conta na Solomon com uma empresa ativa. Como conectar: https://www.solomon.com.br/conector-ia"
          }
        }
      },
      "apps": "./.app.json"
    }
  }
}