メインコンテンツへスキップ
Manage Direct Messages エンドポイントを使用すると、認証済みのユーザーに代わってダイレクトメッセージを送信および削除できます。

概要

メッセージを送信

他のユーザーにDMを送信する

メッセージを削除

自分だけの表示からDMを削除する

会話を作成

新しい会話を開始する

グループメッセージ

グループ会話にDMを送信する

エンドポイント

MethodEndpoint説明
POST/2/dm_conversations新しい会話を作成
POST/2/dm_conversations/with/:participant_id/messages1対1の会話にメッセージを送信
POST/2/dm_conversations/:dm_conversation_id/messages既存の会話にメッセージを送信
DELETE/2/dm_events/:idDMイベントを削除

例:メッセージを送信する

curl -X POST "https://api.x.com/2/dm_conversations/with/1234567890/messages" \
  -H "Authorization: Bearer $USER_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"text": "Hello! How are you?"}'

レスポンスの例

{
  "data": {
    "dm_conversation_id": "1234567890-0987654321",
    "dm_event_id": "1122334455667788990"
  }
}

メッセージの種類

テキストメッセージを送信し、メディアを添付できます。
{
  "text": "Check out this photo!",
  "attachments": [{
    "media_id": "1234567890123456789"
  }]
}

はじめに

前提条件

クイックスタート

最初の DM を送信する

連携ガイド

主要な概念とベストプラクティス

DM ルックアップ

DM イベントを取得する

APIリファレンス

エンドポイントの詳細ドキュメント