메인 콘텐츠로 건너뛰기다이렉트 메시지는 X에서 비공개 대화를 가능하게 합니다. 다이렉트 메시지는 X의 가장 인기 있는 기능 중 하나로, 다양한 활용 사례가 있습니다. 활용 사례는 친구들 간의 그룹 채팅부터 전 세계 브랜드의 고객 지원까지 폭넓습니다. 다이렉트 메시지 엔드포인트의 새로운 v2 버전은 단계적으로 제공되며, 이번 첫 단계에는 다이렉트 메시지 생성과 다이렉트 메시지 대화 이벤트 목록 조회를 위한 기본 엔드포인트가 포함됩니다. X API v2는 처음으로 그룹 대화를 지원합니다.
이번 초기 Manage Direct Messages 릴리스에는 다이렉트 메시지를 생성하기 위한 세 가지 POST 메서드가 포함됩니다:
- POST /2/dm_conversations/with/:participant_id/messages - 1:1 다이렉트 메시지를 생성합니다. 이 메서드는 새로운 1:1 대화를 생성하거나, 현재 대화를 찾아 그 대화에 다이렉트 메시지를 추가합니다. :participant_id 경로 매개변수는 메시지를 받는 계정의 사용자 ID입니다.
- POST /2/dm_conversations - 새로운 그룹 대화를 생성하고 다이렉트 메시지를 추가합니다. 이 요청에는 대화 참여자 목록이 필요합니다. 동일한 참여자 목록으로 여러 대화를 생성할 수 있습니다. 이 요청은 항상 새로운 대화 ID를 반환합니다.
- POST /2/dm_conversations/:dm_conversation_id/messages - 다이렉트 메시지를 생성하여 기존 대화에 추가합니다. :dm_conversation_id 경로 매개변수는 메시지를 추가할 대화의 ID입니다.
다이렉트 메시지 이벤트 ID는 v1.1과 v2(및 X 앱) 전반에서 공통이므로, v1.1의 다이렉트 메시지 숨기기/삭제 메서드를 새로운 v2 엔드포인트와 함께 사용할 수 있습니다. 또한 Enterprise 및 Premium Account Activity API는 v2 1:1 메시지를 지원하지만, 아직 그룹 대화는 지원하지 않습니다.
POST 메서드에는 15분당 사용자 기준 200건의 요청 한도가 있습니다. 또한 사용자당 24시간에 1,000건의 요청 한도가 있습니다. 추가로 24시간에 15,000건의 요청 한도가 있습니다. 이러한 요청 한도는 본 문서의 POST 엔드포인트 전반에서 공유됩니다.
manage Posts 엔드포인트로 사용자를 대신해 요청하므로, OAuth 1.0a 사용자 컨텍스트 또는 OAuth 2.0 Authorization Code with PKCE로 인증하고, 앱을 승인한 사용자와 연결된 사용자 액세스 토큰을 사용해야 합니다. OAuth 1.0a로 이 사용자 액세스 토큰을 생성하려면 3-legged OAuth 플로우를 사용할 수 있습니다. OAuth 2.0으로 사용자 액세스 토큰을 생성하려면 Authorization Code with PKCE grant flow 를 사용할 수 있습니다.
계정 설정이 엔드포인트에 접근하려면 다음이 필요합니다:X API v2 엔드포인트 접근에 대한 자세한 내용은 시작 가이드를 확인하세요. 
