メインコンテンツへスキップ
ダイレクトメッセージは、X 上でプライベートな会話を実現します。ダイレクトメッセージは X で最も人気のある機能の一つで、活用場面は多岐にわたります。友人同士のグループチャットから、世界中のブランドのカスタマーサポートまで幅広く利用されています。ダイレクトメッセージの新しい v2 の endpoint は段階的に導入され、この最初の段階には、ダイレクトメッセージの作成とダイレクトメッセージ会話イベントの一覧取得のための基礎的な endpoint が含まれます。X API v2 では初めて、グループ会話がサポートされます。 Manage Direct Messages のこの初期リリースには、ダイレクトメッセージを作成するための 3 つの POST メソッドが含まれます:
  • POST /2/dm_conversations/with/:participant_id/messages - 1 対 1 のダイレクトメッセージを作成します。このメソッドは、新しい 1-1 会話を作成するか、既存の会話を取得してそこにダイレクトメッセージを追加します。:participant_id のパスパラメータは、メッセージを受け取るアカウントのユーザー ID です。
  • POST /2/dm_conversations - 新しいグループ会話を作成し、そこにダイレクトメッセージを追加します。これらのリクエストには会話参加者のリストが必要です。同じ参加者リストで複数の会話を作成できる点に注意してください。これらのリクエストは常に新しい会話 ID を返します。
  • POST /2/dm_conversations/:dm_conversation_id/messages - ダイレクトメッセージを作成し、既存の会話に追加します。:dm_conversation_id のパスパラメータは、メッセージを追加する会話の ID です。
ダイレクトメッセージイベントの ID は v1.1 と v2（および X App）間で共通のため、v1.1 の非表示/削除メソッドは、この新しい v2 の endpoint と併用できます。また、Enterprise および Premium の Account Activity API は v2 の 1 対 1 メッセージをサポートしていますが、グループ会話はまだサポートしていない点にも注意してください。 POST メソッドには、ユーザーあたり 15 分間で 200 リクエストのユーザーレートリミットがあります。さらに、ユーザーあたり 24 時間で 1000 リクエストのレートリミットがあります。加えて、24 時間で 15000 リクエストのレートリミットがあります。これらのレートリミットは、これらの POST endpoint 間で共有されます。 manage Posts の endpoint でユーザーに代わってリクエストを送信するため、OAuth 1.0a User Context または OAuth 2.0 Authorization Code with PKCE で認証し、あなたの App を承認したユーザーに紐づくユーザー Access Tokens を使用する必要があります。OAuth 1.0a でこのユーザー Access Token を生成するには、3-legged OAuth フローを使用できます。OAuth 2.0 でユーザー Access Token を生成するには、Authorization Code with PKCE grant フロー) を使用できます。
アカウントのセットアップこれらの endpoint にアクセスするには、以下が必要です:X API v2 の endpoint へのアクセス方法の詳細は、当社の 入門ガイドをご覧ください。
⌘I