plugin.json

{
  "$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json",
  "name": "sociallab",
  "version": "1.0.2",
  "description": "Run WhatsApp customer service from ChatGPT: read conversations and contacts, reply, send approved templates, tag and assign customers, and run campaigns in your SocialLab account.",
  "author": {
    "name": "SocialLab",
    "email": "support@sociallab.sa",
    "url": "https://sociallab.sa"
  },
  "homepage": "https://sociallab.sa",
  "keywords": [
    "whatsapp",
    "customer service",
    "crm",
    "campaigns",
    "saudi arabia"
  ],
  "extensions": {
    "com.openai": {
      "interface": {
        "displayName": "SocialLab",
        "shortDescription": "WhatsApp customer service",
        "longDescription": "SocialLab is a customer-communication platform for businesses in Saudi Arabia: WhatsApp, Instagram, Messenger, TikTok and more, with CRM, campaigns and an AI assistant. This plugin lets ChatGPT work in your SocialLab account on your behalf.\n\nAsk ChatGPT to find a customer's conversation, summarise what they asked, and reply; to send an approved WhatsApp template or an interactive message; to tag customers, add an internal note or assign a conversation to a teammate; to look up a Salla abandoned cart or a product; and to read your dashboard and campaign performance. Campaigns are created as drafts and sent only when you confirm.\n\nYou sign in with your SocialLab account and approve access. Every action that changes something asks for your confirmation first. Account admins see every connected assistant and what it changed under Settings > Connected Apps, and can revoke access at any time; a revoked assistant is refused from its next request.\n\nWorks with SocialLab business accounts that have Partner API access turned on. Free-form WhatsApp replies follow WhatsApp's 24-hour customer-service window; outside it, use an approved template.",
        "developerName": "SocialLab",
        "category": "Communication",
        "capabilities": [
          "Read and search WhatsApp conversations",
          "Reply and send approved templates",
          "Tag, note and assign conversations",
          "Create and send campaigns",
          "Read reports and campaign performance"
        ],
        "websiteURL": "https://sociallab.sa",
        "supportURL": "https://sociallab.sa/contact-us",
        "privacyPolicyURL": "https://sociallab.sa/privacy",
        "termsOfServiceURL": "https://sociallab.sa/terms",
        "defaultPrompt": [
          "Show my most recent WhatsApp conversations in SocialLab.",
          "Summarise what my latest customer asked for.",
          "How did my latest SocialLab campaign perform?"
        ],
        "brandColor": "#1E8E3E",
        "composerIcon": "./assets/logo.png",
        "logo": "./assets/logo.png"
      },
      "review": {
        "test_cases": {
          "positive": [
            {
              "description": "List recent conversations",
              "prompt": "Show me my most recent WhatsApp conversations in SocialLab.",
              "tools_triggered": "list_conversations",
              "expected_behavior": "Lists the test account's three conversations (Abdulrazzak, Khalid 1, Khalid 2) with last activity, status and unread counts. Changes nothing."
            },
            {
              "description": "Summarise one conversation",
              "prompt": "Open Abdulrazzak's conversation and summarise what he asked for.",
              "tools_triggered": "list_conversations, get_conversation, list_messages",
              "expected_behavior": "Reads that customer's messages and summarises the request (an order-status question) and the assistant's reply. Changes nothing."
            },
            {
              "description": "Search messages",
              "prompt": "Search my SocialLab messages for \u00ab\u0637\u0644\u0628\u00bb and tell me which customers mentioned it.",
              "tools_triggered": "search_messages",
              "expected_behavior": "Returns the matching messages grouped by customer, with counts and the latest match. Changes nothing."
            },
            {
              "description": "Reply to a customer after confirmation",
              "prompt": "Reply to Abdulrazzak on WhatsApp: \u00ab\u0634\u0643\u0631\u0627\u064b \u0644\u062a\u0648\u0627\u0635\u0644\u0643\u060c \u0633\u0646\u062a\u0627\u0628\u0639 \u0637\u0644\u0628\u0643 \u0627\u0644\u0622\u0646\u00bb",
              "tools_triggered": "send_message",
              "expected_behavior": "ChatGPT asks for confirmation; after the user allows it, the message is sent to the test contact and ChatGPT reports it as sent. The test contacts are our team's phones. Free-form replies need the contact to have written in the last 24 hours (WhatsApp rule); otherwise the tool explains that an approved template is required."
            },
            {
              "description": "Campaign performance",
              "prompt": "How did my latest SocialLab campaign perform?",
              "tools_triggered": "list_campaigns, get_campaign_stats",
              "expected_behavior": "Finds the latest campaign and reports its delivery figures (sent, delivered, read, failed). Changes nothing."
            }
          ],
          "negative": [
            {
              "description": "General writing with no account data needed",
              "prompt": "Write me a marketing slogan for a coffee shop."
            },
            {
              "description": "Unrelated question",
              "prompt": "What is the weather in Riyadh?"
            },
            {
              "description": "Payments are not a SocialLab capability; the plugin has no such tool",
              "prompt": "Transfer 500 SAR to my supplier."
            }
          ]
        },
        "demo_recording_url": "https://drive.google.com/file/d/14CANhQOhL93Oe0I-bXR2cuBgFxX0Wpn3/view?usp=sharing",
        "commerce": false,
        "commerce_description": "This plugin does not sell products or process payments."
      },
      "publication": {
        "release_notes": "Initial release: conversations, messages and search, contacts and tags, replies, templates and interactive messages, assignments and notes, campaigns, reports, products and Salla abandoned carts.",
        "translations": {
          "ar-SA": {
            "subtitle": "\u062e\u062f\u0645\u0629 \u0639\u0645\u0644\u0627\u0621 \u0648\u0627\u062a\u0633\u0627\u0628",
            "description": "\u0633\u0648\u0634\u0644 \u0644\u0627\u0628 \u0645\u0646\u0635\u0629 \u062a\u0648\u0627\u0635\u0644 \u0645\u0639 \u0627\u0644\u0639\u0645\u0644\u0627\u0621 \u0644\u0644\u0634\u0631\u0643\u0627\u062a \u0641\u064a \u0627\u0644\u0633\u0639\u0648\u062f\u064a\u0629: \u0648\u0627\u062a\u0633\u0627\u0628 \u0648\u0625\u0646\u0633\u062a\u0642\u0631\u0627\u0645 \u0648\u0645\u0627\u0633\u0646\u062c\u0631 \u0648\u062a\u064a\u0643 \u062a\u0648\u0643 \u0648\u063a\u064a\u0631\u0647\u0627\u060c \u0645\u0639 \u0625\u062f\u0627\u0631\u0629 \u0627\u0644\u0639\u0645\u0644\u0627\u0621 \u0648\u0627\u0644\u062d\u0645\u0644\u0627\u062a \u0648\u0645\u0633\u0627\u0639\u062f \u0630\u0643\u0627\u0621 \u0627\u0635\u0637\u0646\u0627\u0639\u064a. \u062a\u062a\u064a\u062d \u0647\u0630\u0647 \u0627\u0644\u0625\u0636\u0627\u0641\u0629 \u0644\u0640 ChatGPT \u0627\u0644\u0639\u0645\u0644 \u0641\u064a \u062d\u0633\u0627\u0628\u0643 \u0641\u064a \u0633\u0648\u0634\u0644 \u0644\u0627\u0628 \u0646\u064a\u0627\u0628\u0629 \u0639\u0646\u0643: \u0642\u0631\u0627\u0621\u0629 \u0627\u0644\u0645\u062d\u0627\u062f\u062b\u0627\u062a \u0648\u0627\u0644\u0631\u062f \u0639\u0644\u064a\u0647\u0627\u060c \u0648\u0625\u0631\u0633\u0627\u0644 \u0627\u0644\u0642\u0648\u0627\u0644\u0628 \u0627\u0644\u0645\u0639\u062a\u0645\u062f\u0629\u060c \u0648\u0648\u0633\u0645 \u0627\u0644\u0639\u0645\u0644\u0627\u0621 \u0648\u0625\u0633\u0646\u0627\u062f \u0627\u0644\u0645\u062d\u0627\u062f\u062b\u0627\u062a\u060c \u0648\u0642\u0631\u0627\u0621\u0629 \u0627\u0644\u062a\u0642\u0627\u0631\u064a\u0631 \u0648\u0623\u062f\u0627\u0621 \u0627\u0644\u062d\u0645\u0644\u0627\u062a. \u0643\u0644 \u0625\u062c\u0631\u0627\u0621 \u064a\u063a\u064a\u0631 \u0634\u064a\u0626\u0627 \u064a\u0637\u0644\u0628 \u0645\u0648\u0627\u0641\u0642\u062a\u0643 \u0623\u0648\u0644\u0627\u060c \u0648\u064a\u0631\u0649 \u0645\u062f\u064a\u0631 \u0627\u0644\u062d\u0633\u0627\u0628 \u0643\u0644 \u0645\u0633\u0627\u0639\u062f \u0645\u0631\u062a\u0628\u0637 \u0648\u0645\u0627 \u063a\u064a\u0631\u0647 \u0641\u064a \u0627\u0644\u0625\u0639\u062f\u0627\u062f\u0627\u062a > \u0627\u0644\u062a\u0637\u0628\u064a\u0642\u0627\u062a \u0627\u0644\u0645\u0631\u062a\u0628\u0637\u0629 \u0648\u064a\u0633\u062a\u0637\u064a\u0639 \u0625\u0644\u063a\u0627\u0621 \u0648\u0635\u0648\u0644\u0647 \u0641\u064a \u0623\u064a \u0648\u0642\u062a."
          }
        }
      },
      "apps": "./.app.json"
    }
  }
}