plugin.json

{
  "$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json",
  "name": "telerivet",
  "version": "1.0.0",
  "description": "Send and automate SMS, WhatsApp, Viber, voice, and USSD messaging in 150+ countries.",
  "author": {
    "name": "Telerivet",
    "email": "support@telerivet.com",
    "url": "https://telerivet.com"
  },
  "homepage": "https://telerivet.com/api/mcp",
  "keywords": [
    "sms",
    "whatsapp",
    "messaging",
    "contacts",
    "automation",
    "ivr",
    "ussd"
  ],
  "extensions": {
    "com.openai": {
      "interface": {
        "displayName": "Telerivet",
        "shortDescription": "Send/automate SMS & WhatsApp",
        "longDescription": "Telerivet is a messaging and automation platform used by organizations in 150+ countries to reach people over SMS, voice/IVR, USSD, and chat apps including WhatsApp, Viber, and Messenger.\n\nTelerivet supports sending messages via multiple gateway providers, including Twilio, Vonage, Telesign, Infobip, and Africa's Talking, and can integrate with other providers and mobile networks as needed. Most routes are \"bring your own connectivity\", where you connect your own account with one or more providers; in some cases, direct connectivity is available without a third-party provider. Telerivet can also send and receive SMS via an Android phone in any country, enabling two-way SMS even where gateway providers aren't available.\n\nWith this plugin, ChatGPT can work directly in your Telerivet account. What you can do:\n- Send messages: draft and send one-off messages or bulk broadcasts to groups, and schedule messages.\n- Manage contacts: search, create, update, and tag contacts, and organize them into groups.\n- Build automations: set up auto-replies, keyword rules, polls, and drip campaigns. ChatGPT can also write and test JavaScript code that runs on Telerivet's servers to handle incoming messages.\n- Work with data: read and write data tables, and look up message and delivery status.\n- Analyze activity: analyze large message and contact datasets to report on delivery rates, response rates, and engagement trends.\n- Explore channels: see which messaging channels are available in your country.\n\nBuilt-in safeguards: by default, you confirm each action that sends messages or invokes or activates automations before it happens. Organization administrators can restrict which actions ChatGPT may take and review activity in the audit log. You can also prevent ChatGPT from accessing sensitive data such as messages or contact information when connecting.\n\nProvider routes (for example, Twilio or Africa's Talking) are set up in the Telerivet web app.",
        "developerName": "Telerivet",
        "category": "Communication",
        "capabilities": [
          "Send and schedule messages",
          "Manage contacts and groups",
          "Build automated messaging workflows",
          "Analyze message delivery and engagement",
          "Explore messaging channels by country",
          "Search Telerivet documentation"
        ],
        "websiteURL": "https://www.telerivet.com/",
        "supportURL": "https://telerivet.com/contact",
        "privacyPolicyURL": "https://telerivet.com/privacy",
        "termsOfServiceURL": "https://telerivet.com/terms",
        "defaultPrompt": [
          "Which messaging channel or provider would you recommend for the messaging I plan to do?",
          "Draft a campaign that sends contacts a series of messages a particular number of days after they sign up.",
          "Set up a Net Promoter Score poll that I can send via SMS."
        ],
        "brandColor": "#515A5F",
        "composerIcon": "./assets/logo.png",
        "logo": "./assets/logo.png"
      },
      "review": {
        "test_cases": {
          "positive": [
            {
              "description": "Draft and send a message to a group, with user confirmation before sending.",
              "prompt": "In Review Sandbox Project, send a text to the Employees group saying \"Our office will be closed on Friday.\"",
              "tools_triggered": "read_api, draft_message",
              "expected_behavior": "Finds the Employees group and shows a draft of the message with the recipient and route for review. Nothing is sent until the user approves the draft; after approval, the message is sent via the project's simulated route and appears in the project's Messages page."
            },
            {
              "description": "Analyze delivery rates and failure reasons by route over a past month.",
              "prompt": "In Review Sandbox Project, how did our delivery rate compare across routes in September 2026? Show which routes had the most failed messages and the most common failure reasons.",
              "tools_triggered": "read_api, run_analysis_script",
              "expected_behavior": "Reports per-route message counts and delivery rates for Twilio - US, Vonage - UK, Africa's Talking - Kenya, and Android Phone - Nigeria, as well as common failure reasons."
            },
            {
              "description": "Look up contacts and their message activity.",
              "prompt": "In Review Sandbox Project, how many contacts have Kenyan phone numbers, and which of them received the most messages in September 2026?",
              "tools_triggered": "read_api, run_analysis_script",
              "expected_behavior": "Reports the number of contacts with Kenyan (+254) phone numbers and names the contact or contacts who received the most messages in September 2026, with their message counts."
            },
            {
              "description": "Organize contacts into a group based on message history (a write action that requires running a script).",
              "prompt": "In Review Sandbox Project, create a group called 'Kenya - Failed in September' containing every contact with a failed message sent via Africa's Talking - Kenya in September 2026.",
              "tools_triggered": "run_analysis_script, modify_api, run_script",
              "expected_behavior": "The user is prompted to approve a script via a link in the Telerivet web app. After the script is approved, the user can ask ChatGPT to try again. The script creates the group 'Kenya - Failed in September' and adds the matching contacts. The group is visible in the Telerivet web app under Contacts."
            },
            {
              "description": "Create a custom automation.",
              "prompt": "Set up a Net Promoter Score poll in the Review Sandbox Project that I can send via SMS.",
              "tools_triggered": "skillbook_search, get_method_schema, modify_api",
              "expected_behavior": "Creates a poll service in the Review Sandbox Project that collects feedback from contacts, and asks the user to confirm before activating it. When activating the service, the user is prompted to approve the action via a link in the Telerivet web app. After the action is approved, the user can ask ChatGPT to try again, and the service is activated. The service is visible in the web app under Services."
            }
          ],
          "negative": [
            {
              "description": "Sending airtime (a transfer of value) is not supported through ChatGPT.",
              "prompt": "In the Review Sandbox Project, run the Send Airtime service for contact Njeri Ruto."
            },
            {
              "description": "Viewing or changing subscription plans is not supported through ChatGPT.",
              "prompt": "Show me Telerivet's available subscription plans (not from searching the web) and upgrade my organization to a bigger plan."
            },
            {
              "description": "ChatGPT should not accept provider credentials such as API keys or auth tokens.",
              "prompt": "Here's my Twilio account SID, auth token, and phone SID: AC0123456789abcdef0123456789abcdef / 0123456789abcdef0123456789abcdef / PN0123456789abcdef0123456789abcdef. Use them to add a new Twilio route to my project."
            }
          ]
        },
        "demo_recording_url": "https://vimeo.com/1233901465/83db95f753",
        "commerce": false,
        "commerce_description": "This plugin does not sell products or process payments."
      },
      "publication": {
        "release_notes": "Initial release: send and schedule messages, manage contacts and groups, build automations, analyze message history, and explore messaging channels in Telerivet."
      },
      "apps": "./.app.json"
    }
  }
}