Pop-ups e tours no WordPress, Webflow, Shopify e outros construtores
Quer um pop-up na loja, um tooltip na página de preços ou um tour para membros? Todo construtor popular tem um campo de código para o head do site inteiro: cole a linha do Clew ali uma vez e crie cada formato no editor do Clew.
- Tempo
- ● 5 minutos
- Quem faz
- Administrador do site
- Passos
- 6
Passo a passo
- Passo 01
Copie seu código no Clew
Cadastre-se ou entre no Clew e abra Admin → Visão geral. O cartão “O widget ainda não deu sinal.” mostra a linha com a chave real: clique para copiar.
<!-- Clew: troque COLE_AQUI_SUA_CHAVE pela chave do site em Admin > Visão geral --> <script src="https://tryclew.io/widget/COLE_AQUI_SUA_CHAVE.js" async></script>
Passo 1 · ilustração esquemática - Passo 02
Encontre o campo de código do head do site inteiro
Procure uma configuração chamada Custom code, Code injection ou Header que valha para o site inteiro, e não para uma página só. O caminho exato de cada plataforma está na tabela abaixo.
Passo 2 · ilustração esquemática - Passo 03
Cole a linha no head
Cole a linha no campo do head — não no body e não numa página só. Se já houver outros scripts, como analytics, adicione o Clew numa linha nova; a ordem não importa.
Passo 3 · ilustração esquemática - Passo 04
Salve e publique
Salve a configuração. No Webflow, no Framer e no Tilda o código só chega ao site no ar depois de publicar de novo; no WordPress, Shopify, Wix e Squarespace basta salvar.
Passo 4 · ilustração esquemática - Passo 05
Limpe o cache
Se o site usa plugin de cache ou CDN (WP Rocket, LiteSpeed Cache, W3 Total Cache, Cloudflare), limpe o cache para os visitantes receberem as páginas com a nova linha. Plugins que atrasam ou combinam JavaScript devem excluir
tryclew.io/widget.
Passo 5 · ilustração esquemática - Passo 06
Confirme que funciona
Abra qualquer página do site publicado numa janela normal e volte para Admin → Visão geral no Clew. Em até um minuto o cartão fica verde: “O widget está no ar.”
Passo 6 · ilustração esquemática
Caminhos exatos por plataforma
Os nomes dos menus estão em inglês, como nas ilustrações; com a plataforma em português, o caminho é o mesmo.
| Plataforma | Onde colar | Observação |
|---|---|---|
| WordPress | Instale o plugin gratuito WPCode → Code Snippets → Header & Footer → Header → Save Changes | Ou a opção de “scripts no cabeçalho” do seu tema. Não edite arquivos do tema: as atualizações sobrescrevem. No WordPress.com, plugins exigem o plano Business ou superior. |
| Webflow | Site settings → Custom code → Head code → Save e depois Publish | Código personalizado exige um Site plan pago. |
| Shopify | Online Store → Themes → … → Edit code → layout/theme.liquid, logo antes de </head> → Save | Vale para a loja. Repita se trocar de tema. |
| Wix | Settings → Custom code → + Add Custom Code → All pages, Load code once, Head → Apply | Exige plano Premium e domínio conectado. |
| Squarespace | Settings → Developer tools → Code injection (em sites antigos: Advanced) → Header → Save | A injeção de código não está no plano mais barato. |
| Framer | Site settings → Custom code → End of <head> tag → Save e depois Publish | Código personalizado exige plano pago. |
| Tilda | Site Settings → More → HTML code for the HEAD section → Edit code → Save e depois Publish all pages | Exige plano Personal ou Business. |
| HTML simples | Antes de </head> em cada página, ou uma vez no cabeçalho compartilhado | Envie os arquivos alterados para a hospedagem. |
Site institucional ou produto?
Os tours ajudam mais dentro do produto em que as pessoas fazem login. Se o site institucional está no Webflow, mas o app é sob medida, instale o Clew no app: veja o guia para assistentes de IA ou o de Google Tag Manager.
Problemas comuns e perguntas
Dá para colocar só em algumas páginas?
Coloque no site inteiro. Em quais páginas e para quem um tour aparece é configurado no Clew, então você não precisa voltar às configurações do site.
Meu plano não tem campo de código personalizado
Webflow, Framer, Wix e Squarespace só permitem scripts de terceiros em planos pagos, e não existe alternativa suportada. Mude de plano ou instale o Clew direto no produto.
O painel continua dizendo “O widget ainda não deu sinal.”
Abra uma página do site publicado numa janela normal do navegador e recarregue o painel depois de um minuto. Se nada mudar: confira se a alteração foi publicada, e não só salva; se o marcador foi trocado pela sua chave real; e nas ferramentas de desenvolvedor do navegador, aba Network, procure widget/…js — a resposta deve ser 200. Um 404 indica chave errada.
Meu site tem Content Security Policy
Duas diretivas e nada mais: script-src https://tryclew.io e connect-src https://tryclew.io. O widget não usa eval, nem URL blob:, nem workers, e instala a folha de estilos por CSSOM em vez de como marcação — então style-src 'unsafe-inline' não é necessário no Chrome, Edge, Firefox 101+ ou Safari 16.4+. Navegadores mais antigos recebem um elemento <style> de reserva: se você ainda os suporta e seu style-src não tem 'unsafe-inline', lá os tours aparecem sem estilo. Para copiar e colar: Content-Security-Policy: script-src 'self' https://tryclew.io; connect-src 'self' https://tryclew.io;
Posso fixar a versão do widget e usar <code>integrity=</code>?
Sim. A linha dos guias — /widget/COLE_AQUI_SUA_CHAVE.js — é a contínua: serve sempre o widget atual e, por isso, não pode levar um hash de Subresource Integrity (os bytes mudam). Ao lado dela, cada versão também é servida em um endereço imutável com hash do conteúdo. Consulte https://tryclew.io/api/v1/widget-version?site=SUA_CHAVE e você recebe version, path e integrity; coloque-os na tag: <script src="https://tryclew.io/widget/v/<versao>/SUA_CHAVE.js" integrity="sha384-…" crossorigin="anonymous" async></script>. Uma URL fixada nunca muda, então o navegador recusa o arquivo se um único byte for diferente. Você atualiza a versão quando quiser — consulte o mesmo endpoint no seu script de deploy. Nada mais muda: os tours continuam sendo publicados no editor do Clew sem mexer no site.
Um bloqueador de anúncios come o widget?
Não. Nosso domínio não está em nenhuma das listas grandes — EasyList, EasyPrivacy, AdGuard, uBlock Origin — então os tours, as dicas e as checklists aparecem também para quem usa um bloqueador. O delicado são as estatísticas: o EasyPrivacy bloqueia toda requisição ping de terceiros, por isso o widget envia os eventos como uma requisição comum, que essas listas deixam passar. Para ficar fora do alcance de qualquer lista personalizada, sirva o widget do seu próprio domínio: aponte https://seu-site/clew/* para https://tryclew.io/* no CDN ou no nginx e troque a linha por <script src="/clew/widget/SUA_CHAVE.js" async></script>. O widget passa a consultar a API com o mesmo prefixo e tudo vira first-party.
Funciona em SPA (React, Vue, Next.js)?
Sim. Carregue a linha uma vez, no HTML raiz ou no layout raiz. O widget acompanha sozinho as mudanças de rota no cliente (History API e mudanças de hash), então não adicione por rota nem dispare com um acionador “History Change”: uma segunda cópia é ignorada, mas é trabalho à toa.
E o banner de consentimento de cookies?
O Clew guarda um cookie próprio e registros no localStorage para lembrar quais tours cada visitante concluiu e contar as conclusões. Nenhum dado vai para redes de anúncios. Se ele pode rodar antes do consentimento é decisão da sua política de privacidade (por exemplo, pela LGPD); se a sua ferramenta de consentimento bloquear até o aceite, os tours simplesmente começam depois.
Uso um plugin de cache ou otimização
Limpe o cache depois de instalar; senão os visitantes continuam recebendo páginas antigas sem a linha. Se o plugin atrasa, combina ou adia JavaScript (WP Rocket, LiteSpeed Cache, Autoptimize, Cloudflare Rocket Loader), exclua tryclew.io/widget dessas otimizações.
O site vai ficar mais lento?
Não. A linha tem async: o navegador baixa o widget em paralelo e o executa sem travar a página. O widget não tem dependências.
Meu app pode avisar o Clew de que um passo do onboarding foi concluído?
Pode, e é uma linha só. Um item do checklist pode ter uma regra que o marca sem o visitante clicar em nada: uma página que ele acessa, um clique num elemento que você indica com um seletor CSS, ou um evento disparado pelo seu próprio código — Clew.complete('invited'), em que invited é a chave que você digitou ao lado do item no editor. Chame no momento em que a tarefa foi mesmo concluída, por exemplo depois de a sua API confirmar o convite. É seguro chamar a qualquer hora e devolve false quando não há nenhum checklist com essa chave na página. O nome antigo TutorKit continua funcionando.
Outras formas de instalar
Google Tag Manager
Tag de HTML personalizado em todas as páginas, conferência na visualização e publicação. Para sites que já usam GTM.
Abrir guia →Vibe codingAssistentes de IA para programar
Um prompt para Claude Code, Cursor, Lovable, Bolt.new, v0 e Replit que coloca a linha no arquivo raiz certo.
Abrir guia →