Démarrage rapide

Ce guide vous explique comment envoyer des Messages privés et créer des conversations de groupe.

PrérequisAvant de commencer, vous aurez besoin :

D’un compte développeur avec une App approuvée
D’un jeton d’accès utilisateur (OAuth 2.0 PKCE, avec les scopes dm.write et dm.read)

Envoyer un message individuel

Obtenir l'identifiant utilisateur du destinataire

Vous avez besoin de l’identifiant utilisateur de la personne à qui vous souhaitez envoyer un message. Vous pouvez le récupérer à partir de l’endpoint de recherche d’utilisateurs.

Envoyer le message

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")

# Envoyer un message individuel
response = client.dm.send_message(
    participant_id="9876543210",
    text="Hello! This is a message from the API."
)

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

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

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

// Envoyer un message individuel
const response = await client.dm.sendMessage({
  participantId: "9876543210",
  text: "Hello! This is a message from the API.",
});

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

Consulter la réponse

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

Créer une conversation de groupe

Définir les participants

Rassemblez les identifiants des utilisateurs que vous souhaitez inclure dans le groupe (en dehors de vous-même).

Créer le groupe avec le premier message

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")

# Créer une conversation de groupe
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" });

// Créer une conversation de groupe
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}`);

Récupérer l’id de la conversation

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

Enregistrez le dm_conversation_id pour ajouter d’autres messages ultérieurement.

Ajouter un message à une conversation existante

Envoyez un message dans une conversation à laquelle vous participez déjà :

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": "Ajout d’un autre message dans la conversation."}'

from xdk import Client

client = Client(bearer_token="YOUR_USER_ACCESS_TOKEN")

# Ajouter un message à une conversation existante
response = client.dm.send_message_to_conversation(
    dm_conversation_id="1582103724607971328",
    text="Ajout d’un autre message dans la conversation."
)

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

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

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

// Ajouter un message à une conversation existante
const response = await client.dm.sendMessageToConversation(
  "1582103724607971328",
  { text: "Ajout d’un autre message dans la conversation." }
);

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

Envoyer un message avec un média

Téléverser le média

Tout d’abord, téléversez votre média à l’aide de l’endpoint Media Upload.

Envoyer avec une pièce jointe multimédia

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": "Découvrez cette image !",
    "attachments": [{"media_id": "1234567890123456789"}]
  }'

from xdk import Client

client = Client(bearer_token="YOUR_USER_ACCESS_TOKEN")

# Envoyer un message avec média
response = client.dm.send_message(
    participant_id="9876543210",
    text="Découvrez cette image !",
    attachments=[{"media_id": "1234567890123456789"}]
)

print(f"Message avec média envoyé : {response.data.dm_event_id}")

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

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

// Envoyer un message avec média
const response = await client.dm.sendMessage({
  participantId: "9876543210",
  text: "Découvrez cette image !",
  attachments: [{ mediaId: "1234567890123456789" }],
});

console.log(`Message avec média envoyé : ${response.data?.dm_event_id}`);

Supprimer un message

Supprimez un message que vous avez envoyé :

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")

# Supprimer un message
response = client.dm.delete_message("1582103724607971332")
print(f"Supprimé : {response.data.deleted}")

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

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

// Supprimer un message
const response = await client.dm.deleteMessage("1582103724607971332");
console.log(`Supprimé : ${response.data?.deleted}`);

Réponse :

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

Vous ne pouvez supprimer que les messages que vous avez envoyés, pas ceux des autres participants.

Scopes requis

Lorsque vous utilisez OAuth 2.0 PKCE, votre jeton d’accès doit inclure les scopes suivants :

Scope	Description
`dm.write`	Envoyer et supprimer des messages
`dm.read`	Lire les conversations (requis avec `dm.write`)
`tweet.read`	Requis pour certaines Expansions
`users.read`	Requis pour les Expansions d’utilisateurs

Prochaines étapes

Recherche de DM

Récupérer les conversations de DM

Guide d’intégration

Concepts clés et bonnes pratiques

Référence de l’API

Documentation complète de l’endpoint

Exemples de code

Exemples de code prêts à l’emploi

Vue d’ensemble

Publications

Utilisateurs

Messages privés

Mentions J’aime

Listes

Espaces

Communautés

Notes de la communauté

Tendances

Actualités

Médias

Activité sur X

Utilisation

Connexions de flux

Conformité

Enterprise v2

Flux des J’aime

GNIP 2.0

Démarrage rapide

Envoyer un message individuel

Créer une conversation de groupe

Ajouter un message à une conversation existante

Envoyer un message avec un média

Supprimer un message

Scopes requis

Prochaines étapes

Recherche de DM

Guide d’intégration

Référence de l’API

Exemples de code