Zum Hauptinhalt springen
Direct Messages ermöglichen private Unterhaltungen auf X. Direct Messages gehören zu den beliebtesten Funktionen von X und decken eine große Bandbreite an Anwendungsfällen ab — von Gruppenchats unter Freund:innen bis hin zum weltweiten Kundensupport für Marken. Neue v2-Versionen der Direct-Messages-endpoints werden schrittweise eingeführt; diese erste Phase umfasst grundlegende endpoints zum Erstellen von Direct Messages und zum Auflisten von Ereignissen in Direct-Message-Unterhaltungen. Erstmals unterstützt die X API v2 auch Gruppen-Unterhaltungen. Diese erste Veröffentlichung von Manage Direct Messages umfasst drei POST-Methoden zum Erstellen von Direct Messages:
  • POST /2/dm_conversations/with/:participant_id/messages - Erstellt eine 1-zu-1-Direct Message. Diese Methode erstellt entweder eine neue 1-zu-1-Unterhaltung oder ruft die aktuelle Unterhaltung ab und fügt die Direct Message hinzu. Der Pfadparameter :participant_id ist die User-id des Kontos, das die Nachricht erhält.
  • POST /2/dm_conversations - Erstellt eine neue Gruppenunterhaltung und fügt ihr eine Direct Message hinzu. Diese Anfragen erfordern eine Liste der Unterhaltungsteilnehmenden. Sie können mehrere Unterhaltungen mit derselben Teilnehmendenliste erstellen. Diese Anfragen geben immer eine neue Unterhaltungs-id zurück.
  • POST /2/dm_conversations/:dm_conversation_id/messages - Erstellt eine Direct Message und fügt sie einer bestehenden Unterhaltung hinzu. Der Pfadparameter :dm_conversation_id ist die id der Unterhaltung, zu der die Nachricht hinzugefügt wird.
Beachten Sie, dass Direct-Message-Ereignis-ids in v1.1 und v2 (sowie in der X App) identisch sind, sodass die v1.1-Methoden zum Ausblenden/delete von Direct Messages zusammen mit diesem neuen v2-endpoint verwendet werden können. Beachten Sie außerdem, dass die Enterprise- und Premium-Account Activity APIs v2-1-zu-1-Nachrichten unterstützen, Gruppenunterhaltungen jedoch noch nicht. Es gilt ein nutzerbezogenes Rate Limit von 200 Anfragen pro 15 Minuten für die POST-Methode. Es gibt außerdem ein Rate Limit von 1000 Anfragen pro 24 Stunden pro Nutzer:in. Zusätzlich gibt es ein Rate Limit von 15000 Anfragen pro 24 Stunden. Diese Rate Limits werden zwischen diesen POST-endpoints geteilt. Da Sie Anfragen im Namen eines Nutzers mit den manage Posts-endpoints stellen, müssen Sie sich entweder mit OAuth 1.0a User Context oder OAuth 2.0 Authorization Code with PKCE authentifizieren und ein user Access Tokens verwenden, das mit einem Nutzer verknüpft ist, der Ihre App autorisiert hat. Um dieses user Access Token mit OAuth 1.0a zu generieren, können Sie den 3-legged OAuth-Flow verwenden. Um ein user Access Token mit OAuth 2.0 zu generieren, können Sie den Authorization Code with PKCE grant flow) verwenden.
KontoeinrichtungUm auf diese endpoints zuzugreifen, benötigen Sie:Erfahren Sie mehr darüber, wie Sie Zugriff auf die X API v2-endpoints erhalten, in unserem Getting-Started-Leitfaden.
⌘I