Como Adicionar o Chatbot de IA Asyntai ao Umbraco
Guia passo a passo para sites Umbraco CMS
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: Editar o Template Master (Recomendado)
A maneira mais fácil de adicionar o chatbot a todas as páginas éeditando o seu template Master:
- Faça login no seu Umbraco Backoffice
- Acesse Settings na barra lateral esquerda
- Expanda Templates
- Clique no seu template Master (ou no template de layout principal que seu site utiliza)
- Encontre a tag de fechamento
</body> - Cole seu código de incorporação Asyntai logo antes da tag
</body> - Clique em "Save"
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.
Alternativa: Usando Document Type de Configurações do Site
Para mais flexibilidade, você pode adicionar um campo personalizadopara gerenciar scripts do rodapé:
- Vá para Settings → Document Types
- Edite o document type Site Settings (ou crie um senão existir)
- Adicione uma nova propriedade chamada "Footer Scripts" com o tipo de dados Textarea
- Salve o Document Type
- Vá para Content e edite o nó de Site Settings
- Cole o código de incorporação do Asyntai no campo Footer Scripts
- No seu template Master, adicione este código antes de
</body>:@Html.Raw(Model.Value("footerScripts")) - Salve tanto o conteúdo quanto o template
Nota: Usar @Html.Raw() é importante para renderizar as tags de script corretamente sem codificação HTML.
Alternativa: Usando a Pasta de Scripts
Você também pode criar um arquivo JavaScript no Umbraco Backoffice:
- Vá para Settings → Scripts
- Clique com o botão direito em Scripts e selecione"Create"
- Crie um novo arquivo chamado asyntai-chatbot.js
- Adicione o seguinte codigo:
(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);
})(); - Substitua
YOUR_WIDGET_IDpelo seu ID de widget real - Salve o arquivo
- Inclua este script no seu template Master antes de
</body>:<script src="/scripts/asyntai-chatbot.js"></script>
Alternativa: Página Específica com RenderSection
Se voce deseja o chatbot apenas em paginas especificas:
- No seu template Master, adicione antes de
</body>:@RenderSection("footerScripts", required: false) - No template da página específica onde deseja o chatbot, adicione:
@section footerScripts {
<script async src="https://asyntai.com/static/js/chat-widget.js" data-asyntai-id="YOUR_WIDGET_ID"></script>
}
Passo 3: Verifique a Instalação
Após salvar suas alterações, visite seu site em uma nova aba do navegador ou em uma 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 o template após fazer as alterações. Tente limpar o cache do navegador ou visualizar em uma janelaanônima. Se estiver usando o Umbraco Cloud, as alterações devem ser implantadas automaticamente. Para Umbraco auto-hospedado, pode ser necessário reiniciar a aplicação ou limpar o cache.
Weebly