Como Adicionar o Chatbot de IA Asyntai ao MODX

Guia passo a passo para sites MODX 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 ao Template do MODX (Recomendado)

A maneira recomendada de adicionar o chatbot é editando seu Template do MODX diretamente no MODX Manager:

Faça login no seu MODX Manager (painel de administração)
Na barra lateral esquerda, vá para Elements > Templates
Abra o template do seu site (geralmente chamado "BaseTemplate" ou seu template ativo)
Encontre a tag de fechamento </body>
Cole seu código de incorporação do Asyntai logo antes da tag de fechamento </body>
Clique em "Save" para salvar o template

<!-- Your existing template content -->

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

Dica: Adicionar o código logo antes da tag de fechamento </body> garante que o chatbot carregue após todo o conteúdo da página, que é o posicionamento recomendado para widgets de chat e não irá desacelerar o carregamento da sua página.

Método Alternativo 1: Usando um Chunk do MODX

Você pode usar um Chunk do MODX para manter o código de incorporação separado e reutilizável:

No MODX Manager, vá para Elements > Chunks
Clique em "New Chunk" para criar um novo chunk
Nomeie o chunk como "asyntaiWidget"
Cole seu código de incorporação Asyntai na área de conteúdo
Clique em "Save"
Abra seu template (em Elements > Templates)
Adicione a chamada do chunk [[$asyntaiWidget]] logo antes da tag de fechamento </body>
Salve o template

<!-- In your Template, before </body> -->
[[$asyntaiWidget]]
</body>
</html>

Dica: Usar um Chunk facilita o gerenciamento e a atualização do código de incorporação em um só lugar, especialmente se você usa vários templates no seu site.

Método Alternativo 2: Usando Configurações do Sistema MODX (Cabeçalho/Rodapé HTML)

Algumas configurações do MODX incluem placeholders para scripts de rodapé via Configurações do Sistema:

No MODX Manager, vá para System > System Settings
Filtre por "htmlhead" ou procure uma configuração de sistema personalizada para scripts de rodapé
Se sua configuração tem um placeholder para scripts de rodapé (como [[++footer_scripts]]), você pode usá-lo
Defina o valor da configuração do sistema para o seu código de incorporação do Asyntai
Certifique-se de que o placeholder correspondente [[++footer_scripts]] está presente no seu template antes da tag de fechamento </body>
Salve a configuração do sistema

<!-- In your Template, before </body> -->
[[++footer_scripts]]
</body>
</html>

Nota: Este método depende da sua configuração do MODX ter uma configuração de sistema personalizada para scripts de rodapé. Se não existir, você pode criar uma configuração de sistema personalizada e referenciá-la no seu template usando a sintaxe [[++setting_key]].

Método Alternativo 3: Usando um Plugin do MODX (OnWebPagePrerender)

Para uma abordagem avançada, você pode criar um Plugin do MODX que injeta automaticamente o código do chatbot em todas as páginas:

No MODX Manager, vá para Elements > Plugins
Clique em "New Plugin" para criar um novo plugin
Nomeie o plugin como "AsyntaiChatbot"
Cole o seguinte código PHP na área de código do plugin:

$output = &$modx->resource->_output;
$script = '<script async src="https://asyntai.com/static/js/chat-widget.js" data-asyntai-id="YOUR_WIDGET_ID"></script>';
$output = str_replace('</body>', $script . '</body>', $output);

Clique na aba "System Events"
Marque a caixa ao lado de "OnWebPagePrerender" para disparar este plugin nesse evento
Clique em "Save"

Importante: Substitua YOUR_WIDGET_ID pelo seu ID de widget real do Painel do Asyntai. Este plugin irá injetar automaticamente o script do chatbot em todas as páginas do seu site MODX antes de serem renderizadas.

Etapa 3: Limpar Cache e Verificar

Após adicionar o código de incorporação usando qualquer um dos métodos acima, você precisa limpar o cache do MODX e verificar a instalação:

No MODX Manager, vá para Manage > Clear Cache (ou clique no ícone de limpar cache no menu superior)
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 da sua página
Clique nele para verificar se abre e funciona corretamente

Não está vendo o widget? Certifique-se de que limpou o cache do MODX em Manage > Clear Cache no MODX Manager. Também tente limpar o cache do navegador ou visualizar o site em uma janela anônima. Se você usou o método de Plugin, verifique se o evento de sistema "OnWebPagePrerender" está marcado para o seu plugin.