Qual é o meu plano?
Complemento Agentes de IA - Avançado
Este artigo descreve a funcionalidade legada e deve ser usado apenas por clientes que já instalaram o Widget de Chat Ultimate e precisam de informações sobre sua manutenção. Os novos clientes devem implementar Agentes de IA para mensagens por meio do Web Widget .

Com apenas alguns minutos do seu tempo, o Widget de Chat Ultimate pode estar em funcionamento no seu site. Você poderá fornecer suporte ao cliente de alto nível rapidamente. O widget é altamente personalizável para combinar com a aparência exclusiva da sua marca. Ele foi projetado para ter o desempenho ideal: seu tamanho compacto não diminui os tempos de carregamento da página.

Neste artigo:

  • Incorporação do widget
  • Carregamento do widget
  • Captura de metadados
  • Histórico de conversas
  • Internacionalização e localização
  • Configuração de mensagens do UltimateGPT
  • Notificações
  • Métodos
  • Formulários
  • Localização
  • Privacidade de dados
  • PERGUNTAS FREQUENTES

Plataformas compatíveis:

  • Computador
  • Web móvel

Tipos de conteúdo compatíveis:

  • Mensagens de texto, incluindo formatação em HTML
  • Mensagens UltimateGPT
  • Botões
  • Cartões e carrosséis
  • Links
  • Suporte a imagens e GIF

Transferências

  • Transferência de e-mail
  • Criação de ticket (requer integração de API simples)

Incorporação do widget

Para adicionar o widget, incorpore o script em seu site ou por meio de um gerenciador de tags.

Certifique-se de trocar o botID pelo seu identificador de agente de IA exclusivo. Encontre seu botID na URL: https://dashboard.ultimate.ai/bot/{botID}/ ou https://dashboard.ultimate.ai/ultimategpt/{botID}.

Incorporação de roteiro – em arquivo HTML

O script deve ser inserido antes de fechar a tag do corpo: </body>

<script type="module"> import UltimateChat from 'https://widget.ultimate.ai/sdk/index.mjs'; const chat = UltimateChat.Initialize({ botId: 'YOUR_BOT_ID_HERE', theme: {

'actions-hover': '#4A48B0',

'actions': '#5D5ADC',

'header-text': '#ECECF9',

'chat-button': '#15142d',

'chat-border-radius': 12px,

'header': '#000'

}, navbar: { avatarUrl: 'https://www.ultimate.ai/hubfs/raw_assets/public/ultimate/favicon/apple-touch-icon-152x152.png', title: 'Ultimate.ai', subtitle: 'Our bot will reply instantly', longSubtitle: 'I\'m an AI agent and here to answer your questions.' }, recoverConversation: true, metadata: [ { key: 'name', value: 'John Doe' }, { key: 'email', value: 'john@ultimate.ai', sanitize: true } ] }); </script>

Script de incorporação – Gerenciador de tags (GTM ou serviços similares) 

<script> function _onUltimateChatLoad() { var chat = UltimateChat.Initialize({ botId: 'YOUR_BOT_ID', theme: {

'actions-hover': '#4A48B0',

'actions': '#5D5ADC',

'header-text': '#ECECF9',

'chat-button': '#15142d',

'chat-border-radius': 12px,

'header': '#000'

}, navbar: { avatarUrl: 'https://www.ultimate.ai/hubfs/raw_assets/public/ultimate/favicon/apple-touch-icon-152x152.png', title: 'Ultimate.ai', subtitle: 'Our bot will reply instantly', longSubtitle: "I'm an AI agent and here to answer your questions." }, recoverConversation: true, metadata: [ { key: 'name', value: 'John Doe' }, { key: 'email', value: 'john@ultimate.ai', sanitize: true } ] }); } </script> <script> (function () { var s = document.createElement('script'); s.type = 'text/javascript'; s.async = true; s.src = 'https://widget.ultimate.ai/sdk/index.iife.js'; s.onload = _onUltimateChatLoad; var x = document.getElementsByTagName('script')[0]; x.parentNode.insertBefore(s, x); })(); </script>

Personalizações de estilo

No script do widget, você tem várias opções de cores que podem ser adaptadas ao tema do widget.

theme: { 
'actions-hover': '#4A48B0', 
'actions': '#5D5ADC', 
'header-text': '#ECECF9', 
'chat-button': '#15142d', 
'chat-border-radius': 12px, 
'header': '#000' 
},

Especificações do ativo:

Avatar – 172x172 px

Carregamento do widget

Abrir ao carregar

Essa opção de configuração controla o comportamento do widget durante o carregamento. Quando definido como true, o widget será aberto automaticamente assim que estiver totalmente carregado. Por padrão, essa opção é definida como false o que significa que o widget de chat permanece fechado até ser aberto manualmente pelo usuário.

A abertura do widget só será possível programaticamente (consulte Métodos – abrir widget) ou pelo openOnLoad opção de configuração. Por padrão, essa opção é definida como false.

 

Botão Mostrar/ocultar widget

Essa opção de configuração controla a visibilidade do "botão de boas-vindas" do widget. Quando definido como true, o botão não será exibido no carregamento inicial e nem após o fechamento do widget.

 

Posição do Chat

Essa configuração permite que você controle onde gostaria de ver o widget de chat na tela. Você pode defini-la como Bottom-right ou Bottom-leftdependendo de onde for mais adequado para sua marca. Se indefinido, o padrão do widget será Bottom-right.

Captura de metadados

Os metadados são dados que fornecem contexto adicional para o agente de IA. Os Metadados podem ser usados para enriquecer um chat fornecendo informações adicionais sobre o cliente, seu comportamento e suas interações anteriores com a empresa.

Ao aproveitar os metadados, os agentes de IA podem fornecer uma experiência mais personalizada e eficiente para os clientes, o que pode aumentar a satisfação e a fidelidade deles. Além disso, os metadados podem ajudar as equipes de suporte a analisar e melhorar seus processos de suporte ao longo do tempo.

A qualquer momento, um site pode definir e atualizar os metadados disponíveis durante a conversa.

Isso é feito adicionando ao código do widget os valores que você gostaria de coletar.

Podemos aconselhá-lo sobre como adaptar o código do widget se você desejar utilizar essa funcionalidade.

Exemplos de casos de uso:

Informações do cliente: os metadados podem fornecer informações sobre o cliente, como nome, endereço de e-mail, número de telefone, localização e outros detalhes. Essas informações podem ajudar o agente de IA a personalizar a conversa e fornecer assistência mais relevante.

Histórico de compras: se o cliente já fez compras anteriores na empresa, os metadados podem fornecer informações sobre o histórico de compras dele, como os produtos que ele comprou, a data da compra e o preço pago. Essas informações podem ajudar o agente de IA a entender as necessidades do cliente e fornecer assistência direcionada.

Histórico de interações: os metadados também podem fornecer informações sobre as interações anteriores do cliente com a empresa, como chats, e-mails ou chamadas anteriores. Essas informações podem ajudar o agente de IA a entender o contexto da conversa atual e fornecer uma experiência mais otimizada para o cliente.

Informações do dispositivo: os metadados podem fornecer informações sobre o dispositivo que o cliente está usando para conversar, como tipo de dispositivo, sistema operacional e navegador. Essas informações podem ajudar o agente de IA a resolver problemas técnicos e fornecer assistência mais direcionada.

Metadata

Para fornecer mais contexto para o agente de IA, use:

setMetadata(Array<{
key: string;
value: string;
sanitize: boolean;
}> metadata)

Se sanitize está definido como true o valor não estiver disponível nos registros de conversa, ele aparecerá com um placeholder

Exemplo:

            setTimeout(() => {
                chat.setMetadata([
                    { key: 'orderName', value: 'Jane Doe' },
                    { key: 'orderEmail', value: 'jane@ultimate.ai', sanitize: true }
                ]);
            }, 2000);

Coleta automática de metadados

O Widget de Chat Ultimate pode coletar metadados relacionados ao dispositivo do usuário automaticamente.

Como configurar?

Essa funcionalidade está ativa por padrão.

Você pode desativá-lo definindoautoMetadataCollection para false.

Detalhes dos metadados coletados

Essa funcionalidade está funcionando com base na configuração do dispositivo e não requer cookies e IP do usuário para funcionar corretamente.

Metadata Descrição
Idioma {{systemLanguage}}

O idioma padrão do dispositivo de um usuário.

Por exemplo, en-GB, en-US.

Você pode encontrar uma lista completa de códigos de idioma aqui.

(Usando o padrão BCP 47)
Fuso horário{{systemTimezone}}

O fuso horário/região em que o usuário está no momento.

Por exemplo, Europe/Berlin,.

Uma lista completa de fusos horários pode ser encontrada aqui na coluna ID da zona.
Tipo de dispositivo {{deviceName}}

O tipo de dispositivo usado por um usuário. Os dispositivos que estamos detectando são:

Dispositivos móveis: iPad, iPhone, Android, Windows Phone

Dispositivos de área de trabalho: Mac, Windows, Linux

URL inicial

{{url}}

A URL da página onde o usuário abriu o widget.

Por exemplo, https://www.google.com.
Nome do navegador {{browserName}}

O nome do navegador do usuário.

Por exemplo, Chrome, Firefox, Opera, etc.
Versão do navegador {{browserVersion}}

A versão do navegador do usuário.

Por exemplo, 111, 113 etc.

 

Histórico de conversas

Todas as conversas com o widget são armazenadas diretamente nos registros de conversas.

Para uma conversa otimizada, sugerimos ativar o histórico do chat. Isso permite que os usuários continuem de onde pararam, mesmo depois de recarregar a página ou reabrir a aba do navegador.

Para que isso aconteça, utilizamos o armazenamento local do navegador para salvar o ID da conversa. Assim, podemos recuperar os dados da conversa sempre que necessário.

Ativação

Como recuperar a conversa anterior, alterne o recoverConversationparâmetro para true.

Desativação

Ao desativar o histórico de conversas (alterar recoverConversation parâmetro para false), o lastReadMessageId_{botId} e platformConversationId_{botId} são removidos do armazenamento local do navegador (LS) do usuário. Mais detalhes sobre o uso do armazenamento local podem ser encontrados aqui.

recoverConversation was previously named isConversationPersistanceEnabled

 

Configuração de mensagens do UltimateGPT

Rótulo de resposta de IA

De agora em diante, todas as respostas geradas por IA exibirão um rótulo acima delas. Isso significa que os usuários podem distinguir facilmente entre o conteúdo gerado por IA e outras entradas de mensagem. É um passo para tornar a experiência do usuário mais clara e informada, mantendo o usuário informado sobre a natureza do conteúdo com o qual está interagindo.

Configuração:

Ícone Mostrar/ocultar informações messageGeneratedAdditionalInfo (padrão false)

Origens das mensagens

Toda resposta gerada por IA agora exibirá as origens das informações, permitindo que você rastreie as origens da resposta. Isso não apenas promove a credibilidade, mas também permite que o usuário explore mais o tópico com referências confiáveis na ponta dos dedos.

Configuração:

Mostrar/ocultar origens de IA usando o parâmetro showLlmSources (padrão true)

Notificações

Notificações visuais

Essas notificações agem como uma representação visual das mensagens recebidas. Sempre que o widget for fechado ou minimizado e uma nova mensagem for recebida, uma notificação em vermelho mostrará o número de mensagens recebidas, mas não abertas. 

Notificação sonora

As notificações sonoras servem como alertas sonoros que aumentam a conscientização do usuário e são ativadas nas seguintes condições:
  1. Transferência de agente: quando um agente ingressa em uma solicitação de transferência.
  2. Alerta da aba em segundo plano: quando uma mensagem é recebida enquanto o usuário está visualizando uma aba diferente do navegador.
  3. Alerta de widget minimizado: quando uma nova mensagem chega e o widget é minimizado.
Opções de configuração
Ativação/desativação das notificações sonoras. Os clientes podem configurar o estado padrão das notificações sonoras usando o allowSoundNotifications dentro do script do widget:
  • Para ativar as notificações sonoras por padrão, defina allowSoundNotifications para true.
  • Para desativar as notificações sonoras por padrão, defina allowSoundNotifications para false.
Depois de configurados, os usuários mantêm a capacidade de ativar ou desativar manualmente as notificações sonoras conforme sua preferência.

Abrir/fechar o widget

Você pode controlar facilmente o widget de qualquer lugar do seu site usando estes comandos simples:

  • Como mostrar o widget openWidget()
  • Como ocultar o widget closeWidget()

Remover o widget?

Exemplo de caso de uso:

Forneça acesso ao widget apenas para os usuários que estão conectados e certifique-se de que o widget seja fechado depois que um usuário for desconectado.

Implementação:

Chamar um método destroy()

Comportamento:

  • Remove o iframe do widget de chat do DOM (Modelo de objeto de documento)

  • Desconectar a conexão do WebSocket

 

Formulários 

As mensagens de formulário são um tipo de mensagem estruturada que permite que você capture dados do usuário em uma conversa em andamento, exibindo um formulário que pode conter entradas de texto e listas suspensas selecionadas. 

Uso de formulários com Agentes de IA - Avançado

Os formulários são uma ótima maneira de coletar dados do cliente sem que o agente de IA faça várias perguntas. Os casos de uso típicos incluem segurança, perguntas de identificação ou solicitações de alteração de dados.

Para criar um formulário, acesse Settings / Ultimate Chat Widget / Forms e crie um formulário com base nas instruções da página.

É possível criar campos de formulário como:

  • Texto
  • E-mail
  • Selecionar

Depois que seu formulário for criado, vá para o respectivo Dialogue onde você gostaria de adicionar o formulário e siga as etapas abaixo. 

Etapas:

  1. Adicione uma mensagem do agente de IA com o código abreviado para capturar o formulário e inseri-lo. Na imagem abaixo, estamos adicionando nosso formulário lead_capture. No entanto, você adicionará o nome do seu formulário entre template: e ))% no trecho abaixo.

    %((template: nameOfTemplate))%

  2. Adicione uma mensagem do visitante (texto livre por escrito) logo após a mensagem do agente de IA. Isso capta as respostas do usuário.

  3. Adicione outro bloco de mensagem do agente de IA após a mensagem do visitante com algum tipo de confirmação do preenchimento do formulário pelos clientes, como um agradecimento.

  4. As respostas do usuário ficam bloqueadas nos metadados. Se você quiser usá-los posteriormente no chat, precisará recuperá-los. Isso é totalmente opcional. Fazemos isso com Ações.

Limpar as respostas dos clientes

A limpeza de respostas é algo que você desejará fazer se estiver solicitando dados de IIP de seus clientes. Isso é algo com o qual você estará familiarizado em Entidades de conteúdo; por exemplo, nós, por padrão, limpamos endereços de e-mail e números IBAN. Para entender mais sobre a Limpeza, consulte os artigos abaixo.

Processamento de dados dos Agentes de IA - Avançado explicado

Instruções: Limpar dados de informações de identificação pessoal (IIP) com entidades de conteúdo

Como limpar os dados do formulário

Dependendo do caso de uso que você tem para os formulários, pode ser uma boa ideia limpar as informações. Isso é fácil de fazer. 

  1. Clique na barra azul onde diz "se..." para abrir o painel de detalhes.
  2. Clique na caixa "Limpar a resposta do usuário" para ocultar os detalhes nos Agentes de IA - Avançado.

O resultado disso significa que, ao revisar a conversa em Agentes de IA - Avançado, ela terá a aparência mostrada abaixo.

 

Localização

É possível ajustar a localidade do Widget no tempo de execução. Como alterar a localização do método de chamada do widget: setLocale(<string>)

Valor padrão: en_US

Outros idiomas com suporte: nl_NL

Testando a localização

Use o parâmetro de teste para alternar o idioma do widget. https://widget.ultimate.ai/demo/?botId={Your.Bot.ID}&locale={Your.Locale}
ou seja, https://widget.ultimate.ai/demo/?botId=65da6df65ab8b465b87222586&locale=nl_NL

Exemplo de caso de uso: sincronize o idioma da interface do widget com o idioma do site. Chame um método para atualizar o idioma do widget quando o idioma do site for alterado.

Privacidade de dados

Nosso widget é compatível com SOC2 e RGPD.

  • Não são usados cookies.
  • O armazenamento local é usado para fornecer a melhor experiência de conversa.

URL da política de privacidade personalizada

É possível adicionar sua própria política de privacidade, acessível por meio de nosso widget, adicionando-a à seção da barra de navegação.

privacyPolicyUrl: URL

ou seja, privacyPolicyUrl: https://www.ultimate.ai/security-privacy

Armazenamento local

Nosso widget não armazena cookies no dispositivo do usuário, mas é necessário armazenamento do lado do usuário para oferecer suporte à funcionalidade do widget. Elas são descritas abaixo:

Nome do parâmetro Descrição
platformConversationId_{botId} Armazenamos o ID da conversa para restaurar a conversa na recarga da página (é possível desativá-lo, consulte esta seção).
lastReadMessageId_{botId}

Se armazenamos o ID da última mensagem lida pelo usuário. Posteriormente, isso é usado para calcular o contador de notificações.

PERGUNTAS FREQUENTES

  1. Preciso me conectar a um CRM para testar o widget? Não, a conexão com o CRM não é necessária. Você pode implementá-la em um site sandbox ou solicitar que forneçamos um ambiente se isso não for possível.
    Adicionaremos nosso widget à nossa plataforma para complementar nossa funcionalidade de agente de IA de teste. 

  2. Podemos monitorar se um link foi clicado? Infelizmente, não é possível monitorar se um link foi clicado no momento. Avaliaremos a adição dessa funcionalidade no futuro.

  3. Temos formatação HTML no DLB? Infelizmente, não no momento. Você pode tentar usar um editor online, tal como - Editor HTML5 - Compositor de conteúdo online grátis

  4. Podemos ter várias conversas? Esse recurso não é compatível no momento.

  5. O Widget de Chat Ultimate usa cookies? Não, nosso widget não armazena cookies no dispositivo do usuário. Consulte acima para obter detalhes sobre os requisitos de armazenamento do lado do cliente.

Powered by Zendesk