Como Adicionar o Chatbot de IA Asyntai ao Kentico

Guia passo a passo para sites Kentico CMS

Plataforma:

Passo 1: Obtenha Seu Código de Incorporação

Primeiro, acesse seu Dashboard Asyntai e role para baixo até a seção "Embed Code". Copie seu código de incorporação exclusivo que se parecerá com isto:

<script async src="https://asyntai.com/static/js/chat-widget.js" data-asyntai-id="YOUR_WIDGET_ID"></script>

Nota: O código acima é apenas um exemplo. Você deve copiar seu próprio código de incorporação exclusivo do seu Dashboard, pois ele contém seu ID de widget pessoal.

Etapa 2: Adicionar Código ao Template de Página Mestre (Recomendado)

Para adicionar o chatbot a todas as páginas do seu site Kentico de uma só vez, use o método de Template de Página Mestre:

Faça login no Kentico Admin e navegue até o aplicativo Page templates
Localize e abra seu Master page template (o template usado em todas as páginas)
Clique na aba Header no editor de templates
Na seção de cabeçalho, cole seu código de incorporação do Asyntai
Alternativamente, adicione o código ao layout do template antes da tag de fechamento </head>
Clique em Save para aplicar as alterações
Limpe o cache do seu site e verifique as alterações no site ao vivo

Dica: Usar o Template de Página Mestre garante que o chatbot apareça em todas as páginas que herdam deste template. Este é o método mais eficiente para implantação em todo o site no Kentico.

Método Alternativo 1: Cabeçalho do Template de Página

Se você deseja adicionar o chatbot apenas a páginas específicas:

Vá para o aplicativo Page templates no Kentico Admin
Selecione o template de página específico que deseja editar
Clique na aba Header
Adicione seu código de incorporação do Asyntai usando uma tag de script:

<script async src="https://asyntai.com/static/js/chat-widget.js" data-asyntai-id="YOUR_WIDGET_ID"></script>

Clique em Save
Todas as páginas que usam este template agora incluirão o chatbot

Nota: Este método é útil quando você deseja adicionar o chatbot a seções específicas do seu site que compartilham o mesmo template de página, em vez de todo o site.

Método Alternativo 2: Web Part HEAD HTML

Para um controle mais granular em páginas específicas ou para JavaScript herdável entre subpáginas:

Abra a página que deseja editar no editor de páginas do Kentico
Adicione uma nova web part à página (preferencialmente em uma página pai para herança)
Procure e selecione a web part HEAD HTML
Na configuração da web part, cole seu código de incorporação do Asyntai
Configure a web part como herdável se quiser que as páginas filhas tenham o chatbot
Clique em OK para salvar a web part
Salve e publique a página

Dica: A web part HEAD HTML é perfeita para adicionar código a uma página pai que será automaticamente propagado para todas as páginas filhas, criando uma instalação abrangente na seção.

Método Alternativo 3: Arquivos JavaScript Personalizados (Avançado)

Para desenvolvedores que preferem gerenciar scripts como arquivos:

No seu projeto Kentico, navegue até o diretório ~/CMSScripts/Custom/
Crie um novo arquivo JavaScript (ex: asyntai-widget.js)
Adicione código para carregar dinamicamente seu widget Asyntai:

(function() {
    var script = document.createElement('script');
    script.src = 'https://asyntai.com/static/js/chat-widget.js';
    script.setAttribute('data-asyntai-id', 'YOUR_WIDGET_ID');
    script.async = true;
    document.head.appendChild(script);
})();

Referencie este arquivo no cabeçalho do seu Template de Página Mestre:

<script src="~/CMSScripts/Custom/asyntai-widget.js"></script>

Importante: Este método avançado requer acesso ao sistema de arquivos e conhecimento da estrutura de diretórios do Kentico. Certifique-se de ter as permissões adequadas e sempre teste em um ambiente de homologação primeiro.

Passo 3: Verifique a Instalação

Após salvar suas alterações e limpar o cache, abra seu site em uma nova aba do navegador ou em uma janela anônima. Você deverá ver o botão do widget de chat no canto inferior direito. Clique nele para verificar se abre e funciona corretamente.

Não está vendo o widget? Certifique-se de que salvou todas as alterações e limpou o cache do Kentico (Settings > System > Clear cache). Tente visualizar seu site em uma janela anônima. Verifique o console do navegador (F12) para quaisquer erros de JavaScript que possam impedir o carregamento do widget.