MCP टूल

निजी संदेशों की क्वेरी

sosoapi_dm_messages_query

खाते के लिए स्पष्ट पठन अनुमति के अंतर्गत ऐसे निजी संदेश सीमित संख्या में पढ़ें जिनकी अवधि समाप्त नहीं हुई है। सामग्री निजी और अविश्वसनीय है; उसे मॉडल को न भेजें।

Markdown में पढ़ें

प्रोफ़ाइल और ट्रांसपोर्ट

प्रोफ़ाइल: full · ट्रांसपोर्ट: stdio, http

क्लाइंट में दिखने वाले टूल के लिए core या full चुनें; इससे अनुमतियाँ नहीं बदलतीं। लोकल फ़ाइल अपलोड के लिए stdio चाहिए और HTTP पर उपलब्ध नहीं। खोज में आउटपुट स्कीमा के लिए SOSOAPI_OUTPUT_SCHEMAS=1 सेट करें। इस सेटिंग के साथ या बिना टूल संरचित परिणाम लौटाते हैं।

अनुमतियाँ और अन्य प्रभाव

एनोटेशन क्लाइंट को टूल का वर्णन करने में मदद करते हैं। हर कॉल फिर भी यूज़र का प्रमाणीकरण, भूमिका, संसाधन एक्सेस और क्षमता अधिकार जाँचती है।

{
  "readOnlyHint": true,
  "destructiveHint": false,
  "idempotentHint": true,
  "openWorldHint": true
}

/private-messaging-api/messages/query: agent:dm_read · synchronous_http_response

इनपुट फ़ील्ड

Required का अर्थ पैरेंट ऑब्जेक्ट और चुनी शाखा के भीतर अनिवार्य है। अनिवार्य चाइल्ड से वैकल्पिक पैरेंट अनिवार्य नहीं होता। नीचे के नियम और फ़ील्ड नाम कॉन्ट्रैक्ट से लिए गए हैं।

इनपुट फ़ील्ड
फ़ील्ड / शाखा	प्रकार / अनिवार्य	शर्तें
`$`	`object`पैरेंट में अनिवार्य	`additionalProperties: false`
`workspace_id`	`string`पैरेंट में अनिवार्य	`format: "uuid"`
`social_account_id`	`string`पैरेंट में अनिवार्य	`format: "uuid"`
`conversation_id`	`string`पैरेंट में अनिवार्य	`format: "uuid"`
`page_size`	`integer`वैकल्पिक / आइटम	`minimum: 1` `maximum: 50`
`cursor`	`string`वैकल्पिक / आइटम	`minLength: 1` `maxLength: 4096`

संपूर्ण JSON Schema

{
  "type": "object",
  "properties": {
    "workspace_id": {
      "type": "string",
      "format": "uuid"
    },
    "social_account_id": {
      "type": "string",
      "format": "uuid"
    },
    "conversation_id": {
      "type": "string",
      "format": "uuid"
    },
    "page_size": {
      "type": "integer",
      "minimum": 1,
      "maximum": 50
    },
    "cursor": {
      "type": "string",
      "minLength": 1,
      "maxLength": 4096
    }
  },
  "required": [
    "workspace_id",
    "social_account_id",
    "conversation_id"
  ],
  "additionalProperties": false
}

संरचित आउटपुट

यह स्कीमा सफल टूल परिणाम के structuredContent का वर्णन करता है। MCP रिस्पॉन्स में content भी होता है और कॉल विफल होने पर isError सेट हो सकता है। प्रकाशन के लिए स्वीकृत अनुरोध या टेक्स्ट रिस्पॉन्स को पुष्टि मानने के बजाय पोस्ट का अंतिम परिणाम पढ़ें। लिंक किया गया API ऑपरेशन अनुमतियाँ और पुनः प्रयास के नियम समझाता है।

संरचित आउटपुट
फ़ील्ड / शाखा	प्रकार / अनिवार्य	शर्तें
`$`	`object`पैरेंट में अनिवार्य	`additionalProperties: false`
`contract_version`	`string`पैरेंट में अनिवार्य	`const: "private-messaging/v1"`
`items`	`array`पैरेंट में अनिवार्य	—
`items[]`	`object`वैकल्पिक / आइटम	`additionalProperties: false`
`items[].id`	`string`पैरेंट में अनिवार्य	`format: "uuid"`
`items[].conversation_id`	`string`पैरेंट में अनिवार्य	`format: "uuid"`
`items[].direction`	`string`पैरेंट में अनिवार्य	`enum: ["inbound","outbound"]`
`items[].provider_message_id`	`string`पैरेंट में अनिवार्य	—
`items[].occurred_at`	`string`पैरेंट में अनिवार्य	`format: "date-time"` `pattern: "^(?:(?:\\d\\d[2468][048]\|\\d\\d[13579][26]\|\\d\\d0[48]\|[02468][048]00\|[13579][26]00)-02-29\|\\d{4}-(?:(?:0[13578]\|1[02])-(?:0[1-9]\|[12]\\d\|3[01])\|(?:0[469]\|11)-(?:0[1-9]\|[12]\\d\|30)\|(?:02)-(?:0[1-9]\|1\\d\|2[0-8])))T(?:(?:[01]\\d\|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z\|([+-](?:[01]\\d\|2[0-3]):[0-5]\\d)))$"`
`items[].expires_at`	`string`पैरेंट में अनिवार्य	`format: "date-time"` `pattern: "^(?:(?:\\d\\d[2468][048]\|\\d\\d[13579][26]\|\\d\\d0[48]\|[02468][048]00\|[13579][26]00)-02-29\|\\d{4}-(?:(?:0[13578]\|1[02])-(?:0[1-9]\|[12]\\d\|3[01])\|(?:0[469]\|11)-(?:0[1-9]\|[12]\\d\|30)\|(?:02)-(?:0[1-9]\|1\\d\|2[0-8])))T(?:(?:[01]\\d\|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z\|([+-](?:[01]\\d\|2[0-3]):[0-5]\\d)))$"`
`items[].text`	`string \| null`पैरेंट में अनिवार्य	—
`items[].redacted`	`boolean`पैरेंट में अनिवार्य	—
`next_cursor`	`string \| null`पैरेंट में अनिवार्य	—

संपूर्ण JSON Schema

{
  "type": "object",
  "properties": {
    "contract_version": {
      "type": "string",
      "const": "private-messaging/v1"
    },
    "items": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid"
          },
          "conversation_id": {
            "type": "string",
            "format": "uuid"
          },
          "direction": {
            "type": "string",
            "enum": [
              "inbound",
              "outbound"
            ]
          },
          "provider_message_id": {
            "type": "string"
          },
          "occurred_at": {
            "type": "string",
            "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$",
            "format": "date-time"
          },
          "expires_at": {
            "type": "string",
            "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$",
            "format": "date-time"
          },
          "text": {
            "type": [
              "string",
              "null"
            ]
          },
          "redacted": {
            "type": "boolean"
          }
        },
        "required": [
          "id",
          "conversation_id",
          "direction",
          "provider_message_id",
          "occurred_at",
          "expires_at",
          "text",
          "redacted"
        ],
        "additionalProperties": false
      }
    },
    "next_cursor": {
      "type": [
        "string",
        "null"
      ]
    }
  },
  "required": [
    "contract_version",
    "items",
    "next_cursor"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#",
  "additionalProperties": false
}

टूल कॉल का उदाहरण

उदाहरणों में स्कीमा से जाँचे काल्पनिक मान हैं। IDs को अधिकृत IDs, मीडिया को तैयार एसेट और तारीखों को पुष्ट प्रकाशन समय से बदलें। राइट सबमिट करने से पहले खाते की पात्रता जाँचें। यह पेज API अनुरोध नहीं भेजता।

{
  "name": "sosoapi_dm_messages_query",
  "arguments": {
    "workspace_id": "11111111-1111-4111-8111-111111111111",
    "social_account_id": "11111111-1111-4111-8111-111111111111",
    "conversation_id": "11111111-1111-4111-8111-111111111111"
  }
}

structuredContent

{
  "contract_version": "private-messaging/v1",
  "items": [],
  "next_cursor": "example"
}

/private-messaging-api/messages/query

MCP इंस्टॉल या कनेक्ट करें

गोपनीयता प्राथमिकताएँ

आवश्यक सुविधाएँ

Landing डायग्नोस्टिक्स और छिपी सामग्री वाला रीप्ले

वैकल्पिक उपयोग एनालिटिक्स

इस सार्वजनिक वेबसाइट पर सत्र रीप्ले की भी अनुमति दें

निजी संदेशों की क्वेरी

प्रोफ़ाइल और ट्रांसपोर्ट

अनुमतियाँ और अन्य प्रभाव

इनपुट फ़ील्ड

संरचित आउटपुट

टूल कॉल का उदाहरण

structuredContent

निजी संदेशों की क्वेरी

प्रोफ़ाइल और ट्रांसपोर्ट

अनुमतियाँ और अन्य प्रभाव

इनपुट फ़ील्ड

संरचित आउटपुट

टूल कॉल का उदाहरण

structuredContent

आधारभूत API ऑपरेशन