> ## Documentation Index > Fetch the complete documentation index at: https://generaltranslation.mintlify.site/llms.txt > Use this file to discover all available pages before exploring further. # Guía de integración > Conceptos clave y prácticas recomendadas para el envío de Mensajes Directos export const Button = ({href, children}) => { return

; }; Esta guía cubre los conceptos clave que necesitas para integrar los endpoints para administrar los Mensajes Directos en tu aplicación. ***

## Autenticación

Los endpoints de Mensajes Directos requieren autenticación de usuario: | Método | Descripción | | :-------------------------------------------------------------------------------------------------------------------------------- | :---------------------- | | [OAuth 2.0 Authorization Code with PKCE](/es/resources/fundamentals/authentication#oauth-2-0-authorization-code-flow-with-pkce-2) | Recomendado | | [OAuth 1.0a User Context](/es/resources/fundamentals/authentication) | Compatibilidad heredada | La autenticación App-Only no está admitida. Todos los mensajes directos son privados.

### Scopes requeridos (OAuth 2.0)

## Descripción general de los endpoints

## Enviar mensajes

### Mensaje uno a uno

Envía un mensaje a un usuario específico. Crea una nueva conversación si aún no existe ninguna: ```bash cURL theme={null} 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!"}' ``` ```python Python SDK theme={null} from xdk import Client client = Client(bearer_token="YOUR_USER_ACCESS_TOKEN") # Enviar un MD uno a uno response = client.dm_conversations.create_message( participant_id="9876543210", text="¡Hola!" ) print(response.data) ``` ```javascript JavaScript SDK theme={null} import { Client } from "@xdevplatform/xdk"; const client = new Client({ accessToken: "YOUR_USER_ACCESS_TOKEN" }); // Enviar un MD uno a uno const response = await client.dmConversations.createMessage({ participantId: "9876543210", text: "¡Hola!", }); console.log(response.data); ```

### Conversación de grupo

Crea un nuevo grupo y envía el primer mensaje: ```bash cURL theme={null} 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": "¡Bienvenido a nuestro grupo!"} }' ``` ```python Python SDK theme={null} from xdk import Client client = Client(bearer_token="YOUR_USER_ACCESS_TOKEN") # Crear una conversación de grupo response = client.dm_conversations.create( conversation_type="Group", participant_ids=["944480690", "906948460078698496"], message={"text": "¡Bienvenido a nuestro grupo!"} ) print(response.data) ``` ```javascript JavaScript SDK theme={null} import { Client } from "@xdevplatform/xdk"; const client = new Client({ accessToken: "YOUR_USER_ACCESS_TOKEN" }); // Crear una conversación de grupo const response = await client.dmConversations.create({ conversationType: "Group", participantIds: ["944480690", "906948460078698496"], message: { text: "¡Bienvenido a nuestro grupo!" }, }); console.log(response.data); ``` El campo `conversation_type` debe configurarse en `"Group"` (distingue entre mayúsculas y minúsculas).

### Agregar a una conversación existente

Envía un mensaje a cualquier conversación en la que participes: ```bash cURL theme={null} 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": "Another message"}' ``` ```python Python SDK theme={null} from xdk import Client client = Client(bearer_token="YOUR_USER_ACCESS_TOKEN") # Agregar un mensaje a una conversación existente response = client.dm_conversations.add_message( dm_conversation_id="1582103724607971328", text="Another message" ) print(response.data) ``` ```javascript JavaScript SDK theme={null} 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.dmConversations.addMessage({ dmConversationId: "1582103724607971328", text: "Another message", }); console.log(response.data); ``` ***

## Archivos multimedia adjuntos

Adjunta un archivo multimedia (foto, video o GIF) por mensaje. Usa el [endpoint Media Upload](/es/x-api/media/quickstart/media-upload-chunked) para subir tu archivo y obtener un `media_id`. ```json theme={null} { "text": "¡Mira esta imagen!", "attachments": [{"media_id": "1583157113245011970"}] } ``` * El usuario autenticado debe haber subido el archivo multimedia * El archivo multimedia estará disponible durante 24 horas después de haberse subido * Solo se admite un archivo adjunto por mensaje *** Incluye una Publicación en tu mensaje añadiendo la URL de la Publicación al texto: ```json theme={null} { "text": "Have you seen this? https://x.com/XDevelopers/status/1580559079470145536" } ``` La respuesta incluirá un campo `referenced_tweets` con el ID de la Publicación. ***

## Requisitos de los mensajes

## Compatibilidad de id con v1.1

Los id de conversación y de eventos se comparten entre los endpoints de v1.1 y v2. Esto permite flujos de trabajo híbridos: * Crear mensajes con v2 * Eliminar mensajes con v1.1 (aún no disponible en v2) * Hacer referencia a id de conversación desde URL de x.com ***

## Manejo de errores

### Problemas comunes

Es posible que el destinatario tenga una configuración de MD que impida recibir mensajes de usuarios desconocidos o que te haya bloqueado. Asegúrate de que el contenido multimedia fue cargado por el mismo usuario autenticado y tenga menos de 24 horas de antigüedad. Verifica que todos los id de participantes sean válidos y que los usuarios permitan recibir invitaciones a MD grupales. ***

## Próximos pasos

Envía tu primer mensaje directo (DM) Recupera conversaciones de DM Sube archivos multimedia para adjuntarlos Documentación completa del endpoint