Passer au contenu principal
Les Messages privés permettent d’avoir des conversations privées sur X. Il s’agit de l’une des fonctionnalités les plus populaires de X, avec une grande variété de cas d’usage, allant des discussions de groupe entre amis à l’assistance client pour des marques du monde entier. De nouvelles versions v2 des endpoints des Messages privés seront introduites par étapes, et cette première phase inclut des endpoints fondamentaux pour créer des Messages privés et répertorier les événements de conversation de Messages privés. Pour la première fois, la X API v2 prend en charge les conversations de groupe. Cette version initiale de Manage Direct Messages inclut trois méthodes POST pour créer des Messages privés :
  • POST /2/dm_conversations/with/:participant_id/messages - Crée un Message privé en tête-à-tête. Cette méthode crée soit une nouvelle conversation 1‑1, soit récupère la conversation en cours et y ajoute le Message privé. Le paramètre de chemin :participant_id est l’id utilisateur du compte destinataire du message.
  • POST /2/dm_conversations - Crée une nouvelle conversation de groupe et y ajoute un Message privé. Ces requêtes nécessitent une liste de participants à la conversation. Notez que vous pouvez créer plusieurs conversations avec la même liste de participants. Ces requêtes renverront toujours un nouvel id de conversation.
  • POST /2/dm_conversations/:dm_conversation_id/messages - Crée un Message privé et l’ajoute à une conversation existante. Le paramètre de chemin :dm_conversation_id est l’id de la conversation à laquelle le message sera ajouté.
Notez que les id d’événements de Message privé sont communs entre v1.1 et v2 (ainsi que l’X App), donc les méthodes v1.1 pour masquer/DELETE des Messages privés peuvent être utilisées avec ce nouvel endpoint v2. Notez également que les Account Activity APIs Enterprise et Premium prennent en charge les messages en tête-à-tête v2, mais ne prennent pas encore en charge les conversations de groupe. Il existe une limite de taux par utilisateur de 200 requêtes par 15 minutes pour la méthode POST. Il existe également une limite de taux de 1000 requêtes par 24 heures et par utilisateur. En outre, il existe une limite de taux de 15000 requêtes par 24 heures. Notez que ces limites de taux sont partagées entre ces endpoints POST. Comme vous effectuez des requêtes au nom d’un utilisateur avec les endpoints manage Posts, vous devez vous authentifier soit avec le Contexte utilisateur OAuth 1.0a, soit avec OAuth 2.0 Autorisation par code avec PKCE, et utiliser des Access Tokens utilisateur associés à un utilisateur ayant autorisé votre App. Pour générer cet Access Token utilisateur avec OAuth 1.0a, vous pouvez utiliser le flux OAuth à 3 étapes. Pour générer un Access Token utilisateur avec OAuth 2.0, vous pouvez utiliser le flux d’autorisation par code avec PKCE).
Configuration du comptePour accéder à ces endpoints, vous aurez besoin de :En savoir plus sur l’accès aux endpoints X API v2 dans notre guide de démarrage.
⌘I