> ## 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 migración

export const Button = ({href, children}) => {
  return <div className="not-prose group">
    <a href={href}>
      <button className="flex items-center space-x-2.5 py-1 px-4 bg-primary-dark dark:bg-white text-white dark:text-gray-950 rounded-full group-hover:opacity-[0.9] font-medium">
        <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>;
};

<div id="comparing-v11-and-v2-manage-direct-message-endpoints">
  ## Comparación de los endpoints Administrar mensajes directos de v1.1 y v2
</div>

Las versiones v1.1 y v2 de los endpoints de mensajes directos proporcionan métodos para crear mensajes directos. Esta guía está pensada para ayudar a comprender 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 compatibilidad con conversaciones grupales. Una consecuencia de esto es que v1.1 solo admite eventos de "mensaje creado", mientras que v2 también admite eventos asociados con la incorporación y la salida de participantes de las conversaciones. De hecho, una actualización fundamental de v2 es establecer dm\_conversations como un objeto central de la API.   

Con v1.1 hay dos endpoints para administrar mensajes directos:

* POST direct\_messages/events/new - Crea un mensaje directo uno a uno. Este endpoint de 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 de 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 agrega el mensaje a una conversación uno a uno existente o crea una nueva. El parámetro de ruta :participant\_id es el id de usuario de la cuenta que recibe el mensaje. 

* **POST /2/dm\_conversations** - Crea una nueva conversación grupal y agrega 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 agrega a una conversación existente. El parámetro de ruta :dm\_conversation\_id es el id de la conversación a la que se agregará el mensaje. 

Un detalle importante es que los ID de conversación y de evento se comparten entre las versiones v1.1 y v2 de la Plataforma de X. Esto significa que se pueden usar ambas versiones a la vez. Por ejemplo, los endpoints de mensajes directos de v1.1 proporcionan métodos para devolver un único evento y para eliminar eventos, métodos que aún no están disponibles con v2. Dado que los ID son comunes entre v1.1 y v2, puedes realizar solicitudes de v1.1 basadas en ID proporcionados por v2, o haciendo referencia a los ID de conversación que se muestran en las URL de conversación en la aplicación de X.

La siguiente tabla compara aspectos fundamentales de los endpoints de administración de mensajes directos de v1.1 y v2. Las características de X API v2 que se comparten aquí son comunes a todos los endpoints de consulta de mensajes directos.

|                                                                                                                                                                                           |                                                                                         |                                                                                                                                                                                                                                                                                   |
| :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :-------------------------------------------------------------------------------------- | :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Descripción**                                                                                                                                                                           | **v1.1 estándar**                                                                       | **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](/es/resources/fundamentals/authentication)                                                                                                                                | Contexto de usuario de OAuth 1.0a                                                       | Contexto de usuario de OAuth 1.0a<br /><br />Contexto de usuario de OAuth 2 (scopes: dm.read, dm.write)                                                                                                                                                                           |
| Requiere el uso de credenciales de una [App de desarrollador](/es/resources/fundamentals/authentication) asociada con un [Project](/es/resources/fundamentals/developer-apps) de X API v2 |                                                                                         | ✔                                                                                                                                                                                                                                                                                 |
| [Límites de tasa](/es/x-api/fundamentals/rate-limits) de solicitud predeterminados\*  <br />\*Todas las solicitudes requieren tokens de usuario                                           | 1000 solicitudes por usuario por 24 horas  <br />15000 solicitudes por app por 24 horas | 200 solicitudes por 15 minutos por usuario<br /><br />1000 solicitudes por usuario por 24 horas<br /><br />15000 solicitudes por app por 24 horas<br /><br />Estos límites de tasa 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 funcionalidades 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**                                                                                     | **Estándar v1.1**                                                                                | **X API v2**                                                                                                                                                                                                                                                   |
| Ruta del endpoint                                                                                   | POST direct\_messages/events/new (message\_create)                                               | POST /2/dm\_conversations/with/:participant\_id/messages                                                                                                                                                                                                       |
| Límites de tasa de solicitudes predeterminados de [rate limits](/es/x-api/fundamentals/rate-limits) | 1000 solicitudes por usuario cada 24 horas  <br />15000 solicitudes por aplicación cada 24 horas | 200 solicitudes por usuario cada 15 minutos<br /><br />1000 solicitudes por usuario cada 24 horas<br /><br />15000 solicitudes por aplicación cada 24 horas<br /><br />Estos límites de tasa se comparten entre todos los endpoints POST de dm\_conversations. |
| Admite Mensajes Directos en grupo                                                                   |                                                                                                  | ✔                                                                                                                                                                                                                                                              |

**Crear una nueva conversación grupal de Mensajes Directos y agregar un mensaje**

Ruta: POST /2/dm\_conversations

|                                                                                                     |                   |                                                                                                                                                                                                                                                                |
| :-------------------------------------------------------------------------------------------------- | :---------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Descripción**                                                                                     | **Estándar v1.1** | **X API v2**                                                                                                                                                                                                                                                   |
| Ruta del endpoint                                                                                   | No admitido       | POST /2/dm\_conversations                                                                                                                                                                                                                                      |
| Límites de tasa de solicitudes predeterminados de [rate limits](/es/x-api/fundamentals/rate-limits) |                   | 200 solicitudes por usuario cada 15 minutos<br /><br />1000 solicitudes por usuario cada 24 horas<br /><br />15000 solicitudes por aplicación cada 24 horas<br /><br />Estos límites de tasa se comparten entre todos los endpoints POST de dm\_conversations. |
| Admite Mensajes Directos en grupo                                                                   |                   | ✔                                                                                                                                                                                                                                                              |

**Agregar un Mensaje Directo a una conversación existente mediante su ID**

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

|                                                                                                     |                   |                                                                                                                                                                                                                                                                |
| :-------------------------------------------------------------------------------------------------- | :---------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Descripción**                                                                                     | **Estándar v1.1** | **X API v2**                                                                                                                                                                                                                                                   |
| Ruta del endpoint                                                                                   | No admitido       | POST /2/dm\_conversations/:dm\_conversation\_id/messages                                                                                                                                                                                                       |
| Límites de tasa de solicitudes predeterminados de [rate limits](/es/x-api/fundamentals/rate-limits) |                   | 200 solicitudes por usuario cada 15 minutos<br /><br />1000 solicitudes por usuario cada 24 horas<br /><br />15000 solicitudes por aplicación cada 24 horas<br /><br />Estos límites de tasa se comparten entre todos los endpoints POST de dm\_conversations. |
| Admite Mensajes Directos en grupo                                                                   |                   | ✔                                                                                                                                                                                                                                                              |