.codex-plugin/plugin.json

{
  "author": {
    "name": "NEW CORE TECH"
  },
  "description": "Instagram, Facebook Messenger, and WhatsApp customer growth\u2014orchestrated from ChatGPT. Use ChatGPT to analyze customer context and behavior, identify high-intent buyers, create personalized content, and instruct your 3Chat Agent to follow up through connected channels after your confirmation. When customers reply, the Agent responds 24/7, handles questions and objections, and guides them toward purchase, booking, lead capture, or human handoff. Access and actions follow your organization\u2019s 3Chat permissions.",
  "interface": {
    "capabilities": [
      "Customer Discovery & Segmentation",
      "Conversation Intelligence",
      "Intent & Engagement Analysis",
      "Personalized Customer Outreach",
      "Cross-Channel Campaign Messaging",
      "Batch Send Tracking"
    ],
    "category": "Communication",
    "defaultPrompt": [
      "List my high-intent customers.",
      "Show me which customers haven\u2019t converted and why.",
      "Draft an outreach message for my high-intent customers, then send it after I approve."
    ],
    "developerName": "NEW CORE TECH",
    "displayName": "3Chat Customer Growth",
    "longDescription": "Instagram, Facebook Messenger, and WhatsApp customer growth\u2014orchestrated from ChatGPT. Use ChatGPT to analyze customer context and behavior, identify high-intent buyers, create personalized content, and instruct your 3Chat Agent to follow up through connected channels after your confirmation. When customers reply, the Agent responds 24/7, handles questions and objections, and guides them toward purchase, booking, lead capture, or human handoff. Access and actions follow your organization\u2019s 3Chat permissions.",
    "privacyPolicyURL": "https://www.3chat.ai/privacy",
    "shortDescription": "IG/FB/WA profiles & messaging",
    "supportURL": "https://group.3chat.ai",
    "termsOfServiceURL": "https://www.3chat.ai/terms",
    "websiteURL": "https://www.3chat.ai",
    "logo": "./assets/icon.png",
    "composerIcon": "./assets/icon.png"
  },
  "extensions": {
    "com.openai": {
      "onboardingSkill": "./skills/3chat-customer-growth-setup/SKILL.md",
      "review": {
        "test_cases": {
          "positive": [
            {
              "description": "Check workspace startup milestones and guide any missing setup. Run in the dedicated review workspace. The expected branch is determined by the returned milestone state; no configuration changes are performed by this test.",
              "prompt": "Check my 3Chat setup progress and tell me what I need to do next to start managing customers.",
              "tools_triggered": "get_3chat_workspace_readiness",
              "expected_behavior": "Call get_3chat_workspace_readiness with {}. For READY, report that both startup milestones are complete without claiming channels are currently online or messages can be sent. For ACTION_REQUIRED with both milestones incomplete, explain 3Chat's customer-facing Agent, why Agent publication and channel connection enable customer operations, all three quick-start steps, and ongoing improvement through 3Chat Agent Builder. If only one milestone is incomplete, show only that step. Present prominent named Markdown links using the exact matching data.actions[].url. Do not configure an Agent or channel, invent URLs, or treat ACTION_REQUIRED as a tool failure."
            },
            {
              "description": "Find customers and summarize their communication context without sending. Prerequisite: the review workspace contains at least two sample customers with one-to-one message history. No tenant-specific custom field is required.",
              "prompt": "Show me up to three customers in my 3Chat workspace. Summarize each customer's needs, recent conversation, and a suggested next step. Do not send any messages.",
              "tools_triggered": "search_3chat_customers, search_3chat_customers_context",
              "expected_behavior": "Use search_3chat_customers with query_mode=list and limit=3; retain all returned customer IDs without forcing a single selection. Retrieve their context using customer_ids and include_conversation_messages=true. Base each brief on returned memory, summaries, and messages, distinguishing evidence from inference. Explain any missing or truncated context; NO_SESSION, NO_CONVERSATION, and NO_MESSAGE are normal business results, not proof of no previous communication. Do not call send tools. If startup state is unknown, one initial readiness check is permitted."
            },
            {
              "description": "Review completed one-to-one conversations not solved by AI. Prerequisite: the review workspace contains at least one COMPLETED conversation with solved=false and accessible customer context. The scope is explicitly a sample of up to five records.",
              "prompt": "Review up to five completed customer conversations that were not solved by AI. Summarize the main blockers and recommended follow-up actions. Do not contact anyone.",
              "tools_triggered": "search_3chat_conversations, search_3chat_customers_context",
              "expected_behavior": "Search with session_type=p2p, status=COMPLETED, solved=false, offset=0, and limit=5. Retrieve customer context for returned customer IDs as needed, matching the returned conversation IDs when analyzing transcripts. Describe solved=false as not solved by AI rather than automatically treating it as currently unresolved. Report sample size and context limitations; do not fabricate blockers or claim a complete aggregate report. Do not send messages. If startup state is unknown, one initial readiness check is permitted."
            },
            {
              "description": "Send one explicitly confirmed customer message. Prerequisite: the dedicated review workspace contains a send-eligible sample customer and a connected test channel whose recipient is controlled by the reviewer. Run only against that test recipient. After the preview, the reviewer confirms the exact selected customer, channel, and text.",
              "prompt": "Help me send 'Thank you for your interest. Would you like to discuss your needs?' to one test customer in this 3Chat workspace. Show me the recipient, channel, and exact message first, and wait for my confirmation.",
              "tools_triggered": "search_3chat_customers, send_3chat_customer_message",
              "expected_behavior": "Find sample customers with search_3chat_customers. Resolve ambiguity with the reviewer and retain the canonical customer_id. Present the exact recipient, chosen channel, final message, and single-send scope. Do not send until the reviewer explicitly confirms that preview. Then call send_3chat_customer_message with the confirmed parameters, a confirmation_token, and a stable idempotency_key. Report the actual returned result; accepted is not delivery or read confirmation. A deterministic eligibility error must be explained without inventing success or switching to another recipient. If startup state is unknown, one initial readiness check is permitted."
            },
            {
              "description": "Send a confirmed batch to two customers and track the original job. Prerequisite: the review workspace contains at least two send-eligible sample customers on connected test channels with recipients controlled by the reviewer. After the proposed list and message are shown, the reviewer confirms exactly two recipients and their channels.",
              "prompt": "Prepare this message for two test customers in my 3Chat workspace: 'We would be happy to help with your next steps. Reply if you would like assistance.' Show me the exact recipients and channels, wait for my approval, then send it and track the batch result.",
              "tools_triggered": "search_3chat_customers, send_3chat_customer_messages, get_3chat_batch_send_status",
              "expected_behavior": "Use search_3chat_customers with query_mode=list to propose two sample customers and retain their IDs. Show both recipients, channels, exact message, and batch scope. Only after explicit approval, create one batch with two items, each having its own confirmation_token and idempotency_key. Once job_id is returned, query that original job with get_3chat_batch_send_status and follow the documented polling budget. Report counters and item-level data.results[].success; PARTIAL_FAILED may include all items failing. If still running, report that state and job_id. Do not recreate the batch, automatically resend failed items, or claim delivery or read status from accepted, sent, or COMPLETED. If startup state is unknown, one initial readiness check is permitted."
            }
          ],
          "negative": [
            {
              "description": "Customer-record updates are outside the plugin's current capabilities. Explain that it cannot save customer fields and offer read-only customer review or a summary for manual updates. Do not invoke search, send, or upload tools solely to simulate a write, and do not claim any record changed.",
              "prompt": "Update all my high-intent 3Chat customers to the customer stage 'Qualified' and save those changes to their customer records."
            },
            {
              "description": "Scheduled campaigns and background monitoring are not provided by this plugin. Explain that it cannot create the recurring campaign or promise future execution. Offer to prepare an audience and message for a separately confirmed immediate send. Do not invoke send or upload tools, create a batch as a substitute, or claim a schedule was saved.",
              "prompt": "Create a recurring 3Chat campaign that automatically sends a re-engagement message every Monday to customers who have been inactive for 30 days, without asking me again."
            },
            {
              "description": "The plugin guides setup but cannot build, publish, or connect on the user's behalf. Explain that configuration must be completed in 3Chat. A read-only get_3chat_workspace_readiness call is allowed to identify missing milestones and display exact returned action URLs; no configuration or messaging operation is permitted. Do not claim an Agent was created or a channel connected.",
              "prompt": "Create and publish a new customer-service 3Chat Agent for my business and connect my Instagram account for me. Complete the setup on my behalf."
            }
          ]
        }
      }
    }
  },
  "name": "3chat-customer-growth",
  "mcpServers": "./.mcp.json",
  "skills": "./skills",
  "version": "1.0.6",
  "apps": "./.app.json"
}