메인 콘텐츠로 건너뛰기
Manage Direct Messages 엔드포인트를 사용하면 인증된 사용자 계정으로 다이렉트 메시지를 보내거나 삭제할 수 있습니다.

개요

메시지 보내기

다른 사용자에게 다이렉트 메시지(DM)를 보냅니다

메시지 삭제

내 계정에서 DM을 삭제합니다

대화 생성

새로운 대화를 시작합니다

그룹 메시지

그룹 대화로 보냅니다

엔드포인트

MethodEndpoint설명
POST/2/dm_conversations새 대화 생성
POST/2/dm_conversations/with/:participant_id/messages일대일 대화로 메시지 전송
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 참조 문서

전체 엔드포인트 문서