Saltar al contenido principal
Los Mensajes Directos permiten conversaciones privadas en X. Son una de las funciones más populares de X y abarcan una amplia variedad de casos de uso, desde chats grupales entre amigos hasta la atención al cliente para marcas de todo el mundo. Las nuevas versiones v2 de los endpoints de Mensajes Directos se introducirán por etapas; esta primera etapa incluye endpoints fundamentales para crear Mensajes Directos y listar eventos de conversaciones de Mensajes Directos. Por primera vez, la X API v2 admite conversaciones de tipo grupo. Este lanzamiento inicial de Manage Direct Messages incluye tres métodos POST para crear Mensajes Directos:
  • POST /2/dm_conversations/with/:participant_id/messages - Crea un Mensaje Directo uno a uno. Este método crea una nueva conversación 1-1 o recupera la conversación actual y añade el Mensaje Directo a esta. El parámetro de ruta :participant_id es el User ID de la cuenta que recibe el mensaje.
  • POST /2/dm_conversations - Crea una nueva conversación de grupo y añade un Mensaje Directo a esta. Estas solicitudes requieren una lista de participantes de la conversación. Ten en cuenta que puedes crear varias conversaciones con la misma lista de participantes. Estas solicitudes siempre devolverán un nuevo id de conversación.
  • POST /2/dm_conversations/:dm_conversation_id/messages - Crea un Mensaje Directo y lo añade a una conversación existente. El parámetro de ruta :dm_conversation_id es el id de la conversación a la que se añadirá el mensaje.
Ten en cuenta que los ids de eventos de Mensajes Directos son comunes en v1.1 y v2 (así como en la X App), por lo que los métodos de v1.1 para ocultar/DELETE Mensajes Directos pueden usarse junto con este nuevo endpoint de v2. También ten en cuenta que las Account Activity APIs de Enterprise y Premium admiten mensajes uno a uno de v2, pero aún no admiten conversaciones de grupo. Existe un límite de tasa por usuario de 200 solicitudes por 15 minutos para el método POST. También hay un límite de tasa de 1000 solicitudes por 24 horas por usuario. Además, hay un límite de tasa de 15000 solicitudes por 24 horas. Ten en cuenta que estos límites de tasa se comparten entre estos endpoints POST. Dado que estás realizando solicitudes en nombre de un usuario con los endpoints de manage Posts, debes autenticarte con OAuth 1.0a User Context o OAuth 2.0 Authorization Code with PKCE, y usar un Access Token de usuario asociado a un usuario que haya autorizado tu App. Para generar este Access Token de usuario con OAuth 1.0a, puedes usar el flujo de OAuth de 3 fases. Para generar un Access Token de usuario con OAuth 2.0, puedes usar el Authorization Code with PKCE grant flow).
Configuración de la cuentaPara acceder a estos endpoints, necesitarás:Obtén más información sobre cómo obtener acceso a los endpoints de la X API v2 en nuestra guía de introducción.
⌘I