Quickstart

Esta guía te lleva paso a paso a enviar Mensajes Directos y crear conversaciones grupales.

Requisitos previosAntes de comenzar, necesitarás:

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

Enviar un mensaje uno a uno

Obtén el ID de usuario del destinatario

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

Envía 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": "Hello! This is a message from the API."}'

from xdk import Client

client = Client(bearer_token="YOUR_USER_ACCESS_TOKEN")

# Send a one-to-one message
response = client.dm.send_message(
    participant_id="9876543210",
    text="Hello! This is a message from the API."
)

print(f"Message sent: {response.data.dm_event_id}")
print(f"Conversation: {response.data.dm_conversation_id}")

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

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

// Send a one-to-one message
const response = await client.dm.sendMessage({
  participantId: "9876543210",
  text: "Hello! This is a message from the API.",
});

console.log(`Message sent: ${response.data?.dm_event_id}`);
console.log(`Conversation: ${response.data?.dm_conversation_id}`);

Revisa la respuesta

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

Crear una conversación grupal

Define los participantes

Reúne los IDs de usuario de todos los que quieras en el grupo (excluyéndote a ti).

Crea 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": "Welcome to our new group!"}
  }'

from xdk import Client

client = Client(bearer_token="YOUR_USER_ACCESS_TOKEN")

# Create a group conversation
response = client.dm.create_conversation(
    conversation_type="Group",
    participant_ids=["944480690", "906948460078698496"],
    message={"text": "Welcome to our new group!"}
)

print(f"Group created: {response.data.dm_conversation_id}")

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

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

// Create a group conversation
const response = await client.dm.createConversation({
  conversationType: "Group",
  participantIds: ["944480690", "906948460078698496"],
  message: { text: "Welcome to our new group!" },
});

console.log(`Group created: ${response.data?.dm_conversation_id}`);

Recibe el ID de conversación

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

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

Añadir 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": "Adding another message to the conversation."}'

from xdk import Client

client = Client(bearer_token="YOUR_USER_ACCESS_TOKEN")

# Add message to existing conversation
response = client.dm.send_message_to_conversation(
    dm_conversation_id="1582103724607971328",
    text="Adding another message to the conversation."
)

print(f"Message sent: {response.data.dm_event_id}")

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

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

// Add message to existing conversation
const response = await client.dm.sendMessageToConversation(
  "1582103724607971328",
  { text: "Adding another message to the conversation." }
);

console.log(`Message sent: ${response.data?.dm_event_id}`);

Enviar un mensaje con medios

Sube el medio

Primero, sube tu medio usando el endpoint de Media Upload.

Envía con adjunto de media

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")

# Send message with media
response = client.dm.send_message(
    participant_id="9876543210",
    text="Check out this image!",
    attachments=[{"media_id": "1234567890123456789"}]
)

print(f"Message with media sent: {response.data.dm_event_id}")

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

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

// Send message with media
const response = await client.dm.sendMessage({
  participantId: "9876543210",
  text: "Check out this image!",
  attachments: [{ mediaId: "1234567890123456789" }],
});

console.log(`Message with media sent: ${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")

# Delete a message
response = client.dm.delete_message("1582103724607971332")
print(f"Deleted: {response.data.deleted}")

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

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

// Delete a message
const response = await client.dm.deleteMessage("1582103724607971332");
console.log(`Deleted: ${response.data?.deleted}`);

Respuesta:

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

Solo puedes eliminar mensajes que hayas enviado tú, no mensajes de otros participantes.

Scopes requeridos

Al usar OAuth 2.0 PKCE, tu access token debe tener estos scopes:

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

Búsqueda de DM

Recupera conversaciones de DM

Guía de integración

Conceptos clave y buenas prácticas

Referencia de la API

Documentación completa de endpoints

Código de ejemplo

Ejemplos de código funcional

Getting Started

Products

Fundamentals

Partners & Customers

Resources

Quickstart

Enviar un mensaje uno a uno

Crear una conversación grupal

Añadir un mensaje a una conversación existente

Enviar un mensaje con medios

Eliminar un mensaje

Scopes requeridos

Próximos pasos

Búsqueda de DM

Guía de integración

Referencia de la API

Código de ejemplo

​Enviar un mensaje uno a uno

​Crear una conversación grupal

​Añadir un mensaje a una conversación existente

​Enviar un mensaje con medios

​Eliminar un mensaje

​Scopes requeridos

​Próximos pasos

Búsqueda de DM

Guía de integración

Referencia de la API

Código de ejemplo

Enviar un mensaje uno a uno

Crear una conversación grupal

Añadir un mensaje a una conversación existente

Enviar un mensaje con medios

Eliminar un mensaje

Scopes requeridos

Próximos pasos