この文章は Salesforce 機械翻訳システムを使用して翻訳されました。詳細はこちらをご参照ください。

User Messages, General

コンテキストユーザの非公開メッセージを取得します。非公開メッセージ全体を検索し、非公開メッセージを投稿します。

コンテキストユーザの非公開の会話をすべて取得するには、「User Conversations, General」を参照してください。

非公開メッセージとダイレクトメッセージは異なる機能です。ダイレクトメッセージの方が新しく、Experience Cloud サイトで非公開コミュニケーションに関するより豊富な機能セットを利用できます。ダイレクトメッセージは、Chatter フィードの機能です。ダイレクトメッセージの操作については、「Feed Elements, Post and Search」を参照してください。

リソース

1/chatter/users/userId/messages

1/connect/communities/communityId/chatter/users/userId/messages

userId は、コンテキストユーザの ID または別名 me である必要があります。

メモ

適用開始バージョン

23.0

Chatter が必要かどうか

はい

HTTP のメソッド

GET、HEAD、POST

GET の要求パラメータ

パラメータ名	型	必須か省略可能	説明	使用可能なバージョン
`page`	String	省略可能	取得を開始する場所を示すページトークン。レスポンスボディの `NextPageUrl` プロパティからこのトークンを取得します。	23.0
`pageSize`	Integer	省略可能	ページあたりの項目数を指定します。有効な値は 1 ～ 100 です。サイズを指定しない場合、デフォルトは 25 です。	23.0
`q`	String	省略可能	検索する文字列を指定します。検索文字列にはワイルドカード文字を除いて 2 文字以上が含まれている必要があります。ワイルドカードについての詳細は、「ワイルドカード」を参照してください。このパラメータは省略可能です。クエリパラメータが検索するのはメッセージテキスト本文のみで、ユーザ名、役職などは検索しません。メモ	24.0

GET のレスポンスボディ

Message Collection

POST のリクエストボディ

ルート XML タグ

<message>

プロパティ

名前	型	説明	使用可能なバージョン
`body`	String	メッセージ本文のテキスト	23.0
`inReplyTo`	String	このメッセージが含まれる会話を識別する既存のメッセージの ID。`recipients` または `inReplyTo` を指定します。両方ではなく、どちらか一方を指定します。	23.0
`recipients`	User Message Recipient List Input	目的のメッセージ受信者であるユーザ (最大 9 人) のリスト。ユーザ ID のカンマ区切りのリスト。`recipients` または `inReplyTo` を指定します。両方ではなく、どちらか一方を指定します。	23.0

XML 形式の例:

1<message>
2   <body>Text of the message</body>
3   <recipients>
4      <recipient>userID</recipient>
5      <recipient>userID</recipient>
6   </recipients>
7   <inReplyTo>messageID</inReplyTo>
8</message>

JSON 形式の例:

1{
2   "body": "Text of the message",
3   "recipients": ["userID","userID"],
4   "inReplyTo": "messageID"
5}

POST の要求パラメータ

パラメータ名	型	必須か省略可能	説明	使用可能なバージョン
`inReplyTo`	String	`recipients` または `inReplyTo` を指定します。両方を指定することはできません。	このメッセージが含まれる会話を識別する既存のメッセージの ID	23.0
`recipients`	String	`recipients` または `inReplyTo` を指定します。両方を指定することはできません。	目的のメッセージ受信者であるユーザ (最大 9 人) のリスト。ユーザ ID のカンマ区切りのリスト。	23.0
`text`	String	必須	メッセージのテキスト (最大 10,000 文字)	23.0

POST のレスポンスボディ

Message

Connect REST API 開発者ガイド

User Messages, General

関連項目: