Skip to main content
このガイドでは、manage Direct Messages エンドポイントをアプリケーションに統合するために必要な主要な概念を説明します。

認証

DM エンドポイントではユーザー認証が必要です。
App-Only 認証はサポートされていません。すべてのダイレクトメッセージは非公開です。

必要なスコープ(OAuth 2.0)


エンドポイントの概要


メッセージの送信

1 対 1 のメッセージ

特定のユーザーにメッセージを送信します。会話が存在しない場合は新規に作成します。
cURL

グループ会話

新しいグループを作成し、最初のメッセージを送信します。
cURL
conversation_type フィールドは "Group" に設定する必要があります(大文字小文字を区別)。

既存の会話に追加

自分が参加している任意の会話にメッセージを送信します。
cURL

メディア添付

1 メッセージにつき 1 つのメディア(写真、動画、GIF)を添付できます。
1

メディアをアップロード

Media Upload endpoint を使用してファイルをアップロードし、media_id を取得します。
2

メッセージに含める

  • 認証済みユーザー自身がメディアをアップロードしている必要があります
  • メディアはアップロードから 24 時間有効です
  • 1 メッセージにつき添付できるのは 1 つだけです

Post の共有

Post URL をテキストに追加すると、メッセージに Post を含められます。
レスポンスには Post ID を含む referenced_tweets フィールドが含まれます。

メッセージの要件

*text または attachments のいずれかを必ず指定する必要があります。

v1.1 との ID 互換性

会話 ID とイベント ID は v1.1 と v2 のエンドポイント間で共有されます。これにより、ハイブリッドなワークフローが可能になります。
  • v2 でメッセージを作成
  • v1.1 でメッセージを削除(v2 ではまだ利用不可)
  • x.com URL の会話 ID を参照

エラー処理

よくある問題

受信者が未知のユーザーからのメッセージを許可しない DM 設定にしている、またはあなたをブロックしている可能性があります。
メディアが同じ認証済みユーザーによってアップロードされ、24 時間以内であることを確認してください。
すべての participant ID が有効で、ユーザーがグループ DM の招待を許可していることを確認してください。

次のステップ

クイックスタート

最初のダイレクトメッセージを送信

DM lookup

DM の会話を取得

メディアアップロード

添付用のメディアをアップロード

API リファレンス

エンドポイントの完全なドキュメント