Ir para conteúdo principal

Avançado: definir a posição da caixa de chat via API JavaScript

Gerir a posição da caixa de chat no seu código, incluindo opções diferentes para computador e dispositivo móvel.

Escrito por Michal Jindra

Os programadores podem personalizar exatamente onde a caixa de chat aparece, adicionando opções de configuração ao código de instalação do Smartsupp. Este guia explica como posicionar a caixa de chat à esquerda, alterar a sua distância em relação à posição padrão e definir uma posição distinta em dispositivos móveis.

Avançado: ajustar a posição no código de instalação

🟡 Nota: É necessário ter acesso de programador ao código do site. Para mover a caixa de chat para a esquerda, é preciso ter o plano Solo ou superior.

Adicione estas opções na secção de configuração do script de instalação: logo depois da linha com _smartsupp.key e antes do loader (a parte que começa por window.smartsupp||). A caixa de chat irá ler estas definições ao iniciar, pelo que devem ser declaradas antes de o loader ser executado.

Para posicionar a caixa de chat à esquerda:

<script>var _smartsupp = _smartsupp || {};_smartsupp.key = 'YOUR_SMARTSUPP_KEY';_smartsupp.orientation = "left";// ...restante código de instalação (loader)</script>

Para afastar a caixa de chat da posição padrão (valores em píxeis):

_smartsupp.offsetX = 20;  // distância da margem lateral _smartsupp.offsetY = 100; // distância do fundo

Para utilizar uma posição diferente apenas em dispositivos móveis:

<script>var _smartsupp = _smartsupp || {};_smartsupp.key = 'YOUR_SMARTSUPP_KEY';if (window.innerWidth < 768) {  _smartsupp.offsetY = 150;}// ...restante código de instalação (loader)</script>

Para aplicar estas definições:

  1. Abra o código do seu site e localize o script de instalação do Smartsupp.

  2. Adicione as opções desejadas logo após a linha _smartsupp.key, antes do loader.

  3. Ajuste os valores segundo o design pretendido.

  4. Guarde as alterações e abra o site numa janela anónima ou privada para verificar a nova posição. Teste também a versão móvel num telemóvel.

💡 Dica: Comandos como smartsupp('chat:position', ...) não são suportados. Estes comandos não têm qualquer efeito e verá "Unknown API command" na consola do navegador. Consulte todas as opções de configuração na documentação para programadores.


Próximos passos

💡 Precisa de ajuda adicional? Entre em contacto com a equipa de suporte — estamos disponíveis para ajudar!

Isto respondeu à sua pergunta?