Recherche de messages privés

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

Les endpoints de consultation des messages privés vous permettent de récupérer les événements de messages privés (DM) pour l’utilisateur authentifié, y compris les messages issus de conversations individuelles et de groupe.

​

Vue d’ensemble

Tous les événements de DM

Obtenir tous les événements de DM de l’utilisateur

En tête-à-tête

Obtenir les événements d’une conversation spécifique

Par identifiant de conversation

Obtenir les événements par identifiant de conversation

Types d’événements

Messages, ajouts à la conversation et départs

---

​

Endpoints

Méthode	Endpoint	Description
GET	/2/dm_events	Récupérer tous les événements de DM pour l’utilisateur
GET	/2/dm_conversations/with/:participant_id/dm_events	Récupérer les événements d’une conversation en tête-à-tête
GET	/2/dm_conversations/:dm_conversation_id/dm_events	Récupérer les événements par id de conversation

---

​

Types d’événements

Événement	Description
MessageCreate	Un message a été envoyé dans la conversation
ParticipantsJoin	Un utilisateur a rejoint la conversation
ParticipantsLeave	Un utilisateur a quitté la conversation

---

​

Rétention des données

Les événements couvrant les 30 derniers jours sont disponibles via ces endpoints.

---

​

Pour commencer

Prérequis

• Un compte développeur approuvé
• Un projet et une App dans la Console de développement
• Des jetons d’accès utilisateur via le flux OAuth à 3 volets

Démarrage rapide

Effectuez votre première requête de recherche 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 fonctionnels