{"section":"tutorials","requestedLocale":"pt","requestedSlug":"configurar-o-shopping-assistant","locale":"pt","slug":"configurar-o-shopping-assistant","path":"docs/pt/tutorials/vtex-cx-platform/integrações/configurar-o-shopping-assistant.md","branch":"main","content":"O Shopping Assistant é o canal de web chat do VTEX CX Platform que permite atender os visitantes do seu site com um agente de IA. Você personaliza o visual e o comportamento do widget e, em seguida, instala o chat no site com um script gerado pela plataforma.\n\nEste tutorial explica como acessar o canal, personalizar a aparência, configurar as preferências e instalar o script no site.\n\n## Instalar o aplicativo\n\nPara instalar o aplicativo na sua loja, siga os passos a seguir:\n\n1. No projeto desejado, acesse **Configurações > Canais**.\n2. Clique na aba **Descoberta**.\n3. Digite **Shopping Assistant** no campo de busca ou procure pelo card do aplicativo.\n4. Clique no botão de <i class=\"fas fa-plus\" aria-hidden=\"true\"></i> para adicionar o aplicativo ao seu projeto.\n\n## Acessar o aplicativo\n\nPara abrir as configurações do Shopping Assistant, siga os passos a seguir:\n\n1. No projeto, acesse **Configurações > Canais**.\n2. Clique na aba **Meus aplicativos**.\n3. Na seção **Aplicativos instalados**, clique no card **Shopping Assistant** que deseja configurar.\n\nAo clicar no card, a janela de configuração do **Shopping Assistant** é aberta, com as abas **Aparência**, **Preferências** e **Código Script**. Uma prévia do widget é exibida para você conferir o resultado das alterações.\n\n## Personalizar o aplicativo\n\nVocê pode personalizar o Shopping Assistant do seu projeto, modificando a aparência e as funcionalidades do agente.\n\n### Aparência\n\nA aba **Aparência** define o visual do widget de chat. Nela, você pode configurar os seguintes campos:\n\n- **Título do chat**: nome exibido no cabeçalho do widget.\n  - Ao clicar em <i class=\"fas fa-plus\" aria-hidden=\"true\"></i>`Mais`, você pode adicionar campos opcionais:\n    - **Subtítulo do chat:** texto que fica abaixo do título.\n    - **Mensagem de notificação do chat:** mensagem que aparece na notificação do chatbot.\n    - **Texto do placeholder:** placeholder do campo de mensagem.\n- **Cor principal:** cor principal do chat.\n- **Imagem do avatar:** avatar do agente no chat.\n- **CSS customizado:** envie um arquivo CSS para aplicar estilos próprios ao widget.\n\n### Preferências\n\nA aba **Preferências** define o comportamento do chat. Nela, você pode configurar os seguintes campos:\n\n| Seção | Funcionalidade | Descrição |\n| --- | --- | --- |\n| **Comportamento** | Modo incorporado | Ative esse botão para exibir o chat incorporado na página da loja. Se preferir o chat como uma janela flutuante, desligue o botão. |\n| **Comportamento** | Mostrar botão de tela cheia | Exibe um botão que permite ao usuário expandir o chat para tela cheia. |\n| **Comportamento** | Iniciar chat em tela cheia | Abre o chat diretamente em tela cheia quando o usuário inicia uma conversa. |\n| **Comportamento** | Indicador de mensagens não lidas | Exibe um indicador visual quando há mensagens não lidas pelo usuário. |\n| **Comportamento** | Usar otimização de conexão | Ative esse botão para conectar o chat com o Socket apenas quando o usuário abre um chat ou quando a última mensagem do usuário tiver sido enviada há menos de 24 horas (tempo de inicialização automática do Socket). Se preferir que o chat conecte-se automaticamente com o Socket, desligue o botão. |\n| **Varejo** | Perguntas sugeridas por IA (Novo) | Exibe botões de interação rápida na página do produto. A IA analisa o SKU para sugerir automaticamente as perguntas mais relevantes dos clientes. |\n| **Varejo** | Permitir que o Shopping Assistant redirecione automaticamente a página **(Beta)** | Permite que o Shopping Assistant redirecione automaticamente o usuário para outra página quando um link é enviado durante a conversa. Esta funcionalidade está atualmente em beta e pode mudar. |\n| **Varejo** | Adicionar ao carrinho da loja **(Beta)** | Permite que os usuários adicionem produtos sugeridos pela IA diretamente ao carrinho nativo da loja, em vez de usar um carrinho gerenciado pelo Shopping Assistant. Recomendado para lojas com carrinho ou fluxos de checkout personalizados. Esta funcionalidade está atualmente em beta e pode mudar. |\n| **Mídia** | Mostrar botão de gravação de voz | Exibe um botão que permite ao usuário enviar mensagens de voz no chat. |\n| **Mídia** | Mostrar botão de câmera | Exibe um botão que permite ao usuário enviar imagens no chat. |\n| **Histórico de chats e inatividade** | Manter histórico de mensagens | Preserva o histórico de mensagens da conversa entre sessões do usuário. |\n| **Histórico de chats e inatividade** | Reiniciar conversa por inatividade do contato | Reinicia a conversa automaticamente após um período de inatividade do usuário. Quando habilitado, você pode delimitar esse período de inatividade no campo seguinte, no formato HH:mm. |\n| **Histórico de chats e inatividade** | Tempo entre as mensagens | Define o intervalo entre mensagens enviadas pelo agente. |\n\n### Código Script\n\nA aba **Código Script** gera o código para instalar o Shopping Assistant no site. Para instalar o chat, siga os passos a seguir:\n\n1. Após finalizar as configurações do Shopping Assistant, clique em `Salvar alteraçõe`. Isso gera o código script com suas preferências salvas.\n2. Clique na aba **Código Script**.\n3. Copie o código exibido ou clique em `Baixar script`.\n4. No código do seu site, cole esse script acima da última tag `</body>`."}