Gerenciando informações de identidade do usuário no bate-papo da web

Seus encargos para watsonx Assistant são baseados no número de usuários ativos mensais (MAU) exclusivos.

Se você não passar um identificador para o usuário quando a sessão começar, o chat web criará um. Ele cria um cookie próprio com um ID anônimo gerado. O cookie permanece ativo por 45 dias. Se o mesmo usuário retornar ao seu site mais tarde no mês e conversar com seu assistente novamente, a integração de bate-papo da web o reconhecerá. E você será cobrado somente uma vez quando o mesmo usuário anônimo interagir com seu assistente diversas vezes em um único mês.

Se você quiser executar tarefas em que precise saber o usuário que enviou a entrada, deverá passar o ID do usuário para a integração do bate-papo na Web. Escolha um ID identificável não humano. Por exemplo, não use o endereço de e-mail de uma pessoa como ID de usuário.

Além disso, a capacidade de excluir quaisquer dados criados por alguém que solicite o esquecimento exige que um customer_id seja associado à entrada do usuário. Quando um user_id é definido, o produto pode reutilizá-lo para passar um parâmetro customer_id. (Para obter mais informações sobre como excluir dados do usuário, consulte Rotular e excluir dados.)

Como o valor user_id que você envia está incluído no valor customer_id que é incluído no cabeçalho X-Watson-Metadata em cada solicitação de mensagem, a sintaxe user_id deve atender aos requisitos para campos de cabeçalho, conforme definido na RFC 7230.

Para oferecer suporte a esses recursos baseados no usuário, adicione o método updateUserID() no snippet de código antes de colá-lo na sua página da Web.

Se você ativar a segurança, em vez disso, definirá o ID do usuário no JSON Web Token. Para obter mais informações, consulte Autenticando usuários no bate-papo da web..

No exemplo a seguir, o ID do usuário L12345 é incluído no script.

<script>
  window.watsonAssistantChatOptions = {
      integrationID: 'YOUR_INTEGRATION_ID',
      region: 'YOUR_REGION',
      serviceInstanceID: 'YOUR_SERVICE_INSTANCE',
      onLoad: function(instance) {
        instance.updateUserID('L12345');
        instance.render();
        }
    };
  setTimeout(function(){
    const t=document.createElement('script');
    t.src='https://web-chat.global.assistant.dev.watson.appdomain.cloud/versions/' +
      (window.watsonAssistantChatOptions.clientVersion || 'latest') +
      '/WatsonAssistantChatEntry.js';
    document.head.appendChild(t);
  });
</script>

Dispositivos Apple

Em dispositivos Apple, o recurso Intelligent Tracking Prevention exclui automaticamente qualquer cookie do lado do cliente após 7 dias. Isso significa que se um cliente anônimo acessar o website e depois visitá-lo novamente duas semanas depois, as duas visitas serão tratadas como dois MAUs diferentes.

Para evitar esse problema, use um cookie de primeira parte do lado do servidor em seu aplicativo da web. Por exemplo, quando um usuário anônimo visita o website pela primeira vez, é possível gerar um ID de usuário exclusivo e armazená-lo em um cookie do lado do servidor com qualquer data de expiração que você escolher. Em seguida, seu código pode usar o método de instância updateUserID() para configurar o ID do usuário. É possível usar o mesmo cookie para configurar o mesmo ID de usuário para esse cliente em quaisquer visitas futuras até ele expirar.

Mais informações

Para obter mais informações sobre o faturamento, consulte Planos baseados em usuários explicados.

Para obter mais informações sobre limites MAU por plano, consulte Precificação.

Para obter mais informações sobre a exclusão de dados de um usuário, consulte Rotulando e excluindo dados.