As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.
# Migrar para o namespace do sistema de mensagens do SDK do Amazon Chime
O namespace [Amazon Chime SDK Messaging](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_Operations_Amazon_Chime_SDK_Messaging.html) é um local dedicado para quem cria e gerencia recursos de mensagens do APIs Amazon Chime SDK. Use o namespace para abordar os endpoints da API do sistema de mensagens do SDK do Amazon Chime em qualquer região da AWS na qual eles estejam disponíveis. Use esse namespace se você acabou de começar a usar o SDK do Amazon Chime. Para obter mais informações sobre as regiões, consulte [Regiões da AWS disponíveis para o SDK do Amazon Chime](sdk-available-regions.md) neste guia.
Os aplicativos existentes que usam o namespace [Amazon Chime](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_Operations_Amazon_Chime.html) devem planejar a migração para o namespace dedicado.
**Topics**
+ [Motivos para migrar](#migration-reasons)
+ [Antes de migrar](#before-migrating)
+ [Diferenças entre os namespaces](#namespace-differences)
## Motivos para migrar
Recomendamos que você migre para o namespace de [Mensagens do SDK do Amazon Chime](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_Operations_Amazon_Chime_SDK_Messaging.html) pelos seguintes motivos:
**Escolha do endpoint de API**
O namespace do sistema de mensagens do SDK do Amazon Chime é o único namespace de API que pode usar endpoints de API em qualquer [região que os disponibilize](https://docs.aws.amazon.com/chime-sdk/latest/dg/sdk-available-regions.html). Se quiser usar outros endpoints de API diferentes da região do Leste dos EUA (N. da Virgínia), deverá usar o namespace de mensagens do SDK do Amazon Chime.
Para obter mais informações sobre como o sistema de mensagens do Amazon Chime SDK usa AWS regiões, consulte [Regiões disponíveis neste guia](https://docs.aws.amazon.com/chime-sdk/latest/dg/available-regions.html).
**Mensagens atualizadas e novas APIs**
Só adicionamos ou atualizamos mensagens APIs no namespace Amazon Chime SDK Messaging.
## Antes de migrar
Antes de migrar, observe as diferenças entre os namespaces. A tabela a seguir lista e descreve-os.
| | Namespace de Mensagens do SDK do Amazon Chime | Namespace Amazon Chime |
| --- | --- | --- |
| AWS Namespace do SDK | ChimeSDKMessaging | Chime |
| Regiões | Vários | Somente leste dos EUA (Norte da Virgínia) |
| APIs | Somente APIs para mensagens | APIs para mensagens e outras partes do Amazon Chime |
| Fluxos | Available (Disponível) | Indisponível |
| Canais elásticos | Available (Disponível) | Indisponível |
## Diferenças entre os namespaces
As seções a seguir explicam as diferenças entre os namespaces `Amazon Chime` e `Amazon Chime SDK Messaging`.
**AWS Namespace do SDK**
O namespace SDK do Amazon Chime usa o nome formal `Chime`. O namespace de Mensagens do SDK do Amazon Chime usa o nome formal `ChimeSDKMessaging`. O formato preciso do nome varia de acordo com a plataforma.
Por exemplo, se você usa o AWS SDK no Node.js para criar mensagens, você usa uma linha de código para endereçar o namespace.
```
const chimeMessaging = AWS.Chime();
```
Para migrar para o SDK de Mensagens do Amazon Chime, atualize essa linha de código com o novo namespace e a região do endpoint.
```
const chimeMessaging = AWS.ChimeSDKMessaging({ region: "Europe (Frankfurt)" });
```
**Regiões**
O namespace [Amazon Chime](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_Operations_Amazon_Chime.html) só pode referenciar endpoints de API na região `US East (N. Virginia)`. O namespace de [Mensagens do SDK do Amazon Chime](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_Operations_Amazon_Chime_SDK_Messaging.html) pode referenciar endpoints de API de Mensagens do SDK do Amazon Chime em qualquer região em que esteja disponível. Para obter uma lista atual das regiões de mensagens, consulte [Regiões da AWS disponíveis para o SDK do Amazon Chime](sdk-available-regions.md) neste guia.
**Endpoints**
O namespace de [Mensagens do SDK do Amazon Chime](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_Operations_Amazon_Chime_SDK_Messaging.html) usa endpoints de API diferentes do namespace do [Amazon Chime](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_Operations_Amazon_Chime.html).
Somente o endpoint usado para criar um recurso de mensagens pode ser usado para modificá-lo. Isso significa que um recurso de mensagens criado por meio de um endpoint na `Europe (Frankfurt)` só pode ser modificado via `Europe (Frankfurt)`. Isso significa que um canal criado por meio de um endpoint na Europa (Frankfurt) só pode ser modificado via Europa (Frankfurt). Isso também significa que você não pode abordar um canal criado por meio do namespace `Chime` com o namespace `ChimeSDKMessaging` na região do Leste dos EUA (N. da Virgínia). Para obter mais informações sobre os endpoints atuais, consulte [Mapeamento de API](migrate-from-chm-namespace.md#name-end-map) neste guia.
**Entidade principal do serviço**
O namespace de [Mensagens do SDK do Amazon Chime](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_Operations_Amazon_Chime_SDK_Messaging.html) usa uma nova entidade principal de serviço: `messaging.chime.amazonaws.com`. Se você tiver SQS, SNS ou outras políticas de acesso do IAM que concedem acesso ao serviço, precisará atualizá-las para conceder acesso à nova entidade principal de serviço.
**APIs**
O namespace [Amazon Chime SDK Messaging](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_Operations_Amazon_Chime_SDK_Messaging.html) contém apenas APIs para criar e gerenciar recursos de mensagens e para enviar e receber mensagens. O namespace [Amazon Chime](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_Operations_Amazon_Chime.html) inclui APIs outras partes do serviço Amazon Chime, bem como mensagens.
**Fluxos de canais**
Os fluxos de canais permitem que os desenvolvedores executem a lógica de negócios nas mensagens em andamento antes que elas sejam entregues aos membros de um canal de mensagens. Por exemplo, você pode criar fluxos que removem dados confidenciais, como números de identificação do governo, números de telefone ou palavrões, das mensagens antes que elas sejam entregues. Isso pode ajudar a implementar políticas de comunicação corporativa ou outras diretrizes de comunicação.
Você também pode usar fluxos de canais para realizar funções como agregar respostas a uma enquete antes de enviar os resultados de volta aos participantes ou enviar mensagens via SMS.
Os fluxos de canais só estão disponíveis no namespace `ChimeSDKMessaging`. Para obter mais informações sobre eles, consulte [Usar fluxos de canal para processar mensagens do sistema de mensagens do SDK do Amazon Chime](using-channel-flows.md) neste guia.
**Canais elásticos**
Os canais elásticos oferecem suporte a experiências de chat em grande escala com até um milhão de usuários de chat balanceados automaticamente em um número definido de subcanais. Os canais elásticos só estão disponíveis no endpoint do `ChimeSDKMessaging`. Para obter mais informações sobre canais elásticos, consulte [Usar canais elásticos para hospedar eventos ao vivo em reuniões do SDK do Amazon Chime](elastic-channels.md) neste guia.
**Adicional APIs**
O namespace Messaging tem uma lista crescente do APIs que o `Chime` namespace não tem. Se você está começando a usar o SDK do Amazon Chime, use o namespace de mensagens para acessar todos os atributos mais recentes. Para obter mais informações sobre o atual APIs, consulte [Amazon Chime SDK Messaging na Amazon Chime SDK](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_Operations_Amazon_Chime_SDK_Messaging.html) API *Reference*.