Como Adicionar o Chatbot IA Asyntai ao Concrete CMS

Guia passo a passo para sites Concrete CMS (anteriormente Concrete5)

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 Rodapé do Tema (Recomendado)

A melhor forma de adicionar o chatbot a todas as páginas do seu site Concrete CMS é editando o arquivo de rodapé do seu tema:

Acesse sua instalação do Concrete CMS via FTP ou Gerenciador de Arquivos
Navegue até o diretório /application/themes/your_theme_name/
Localize e abra o arquivo footer.php (ou o template de rodapé equivalente)
Encontre a linha com a tag de fechamento </body>
Cole seu código de incorporação Asyntai logo antes da tag </body>
Salve o arquivo e faça o upload de volta para o seu servidor se estiver editando localmente
Limpe o cache do Concrete CMS: Dashboard → System & Settings → Clear Cache

Dica: Adicionar o código antes da tag de fechamento </body> garante que o chatbot carregue após o conteúdo da página, proporcionando melhor desempenho de carregamento. Este método adiciona automaticamente o chatbot a todas as páginas que usam este tema.

Método Alternativo 1: Bloco HTML (Mais Fácil para Não-Desenvolvedores)

Se você prefere não editar arquivos de tema, pode usar o bloco HTML integrado do Concrete CMS:

Faça login no seu Painel do Concrete CMS
Navegue até a página onde deseja adicionar o chatbot
Clique em Edit Page (ícone de lápis na barra de ferramentas)
Clique em Add Block na área onde deseja colocar o código
Pesquise e selecione o bloco HTML
Cole seu código de incorporação Asyntai no editor HTML
Clique em Add para salvar o bloco
Clique em Publish para publicar as alterações

Nota: O método de bloco HTML é ótimo para adicionar o chatbot a páginas específicas. Para instalação em todo o site, você precisará adicionar o bloco HTML a cada página, ou usar o método de rodapé do tema descrito acima. O posicionamento visual do bloco não afeta onde o chatbot aparece - ele ainda será exibido no canto inferior direito.

Método Alternativo 2: Arquivo de Cabeçalho do Tema

Você também pode adicionar o código ao arquivo de cabeçalho do seu tema para instalação em todo o site:

Acesse seus arquivos do Concrete CMS via FTP ou Gerenciador de Arquivos
Navegue até /application/themes/your_theme_name/
Abra o arquivo header.php (ou elements/header.php)
Encontre a tag de fechamento </head>
Cole seu código de incorporação Asyntai logo antes da tag </head>
Salve e envie o arquivo
Limpe o cache pelo Dashboard

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

Dica: Certifique-se de incluir os elementos de cabeçalho obrigatórios usando <?php View::element('header_required'); ?> no seu arquivo header.php para que o Concrete CMS funcione corretamente.

Método Alternativo 3: Template Personalizado (Avançado)

Para desenvolvedores que desejam mais controle, você pode criar um template de página personalizado:

Crie um novo arquivo de template de página em /application/themes/your_theme_name/
Ou copie um template existente (por exemplo, default.php) e renomeie-o
Adicione seu código de incorporação Asyntai ao arquivo de template antes de </body>
No Dashboard do Concrete CMS, acesse Pages & Themes
Clique em Page Types
Selecione o tipo de página que deseja usar com este template
Atribua seu template personalizado ao tipo de página
Todas as páginas que usam este template agora incluirão o chatbot

Importante: Sempre faça backup dos arquivos do tema antes de fazer alterações. Teste suas modificações em um site de staging primeiro, se possível. Edições incorretas nos arquivos de tema podem quebrar o layout ou a funcionalidade do seu site.

Passo 3: Verifique a Instalação

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

Não está vendo o widget? Certifique-se de ter limpado o cache do Concrete CMS (Dashboard → System & Settings → Clear Cache). Tente visualizar seu site em uma janela anônima. Confirme se salvou e enviou todas as alterações de arquivos. Abra o console do navegador (F12) para verificar se há erros de JavaScript.