Como Adicionar o Chatbot de IA Asyntai ao Backdrop CMS

Guia passo a passo para sites Backdrop 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.

Passo 2: Adicione ao Template do Tema (Recomendado)

O Backdrop CMS usa arquivos de template .tpl.php nos seus temas. A abordagem recomendada é adicionar o código de incorporação diretamente ao template de página do seu tema ativo:

Acesse sua instalação do Backdrop CMS via FTP ou Gerenciador de Arquivos
Navegue até o diretório do seu tema ativo: themes/yourtheme/
Abra o arquivo page.tpl.php (ou layout.tpl.php dependendo do seu tema)
Encontre a tag de fechamento </body> ou a linha <?php print $page_bottom; ?>
Cole seu código de incorporação Asyntai logo antes dessa linha
Salve o arquivo

<!-- Asyntai AI Chatbot -->
<script async src="https://asyntai.com/static/js/chat-widget.js" data-asyntai-id="YOUR_WIDGET_ID"></script>
<?php print $page_bottom; ?>
</body>

Dica: Colocar o código logo antes de <?php print $page_bottom; ?> ou 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: Usando um Módulo Personalizado

Você pode criar um módulo simples do Backdrop CMS que injeta o script do chatbot usando backdrop_add_js():

Crie o diretório do módulo: modules/custom/asyntai_widget/
Crie o arquivo do módulo asyntai_widget.module com o seguinte código:
// modules/custom/asyntai_widget/asyntai_widget.module function asyntai_widget_init() { backdrop_add_js('https://asyntai.com/static/js/chat-widget.js', array( 'type' => 'external', 'scope' => 'footer', 'attributes' => array('async' => 'async', 'data-asyntai-id' => 'YOUR_WIDGET_ID'), )); }
Crie o arquivo asyntai_widget.info:
name = Asyntai AI Chatbot Widget description = Adds the Asyntai AI chatbot widget to all pages. backdrop = 1.x package = Custom type = module
Acesse Functionality (admin/modules) no seu painel de administração do Backdrop
Encontre "Asyntai AI Chatbot Widget" no pacote Custom e ative-o
Clique em "Save configuration"

Nota: Substitua YOUR_WIDGET_ID no código do módulo pelo seu ID de widget real do Dashboard Asyntai. A abordagem de módulo personalizado é segura para atualizações e não será sobrescrita ao atualizar seu tema.

Método Alternativo 2: Usando o Módulo "Add to Head" do Backdrop

O módulo contribuído "Add to Head" oferece uma maneira fácil de injetar scripts sem editar código:

Baixe e instale o módulo contribuído "Add to Head" do site do Backdrop CMS
Vá para Configuration > Development > Add to Head
Adicione seu código de incorporação Asyntai na footer section
Clique em "Save configuration"

Dica: Usar o módulo "Add to Head" é o método mais fácil se você preferir não editar arquivos de tema ou criar módulos personalizados. Ele fornece uma interface administrativa simples para gerenciar scripts injetados.

Método Alternativo 3: Usando o Sistema de Blocos

O sistema de layout e blocos do Backdrop CMS também pode ser usado para adicionar o chatbot:

Faça login no seu painel administrativo do Backdrop CMS
Acesse Structure > Layouts
Selecione o layout que deseja editar (ex.: o layout padrão)
Clique em "Add block" na região do rodapé
Escolha "Custom block"
Defina o formato do bloco para "Full HTML" ou "Raw HTML"
Cole seu código de incorporação Asyntai no corpo do bloco
Dê um título ao bloco (ex.: "Asyntai Chatbot") e opcionalmente marque "Hide title"
Clique em "Save block" e depois em "Save layout"

Importante: Certifique-se de que o formato de texto está definido como "Full HTML" ou "Raw HTML" para que a tag de script não seja removida. O formato padrão "Filtered HTML" removerá tags de script por motivos de segurança.

Etapa 3: Limpar Cache e Verificar

Após fazer suas alterações, limpe o cache do Backdrop CMS e verifique a instalação:

Acesse Configuration > Performance no seu painel de administração
Clique em "Clear all caches"
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 Backdrop CMS em Configuration > Performance. Tente visualizar seu site em uma janela anônima ou limpar o cache do navegador. Abra o console do navegador (F12) para verificar se há erros de JavaScript. Se você usou o método de módulo personalizado, verifique se o módulo está habilitado em Functionality.