Como Adicionar o Chatbot IA Asyntai ao Bagisto

Guia passo a passo para a plataforma de e-commerce Bagisto

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 de Layout Blade (Recomendado)

O Bagisto usa templates Laravel Blade. A abordagem recomendada é adicionar o código de incorporação diretamente ao arquivo de layout da loja:

Abra o arquivo de layout da loja:
- Código-fonte do pacote: packages/Webkul/Shop/src/Resources/views/layouts/master.blade.php
- Versão publicada: resources/views/vendor/shop/layouts/master.blade.php (se você publicou as views)
Encontre a tag de fechamento </body>
Adicione o código de incorporação logo antes de </body>, após @stack('scripts'):

@stack('scripts')
<script async src="https://asyntai.com/static/js/chat-widget.js" data-asyntai-id="YOUR_WIDGET_ID"></script>
</body>

Dica: Se você publicou as views do vendor, edite a versão publicada em resources/views/vendor/shop/. Caso contrário, publique-as primeiro com php artisan vendor:publish --tag=shop-views para evitar perder as alterações durante atualizações de pacotes.

Método Alternativo 1: Usando @push('scripts') em uma View

Em qualquer view ou componente Blade, você pode usar a pilha de scripts para injetar o script do chatbot:

@push('scripts')
    <script async src="https://asyntai.com/static/js/chat-widget.js" data-asyntai-id="YOUR_WIDGET_ID"></script>
@endpush

Nota: Este método requer que @stack('scripts') esteja presente no arquivo de layout principal. Ele é incluído por padrão no layout do Bagisto.

Método Alternativo 2: Usando um Service Provider

Você pode usar um service provider para disponibilizar o script em todas as views programaticamente. Crie um service provider personalizado ou use o AppServiceProvider:

public function boot()
{
    view()->composer('shop::layouts.master', function ($view) {
        // The script will be available in the layout
    });
}

Ou crie um componente Blade que renderiza a tag de script e inclua-o no seu layout.

Dica: A abordagem de service provider é útil se você deseja carregar o chatbot condicionalmente com base em valores de configuração ou configurações de ambiente.

Método Alternativo 3: Usando o Sistema de Eventos do Bagisto

O Bagisto dispara eventos de view em vários pontos do layout. Você pode ouvir bagisto.shop.layout.body.after para injetar o script do chatbot:

Event::listen('bagisto.shop.layout.body.after', function($viewRenderEventManager) {
    $viewRenderEventManager->addTemplate('shop::partials.asyntai-widget');
});

Em seguida, crie o template parcial em packages/Webkul/Shop/src/Resources/views/partials/asyntai-widget.blade.php (ou o equivalente publicado) com seu código de incorporação:

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

Nota: A abordagem do sistema de eventos mantém suas alterações modulares e separadas dos arquivos de layout principais, facilitando o gerenciamento durante atualizações do Bagisto.

Etapa 3: Limpar Cache e Verificar

Após adicionar o código de incorporação, limpe o cache da aplicação para garantir que suas alterações tenham efeito:

php artisan cache:clear && php artisan view:clear

Visite sua loja Bagisto 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 executado tanto php artisan cache:clear quanto php artisan view:clear. Também tente limpar o cache do navegador ou visualizar em uma janela anônima. Se você editou o código-fonte do pacote diretamente, verifique se nenhuma view publicada está sobrescrevendo suas alterações. Confirme se o código de incorporação está posicionado corretamente antes da tag de fechamento </body>.