Démarrage rapide

Récupérer les événements et conversations de messages privés

Ce guide vous explique comment récupérer les événements de messages privés pour l’utilisateur authentifié.

Prérequis

Avant de commencer, vous aurez besoin des éléments suivants :

• Un compte développeur avec une App approuvée
• Un jeton d’accès utilisateur (OAuth 1.0a ou OAuth 2.0 PKCE)

---

​

Récupérer tous les événements de DM

Récupérez tous les événements de DM pour l’utilisateur authentifié :

cURL

shellscript

curl "https://api.x.com/2/dm_events?\
dm_event.fields=created_at,sender_id,text&\
max_results=100" \
  -H "Authorization: Bearer $USER_ACCESS_TOKEN"

​

Réponse

{
  "data": [
    {
      "id": "1234567890",
      "event_type": "MessageCreate",
      "text": "Bonjour ! Comment allez-vous ?",
      "sender_id": "9876543210",
      "created_at": "2024-01-15T10:30:00.000Z"
    }
  ],
  "meta": {
    "result_count": 1,
    "next_token": "abc123"
  }
}

---

​

Récupérer une conversation individuelle

Récupérez les événements de DM d’une conversation individuelle spécifique :

cURL

shellscript

curl "https://api.x.com/2/dm_conversations/with/9876543210/dm_events?\
dm_event.fields=created_at,sender_id,text" \
  -H "Authorization: Bearer $USER_ACCESS_TOKEN"

Remplacez 9876543210 par l’identifiant utilisateur de l’autre participant.

---

​

Récupérer une conversation par identifiant

Récupérez les événements de DM à partir de l’identifiant d’une conversation spécifique :

cURL

shellscript

curl "https://api.x.com/2/dm_conversations/1234567890-9876543210/dm_events?\
dm_event.fields=created_at,sender_id,text" \
  -H "Authorization: Bearer $USER_ACCESS_TOKEN"

---

​

Filtrer par type d’événement

Obtenez uniquement certains types d’événements :

cURL

shellscript

curl "https://api.x.com/2/dm_events?\
event_types=MessageCreate&\
dm_event.fields=created_at,sender_id,text" \
  -H "Authorization: Bearer $USER_ACCESS_TOKEN"

​

Types d’événements

Type	Description
MessageCreate	Un message a été envoyé
ParticipantsJoin	L’utilisateur a rejoint la conversation
ParticipantsLeave	L’utilisateur a quitté la conversation

---

​

Inclure des données utilisateur

Étendre les informations relatives à l’expéditeur :

cURL

shellscript

curl "https://api.x.com/2/dm_events?\
dm_event.fields=created_at,sender_id,text&\
expansions=sender_id&\
user.fields=username,profile_image_url" \
  -H "Authorization: Bearer $USER_ACCESS_TOKEN"

​

Réponse avec expansion

{
  "data": [
    {
      "id": "1234567890",
      "event_type": "MessageCreate",
      "text": "Hello!",
      "sender_id": "9876543210"
    }
  ],
  "includes": {
    "users": [
      {
        "id": "9876543210",
        "username": "example_user",
        "profile_image_url": "https://..."
      }
    ]
  }
}

---

​

Paramètres courants

Paramètre	Description
max_results	Événements par page (1-100, valeur par défaut : 100)
pagination_token	Jeton pour la page suivante
dm_event.fields	Champs d’événement à retourner
event_types	Filtrer par type d’événement
expansions	Objets associés à inclure

---

​

Prochaines étapes

Envoyer des DM

Envoyer des messages directs

Guide d’intégration

Concepts clés et bonnes pratiques

Référence de l’API

Documentation complète de l’endpoint