빠른 시작

다이렉트 메시지 이벤트와 대화 가져오기

이 가이드는 인증된 사용자의 다이렉트 메시지 이벤트를 조회하는 방법을 단계별로 안내합니다.

사전 준비 사항

시작하기 전에 다음이 필요합니다.

• 승인이 완료된 App을 보유한 개발자 계정
• 사용자 액세스 토큰(OAuth 1.0a 또는 OAuth 2.0 PKCE)

---

​

모든 DM 이벤트 가져오기

인증된 사용자의 모든 DM 이벤트를 가져옵니다.

cURL

shellscript

curl "https://api.x.com/2/dm_events?\
dm_event.fields=created_at,sender_id,text&\
max_results=100" \
  -H "Authorization: Bearer $USER_ACCESS_TOKEN"

​

응답

{
  "data": [
    {
      "id": "1234567890",
      "event_type": "MessageCreate",
      "text": "Hello! How are you?",
      "sender_id": "9876543210",
      "created_at": "2024-01-15T10:30:00.000Z"
    }
  ],
  "meta": {
    "result_count": 1,
    "next_token": "abc123"
  }
}

---

​

일대일 대화 가져오기

특정 일대일 대화에서 DM 이벤트를 조회합니다:

cURL

shellscript

curl "https://api.x.com/2/dm_conversations/with/9876543210/dm_events?\
dm_event.fields=created_at,sender_id,text" \
  -H "Authorization: Bearer $USER_ACCESS_TOKEN"

9876543210을 다른 참가자의 사용자 ID로 바꾸세요.

---

​

ID로 대화 조회하기

특정 대화 ID에 대한 DM 이벤트를 조회합니다:

cURL

shellscript

curl "https://api.x.com/2/dm_conversations/1234567890-9876543210/dm_events?\
dm_event.fields=created_at,sender_id,text" \
  -H "Authorization: Bearer $USER_ACCESS_TOKEN"

---

​

이벤트 유형으로 필터링하기

특정 이벤트 유형만 가져옵니다:

cURL

shellscript

curl "https://api.x.com/2/dm_events?\
event_types=MessageCreate&\
dm_event.fields=created_at,sender_id,text" \
  -H "Authorization: Bearer $USER_ACCESS_TOKEN"

​

이벤트 type

Type	설명
MessageCreate	메시지 전송
ParticipantsJoin	사용자가 대화에 참여
ParticipantsLeave	사용자가 대화에서 나감

---

​

사용자 데이터 포함

발신자 정보를 확장합니다:

cURL

shellscript

curl "https://api.x.com/2/dm_events?\
dm_event.fields=created_at,sender_id,text&\
expansions=sender_id&\
user.fields=username,profile_image_url" \
  -H "Authorization: Bearer $USER_ACCESS_TOKEN"

​

확장을 포함한 응답

{
  "data": [
    {
      "id": "1234567890",
      "event_type": "MessageCreate",
      "text": "Hello!",
      "sender_id": "9876543210"
    }
  ],
  "includes": {
    "users": [
      {
        "id": "9876543210",
        "username": "example_user",
        "profile_image_url": "https://..."
      }
    ]
  }
}

---

​

공통 파라미터

Parameter	Description
max_results	페이지당 이벤트 수 (1-100, 기본값 100)
pagination_token	다음 페이지용 토큰
dm_event.fields	반환할 이벤트 필드
event_types	이벤트 유형으로 필터링
expansions	포함할 관련 객체

---

​

다음 단계

DM 보내기

다이렉트 메시지 보내기

통합 가이드

주요 개념과 모범 사례

API 참조 문서

엔드포인트 전체 문서