Autenticación
Los endpoints de DM requieren autenticación de usuario: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: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
No se puede enviar al usuario
No se puede enviar al usuario
El destinatario puede tener configuraciones de DM que impiden mensajes de usuarios desconocidos, o puede haberte bloqueado.
El adjunto de media falló
El adjunto de media falló
Asegúrate de que el medio fue subido por el mismo usuario autenticado y tiene menos de 24 horas.
La creación del grupo falló
La creación del grupo falló
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