Saltar al contenido principal
Los Mensajes Directos permiten conversaciones privadas en X. Los Mensajes Directos son una de las funciones más populares de X, con una amplia variedad de casos de uso. Estos van 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, y 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 grupo. Esta versión 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 agrega el Mensaje Directo a esta. El parámetro de ruta :participant_id es el id de usuario de la cuenta que recibe el mensaje.
  • POST /2/dm_conversations - Crea una nueva conversación de grupo y agrega un Mensaje Directo. 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 agrega a una conversación existente. El parámetro de ruta :dm_conversation_id es el id de la conversación a la que se agregará el mensaje.
Ten en cuenta que los ids de eventos de Mensajes Directos son comunes entre v1.1 y v2 (así como en la App de X), por lo que los métodos de v1.1 para ocultar/eliminar Mensajes Directos pueden usarse junto con este nuevo endpoint de v2. También ten en cuenta que las Enterprise y Premium Account Activity APIs admiten mensajes uno a uno de v2, pero aún no admiten conversaciones de grupo. Hay un límite por usuario de 200 solicitudes cada 15 minutos para el método POST. También hay un límite de 1000 solicitudes por usuario cada 24 horas. Adicionalmente, hay un límite de 15000 solicitudes cada 24 horas. Ten en cuenta que estos límites se comparten entre estos endpoints POST. Dado que estás realizando solicitudes en nombre de un usuario con los endpoints de gestión de Posts, debes autenticarte con OAuth 1.0a User Context o OAuth 2.0 Authorization Code with PKCE, y usar tokens de acceso de usuario asociados con un usuario que haya autorizado tu App. Para generar este token de acceso de usuario con OAuth 1.0a, puedes usar el flujo OAuth de 3 pasos. Para generar un token de acceso de usuario con OAuth 2.0, puedes usar el flujo de concesión Authorization Code with PKCE.
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 primeros pasos.