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á.
Como migrar para o namespace SDK Messaging do Amazon Chime
O namespace de Mensagens do SDK do Amazon Chime é um local dedicado às APIs que criam e gerenciam recursos de Mensagens do SDK do Amazon Chime. Você usa o namespace para endereçar os endpoints da API de mensagens do Amazon Chime SDK 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 disponíveis neste guia.
Os aplicativos existentes que usam o namespace Amazon Chime devem planejar a migração para o namespace dedicado.
Motivos para migrar
Recomendamos que você migre para o namespace de Mensagens do SDK do Amazon Chime pelos seguintes motivos:
- Escolha do endpoint de API
O namespace Amazon Chime SDK Messaging é o único namespace de API que pode usar endpoints de API em qualquer região que os disponibilize. Se você quiser usar endpoints de API que não sejam o Leste dos EUA (Norte da Virgínia), você deve usar o namespace Amazon Chime SDK Messaging.
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.
- APIs de mensagens novas e atualizadas
Só adicionamos ou atualizamos APIs de mensagens no namespace de Mensagens do SDK do Amazon Chime.
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 só pode referenciar endpoints de API na região US East (N. Virginia). O namespace de Mensagens do SDK do Amazon Chime 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 disponíveis neste guia.
Endpoints
O namespace de Mensagens do SDK do Amazon Chime usa endpoints de API diferentes do namespace do Amazon Chime.
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 endereçar um canal criado por meio do Chime namespace com o ChimeSDKMessaging namespace no Leste dos EUA (Norte da Virgínia). Para obter mais informações sobre os endpoints atuais, consulte Mapeamento de API neste guia.
Entidade principal do serviço
O namespace de Mensagens do SDK do Amazon Chime 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 de Mensagens do SDK do Amazon Chime contém somente APIs para criar e gerenciar recursos de mensagens e para enviar e receber mensagens. O namespace Amazon Chime inclui APIs para outras partes do serviço Amazon Chime, além de 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 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 neste guia.
APIs adicionais
O namespace de Mensagens tem uma lista crescente de APIs que o namespace do Chime 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 as APIs atuais, consulte Mensagens do SDK do Amazon Chime na Referência de API do SDK do Amazon Chime.
