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á.
Habilitar a transmissão em tempo real de mensagens de chat no Amazon Connect
O Amazon Connect Chat fornece APIsserviços que permitem que você assine um stream de mensagens de bate-papo em tempo real. Com eles APIs, você pode:
-
Transmitir mensagens de chat em tempo real quando um novo contato de chat for criado.
-
Estender a funcionalidade atual do Amazon Connect Chat para oferecer suporte a casos de uso, como criar integrações com soluções de SMS e aplicações de mensagens de terceiros, habilitar notificações por push móveis e criar painéis de análise para monitorar e rastrear a atividade de mensagens de chat.
Como funciona o streaming de APIs mensagens
O streaming de mensagens do Amazon Connect APIs é acionado quando certos eventos ocorrem em um contato do Amazon Connect Chat. Por exemplo, quando um cliente envia uma nova mensagem de chat, o evento envia uma carga útil para um endpoint específico contendo dados sobre a mensagem que acabou de ser enviada. As mensagens são publicadas usando o Amazon Simple Notification Service (Amazon SNS) para um endpoint específico.
Este tópico descreve como configurar a transmissão de mensagens em tempo real usando o Amazon Connect e o Amazon SNS. As etapas são:
-
Use o console do Amazon SNS para criar um novo tópico padrão do SNS e configurar as mensagens.
-
Chame a StartChatContactAPI para iniciar o contato no chat.
-
Chame a StartContactStreamingAPI para iniciar o streaming de mensagens.
-
Chame a CreateParticipantConnectionAPI para criar a conexão do participante.
Etapa 1: Criar um tópico padrão do SNS
-
Acesse o console do Amazon SNS.
-
Crie um tópico do SNS na sua AWS conta. Na seção Detalhes, em Tipo, escolha Padrão, insira um nome para o tópico e escolha Criar tópico.
nota
Atualmente, o streaming de mensagens suporta APIs apenas o SNS padrão para streaming de mensagens em tempo real. Elas não são compatíveis com tópicos FIFO (primeiro a entrar, primeiro a sair) do Amazon SNS.
-
Depois de criar o tópico, o nome do recurso da Amazon (ARN) é exibido na seção Detalhes. Copie o ARN do tópico para a área de transferência. Você usará o ARN do tópico na próxima etapa e em Etapa 3: Habilitar a transmissão de mensagens no contato.
O ARN do tópico é semelhante ao seguinte exemplo:
arn:aws:sns:
us-east-1
:123456789012
:MyTopic
-
Escolha a guia Política de acesso, escolha Editar e, em seguida, adicione uma política baseada em recursos no tópico do SNS para que o Amazon Connect tenha permissão para publicar nele. Veja a seguir um exemplo de política do SNS que você pode copiar e colar no editor JSON e, em seguida, personalizar com seus valores:
{ "Version":"2012-10-17", "Statement":[ { "Effect":"Allow", "Principal":{ "Service":"connect.amazonaws.com" }, "Action":"sns:Publish", "Resource":"
YOUR_SNS_TOPIC_ARN
", "Condition":{ "StringEquals":{ "aws:SourceAccount":"YOUR_AWS_ACCOUNT_ID
" }, "ArnEquals":{ "aws:SourceArn":"YOUR_CONNECT_INSTANCE_ARN
" } } } ] }nota
A Política de acesso padrão vem com condições aplicadas ao
sourceOwner
como:"Condition": { "StringEquals": { "AWS:SourceOwner": "921772911154" } }
Remova e substitua por
SourceAccount
, por exemplo:"Condition":{ "StringEquals":{ "aws:SourceAccount":"YOUR_AWS_ACCOUNT_ID" }, "ArnEquals":{ "aws:SourceArn":"YOUR_CONNECT_INSTANCE_ARN" } }
Isso evita um problema de substituto confuso entre serviços.
-
Se você estiver usando criptografia do lado do servidor no SNS, verifique se você tem a permissão
connect.amazonaws.com
habilitada na KMS key. Veja a seguir um exemplo de política:{ "Version": "2012-10-17", "Id": "key-consolepolicy-3", "Statement": [ { "Sid": "Enable IAM User Permissions", "Effect": "Allow", "Principal": { "AWS": "arn:aws:iam::
your_accountId
:root", "Service": "connect.amazonaws.com" }, "Action": "kms:*", "Resource": "*" }, { "Sid": "Allow access for Key Administrators", "Effect": "Allow", "Principal": { "AWS": "arn:aws:iam::your_accountId
:root", "Service": "connect.amazonaws.com" }, "Action": [ "kms:Create*", "kms:Describe*", "kms:Enable*", "kms:List*", "kms:Put*", "kms:Update*", "kms:Revoke*", "kms:Disable*", "kms:Get*", "kms:Delete*", "kms:TagResource", "kms:UntagResource", "kms:ScheduleKeyDeletion", "kms:CancelKeyDeletion" ], "Resource": "*" } ] }
Etapa 2: Iniciar o contato do chat
-
Ligue para a StartChatContactAPI Amazon Connect para iniciar o contato por chat.
Para obter informações sobre como criar o cliente SDK para chamar o Amazon Connect APIs, consulte os seguintes tópicos:
-
Acompanhe a StartChatContactresposta
ContactId
e aParticipantToken
partir dela, pois esses atributos de resposta são usados para chamar outro bate-papo APIs necessário para habilitar o streaming. Isso é descrito nas próximas etapas.
Etapa 3: Habilitar a transmissão de mensagens no contato
-
Ligue StartContactStreamingpara ativar o streaming de mensagens em tempo real para seu tópico do SNS.
-
Limites: você pode assinar até dois tópicos do SNS por contato.
-
Ao ligar StartContactStreaming, você precisará fornecer o Amazon Resource Name (ARN) do tópico do SNS (consulte). Etapa 1: Criar um tópico padrão do SNS
Um único ARN de tópico do SNS pode ser usado em Contas da AWS vários, mas deve estar na mesma região da sua instância do Amazon Connect. Por exemplo, se o ARN do seu tópico estiver em us-east-1, sua instância do Amazon Connect deverá estar em us-east-1.
-
Para mensagens de bate-papo iniciais que não são recebidas no endpoint de streaming, você pode chamar a GetTranscriptAPI para receber as mensagens iniciais.
-
Etapa 4: Criar a conexão do participante
-
Chamada CreateParticipantConnectioncom o
ConnectParticipant
atributo passado como verdadeiro.-
Você deve ligar CreateParticipantConnectiondentro de cinco minutos após criar o bate-papo.
-
Ligar CreateParticipantConnectioncom
ConnectParticipant
set como true só funciona se você habilitou o streaming Etapa 2: Iniciar o contato do chat e o participante da chamada estáCustomer
. -
Essa etapa (criar a conexão do participante) é opcional se você já se conectou com sucesso ao contato do chat usando
WEBSOCKET
.
-
Próximas etapas
Você está pronto para trabalhar com o streaming de mensagens APIs.
-
Para verificar se está funcionando, verifique se as mensagens foram publicadas no tópico do SNS que você criou. Você pode fazer isso usando as CloudWatch métricas da Amazon. Para obter instruções, consulte Tópicos de monitoramento do Amazon SNS usando. CloudWatch
-
Como o SNS tem retenção limitada
, recomendamos que você configure o Amazon Simple Queue Service (Amazon SQS) , o Amazon Kinesis ou outro serviço para reter mensagens. -
StopContactStreamingO uso é opcional e não obrigatório se os bate-papos estiverem sendo desconectados por meio de um fluxo de contato ou se o cliente desconectar o bate-papo. No entanto,
StopContactStreaming
oferece a opção de interromper a transmissão de mensagens no tópico do SNS, mesmo se o chat estiver ativo e contínuo.