Skip to main content
이 가이드는 Manage Direct Messages endpoint를 애플리케이션에 통합하기 위해 알아야 할 핵심 개념을 다룹니다.

인증

DM endpoint는 사용자 인증이 필요합니다:
App-Only 인증은 지원되지 않습니다. 모든 Direct Message는 비공개입니다.

필수 scope (OAuth 2.0)


Endpoint 개요


메시지 전송

1:1 메시지

특정 사용자에게 메시지를 보냅니다. 대화가 없으면 새로 생성합니다:
cURL

그룹 대화

새 그룹을 만들고 첫 메시지를 전송합니다:
cURL
conversation_type field는 "Group"으로 설정해야 하며 대소문자를 구분합니다.

기존 대화에 추가

참여 중인 대화에 메시지를 전송합니다:
cURL

미디어 첨부

메시지당 미디어 한 개(사진, 동영상 또는 GIF)를 첨부할 수 있습니다.
1

미디어 업로드

Media Upload endpoint를 사용하여 파일을 업로드하고 media_id를 받습니다.
2

메시지에 포함

  • 인증된 사용자가 미디어를 업로드했어야 합니다
  • 미디어는 업로드 후 24시간 동안 사용 가능합니다
  • 메시지당 첨부는 하나만 지원됩니다

Post 공유

Post URL을 텍스트에 추가하면 메시지에 Post가 포함됩니다:
응답에는 Post ID가 담긴 referenced_tweets field가 포함됩니다.

메시지 요구사항

*text 또는 attachments 중 하나는 반드시 제공해야 합니다.

v1.1과의 ID 호환성

대화 ID와 이벤트 ID는 v1.1과 v2 endpoint 간에 공유됩니다. 이를 통해 하이브리드 워크플로가 가능합니다:
  • v2로 메시지 생성
  • v1.1로 메시지 삭제(v2에서 아직 미제공)
  • x.com URL의 대화 ID 참조

오류 처리

자주 발생하는 문제

수신자가 알 수 없는 사용자로부터의 메시지를 차단하는 DM 설정을 사용 중이거나 발신자를 차단했을 수 있습니다.
미디어가 동일한 인증된 사용자에 의해 업로드되었고 업로드 후 24시간 이내인지 확인하세요.
모든 참가자 ID가 유효한지, 그리고 사용자가 그룹 DM 초대를 허용하는지 확인하세요.

다음 단계

빠른 시작

첫 Direct Message 전송하기

DM 조회

DM 대화 조회하기

미디어 업로드

첨부용 미디어 업로드

API 레퍼런스

전체 endpoint 문서