Saltar al contenido principal
Esta versión inicial de la búsqueda de Mensajes Directos incluye tres métodos GET:
  • GET /2/dm_conversations/with/:participant_id/dm_events - Recupera eventos de Mensajes Directos asociados con una conversación uno a uno. El parámetro de ruta :participant_id es el ID de usuario de la cuenta que mantiene la conversación con el usuario autenticado que realiza esta solicitud. 
  • GET /2/dm_conversations/:dm_conversation_id/dm_events - Recupera eventos de Mensajes Directos asociados con un ID de conversación específico, según se indica en el parámetro de ruta :dm_conversation_id. 
  • GET /2/dm_events - Recupera eventos de Mensajes Directos asociados con un usuario, incluyendo tanto conversaciones uno a uno como de grupo. Los eventos de hasta 30 días atrás están disponibles.  
Tenga en cuenta que los ID de eventos de Mensajes Directos son comunes entre v1.1 y v2 (así como en la X App), por lo que el método de v1.1 para listar un solo evento se puede usar junto con estos nuevos endpoints de v2. También tenga en cuenta que las API de Actividad de Cuenta Empresarial y Premium admiten mensajes v2 uno a uno, pero aún no admiten conversaciones de grupo.    Con esta versión, se admiten tres tipos de eventos, y estos endpoints admiten parámetros de consulta para filtrarlos:
  • MessageCreate - Se ha creado un mensaje. 
  • ParticipantsJoin - Un nuevo participante se ha unido a una conversación. 
  • ParticipantsLeave - Un participante ha dejado una conversación. 
Existe un límite de tasa de usuario de 300 solicitudes por 15 minutos para los métodos GET. Este límite de tasa se comparte entre estos endpoints GET. Dado que realiza solicitudes en nombre de un usuario con los endpoints de Mensajes Directos v2, debe autenticarse con Contexto de usuario de OAuth 1.0a o Código de autorización de OAuth 2.0 con PKCE, utilizando tokens de acceso asociados con usuarios que han autorizado su App de X. Para generar estos tokens de acceso con OAuth 1.0a, puede usar el flujo de OAuth de 3 patas. Para generar tokens de acceso de usuario con OAuth 2.0, puede usar el flujo de concesión de Código de autorización con PKCE. Configuración de cuenta Para acceder a estos endpoints, necesitará: Obtenga más información sobre cómo acceder a los endpoints de X API v2 en nuestra guía de inicio.