Passer au contenu principal
Les endpoints de gestion des Messages directs vous permettent d’envoyer et de supprimer des Messages directs au nom d’utilisateurs authentifiés.

Aperçu

Envoyer un message

Envoyer un DM à un autre utilisateur

Supprimer un message

Supprimer un DM pour vous seul

Créer une conversation

Démarrer une nouvelle conversation

Messages de groupe

Envoyer des messages dans des conversations de groupe

Endpoints

MéthodeEndpointDescription
POST/2/dm_conversationsCréer une nouvelle conversation
POST/2/dm_conversations/with/:participant_id/messagesEnvoyer un message dans une conversation individuelle
POST/2/dm_conversations/:dm_conversation_id/messagesEnvoyer un message dans une conversation existante
DELETE/2/dm_events/:idSupprimer un événement de DM

Exemple : envoyer un message

curl -X POST "https://api.x.com/2/dm_conversations/with/1234567890/messages" \
  -H "Authorization: Bearer $USER_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"text": "Hello! How are you?"}'

Exemple de réponse

{
  "data": {
    "dm_conversation_id": "1234567890-0987654321",
    "dm_event_id": "1122334455667788990"
  }
}

Types de messages

Vous pouvez envoyer des messages texte et joindre des médias :
{
  "text": "Check out this photo!",
  "attachments": [{
    "media_id": "1234567890123456789"
  }]
}

Pour commencer

Prérequis

Démarrage rapide

Envoyez votre premier DM

Guide d’intégration

Concepts clés et bonnes pratiques

Recherche de DM

Récupérez les événements DM

Référence de l’API

Documentation complète de l’endpoint