Skip to main content
Esta guía cubre los conceptos clave que necesitas para integrar los endpoints de búsqueda de Mensajes Directos en tu aplicación.

Autenticación

Los endpoints de DM requieren autenticación de usuario para acceder a conversaciones privadas:
La autenticación App-Only no es compatible. Todos los Mensajes Directos son privados.

Scopes requeridos (OAuth 2.0)


Tipos de conversación

Uno a uno

Siempre tiene exactamente dos participantes. Formato del ID de conversación: {smaller_user_id}-{larger_user_id}

Grupal

Dos o más participantes. La composición puede cambiar con el tiempo.

Tipos de eventos

Ejemplos de eventos


Fields y expansions

Fields por defecto

Fields disponibles

Expansions disponibles

Ejemplo con expansions

cURL

Paginación

Los eventos de DM se devuelven en orden cronológico inverso (los más nuevos primero):
cURL
Los eventos de hasta hace 30 días están disponibles.

Compatibilidad de IDs con v1.1

Los IDs de conversación y de evento se comparten entre los endpoints v1.1 y v2. Esto significa que puedes:
  • Usar v2 para recuperar eventos, luego usar v1.1 para eliminar mensajes específicos
  • Referenciar los IDs de conversación de las URLs de x.com en las solicitudes de la API

Próximos pasos

Quickstart

Realiza tu primera solicitud de búsqueda de DM

Enviar DMs

Envía Mensajes Directos

Referencia de la API

Documentación completa de endpoints

Código de ejemplo

Ejemplos de código funcional