Como Adicionar o Chatbot IA Asyntai ao Craft CMS

Guia passo a passo para sites Craft 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: Editar Seu Template de Layout (Recomendado)

A maneira mais fácil de adicionar o chatbot a todas as páginas é editando seu template de layout principal:

Access your Craft CMS project files via FTP, SSH, or your code editor
Navegue até o diretório templates/
Encontre seu arquivo de layout principal (geralmente chamado _layout.twig, _layout.html, ou localizado em templates/_layouts/)
Encontre a tag de fechamento </body>
Cole seu código de incorporação Asyntai logo antes da tag </body>
Salve o arquivo

Dica: Adicionar o script antes da tag de fechamento </body> garante que ele carregue após o conteúdo da página, o que é recomendado para widgets de chat e não atrasa o carregamento da sua página.

Alternative: Using Twig {% js %} Tag (Craft CMS 3.x+)

O Craft CMS fornece uma tag Twig integrada para registrar JavaScript:

Abra seu template de layout principal
Adicione o seguinte código antes da tag de fechamento </body>:
{% js %} (function() { var script = document.createElement('script'); script.async = true; script.src = 'https://asyntai.com/static/js/chat-widget.js'; script.setAttribute('data-asyntai-id', 'YOUR_WIDGET_ID'); document.body.appendChild(script); })(); {% endjs %}
Substitua YOUR_WIDGET_ID pelo seu ID de widget real
Salve o arquivo

Nota: The {% js %} tag automatically handles script registration and prevents duplicate loading if the same code appears multiple times.

Alternativa: Criar um Arquivo de Include Separado

Para melhor organização, crie um arquivo de include dedicado:

Crie um novo arquivo: templates/_includes/chatbot.twig (ou .html)
Adicione seu código de incorporação Asyntai a este arquivo:
<script async src="https://asyntai.com/static/js/chat-widget.js" data-asyntai-id="YOUR_WIDGET_ID"></script>
No seu template de layout principal, inclua este arquivo antes de </body>:
{% include '_includes/chatbot' %}
Salve ambos os arquivos

Dica: Usar um arquivo de include facilita habilitar/desabilitar o chatbot em todo o seu site comentando apenas uma linha.

Alternativa: Carregamento Condicional

Para carregar o chatbot apenas em páginas ou seções específicas:

No seu template de layout ou página, use condicionais Twig:
{% if entry.showChatbot ?? true %} <script async src="https://asyntai.com/static/js/chat-widget.js" data-asyntai-id="YOUR_WIDGET_ID"></script> {% endif %}
Ou verifique seções específicas:
{% if craft.app.request.segments[0] != 'admin' %} <script async src="https://asyntai.com/static/js/chat-widget.js" data-asyntai-id="YOUR_WIDGET_ID"></script> {% endif %}

Passo 3: Verifique a Instalação

Após salvar suas alterações, visite seu site Craft CMS 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 salvo o arquivo de template e de estar editando o template de layout correto que suas páginas utilizam. Limpe o cache do navegador ou visualize em uma janela anônima. Se estiver usando cache de templates, limpe o cache do Craft CMS pelo Painel de Controle em Utilities > Clear Caches.

Localização do Template: A localização dos templates do Craft CMS pode variar dependendo da configuração do seu projeto. Localizações comuns incluem templates/_layout.twig, templates/_layouts/main.twig ou templates/_base.twig. Verifique seus templates existentes para encontrar onde a tag </body> está definida.