> ## Documentation Index
> Fetch the complete documentation index at: https://docs.x.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Guía de migración

> Tanto las versiones v1.1 como v2 de los endpoints de Mensajes Directos proporcionan métodos para crear Direct. Referencia para el nivel estándar de la X API v2 que cubre manage.

export const Button = ({href, children}) => {
  return <div className="not-prose">
    <a href={href}>
      <button className="x-btn">
        <span>{children}</span>
        <svg width="3" height="24" viewBox="0 -9 3 24" class="h-6 rotate-0 overflow-visible"><path d="M0 0L3 3L0 6" fill="none" stroke="currentColor" stroke-width="1.5" stroke-linecap="round"></path></svg>
      </button>
    </a>
  </div>;
};

## Comparación de los endpoints v1.1 y v2 para gestionar Mensajes Directos

Tanto las versiones v1.1 como v2 de los endpoints de Mensajes Directos proporcionan métodos para crear mensajes de Mensajes Directos. Esta guía está pensada para ayudarte a entender las diferencias y proporcionar información para migrar a v2.

Una diferencia importante entre las dos versiones es que v1.1 solo admite conversaciones uno a uno, mientras que v2 introduce soporte para conversaciones grupales. Un resultado de esto es que v1.1 solo admite eventos de "mensaje creado", mientras que v2 también admite eventos asociados con participantes que se unen o abandonan conversaciones. De hecho, una actualización fundamental de v2 es establecer dm\_conversations como un objeto principal de la API.

Con v1.1 hay dos endpoints para gestionar Mensajes Directos:

* POST direct\_messages/events/new - Crea un Mensaje Directo uno a uno. Este endpoint v1.1 solo puede crear mensajes uno a uno, y no admite mensajes grupales.

* DELETE direct\_messages/events/destroy - Elimina un mensaje uno a uno desde la vista del usuario autenticado.

Con esta versión v2, hay tres métodos POST para crear Mensajes Directos:

* **POST /2/dm\_conversations/with/:participant\_id/messages** - Crea un Mensaje Directo uno a uno. Este método añade el mensaje a una conversación uno a uno existente o crea una nueva. El parámetro de ruta :participant\_id es el User ID de la cuenta que recibe el mensaje.

* **POST /2/dm\_conversations** - Crea una nueva conversación grupal y añade un Mensaje Directo a ella. Estas solicitudes requieren una lista de participantes de la conversación. Ten en cuenta que puedes crear varias conversaciones con la misma lista de participantes. Estas solicitudes siempre devolverán un nuevo ID de conversación.

* **POST /2/dm\_conversations/:dm\_conversation\_id/messages** - Crea un Mensaje Directo y lo añade a una conversación existente. El parámetro de ruta :dm\_conversation\_id es el ID de la conversación a la que se añadirá el mensaje.

Un detalle importante es que los IDs de conversación y evento se comparten entre las versiones v1.1 y v2 de la X Platform. Esto significa que ambas versiones se pueden usar juntas. Por ejemplo, los endpoints v1.1 de Mensajes Directos proporcionan métodos para devolver un único evento y para eliminar eventos, métodos que aún no están disponibles con v2. Como los IDs son comunes entre v1.1 y v2, puedes realizar solicitudes v1.1 basadas en IDs proporcionados por v2, o haciendo referencia a los IDs de conversación mostrados en las URLs de conversación en la aplicación X.

La siguiente tabla compara aspectos fundamentales de los endpoints v1.1 y v2 para gestionar Mensajes Directos. Las características de la X API v2 aquí compartidas son comunes a todos los endpoints de búsqueda de Mensajes Directos.

|                                                                                                                                                                                      |                                                                                           |                                                                                                                                                                                                                                                                                   |
| :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :---------------------------------------------------------------------------------------- | :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Descripción**                                                                                                                                                                      | **Standard v1.1**                                                                         | **X API v2**                                                                                                                                                                                                                                                                      |
| Dominio del host                                                                                                                                                                     | [https://api.x.com](https://api.x.com)                                                    | [https://api.x.com](https://api.x.com)                                                                                                                                                                                                                                            |
| Ruta raíz del endpoint                                                                                                                                                               | [/1.1/direct\_messages](https://api.x.com/1.1/direct_messages)                            | [/2/dm\_conversations](https://api.x.com/2/users/:id/dm_conversations)<br /><br />Las conversaciones de Mensajes Directos se introducen como un objeto fundamental de la API.   <br /><br />Estos endpoints recuperan eventos MessageCreate, ParticipantsJoin y ParticipantLeave. |
| Métodos HTTP admitidos                                                                                                                                                               | POST                                                                                      | POST                                                                                                                                                                                                                                                                              |
| Admite Mensajes Directos grupales                                                                                                                                                    |                                                                                           | ✔                                                                                                                                                                                                                                                                                 |
| Tipos de eventos admitidos                                                                                                                                                           | message\_create                                                                           | MessageCreate, ParticipantsJoin, ParticipantsLeave                                                                                                                                                                                                                                |
| [Autenticación](/resources/fundamentals/authentication)                                                                                                                              | OAuth 1.0a User Context                                                                   | OAuth 1.0a User Context<br /><br />OAuth 2 User Context (scopes: dm.read, dm.write)                                                                                                                                                                                               |
| Requiere el uso de credenciales de una [App de desarrollador](/resources/fundamentals/authentication) asociada a un [Project](/resources/fundamentals/developer-apps) de la X API v2 |                                                                                           | ✔                                                                                                                                                                                                                                                                                 |
| [Rate limits](/x-api/fundamentals/rate-limits) de solicitud por defecto\*  <br />\*Todas las solicitudes requieren tokens de usuario                                                 | 1000 solicitudes por usuario cada 24 horas  <br />15000 solicitudes por app cada 24 horas | 200 solicitudes cada 15 minutos por usuario<br /><br />1000 solicitudes por usuario cada 24 horas<br /><br />15000 solicitudes por app cada 24 horas<br /><br />Estos rate limits se comparten entre todos los endpoints POST de dm\_conversations.                               |

Las siguientes tablas comparan los métodos POST de v2 con la versión v1.1. Ten en cuenta que estas ofertas de v2 amplían las capacidades disponibles al admitir conversaciones grupales.

**Crear un nuevo Mensaje Directo uno a uno**

Ruta: POST /2/dm\_conversations/with/:participant\_id/messages

|                                                                         |                                                                                           |                                                                                                                                                                                                                                                     |
| :---------------------------------------------------------------------- | :---------------------------------------------------------------------------------------- | :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Descripción**                                                         | **Standard v1.1**                                                                         | **X API v2**                                                                                                                                                                                                                                        |
| Ruta del endpoint                                                       | POST direct\_messages/events/new (message\_create)                                        | POST /2/dm\_conversations/with/:participant\_id/messages                                                                                                                                                                                            |
| [Rate limits](/x-api/fundamentals/rate-limits) de solicitud por defecto | 1000 solicitudes por usuario cada 24 horas  <br />15000 solicitudes por app cada 24 horas | 200 solicitudes cada 15 minutos por usuario<br /><br />1000 solicitudes por usuario cada 24 horas<br /><br />15000 solicitudes por app cada 24 horas<br /><br />Estos rate limits se comparten entre todos los endpoints POST de dm\_conversations. |
| Admite Mensajes Directos grupales                                       |                                                                                           | ✔                                                                                                                                                                                                                                                   |

**Crear una nueva conversación grupal de Mensajes Directos y añadir un mensaje a ella**

Ruta: POST /2/dm\_conversations

|                                                                         |                   |                                                                                                                                                                                                                                                     |
| :---------------------------------------------------------------------- | :---------------- | :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Descripción**                                                         | **Standard v1.1** | **X API v2**                                                                                                                                                                                                                                        |
| Ruta del endpoint                                                       | No admitido       | POST /2/dm\_conversations                                                                                                                                                                                                                           |
| [Rate limits](/x-api/fundamentals/rate-limits) de solicitud por defecto |                   | 200 solicitudes cada 15 minutos por usuario<br /><br />1000 solicitudes por usuario cada 24 horas<br /><br />15000 solicitudes por app cada 24 horas<br /><br />Estos rate limits se comparten entre todos los endpoints POST de dm\_conversations. |
| Admite Mensajes Directos grupales                                       |                   | ✔                                                                                                                                                                                                                                                   |

**Añadir un Mensaje Directo a una conversación existente por ID**

Ruta: POST /2/dm\_conversations/:dm\_conversation\_id/messages

|                                                                         |                   |                                                                                                                                                                                                                                                     |
| :---------------------------------------------------------------------- | :---------------- | :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Descripción**                                                         | **Standard v1.1** | **X API v2**                                                                                                                                                                                                                                        |
| Ruta del endpoint                                                       | No admitido       | POST /2/dm\_conversations/:dm\_conversation\_id/messages                                                                                                                                                                                            |
| [Rate limits](/x-api/fundamentals/rate-limits) de solicitud por defecto |                   | 200 solicitudes cada 15 minutos por usuario<br /><br />1000 solicitudes por usuario cada 24 horas<br /><br />15000 solicitudes por app cada 24 horas<br /><br />Estos rate limits se comparten entre todos los endpoints POST de dm\_conversations. |
| Admite Mensajes Directos grupales                                       |                   | ✔                                                                                                                                                                                                                                                   |