त्वरित शुरुआत

यह मार्गदर्शिका आपको डायरेक्ट मैसेज भेजने और समूह बातचीत बनाने का तरीका बताती है।

पूर्वापेक्षाएँशुरू करने से पहले, आपके पास ये होने चाहिए:

एक स्वीकृत ऐप के साथ डेवलपर खाता
User Access Token (OAuth 2.0 PKCE के साथ dm.write और dm.read स्कोप)

एक-से-एक संदेश भेजें

प्राप्तकर्ता की user ID प्राप्त करें

जिस व्यक्ति को आप संदेश भेजना चाहते हैं, उसकी user ID आपके पास होनी चाहिए। आप इसे User lookup endpoint से प्राप्त कर सकते हैं।

संदेश भेजें

cURL

curl -X POST "https://api.x.com/2/dm_conversations/with/9876543210/messages" \
  -H "Authorization: Bearer $USER_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"text": "Hello! This is a message from the API."}'

from xdk import Client

client = Client(bearer_token="YOUR_USER_ACCESS_TOKEN")

# एक-से-एक संदेश भेजें
response = client.dm.send_message(
    participant_id="9876543210",
    text="Hello! This is a message from the API."
)

print(f"संदेश भेजा गया: {response.data.dm_event_id}")
print(f"बातचीत: {response.data.dm_conversation_id}")

import { Client } from "@xdevplatform/xdk";

const client = new Client({ accessToken: "YOUR_USER_ACCESS_TOKEN" });

// एक-से-एक संदेश भेजें
const response = await client.dm.sendMessage({
  participantId: "9876543210",
  text: "Hello! This is a message from the API.",
});

console.log(`संदेश भेजा गया: ${response.data?.dm_event_id}`);
console.log(`बातचीत: ${response.data?.dm_conversation_id}`);

रिस्पॉन्स देखें

{
  "data": {
    "dm_conversation_id": "1234567890-9876543210",
    "dm_event_id": "1582103724607971332"
  }
}

एक समूह बातचीत बनाएँ

प्रतिभागियों को तय करें

उन सभी लोगों की user ID इकट्ठा करें जिन्हें आप समूह में शामिल करना चाहते हैं (अपने अलावा)।

पहले संदेश के साथ समूह बनाएँ

cURL

curl -X POST "https://api.x.com/2/dm_conversations" \
  -H "Authorization: Bearer $USER_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "conversation_type": "Group",
    "participant_ids": ["944480690", "906948460078698496"],
    "message": {"text": "Welcome to our new group!"}
  }'

from xdk import Client

client = Client(bearer_token="YOUR_USER_ACCESS_TOKEN")

# एक समूह बातचीत बनाएँ
response = client.dm.create_conversation(
    conversation_type="Group",
    participant_ids=["944480690", "906948460078698496"],
    message={"text": "Welcome to our new group!"}
)

print(f"Group created: {response.data.dm_conversation_id}")

import { Client } from "@xdevplatform/xdk";

const client = new Client({ accessToken: "YOUR_USER_ACCESS_TOKEN" });

// एक समूह बातचीत बनाएँ
const response = await client.dm.createConversation({
  conversationType: "Group",
  participantIds: ["944480690", "906948460078698496"],
  message: { text: "Welcome to our new group!" },
});

console.log(`Group created: ${response.data?.dm_conversation_id}`);

बातचीत की ID प्राप्त करें

{
  "data": {
    "dm_conversation_id": "1582103724607971328",
    "dm_event_id": "1582103724607971332"
  }
}

बाद में और संदेश जोड़ने के लिए dm_conversation_id सहेज लें।

किसी मौजूदा बातचीत में संदेश जोड़ें

उस बातचीत में संदेश भेजें, जिसका आप पहले से हिस्सा हैं:

cURL

curl -X POST "https://api.x.com/2/dm_conversations/1582103724607971328/messages" \
  -H "Authorization: Bearer $USER_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"text": "Adding another message to the conversation."}'

from xdk import Client

client = Client(bearer_token="YOUR_USER_ACCESS_TOKEN")

# मौजूदा बातचीत में संदेश जोड़ें
response = client.dm.send_message_to_conversation(
    dm_conversation_id="1582103724607971328",
    text="Adding another message to the conversation."
)

print(f"Message sent: {response.data.dm_event_id}")

import { Client } from "@xdevplatform/xdk";

const client = new Client({ accessToken: "YOUR_USER_ACCESS_TOKEN" });

// मौजूदा बातचीत में संदेश जोड़ें
const response = await client.dm.sendMessageToConversation(
  "1582103724607971328",
  { text: "Adding another message to the conversation." }
);

console.log(`Message sent: ${response.data?.dm_event_id}`);

मीडिया के साथ संदेश भेजें

मीडिया अपलोड करें

सबसे पहले, Media Upload endpoint का इस्तेमाल करके अपना मीडिया अपलोड करें।

मीडिया संलग्नक के साथ भेजें

cURL

curl -X POST "https://api.x.com/2/dm_conversations/with/9876543210/messages" \
  -H "Authorization: Bearer $USER_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "text": "Check out this image!",
    "attachments": [{"media_id": "1234567890123456789"}]
  }'

from xdk import Client

client = Client(bearer_token="YOUR_USER_ACCESS_TOKEN")

# मीडिया के साथ संदेश भेजें
response = client.dm.send_message(
    participant_id="9876543210",
    text="Check out this image!",
    attachments=[{"media_id": "1234567890123456789"}]
)

print(f"Message with media sent: {response.data.dm_event_id}")

import { Client } from "@xdevplatform/xdk";

const client = new Client({ accessToken: "YOUR_USER_ACCESS_TOKEN" });

// मीडिया के साथ संदेश भेजें
const response = await client.dm.sendMessage({
  participantId: "9876543210",
  text: "Check out this image!",
  attachments: [{ mediaId: "1234567890123456789" }],
});

console.log(`Message with media sent: ${response.data?.dm_event_id}`);

संदेश हटाएँ

अपने द्वारा भेजा गया संदेश हटाने के लिए:

cURL

curl -X DELETE "https://api.x.com/2/dm_events/1582103724607971332" \
  -H "Authorization: Bearer $USER_ACCESS_TOKEN"

from xdk import Client

client = Client(bearer_token="YOUR_USER_ACCESS_TOKEN")

# संदेश हटाएँ
response = client.dm.delete_message("1582103724607971332")
print(f"Deleted: {response.data.deleted}")

import { Client } from "@xdevplatform/xdk";

const client = new Client({ accessToken: "YOUR_USER_ACCESS_TOKEN" });

// संदेश हटाएँ
const response = await client.dm.deleteMessage("1582103724607971332");
console.log(`Deleted: ${response.data?.deleted}`);

प्रतिक्रिया:

{
  "data": {
    "deleted": true
  }
}

आप केवल अपने भेजे गए संदेश हटा सकते हैं, अन्य प्रतिभागियों के संदेश नहीं।

आवश्यक स्कोप

OAuth 2.0 PKCE का उपयोग करते समय, आपके access token में ये स्कोप होने चाहिए:

Scope	विवरण
`dm.write`	संदेश भेजना और हटाना
`dm.read`	बातचीत पढ़ना (`dm.write` के साथ आवश्यक)
`tweet.read`	कुछ expansions के लिए आवश्यक
`users.read`	उपयोगकर्ता expansions के लिए आवश्यक

अगले चरण

DM लुकअप

DM बातचीत प्राप्त करें

एकीकरण गाइड

मुख्य अवधारणाएँ और सर्वोत्तम तरीके

API संदर्भ

एंडपॉइंट का संपूर्ण दस्तावेज़ीकरण

नमूना कोड

कार्यशील कोड के उदाहरण

अवलोकन

पोस्ट्स

उपयोगकर्ता

डायरेक्ट मैसेज

लाइक्स

सूचियाँ

Spaces

Communities

Community Notes

ट्रेंड्स

समाचार

मीडिया

X गतिविधि

उपयोग

स्ट्रीम कनेक्शन

अनुपालन

Enterprise v2

लाइक्स स्ट्रीम्स

GNIP 2.0

त्वरित शुरुआत

एक-से-एक संदेश भेजें

एक समूह बातचीत बनाएँ

किसी मौजूदा बातचीत में संदेश जोड़ें

मीडिया के साथ संदेश भेजें

संदेश हटाएँ

आवश्यक स्कोप

अगले चरण

DM लुकअप

एकीकरण गाइड

API संदर्भ

नमूना कोड