एकीकरण मार्गदर्शिका

डायरेक्ट मैसेज भेजने के लिए मुख्य अवधारणाएँ और सर्वोत्तम प्रथाएँ

इस मार्गदर्शिका में उन प्रमुख अवधारणाओं के बारे में बताया गया है जिनकी आपको manage Direct Messages एंडपॉइंट को अपने ऐप में एकीकृत करने के लिए आवश्यकता है।

---

प्रमाणीकरण

DM एंडपॉइंट्स के लिए उपयोगकर्ता प्रमाणीकरण आवश्यक है:

विधि	विवरण
PKCE के साथ OAuth 2.0 Authorization Code	अनुशंसित
OAuth 1.0a User Context	लेगेसी सपोर्ट

केवल ऐप प्रमाणीकरण समर्थित नहीं है। सभी डायरेक्ट मैसेज निजी होते हैं।

आवश्यक स्कोप (OAuth 2.0)

स्कोप	किनके लिए आवश्यक
dm.write	संदेश भेजने और हटाने के लिए
dm.read	dm.write के साथ आवश्यक
tweet.read	dm स्कोप के साथ आवश्यक
users.read	dm स्कोप के साथ आवश्यक

---

एंडपॉइंट का अवलोकन

Method	Endpoint	Description
POST	/2/dm_conversations/with/:participant_id/messages	एक-से-एक संदेश भेजें
POST	/2/dm_conversations	समूह बातचीत बनाएँ
POST	/2/dm_conversations/:dm_conversation_id/messages	बातचीत में संदेश जोड़ें
DELETE	/2/dm_events/:event_id	संदेश हटाएँ

---

संदेश भेजना

वन-टू-वन संदेश

किसी खास उपयोगकर्ता को संदेश भेजें। अगर बातचीत मौजूद नहीं है, तो नई बातचीत बनाई जाती है:

cURL

shellscript

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!"}'

समूह बातचीत

एक नया समूह बनाएँ और पहला संदेश भेजें:

cURL

shellscript

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 group!"}
  }'

conversation_type फ़ील्ड का मान "Group" होना चाहिए (केस-सेंसिटिव)।

मौजूदा बातचीत में जोड़ें

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

cURL

shellscript

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": "Another message"}'

---

मीडिया संलग्नक

हर संदेश के साथ मीडिया का एक आइटम (फ़ोटो, वीडियो, या GIF) संलग्न करें।

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

   अपनी फ़ाइल अपलोड करने और media_id पाने के लिए Media Upload endpoint का उपयोग करें।

2. संदेश में शामिल करें

   {
     "text": "Check out this image!",
     "attachments": [{"media_id": "1583157113245011970"}]
   }
   

• मीडिया उसी प्रमाणित उपयोगकर्ता द्वारा अपलोड किया गया होना चाहिए
• अपलोड के बाद मीडिया 24 घंटे तक उपलब्ध रहता है
• हर संदेश के लिए केवल एक संलग्नक समर्थित है

---

पोस्ट्स साझा करना

टेक्स्ट में पोस्ट URL जोड़कर अपने संदेश में एक पोस्ट शामिल करें:

{
  "text": "Have you seen this? https://x.com/XDevelopers/status/1580559079470145536"
}

प्रतिक्रिया में पोस्ट ID वाला referenced_tweets फ़ील्ड शामिल होगा।

---

संदेश संबंधी आवश्यकताएँ

फ़ील्ड	आवश्यक	टिप्पणियाँ
text	हाँ*	अगर कोई attachments नहीं है, तो आवश्यक
attachments	हाँ*	अगर कोई text नहीं है, तो आवश्यक

*text या attachments में से कम-से-कम एक दिया जाना चाहिए।

---

v1.1 के साथ ID संगतता

बातचीत और event ID, v1.1 और v2 एंडपॉइंट के बीच साझा होते हैं। इससे हाइब्रिड वर्कफ़्लो संभव होते हैं:

• v2 के साथ संदेश बनाएँ
• v1.1 के साथ संदेश हटाएँ (यह v2 में अभी उपलब्ध नहीं है)
• x.com URL से बातचीत ID प्राप्त करें

---

त्रुटि प्रबंधन

Status	Error	Solution
400	अमान्य अनुरोध	अनुरोध बॉडी का फ़ॉर्मैट जाँचें
401	अनधिकृत	access token सत्यापित करें
403	निषिद्ध	scopes और उपयोगकर्ता अनुमतियों की जाँच करें
429	बहुत अधिक अनुरोध	प्रतीक्षा करें और फिर से प्रयास करें

आम समस्याएँ

उपयोगकर्ता को संदेश नहीं भेजा जा सकता

प्राप्तकर्ता की DM सेटिंग्स ऐसी हो सकती हैं जो अज्ञात उपयोगकर्ताओं के संदेशों को रोकती हैं, या उसने आपको ब्लॉक किया हो सकता है।

मीडिया अटैचमेंट विफल रहा

सुनिश्चित करें कि मीडिया उसी ऑथेंटिकेट किए गए उपयोगकर्ता ने अपलोड किया हो और वह 24 घंटे से कम पुराना हो।

समूह बनाना विफल रहा

सत्यापित करें कि सभी प्रतिभागियों की ID मान्य हैं और उपयोगकर्ता समूह DM आमंत्रण स्वीकार करते हैं।

---

अगले चरण

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

अपना पहला Direct Message भेजें

DM लुकअप

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

मीडिया अपलोड

अटैचमेंट के लिए मीडिया अपलोड करें

API संदर्भ

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