Como Adicionar o Chatbot IA Asyntai ao ProcessWire

Guia passo a passo para sites ProcessWire 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: Adicionar ao Arquivo de Template (Recomendado)

O ProcessWire usa arquivos de template PHP localizados no diretório site/templates/. A abordagem mais fácil é adicionar o código de incorporação diretamente ao seu arquivo de template principal:

Acesse os arquivos de instalação do ProcessWire via FTP, SSH ou seu gerenciador de arquivos
Navegue até site/templates/
Abra seu arquivo de template principal — geralmente é _main.php ou basic-page.php dependendo do perfil do seu site
Se você está usando a estratégia de saída atrasada (o padrão para a maioria dos perfis de site), abra _main.php
Encontre a tag de fechamento </body>
Cole seu código de incorporação Asyntai logo antes dele:

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

Dica: Colocar o script logo antes da tag de fechamento </body> garante que o chatbot carregue após o conteúdo da página, o que é recomendado para desempenho ideal e não vai deixar a renderização da página mais lenta.

Método Alternativo 1: Usando _foot.inc ou Arquivo de Adição _main.php

Se seu site ProcessWire usa a abordagem de arquivo de adição (comum em muitos perfis de site), você pode adicionar o código de incorporação ao include de rodapé compartilhado:

Navegue até site/templates/
Abra _foot.inc (ou seu arquivo de include de rodapé equivalente)
Cole seu código de incorporação do Asyntai logo antes da tag de fechamento </body>
Salve o arquivo

A estratégia de saída atrasada do ProcessWire normalmente funciona com três arquivos principais:

_init.php — executa antes de cada template, inicializa variáveis
Seu arquivo de template (ex.: basic-page.php) — preenche as variáveis de conteúdo
_main.php — gera a marcação HTML final usando essas variáveis

Se o seu site usa essa abordagem, adicionar o script ao _main.php antes de </body> garante que ele apareça em todas as páginas.

Nota: Os nomes dos arquivos _init.php e _main.php são configurados no seu site/config.php via as configurações $config->prependTemplateFile e $config->appendTemplateFile. Verifique sua configuração se seus arquivos tiverem nomes diferentes.

Método Alternativo 2: Usando o Array $config->scripts

O ProcessWire oferece um FilenameArray $config->scripts que você pode usar para gerenciar arquivos JavaScript. No seu _init.php ou arquivo de template individual, adicione:

<?php
$config->scripts->add('https://asyntai.com/static/js/chat-widget.js');
?>

Em seguida, no seu _main.php (ou include de rodapé), percorra o array de scripts para exibi-los:

<?php foreach($config->scripts as $file): ?>
<script src="<?php echo $file; ?>"></script>
<?php endforeach; ?>

Importante: A abordagem $config->scripts lida com o atributo src do script, mas o atributo data-asyntai-id precisa ser tratado separadamente. Você precisará adicionar o atributo data manualmente na saída do loop, ou usar o método de tag script direto do Passo 2 para a configuração mais simples.

Método Alternativo 3: Usando um Hook (ready.php)

Para uma abordagem mais avançada, você pode usar o sistema de hooks do ProcessWire para injetar automaticamente o script do chatbot em cada página. Adicione o seguinte ao seu arquivo site/ready.php:

<?php
$wire->addHookAfter('Page::render', function(HookEvent $event) {
    $html = $event->return;
    $script = '<script async src="https://asyntai.com/static/js/chat-widget.js" data-asyntai-id="YOUR_WIDGET_ID"></script>';
    $html = str_replace('</body>', $script . '</body>', $html);
    $event->return = $html;
});
?>

Este hook intercepta a saída HTML renderizada de cada página e injeta o script Asyntai automaticamente logo antes da tag de fechamento </body>.

Dica: A abordagem de hook ready.php é ideal se você deseja o chatbot em todas as páginas sem modificar nenhum arquivo de template. Ela também sobrevive a alterações de template e atualizações de tema, pois fica fora dos arquivos de template.

Passo 3: Verifique a Instalação

Após salvar suas alterações, visite seu site ProcessWire 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 verificar se abre e funciona corretamente.

Não está vendo o widget? Certifique-se de que salvou todos os arquivos modificados. Tente limpar o cache do navegador ou visualizar em uma janela anônima. Se o cache de template do ProcessWire estiver habilitado, pode ser necessário limpá-lo acessando Modules → Core → Template Engine Cache ou adicionando ?nocache=1 à sua URL. Também verifique se o arquivo de template está sendo realmente usado pelas páginas que você está visualizando.