Transmitir atributos de contato quando um chat for inicializado

Você pode usar atributos de contato para capturar informações sobre o contato que está usando o widget de comunicação. Em seguida, você pode exibir essas informações para o atendente por meio do Painel de Controle de Contato (CCP) ou usá-las em outro lugar no fluxo.

Por exemplo, você pode personalizar seu fluxo para dizer o nome do cliente em sua mensagem de boas-vindas. Ou você pode usar atributos específicos da sua empresa, como IDs de conta/membro, identificadores de clientes, como nomes e e-mails, ou outros metadados associados a um contato.

Como transmitir atributos de contato para o widget de comunicação

1. Ative a segurança no widget de comunicação conforme descrito em Adicionar uma interface de usuário de chat ao seu site, caso ainda não tenha feito isso:

   1. Na Etapa 2, em Adicionar segurança ao widget de chat, escolha Sim.

   2. Na Etapa 3, use a chave de segurança para gerar tokens Web JSON.

2. Adicione os atributos de contato à carga útil do JWT como uma reivindicação attributes.

   Veja a seguir um exemplo de como você pode gerar um JWT com atributos de contato em Python:

   import jwt
   
   CONNECT_SECRET = "your-securely-stored-jwt-secret"
   
   payload = {
     'sub': 'widget-id',
     'iat': datetime.datetime.utcnow(),
     'exp': datetime.datetime.utcnow() + datetime.timedelta(seconds=500),
     'attributes': {"name": "Jane", "memberID": "123456789", "email": "[e-mail]", "isPremiumUser": "true", "age": "45"}
   }
   
   header = {
     'typ': "JWT",
     'alg': 'HS256'
   }
   
   encoded_token = jwt.encode((payload), CONNECT_SECRET, algorithm="HS256", headers=header)
   

   Na carga, você deve criar uma chave de string attributes (no estado em que se encontra, toda em minúsculas), com um objeto como valor. Esse objeto deve ter pares de string-to-string valores-chave. Se algo diferente de uma string for passado em qualquer um dos atributos, o chat não será iniciado.

   Os atributos de contato devem seguir as limitações definidas pela StartChatConnectAPI:

   • As chaves devem ter um comprimento mínimo de 1

   • Os valores podem ter um comprimento mínimo de 0

Coisas que você precisa saber

• O widget de comunicação tem um limite de 6144 bytes para todo o token codificado. Como JavaScript usa a codificação UTF-16, são usados 2 bytes por caractere, portanto, o tamanho máximo do encoded_token deve ser em torno de 3.000 caracteres.

• O encoded_token deve ser passado para callback(data). O snippet authenticate não precisa de nenhuma alteração adicional. Por exemplo: .

  amazon_connect('authenticate', function(callback) {
    window.fetch('/token').then(res => {
      res.json().then(data => {
        callback(data.data);
      });
    });
  });

• Usar um JWT para transmitir atributos de contato garante a integridade dos dados. Se você proteger o segredo compartilhado e seguir as práticas de segurança apropriadas, poderá ajudar a garantir que os dados não sejam manipulados por um atendente mal-intencionado.

• Os atributos de contato são codificados somente no JWT, não criptografados, então é possível decodificar e ler os atributos.

• Se você quiser testar a experiência de chat com a experiência de chat simulada e incluir atributos de contato, coloque a chave e o valor entre aspas, conforme mostrado na imagem a seguir.