Inicio rápido

Esta guía te mostrará cómo enviar Mensajes Directos y crear conversaciones de grupo.

Requisitos previosAntes de comenzar, necesitarás:

Una cuenta de desarrollador con una App aprobada
Un User Access Token (OAuth 2.0 PKCE con los ámbitos dm.write y dm.read)

Enviar un mensaje individual

Obtener el ID de usuario del destinatario

Necesitas el ID de usuario de la persona a la que quieres enviar un mensaje. Puedes obtenerlo mediante el endpoint de búsqueda de usuarios.

Enviar el mensaje

cURL

curl -X POST "https://api.x.com/2/dm_conversations/with/9876543210/messages" \
  -H "Authorization: Bearer $USER_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"text": "¡Hola! Este es un mensaje desde la API."}'

from xdk import Client

client = Client(bearer_token="YOUR_USER_ACCESS_TOKEN")

# Enviar un mensaje individual
response = client.dm.send_message(
    participant_id="9876543210",
    text="¡Hola! Este es un mensaje desde la API."
)

print(f"Mensaje enviado: {response.data.dm_event_id}")
print(f"Conversación: {response.data.dm_conversation_id}")

import { Client } from "@xdevplatform/xdk";

const client = new Client({ accessToken: "YOUR_USER_ACCESS_TOKEN" });

// Enviar un mensaje individual
const response = await client.dm.sendMessage({
  participantId: "9876543210",
  text: "¡Hola! Este es un mensaje desde la API.",
});

console.log(`Mensaje enviado: ${response.data?.dm_event_id}`);
console.log(`Conversación: ${response.data?.dm_conversation_id}`);

Revisa la respuesta

{
  "data": {
    "dm_conversation_id": "1234567890-9876543210",
    "dm_event_id": "1582103724607971332"
  }
}

Crear una conversación de grupo

Definir participantes

Reúne los identificadores de usuario de todas las personas que quieres incluir en el grupo (sin incluirte a ti).

Crear el grupo con el primer mensaje

cURL

curl -X POST "https://api.x.com/2/dm_conversations" \
  -H "Authorization: Bearer $USER_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "conversation_type": "Group",
    "participant_ids": ["944480690", "906948460078698496"],
    "message": {"text": "¡Bienvenidos a nuestro nuevo grupo!"}
  }'

from xdk import Client

client = Client(bearer_token="YOUR_USER_ACCESS_TOKEN")

# Crear una conversación de grupo
response = client.dm.create_conversation(
    conversation_type="Group",
    participant_ids=["944480690", "906948460078698496"],
    message={"text": "¡Bienvenidos a nuestro nuevo grupo!"}
)

print(f"Grupo creado: {response.data.dm_conversation_id}")

import { Client } from "@xdevplatform/xdk";

const client = new Client({ accessToken: "YOUR_USER_ACCESS_TOKEN" });

// Crear una conversación de grupo
const response = await client.dm.createConversation({
  conversationType: "Group",
  participantIds: ["944480690", "906948460078698496"],
  message: { text: "¡Bienvenidos a nuestro nuevo grupo!" },
});

console.log(`Grupo creado: ${response.data?.dm_conversation_id}`);

Recibir el identificador de la conversación

{
  "data": {
    "dm_conversation_id": "1582103724607971328",
    "dm_event_id": "1582103724607971332"
  }
}

Guarda el dm_conversation_id para añadir más mensajes más adelante.

Agregar un mensaje a una conversación existente

Envía un mensaje a una conversación de la que ya formas parte:

cURL

curl -X POST "https://api.x.com/2/dm_conversations/1582103724607971328/messages" \
  -H "Authorization: Bearer $USER_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"text": "Agregando otro mensaje a la conversación."}'

from xdk import Client

client = Client(bearer_token="YOUR_USER_ACCESS_TOKEN")

# Agregar un mensaje a una conversación existente
response = client.dm.send_message_to_conversation(
    dm_conversation_id="1582103724607971328",
    text="Agregando otro mensaje a la conversación."
)

print(f"Mensaje enviado: {response.data.dm_event_id}")

import { Client } from "@xdevplatform/xdk";

const client = new Client({ accessToken: "YOUR_USER_ACCESS_TOKEN" });

// Agregar un mensaje a una conversación existente
const response = await client.dm.sendMessageToConversation(
  "1582103724607971328",
  { text: "Agregando otro mensaje a la conversación." }
);

console.log(`Mensaje enviado: ${response.data?.dm_event_id}`);

Enviar un mensaje con contenido multimedia

Subir el contenido multimedia

Primero, sube tu contenido multimedia utilizando el endpoint Media Upload.

Enviar con contenido multimedia adjunto

cURL

curl -X POST "https://api.x.com/2/dm_conversations/with/9876543210/messages" \
  -H "Authorization: Bearer $USER_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "text": "Check out this image!",
    "attachments": [{"media_id": "1234567890123456789"}]
  }'

from xdk import Client

client = Client(bearer_token="YOUR_USER_ACCESS_TOKEN")

# Enviar un mensaje con contenido multimedia
response = client.dm.send_message(
    participant_id="9876543210",
    text="Check out this image!",
    attachments=[{"media_id": "1234567890123456789"}]
)

print(f"Mensaje con contenido multimedia enviado: {response.data.dm_event_id}")

import { Client } from "@xdevplatform/xdk";

const client = new Client({ accessToken: "YOUR_USER_ACCESS_TOKEN" });

// Enviar un mensaje con contenido multimedia
const response = await client.dm.sendMessage({
  participantId: "9876543210",
  text: "Check out this image!",
  attachments: [{ mediaId: "1234567890123456789" }],
});

console.log(`Mensaje con contenido multimedia enviado: ${response.data?.dm_event_id}`);

Eliminar un mensaje

Elimina un mensaje que enviaste:

cURL

curl -X DELETE "https://api.x.com/2/dm_events/1582103724607971332" \
  -H "Authorization: Bearer $USER_ACCESS_TOKEN"

from xdk import Client

client = Client(bearer_token="YOUR_USER_ACCESS_TOKEN")

# Eliminar un mensaje
response = client.dm.delete_message("1582103724607971332")
print(f"Eliminado: {response.data.deleted}")

import { Client } from "@xdevplatform/xdk";

const client = new Client({ accessToken: "YOUR_USER_ACCESS_TOKEN" });

// Eliminar un mensaje
const response = await client.dm.deleteMessage("1582103724607971332");
console.log(`Eliminado: ${response.data?.deleted}`);

Respuesta:

{
  "data": {
    "deleted": true
  }
}

Solo puedes eliminar los mensajes que tú enviaste; no puedes eliminar los mensajes de otros participantes.

Permisos requeridos

Cuando uses OAuth 2.0 PKCE, tu token de acceso debe tener estos permisos:

Scope	Descripción
`dm.write`	Enviar y eliminar mensajes
`dm.read`	Leer conversaciones (requerido con dm.write)
`tweet.read`	Requerido para algunas expansions
`users.read`	Requerido para expansions de usuario

Próximos pasos

Consulta de mensajes directos

Recupera conversaciones de mensajes directos

Guía de integración

Conceptos clave y mejores prácticas

Referencia de la API

Documentación completa del endpoint

Código de ejemplo

Ejemplos de código funcional

Descripción general

Publicaciones

Usuarios

Mensajes directos

Me gusta

Listas

Spaces

Comunidades

Notas de la comunidad

Tendencias

Noticias

Contenido multimedia

Actividad en X

Uso

Conexiones de streaming

Cumplimiento

Enterprise v2

Flujos de Me gusta

GNIP 2.0

Inicio rápido

Enviar un mensaje individual

Crear una conversación de grupo

Agregar un mensaje a una conversación existente

Enviar un mensaje con contenido multimedia

Eliminar un mensaje

Permisos requeridos

Próximos pasos

Consulta de mensajes directos

Guía de integración

Referencia de la API

Código de ejemplo

​Enviar un mensaje individual

​Crear una conversación de grupo

​Agregar un mensaje a una conversación existente

​Enviar un mensaje con contenido multimedia

​Eliminar un mensaje

​Permisos requeridos

​Próximos pasos

Consulta de mensajes directos

Guía de integración

Referencia de la API

Código de ejemplo

Enviar un mensaje individual

Crear una conversación de grupo

Agregar un mensaje a una conversación existente

Enviar un mensaje con contenido multimedia

Eliminar un mensaje

Permisos requeridos

Próximos pasos