

Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

# Migración al espacio de nombres de mensajería de Amazon Chime SDK
<a name="messaging-namespace-migration"></a>

El espacio de nombres de [mensajería del SDK de Amazon Chime](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_Operations_Amazon_Chime_SDK_Messaging.html) es un lugar dedicado a quienes crean y administran los recursos APIs de mensajería del SDK de Amazon Chime. El espacio de nombres se utiliza para dirigirse a los puntos de conexión de la API de mensajería de Amazon Chime SDK en cualquier región de AWS en la que estén disponibles. Utilice este espacio de nombres si acaba de empezar a utilizar Amazon Chime SDK. Para obtener más información sobre las regiones, consulte [Regiones de AWS disponibles para Amazon Chime SDK](sdk-available-regions.md) en esta guía.

Las aplicaciones existentes que utilizan el espacio de nombres de [Amazon Chime](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_Operations_Amazon_Chime.html) deberían planificar la migración al espacio de nombres dedicado.

**Topics**
+ [Razones para migrar](#migration-reasons)
+ [Antes de realizar la migración](#before-migrating)
+ [Diferencias entre los espacios de nombres](#namespace-differences)

## Razones para migrar
<a name="migration-reasons"></a>

Le recomendamos que migre al espacio de nombres de [mensajería de Amazon Chime SDK](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_Operations_Amazon_Chime_SDK_Messaging.html) por los siguientes motivos:

**Elección de un punto de conexión de API**  
El espacio de nombres de mensajería de Amazon Chime SDK es el único espacio de nombres de API que puede usar puntos de conexión de API en cualquier [región en la que estén disponibles](https://docs.aws.amazon.com/chime-sdk/latest/dg/sdk-available-regions.html). Si desea utilizar puntos de conexión de API distintos de Este de EE. UU. (Norte de Virginia), debe utilizar el espacio de nombres de mensajería de Amazon Chime SDK.  
Para obtener más información sobre cómo la mensajería del SDK de Amazon Chime utiliza AWS las regiones, consulte las [regiones disponibles](https://docs.aws.amazon.com/chime-sdk/latest/dg/available-regions.html) en esta guía.

**Mensajes nuevos y actualizados APIs**  
Solo añadimos o actualizamos los mensajes APIs en el espacio de nombres de mensajería del SDK de Amazon Chime.

## Antes de realizar la migración
<a name="before-migrating"></a>

Antes de realizar la migración, tenga en cuenta las diferencias entre los espacios de nombres. En la siguiente tabla, se muestran y describen.


|  | Espacio de nombres de mensajería de Amazon Chime SDK | Espacio de nombres de Amazon Chime | 
| --- | --- | --- | 
| AWS Espacio de nombres del SDK | ChimeSDKMessaging | Chime | 
| Regiones | Múltiple | Únicamente Este de EE. UU. (Norte de Virginia) | 
| APIs | Solo APIs para mensajería | APIs para mensajería y otras partes de Amazon Chime | 
| Flujos | Disponible | No disponible | 
| Canales elásticos | Disponible | No disponible | 

## Diferencias entre los espacios de nombres
<a name="namespace-differences"></a>

En las siguientes secciones se explican las diferencias entre los espacios de nombres `Amazon Chime` y `Amazon Chime SDK Messaging`.

**AWS espacio de nombres del SDK**  
El espacio de nombres de Amazon Chime SDK usa el nombre formal `Chime`. El espacio de nombres de mensajería de Amazon Chime SDK usa el nombre formal `ChimeSDKMessaging`. El formato preciso del nombre varía según la plataforma.

Por ejemplo, si utilizas el AWS SDK de Node.js para crear mensajes, utilizas una línea de código para direccionar el espacio de nombres.

```
const chimeMessaging = AWS.Chime();
```

Para migrar al espacio de nombres del SDK de mensajería de Amazon Chime, actualice esta línea de código con el nuevo espacio de nombres y la región del punto de conexión.

```
const chimeMessaging = AWS.ChimeSDKMessaging({ region: "Europe (Frankfurt)" });
```

**Regions**  
El espacio de nombres de [Amazon Chime](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_Operations_Amazon_Chime.html) solo puede abordar puntos de conexión de la API de la región de `US East (N. Virginia)`. El espacio de nombres de [mensajería de Amazon Chime SDK](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_Operations_Amazon_Chime_SDK_Messaging.html) puede dirigirse a los puntos de conexión de la API de identidad de Amazon Chime SDK en cualquier región en la que estén disponibles. Para obtener una lista actualizada de las regiones de mensajería, consulte [Regiones de AWS disponibles para Amazon Chime SDK](sdk-available-regions.md) en esta guía.

**Puntos de conexión**  
El espacio de nombres de [mensajería de Amazon Chime SDK](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_Operations_Amazon_Chime_SDK_Messaging.html) utiliza puntos de conexión de API diferentes a los del espacio de nombres de [Amazon Chime.](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_Operations_Amazon_Chime.html)

Solo el punto de conexión utilizado para crear un recurso de mensajería se puede utilizar para modificarlo. Esto significa que un recurso de mensajería creado a través de un punto de conexión en `Europe (Frankfurt)` solo se puede modificar mediante `Europe (Frankfurt)`. Esto significa que un canal creado a través de un punto de conexión en Europa (Fráncfort) solo puede modificarse mediante Europa (Fráncfort). También significa que no puede dirigirse a un canal creado a través del `Chime` con el espacio de nombres `ChimeSDKMessaging` incluido en Este de EE. UU. (Norte de Virginia). Para obtener más información sobre los puntos de conexión actuales, consulte [Mapeo de API](migrate-from-chm-namespace.md#name-end-map) en esta guía.

**Entidad principal de servicio**  
El espacio de nombres de [mensajería de Amazon Chime SDK](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_Operations_Amazon_Chime_SDK_Messaging.html) utiliza una nueva entidad principal de servicio: `messaging.chime.amazonaws.com`. Si tiene políticas de acceso de SQS, SNS u otras políticas de IAM que otorgan acceso al servicio, debe actualizar esas políticas para conceder acceso a la nueva entidad principal del servicio.

**APIs**  
El espacio de nombres de [mensajería del SDK de Amazon Chime](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_Operations_Amazon_Chime_SDK_Messaging.html) solo contiene información APIs para crear y administrar recursos de mensajería y para enviar y recibir mensajes. El espacio de nombres [Amazon Chime](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_Operations_Amazon_Chime.html) incluye otras partes del APIs servicio Amazon Chime, así como la mensajería.

**Flujos de canales**  
Los flujos de canales permiten a los desarrolladores ejecutar lógica empresarial en los mensajes en movimiento antes de que se entreguen a los miembros de un canal de mensajería. Por ejemplo, puede crear flujos que eliminen de los mensajes datos confidenciales, como números de identificación oficiales, números de teléfono o blasfemias, antes de entregarlos. Esto puede ayudar a implementar las políticas de comunicación corporativas u otras pautas de comunicación.

También puede usar los flujos de canales para realizar funciones como agregar las respuestas a una encuesta antes de enviar los resultados a los participantes, o enviar mensajes SMS. 

Los flujos de canales solo están disponibles en el espacio de nombres `ChimeSDKMessaging`. Para más información, consulte [Uso de los flujos de canales para procesar los mensajes de la mensajería de Amazon Chime SDK](using-channel-flows.md) en esta guía.

**Canales elásticos**  
Los canales elásticos admiten experiencias de chat a gran escala, con hasta un millón de usuarios de chat repartidos automáticamente en un número definido de subcanales. Los canales elásticos solo están disponibles en el punto de conexión `ChimeSDKMessaging`. Para más información sobre los canales elásticos, consulte [Uso de canales elásticos para organizar eventos en directo en las reuniones de Amazon Chime SDK](elastic-channels.md) en esta guía.

**Adicional APIs**  
El espacio de nombres de Messaging tiene una lista cada vez mayor de los APIs que no tiene el espacio de `Chime` nombres. Si está empezando a utilizar Amazon Chime SDK, utilice el espacio de nombres de mensajería para tener acceso a todas las características más recientes. Para obtener más información sobre la versión actual APIs, consulte la [mensajería del SDK de Amazon Chime en la referencia de la API del SDK](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_Operations_Amazon_Chime_SDK_Messaging.html) de *Amazon Chime*.