यह मार्गदर्शिका आपको डायरेक्ट मैसेज भेजने और समूह बातचीत बनाने का तरीका बताती है।
पूर्वापेक्षाएँ शुरू करने से पहले, आपके पास ये होने चाहिए:
एक स्वीकृत ऐप के साथ डेवलपर खाता
User Access Token (OAuth 2.0 PKCE के साथ dm.write और dm.read स्कोप)
प्राप्तकर्ता की user ID प्राप्त करें
जिस व्यक्ति को आप संदेश भेजना चाहते हैं, उसकी user ID आपके पास होनी चाहिए। आप इसे User lookup endpoint से प्राप्त कर सकते हैं।
संदेश भेजें
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."}'
रिस्पॉन्स देखें
{
"data" : {
"dm_conversation_id" : "1234567890-9876543210" ,
"dm_event_id" : "1582103724607971332"
}
}
प्रतिभागियों को तय करें
उन सभी लोगों की user ID इकट्ठा करें जिन्हें आप समूह में शामिल करना चाहते हैं (अपने अलावा)।
पहले संदेश के साथ समूह बनाएँ
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!"}
}'
बातचीत की ID प्राप्त करें
{
"data" : {
"dm_conversation_id" : "1582103724607971328" ,
"dm_event_id" : "1582103724607971332"
}
}
बाद में और संदेश जोड़ने के लिए dm_conversation_id सहेज लें।
किसी मौजूदा बातचीत में संदेश जोड़ें
उस बातचीत में संदेश भेजें, जिसका आप पहले से हिस्सा हैं:
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."}'
मीडिया संलग्नक के साथ भेजें
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"}]
}'
अपने द्वारा भेजा गया संदेश हटाने के लिए:
curl -X DELETE "https://api.x.com/2/dm_events/1582103724607971332" \
-H "Authorization: Bearer $USER_ACCESS_TOKEN "
प्रतिक्रिया:
{
"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 संदर्भ एंडपॉइंट का संपूर्ण दस्तावेज़ीकरण
नमूना कोड कार्यशील कोड के उदाहरण