인증
DM endpoint는 사용자 인증이 필요합니다:필수 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가 포함됩니다: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 문서