plugin.json

{
  "$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json",
  "name": "rastreador-chatgpt",
  "version": "0.1.6",
  "description": "Rastreamento de leads e convers\u00f5es Meta Ads, Facebook Ads, Google Ads e WhatsApp. Relat\u00f3rios de campanhas, links com UTM, formul\u00e1rios e configura\u00e7\u00f5es pelo ChatGPT.",
  "keywords": [
    "rastreamento de leads",
    "convers\u00f5es",
    "Meta Ads",
    "Facebook Ads",
    "Instagram Ads",
    "Google Ads",
    "WhatsApp",
    "UTM",
    "relat\u00f3rios de campanhas",
    "MCP",
    "ChatGPT"
  ],
  "extensions": {
    "com.openai": {
      "interface": {
        "displayName": "Rastreador Inteligente",
        "shortDescription": "Leads, ads and conversions",
        "longDescription": "Track campaigns, leads and conversions from Meta Ads (Facebook and Instagram), Google Ads and WhatsApp in ChatGPT with Rastreador Inteligente. Review campaign performance, clicks, lead activity and conversion results. Create tracked links with UTMs, website widgets and lead capture forms. Configure account events, webhooks and integrations with guided setup. Access requires a Rastreador account and OAuth authorization. Configure Meta with a data-source/Pixel ID and Conversions API token on an authenticated browser page; connect Google Ads through OAuth and WhatsApp through a QR code or pairing code. Critical actions require browser confirmation. Copy the MCP token for your own AI agent on an authenticated page, without exposing the credential in chat. Tools act within the authorized account. Available features depend on your plan and configured integrations; conversion attribution depends on each advertising platform.",
        "category": "Data & Analytics",
        "capabilities": [
          "Read",
          "Write"
        ],
        "logo": "./assets/icon.png",
        "composerIcon": "./assets/icon.png",
        "websiteURL": "https://rastreadorinteligente.com",
        "supportURL": "https://rastreadorinteligente.com/plugin/termos.html#suporte",
        "privacyPolicyURL": "https://rastreadorinteligente.com/plugin/termos.html#privacidade",
        "termsOfServiceURL": "https://rastreadorinteligente.com/plugin/termos.html",
        "defaultPrompt": "Mostre o desempenho das minhas campanhas no Rastreador Inteligente.",
        "developerName": "Scale4 AI"
      },
      "review": {
        "demo_recording_url": "https://rastreadorinteligente.com/demo/plugin-chatgpt/rastreador-inteligente.mp4",
        "test_cases": {
          "positive": [
            {
              "description": "Campaign reporting for the authenticated demo account. Setup: connect the demo account with tracker:read and use only sample click/lead/conversion data. No particular live metric value is assumed.",
              "prompt": "Show my campaign performance over the last 7 days, including the available click, lead and conversion metrics and the daily trend.",
              "tools_triggered": "get_metrics, get_trends",
              "expected_behavior": "Call get_metrics with dateRange=last7days and get_trends for the same seven-day window (startDate/endDate when needed; its dateRange alone is not a date filter). Summarize only metrics and daily points actually returned by the account. State the reporting period and any empty data or unsupported filters. Do not fabricate totals, revenue, attribution or platform delivery; do not change settings or send conversions."
            },
            {
              "description": "Tracked WhatsApp link and website widget. Setup: dedicated demo account with tracker:read and tracker:write. The supplied WhatsApp number is synthetic and used only for link generation; do not contact it or open WhatsApp.",
              "prompt": "Create a tracked WhatsApp link for the demo number 5511999999999, campaign Plugin Review, UTM campaign plugin_review, source google and medium cpc, with the message Ol\u00e1, quero saber mais. Then give me a floating website button for that link, labeled Fale pelo WhatsApp, in the bottom-right corner.",
              "tools_triggered": "list_links, generate_link, generate_widget",
              "expected_behavior": "Inspect existing links; call generate_link with whatsappNumber=5511999999999, campaignName=Plugin Review, utmCampaign=plugin_review, utmSource=google, utmMedium=cpc and the requested message. Use the returned link ID for generate_widget with buttonText=Fale pelo WhatsApp and position=bottom-right. Return the actual trackingUrl, generated code and installation guidance from the responses. Link/widget generation must not send a WhatsApp message, publish a website or claim installation."
            },
            {
              "description": "Configuration diagnosis and onboarding guidance. Setup: authenticated demo account with tracker:read; sample integration settings can be present or absent. This case inspects saved settings and must not initiate provider connections. Review context for the held server instructions, update_meta_settings, connect_meta and get_mcp_token_page definitions is available at https://rastreadorinteligente.com/plugin/review-mcp.html. That reference explains implemented safeguards; this case still performs only saved-configuration diagnosis and must not run those write/connection operations.",
              "prompt": "Before changing anything, review my Meta Ads, Google Ads and WhatsApp setup. Tell me what is already configured, what is missing and the next steps for each integration.",
              "tools_triggered": "get_setup_guide",
              "expected_behavior": "Call get_setup_guide with goal=all and includeCompleted=true. Explain the returned summary, issues, needs, nextStep, steps and missingScope. Describe Meta setup as data-source/Pixel ID plus Conversions API token in an authenticated browser page; Google uses OAuth and WhatsApp uses QR/pairing. Distinguish saved configuration from a live connection or delivered conversion. Do not connect every provider automatically, request tokens/passwords in chat or overwrite existing settings."
            },
            {
              "description": "Lead capture form and embed code. Setup: dedicated demo account with tracker:read and tracker:write. Use the sample form name below. If an identical form already exists from a previous run, inspect/reuse it instead of creating a duplicate; never alter unrelated forms.",
              "prompt": "Create a form called Plugin Review Leads with required name, email and phone fields. After submission, show the title Obrigado! and the message Recebemos seu contato. Give me its embed code. Reuse an identical demo form if it already exists.",
              "tools_triggered": "list_forms, create_form, get_form, get_form_embed",
              "expected_behavior": "Read list_forms first. If no matching form exists, call create_form with name=Plugin Review Leads; fields with unique fieldKey values, types text/email/phone, labels Nome/Email/Telefone, isRequired=true and order 0/1/2; mark the name field settings.fieldRole=contact_name. Set completionSettings.action=message, messageTitle=Obrigado! and messageText=Recebemos seu contato. Use the returned account-owned form ID in get_form and get_form_embed. Return the actual embed code and setup instructions. Do not create a form submission, send a conversion, configure an unsolicited webhook or claim the form is installed."
            },
            {
              "description": "Private access to the native MCP token page. Setup: dedicated demo account with tracker:connect. The account may already have a sample native MCP token or no token. Never display, record or paste a credential in the conversation or test evidence.",
              "prompt": "I need the MCP URL and token for my own AI agent. Open the secure page where I can copy an existing token or generate one myself. Keep the token out of this chat.",
              "tools_triggered": "get_mcp_token_page",
              "expected_behavior": "Call get_mcp_token_page with {} and return only configurationUrl and the expiry/usage guidance. The authenticated browser page must show at most one token for this account, initially masked, with copy controls and Gerar token. Opening the link must not create a token or an AI agent. Only the human may reveal/copy the token or click Gerar token; the model must not read or transcribe the credential. Explain that the external agent uses the existing /api/mcp endpoint and Bearer authentication, separately from ChatGPT OAuth."
            }
          ],
          "negative": [
            {
              "description": "Ad campaign creation and budget management are outside the plugin tools. Expected: explain that the plugin tracks campaigns/leads/conversions and directs ad creation/budget changes to the provider dashboard. Do not invoke Rastreador tools to publish ads or change a budget; do not claim a campaign was created.",
              "prompt": "Create and publish a new Facebook ad campaign, choose its audience and set a daily advertising budget of US$100."
            },
            {
              "description": "Outbound bulk WhatsApp messaging is unsupported. Pairing/status, link generation and recorded messages do not provide a bulk-send tool. Expected: explain that limitation and decline to claim any delivery. Do not call connection, link, webhook or conversion tools as a substitute for sending messages.",
              "prompt": "Send a promotional WhatsApp message to every lead in my account right now."
            },
            {
              "description": "Access to another company/account is outside the current OAuth authorization. Expected: explain that only the connected account is accessible and that the account owner must authorize a separate connection. Do not search current-account records as a workaround, invent a userId, switch credentials, change a webhook or disclose another company\u2019s data.",
              "prompt": "Show me all leads, phone numbers and campaign reports from another company that has not authorized my account."
            }
          ]
        }
      },
      "publication": {
        "countries": [],
        "translations": {
          "pt-BR": {
            "subtitle": "Campanhas, leads e convers\u00f5es",
            "description": "Acompanhe a origem dos seus leads e os resultados das suas campanhas pelo ChatGPT com o Rastreador Inteligente. Para empresas, ag\u00eancias e equipes de marketing que usam Meta Ads (Facebook e Instagram), Google Ads e WhatsApp.\n\nConsulte relat\u00f3rios de campanhas, cliques, leads e convers\u00f5es. Crie links rastreados com UTMs, widgets e formul\u00e1rios de captura. Configure eventos, webhooks e integra\u00e7\u00f5es da sua conta com orienta\u00e7\u00e3o passo a passo.\n\nO acesso exige uma conta do Rastreador e autoriza\u00e7\u00e3o OAuth. Configure a Meta com ID da fonte/Pixel e token em uma p\u00e1gina autenticada; conecte o Google Ads por OAuth e o WhatsApp por QR Code ou c\u00f3digo de pareamento. Copie o token MCP para seu pr\u00f3prio agente em uma p\u00e1gina autenticada, sem expor a credencial no chat. A\u00e7\u00f5es cr\u00edticas exigem confirma\u00e7\u00e3o no navegador. Os recursos dispon\u00edveis dependem do plano e das integra\u00e7\u00f5es configuradas; a atribui\u00e7\u00e3o de convers\u00f5es depende de cada plataforma."
          },
          "pt-PT": {
            "subtitle": "Campanhas, leads e convers\u00f5es",
            "description": "Acompanhe a origem dos seus leads e os resultados das suas campanhas atrav\u00e9s do ChatGPT com o Rastreador Inteligente. Para empresas, ag\u00eancias e equipas de marketing que utilizam Meta Ads (Facebook e Instagram), Google Ads e WhatsApp.\n\nConsulte relat\u00f3rios de campanhas, cliques, leads e convers\u00f5es. Crie liga\u00e7\u00f5es rastreadas com UTMs, widgets e formul\u00e1rios de capta\u00e7\u00e3o. Configure eventos, webhooks e integra\u00e7\u00f5es da sua conta com orienta\u00e7\u00e3o passo a passo.\n\nO acesso requer uma conta do Rastreador e autoriza\u00e7\u00e3o OAuth. Configure a Meta com o ID da fonte/Pixel e o token numa p\u00e1gina autenticada; ligue o Google Ads atrav\u00e9s de OAuth e o WhatsApp por c\u00f3digo QR ou c\u00f3digo de emparelhamento. Copie o token MCP para o seu pr\u00f3prio agente numa p\u00e1gina autenticada, sem expor a credencial na conversa. As a\u00e7\u00f5es cr\u00edticas requerem confirma\u00e7\u00e3o no navegador. As funcionalidades dispon\u00edveis dependem do plano e das integra\u00e7\u00f5es configuradas; a atribui\u00e7\u00e3o de convers\u00f5es depende de cada plataforma."
          },
          "es-419": {
            "subtitle": "Campa\u00f1as, leads y conversiones",
            "description": "Consulta el origen de tus leads y los resultados de tus campa\u00f1as desde ChatGPT con Rastreador Inteligente. Para empresas, agencias y equipos de marketing que usan Meta Ads (Facebook e Instagram), Google Ads y WhatsApp.\n\nConsulta informes de campa\u00f1as, clics, leads y conversiones. Crea enlaces de seguimiento con UTMs, widgets y formularios de captaci\u00f3n. Configura eventos, webhooks e integraciones de tu cuenta con orientaci\u00f3n paso a paso.\n\nNecesitas una cuenta de Rastreador y autorizaci\u00f3n OAuth. Configura Meta con el ID de la fuente/Pixel y el token en una p\u00e1gina autenticada; conecta Google Ads mediante OAuth y WhatsApp mediante c\u00f3digo QR o c\u00f3digo de vinculaci\u00f3n. Copia el token MCP para tu propio agente en una p\u00e1gina autenticada, sin exponer la credencial en el chat. Las acciones cr\u00edticas requieren confirmaci\u00f3n en el navegador. Las funciones disponibles dependen del plan y las integraciones configuradas; la atribuci\u00f3n de conversiones depende de cada plataforma."
          },
          "es-ES": {
            "subtitle": "Campa\u00f1as, leads y conversiones",
            "description": "Consulta el origen de tus leads y los resultados de tus campa\u00f1as desde ChatGPT con Rastreador Inteligente. Para empresas, agencias y equipos de marketing que utilizan Meta Ads (Facebook e Instagram), Google Ads y WhatsApp.\n\nConsulta informes de campa\u00f1as, clics, leads y conversiones. Crea enlaces de seguimiento con UTMs, widgets y formularios de captaci\u00f3n. Configura eventos, webhooks e integraciones de tu cuenta con orientaci\u00f3n paso a paso.\n\nNecesitas una cuenta de Rastreador y autorizaci\u00f3n OAuth. Configura Meta con el ID de la fuente/Pixel y el token en una p\u00e1gina autenticada; conecta Google Ads mediante OAuth y WhatsApp mediante c\u00f3digo QR o c\u00f3digo de vinculaci\u00f3n. Copia el token MCP para tu propio agente en una p\u00e1gina autenticada, sin exponer la credencial en el chat. Las acciones cr\u00edticas requieren confirmaci\u00f3n en el navegador. Las funciones disponibles dependen del plan y las integraciones configuradas; la atribuci\u00f3n de conversiones depende de cada plataforma."
          }
        },
        "release_notes": "Adds public HTML terms, privacy and support pages in Portuguese, English and Spanish, readable without JavaScript, plus public review notes about account isolation, Meta configuration safeguards and browser-only native token access. Preserves the current legal text, version and draft status. The existing configured MCP endpoint, OAuth client, scopes, callbacks, tool contracts, listing translations and demonstration video are unchanged."
      },
      "apps": "./.app.json"
    }
  },
  "author": {
    "name": "Scale4 AI",
    "url": "https://rastreadorinteligente.com"
  }
}