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

Autenticación

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

Scopes requeridos (OAuth 2.0)


Descripción general de endpoints


Enviar mensajes

Mensaje uno a uno

Envía un mensaje a un usuario específico. Crea una nueva conversación si no existe una:
cURL

Conversación grupal

Crea un nuevo grupo y envía el primer mensaje:
cURL
El campo conversation_type debe estar configurado como "Group" (sensible a mayúsculas).

Añadir a una conversación existente

Envía un mensaje a cualquier conversación de la que formes parte:
cURL

Adjuntos de medios

Adjunta un elemento de medio (foto, video o GIF) por mensaje.
1

Sube el medio

Usa el endpoint de Media Upload para subir tu archivo y obtener un media_id.
2

Inclúyelo en el mensaje

  • El usuario autenticado debe haber subido el medio
  • El medio está disponible durante 24 horas después de la carga
  • Solo se admite un adjunto por mensaje

Compartir posts

Incluye un Post en tu mensaje añadiendo la URL del Post al texto:
La respuesta incluirá un campo referenced_tweets con el ID del Post.

Requisitos de mensaje

*Al menos uno de text o attachments debe proporcionarse.

Compatibilidad de IDs con v1.1

Los IDs de conversación y evento se comparten entre los endpoints v1.1 y v2. Esto permite flujos híbridos:
  • Crear mensajes con v2
  • Eliminar mensajes con v1.1 (aún no disponible en v2)
  • Referenciar los IDs de conversación de las URLs de x.com

Gestión de errores

Problemas comunes

El destinatario puede tener configuraciones de DM que impiden mensajes de usuarios desconocidos, o puede haberte bloqueado.
Asegúrate de que el medio fue subido por el mismo usuario autenticado y tiene menos de 24 horas.
Verifica que todos los IDs de participante sean válidos y que los usuarios permitan invitaciones a DM grupales.

Próximos pasos

Quickstart

Envía tu primer Mensaje Directo

Búsqueda de DM

Recupera conversaciones de DM

Media upload

Sube medios para adjuntos

Referencia de la API

Documentación completa de endpoints