Incorporar Guide em seu site
Você deve inserir o código Guide JavaScript em cada página do seu site em que deseja exibir as Guide regras de engajamento que você criou.
Para acessar o código de inserção, você precisa da permissão Configuração de Guide.
Veja um breve vídeo sobre como inserir o código do Guide JavaScript.
- Clique no seletor de aplicativos
e selecioneGuide. -
Clique em Integrações. Uma página aparece com código JavaScript específico do seu locatário.
A imagem de exemplo contém áreas desfocadas onde você verá valores específicos do seu locatário.
-
Clique em Copiar código com Guide para copiar o código.
- Paste this code into the header of each webpage on which you want to display a Guide template or proactive offer.
Como alternativa, se o seu site estiver integrado a um gerenciador de tags, você pode usá-lo para executar o script do site.
Habilitar o Chat Demo e Aplicar Configurações de Adaptação à marca
Para visualizar o comportamento do chat durante a implementação, você pode configurar Guide para inicializar o chat no modo demo. Para habilitar o chat demo, adicione o parâmetro demoMode à função cxone('guide','init'); em seu script incorporado.
cxone('chat', 'init', brandId, channelId, locale, { controlledByGuide: true, demoMode: true, customContainerId: 'customId'});
When demoMode is set to true.
-
Guide inicia a janela de chat no modo de demonstração.
-
O chat é carregado em um estado predefinido e somente leitura.
Por padrão, o parâmetro é definido como false.
Depois que o Chat for inicializado no modo Demo, você pode atualizar a pré-visualização em tempo real usando a API de Adaptação à marca:
cxone('chat','setThemeColors', {headerBgColor, headerFontColor, primaryMessageBgColor, primaryMessageFontColor, secondaryMessageBgColor, secondaryMessageFontColor});
Ao usar setThemeColors:
-
Adaptação à marca é expandida para incluir a personalização do chat.
-
A janela de chat exibe a marca configurada.
-
As atualizações de adaptação à marca podem ser usadas em conjunto com o chat Demo para que você possa visualizar a aparência configurada durante a implementação.
Você também pode usar CSS personalizado com as configurações de marca:
-
Se as configurações de marca e o CSS personalizado não entrarem em conflito, ambos serão aplicados.
-
Se as configurações de marca e o CSS personalizado estiverem em conflito, o CSS personalizado tem prioridade.
Habilitar a reavaliação de Regra para Aplicativos de Página única (SPAs)
Para dar suporte ao roteamento dinâmico em aplicativos de página única, você pode configurar Guide para reavaliar automaticamente as regras quando um usuário navega para uma nova página. Para habilitar o roteamento dinâmico, adicione o parâmetro resetRulesOnNewPage à função cxone('guide','init'); no seu script incorporado:
cxone('guide','init', {resetRulesOnNewPage: true});
Quando resetRulesOnNewPage for definido como true.
-
Guide monitora transições de página usando o módulo Analytics.
-
Ao detectar uma nova página, o mecanismo de regras é redefinido para o estado inicial.
-
Todas as regras, incluindo aquelas com avaliações estáticas ou aquelas que já foram disparadas, são reavaliadas imediatamente.
-
Os listeners e os temporizadores de regra são reiniciados como se a página tivesse acabado de ser carregada.
Por padrão, o parâmetro é definido como false.
Definir o Idioma a usar para Guide
Para substituir as configurações de idioma do navegador e forçar os visitantes de Guide a ver conteúdo em um idioma específico, modifique o script de incorporação. Adicione o parâmetro locale ao comando cxone('guide','init'); no final do script e especifique o idioma desejado. Por exemplo, você pode definir para Francês da seguinte forma:
cxone('init','####');
cxone('guide','init', { locale: 'ja', templateId:'xxxxxxx'});
Substituir #### pelo id DO locatário de quatro dígitos.
O conteúdo que você escreve em uma oferta proativa ainda aparece no idioma em que foi escrito. Isso pressupõe que você configurou as strings de tradução do Guide para o francês.
Desabilitar rastreamento
Para usar condições de data e hora ou disponibilidade do agente, mas não usar o rastreamento da web, adicione o seguinte comando de API JavaScript ao script de incorporação:
cxone('disableModule', 'analytics')
Práticas recomendadas para sites
-
Do not use the
!importantparameter in CSS for generic elements on your website. If you do, your website CSS can leak into Guide and change its design. -
Não substitua as funções básicas de JavaScript no seu site. Se você fizer isso, o Guide poderá não funcionar corretamente.
-
Você pode personalizar a aparência e o comportamento de Guide usando as API do JavaScript.