認証
DM エンドポイントではユーザー認証が必要です。必要なスコープ(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 を含められます。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 リファレンス
エンドポイントの完全なドキュメント