Gestionar mensajes directos

Enviar y eliminar mensajes directos

Los endpoints de Manage Direct Messages permiten enviar y eliminar mensajes directos en nombre de usuarios autenticados.

​

Descripción general

Enviar mensaje

Envía un MD a otro usuario

Eliminar mensaje

Elimina un MD solo para ti

Crear conversación

Inicia una nueva conversación

Mensajes de grupo

Envía mensajes a conversaciones de grupo

---

​

Endpoints

Method	Endpoint	Description
POST	/2/dm_conversations	Crear una nueva conversación
POST	/2/dm_conversations/with/:participant_id/messages	Enviar un mensaje a una conversación individual
POST	/2/dm_conversations/:dm_conversation_id/messages	Enviar un mensaje a una conversación existente
DELETE	/2/dm_events/:id	Eliminar un evento de MD

---

​

Ejemplo: enviar un mensaje

curl -X POST "https://api.x.com/2/dm_conversations/with/1234567890/messages" \
  -H "Authorization: Bearer $USER_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"text": "Hello! How are you?"}'

​

Ejemplo de respuesta

{
  "data": {
    "dm_conversation_id": "1234567890-0987654321",
    "dm_event_id": "1122334455667788990"
  }
}

---

​

Tipos de mensajes

Puedes enviar mensajes de texto y adjuntar archivos multimedia:

{
  "text": "¡Mira esta foto!",
  "attachments": [{
    "media_id": "1234567890123456789"
  }]
}

---

​

Primeros pasos

Requisitos previos

• Una cuenta de desarrollador aprobada
• Un Project and App en la Consola de desarrollador
• Tokens de acceso de usuario mediante OAuth 2.0 PKCE

Inicio rápido

Envía tu primer DM

Guía de integración

Conceptos clave y prácticas recomendadas

Búsqueda de DM

Recupera eventos de DM

Referencia de la API

Documentación completa del endpoint