A Provedly é instalada no Webflow pela caixa Footer code nas Site settings, o que leva cerca de um minuto. O widget renderiza num Shadow DOM, então ignora as suas classes do Webflow, e as suas classes do Webflow o ignoram. A parte que exige reflexão são os dados: o Webflow Ecommerce não entrega um webhook do Stripe que você possa apontar para a Provedly, então os pedidos chegam ao widget pela Records API ou por CSV e recebem o rótulo "Imported".
Instale nas Site settings
- No painel da Provedly, crie um widget e copie o token.
- No Webflow, abra Site settings e depois Custom code.
- Cole a tag na caixa Footer code e publique.
<script
src="https://provedly.app/w/widget.js"
data-token="pp_your_token"
async
defer
></script>
O código personalizado exige um plano de site do Webflow; o domínio de staging grátis sem plano não o publica. Adicione tanto o seu domínio próprio quanto o seu domínio de staging webflow.io nos domínios permitidos do site na Provedly; caso contrário, o endpoint de configuração vai se recusar a responder no staging e você vai achar que a instalação falhou.
Se preferir manter o widget fora de certas páginas, não use código personalizado por página. Coloque a tag no site inteiro e configure a segmentação por URL na Provedly ("todas exceto" /checkout, /order-confirmation). Assim você mantém uma única fonte de verdade.
Conferindo a instalação
Publique, abra a URL de staging numa janela anônima e espere alguns segundos. Se nenhuma notificação aparecer, as causas comuns são, nesta ordem: o domínio não está nos domínios permitidos, o widget ainda não tem registros ou a página está excluída pela segmentação por URL. Um widget com zero registros não renderiza nada, então publique um registro de teste pela API ou importe um CSV curto antes de concluir que a instalação está quebrada.
Adicionando uma barra CTA
As barras usam um loader separado com o mesmo método de instalação:
<script
src="https://provedly.app/w/cta.js"
data-token="pp_your_bar_token"
async
defer
></script>
A posição fixa no topo fica acima da sua navbar do Webflow sem que você precise editar a navbar. Se a sua navegação é position: fixed, confira a pré-visualização num celular; talvez você queira mover a barra para baixo. Há três tipos de barra: uma contagem regressiva até uma data real num fuso horário que você escolhe, um timer evergreen que é por visitante e diz isso, e um contador que avança numa programação publicada. Veja recursos: barras e Contagens regressivas honestas.
Fazendo os pedidos chegarem
O Webflow Ecommerce processa os pagamentos pelo Stripe, mas a conta Stripe está conectada ao Webflow, e a fonte Stripe da Provedly precisa de um endpoint de webhook para checkout.session.completed registrado na sua própria conta Stripe. Até onde as configurações do Webflow permitem, isso não é algo que você consiga configurar no painel Ecommerce. Então as opções realistas são:
| Fonte | Como | Rótulo |
|---|---|---|
| Automação (Make, Zapier, n8n) em "novo pedido" | POST para a Records API | Imported |
| Webflow Logic ou uma pequena função serverless | POST para a Records API | Imported |
| Exportação periódica de pedidos | Importação por CSV | Imported |
| O seu próprio Stripe Checkout fora do Webflow Ecommerce | Webhook do Stripe | Verified |
Uma chamada à Records API a partir de uma automação fica assim:
POST /api/v1/widgets/pp_your_token/records
Authorization: Bearer <widget api key>
Content-Type: application/json
{
"name": "{{customer name}}",
"city": "{{shipping city}}",
"country": "{{shipping country code}}",
"product_name": "{{first item name}}",
"price": "{{formatted total}}",
"external_id": "{{order id}}"
}
Envie external_id para que uma execução repetida da automação não crie um duplicado; a segunda tentativa retorna 422. O endpoint está documentado em /docs#api.
Se você vende por um site Webflow mas cobra pelos seus próprios links do Stripe Checkout ou por um formulário separado ligado ao Stripe, você mesmo pode registrar o webhook, e essas compras vão ser marcadas como verificadas. Webhooks do Stripe para compras verificadas explica como.
Por que Imported não é um rebaixamento
Dá vontade de ver "Imported" como um selo inferior. É um rótulo sobre procedência, não sobre qualidade. A Provedly não consegue confirmar criptograficamente o POST de uma automação do jeito que confirma um evento assinado do Stripe, então ela diz exatamente isso ao visitante. Todo selo leva a uma página de verificação pública que lista as fontes do widget, as contagens, a última compra verificada e a política de honestidade. Uma loja Webflow com registros Imported honestos e um contador ao vivo real está numa posição mais forte do que uma loja rodando um widget em que o lojista digitou "47 pessoas vendo" num campo de texto, o que a maioria das ferramentas concorrentes permite em outubro de 2026, segundo as próprias listagens.
Contador ao vivo no Webflow
O contador ao vivo não precisa de configuração extra. Ele conta os visitantes que estiveram com a página aberta nos últimos 90 segundos, com base num sinal enviado a cada 30 segundos, e se esconde abaixo do mínimo que você define em vez de mostrar um número lisonjeiro. Para um site de portfólio ou de agência com tráfego modesto, isso muitas vezes significa que o contador aparece durante campanhas e some discretamente no resto do tempo. Esse é o comportamento correto.
Design nos termos do Webflow
Você não consegue estilizar o widget com classes do Webflow, e não precisa. Escolha um tema no painel: Clean white para a maioria dos templates claros do Webflow, Midnight ou Deep ocean para os escuros, Electric violet ou Sunset blaze quando a marca é chamativa. Os formatos de nome e localização vêm por padrão como "Sarah M." e "Austin, US". Leia Como escolher um tema de notificação que combine com sua marca para entender o raciocínio.
Perguntas frequentes
O widget funciona na pré-visualização do Webflow Designer?
Não. O código personalizado nas Site settings só roda no site publicado. Publique no staging, adicione o domínio de staging aos domínios permitidos e teste lá.
Posso mostrar o widget só na página de preços?
Sim. Instale no site inteiro e use a segmentação por URL em "só estas" com /pricing. Não precisa de código por página.
O plano Free cobre um site Webflow?
Sim. O Free inclui um site, um widget, uma barra e 2.000 impressões por mês (cerca de 700 visitas, a aproximadamente 3 notificações por visita), com o selo "by Provedly" visível.
Instale em um minuto e veja a sua primeira notificação real: comece agora.