Como importar pedidos antigos via CSV, e por que nunca são verificados

Um widget novo não tem nada a dizer até ter registros, e esperar o primeiro webhook pode levar horas. A importação por CSV resolve isso: exporte os pedidos recentes de onde quer que estejam, mapeie algumas colunas e faça o upload na aba Data do widget. As linhas importadas aparecem na hora como notificações com o rótulo "Imported". Elas nunca viram "Verified", e a segunda metade deste post explica por que esse é o resultado certo, e não uma limitação a contornar.

O arquivo

Só name é obrigatório. Todo o resto é opcional e melhora a notificação quando está presente.

name,city,state,country,product_name,price,avatar_url,occurred_at
Sarah Mitchell,Austin,TX,US,Pro Plan,$49,,2026-08-18T13:49:00Z
Hugo Martin,Paris,,FR,Annual Pass,€39,,2026-08-18T11:03:00Z
Yui Tanaka,Tokyo,,JP,Lifetime,,,2026-08-17T14:03:00Z

Os nomes do cabeçalho precisam ser exatos. Se a sua exportação usa First Name e Last Name, junte-os numa única coluna name na planilha antes de salvar.

O que acontece na importação

• As linhas são armazenadas com a fonte csv e verified: false.
• "Skip duplicates" ignora linhas cujo nome e cidade coincidem com um registro existente dentro de uma hora. Ative ao reimportar uma exportação que se sobrepõe à anterior.
• Linhas mais antigas que a sua janela de retroatividade são armazenadas, mas não exibidas. Elas continuam aparecendo nas contagens da página de verificação.
• Linhas sem occurred_at recebem o horário da importação, então cem linhas sem data e hora parecem todas ter acontecido agora há pouco. Informe os horários reais.

O último ponto importa mais do que parece. Um widget que mostra "Sarah M. comprou há 2 minutos" para um pedido feito em março está mentindo sobre o quão recente ele é, mesmo que o pedido tenha sido real. Exporte a coluna de data e hora; toda plataforma de e-commerce tem uma.

Exportando das fontes mais comuns

• Shopify: Orders, Export. (Na Shopify, o ideal é instalar o app da Provedly; ele importa automaticamente os últimos 60 dias como registros verificados.)
• WooCommerce: lista de pedidos, Export, ou qualquer plugin de exportação de pedidos, depois renomeie as colunas.
• Stripe: Payments, Export, depois mapeie nome do cliente, cidade e país de cobrança, descrição e valor. Daqui para a frente, use o webhook do Stripe para que os pedidos novos sejam verificados.
• Uma planilha de agendamentos ou cadastros: já é um CSV. Adicione occurred_at se tiver.

Por que linhas importadas nunca são "Verified"

A marca de verificado da Provedly é uma afirmação que ela consegue defender: o registro chegou por um webhook assinado pelo Stripe, pela Shopify ou pelo WooCommerce com um segredo que só eles e você têm. Um CSV é um arquivo que você fez. Pode ser uma exportação fiel de pedidos reais; pode ser uma coluna de nomes digitados numa terça à tarde. Vistos de fora, os dois são idênticos, e a Provedly se recusa a garantir o que não consegue conferir.

Por isso a notificação leva um rótulo "Imported" visível que nenhuma configuração, plano ou pedido ao suporte consegue remover, e a página de verificação pública, com link em todo selo, lista csv como fonte ao lado das contagens e da última compra verificada. Um visitante interessado pode ver exatamente que proporção do que lhe é mostrado é verificada. Uma raiz SHA-256 noturna sela o histórico para que a proporção não possa ser ajustada depois.

Compare com a alternativa comum. Em outubro de 2026, segundo as próprias listagens, a maioria das ferramentas de notificação deixa o lojista fazer upload ou digitar compras e as apresenta sem distinção das que acontecem ao vivo. A regra da FTC sobre avaliações e depoimentos falsos entrou em vigor no fim de 2024 e, embora tenha sido escrita em torno de avaliações e não de notificações, o princípio de não apresentar atividade fabricada como genuína é o mesmo. Rótulos são uma forma barata de ficar do lado certo dela.

Padrão prático: importe uma vez e depois automatize

O uso saudável do CSV é um preenchimento retroativo único para que o widget não fique vazio no primeiro dia, seguido de uma fonte ao vivo. Em poucos dias a fatia verificada na sua página de verificação sobe e as linhas importadas saem da janela de retroatividade. Se você se pegar importando toda semana, o que você quer é a Records API ou um webhook.

Um plano básico para o dia do lançamento:

1. Exporte os pedidos dos últimos 30 dias, mantenha a coluna de data e hora e importe com "Skip duplicates" desligado.
2. Conecte Stripe, Shopify ou WooCommerce, ou integre a Records API.
3. Confira a página de verificação na manhã seguinte: as fontes devem listar csv e a sua fonte ao vivo, com uma "última compra verificada" recente.

O que costuma dar errado

• Nada aparece depois da importação. Confira o occurred_at. Se todas as linhas forem mais antigas que a janela de retroatividade, elas estão armazenadas, mas ocultas. Encurte a janela ou importe pedidos mais recentes.
• Os nomes parecem estranhos. A sua exportação colocou o nome da empresa no campo do cliente. Limpe a coluna; a notificação vai exibi-la pelo formato de nome, então "Acme GmbH" vira "Acme G.".
• Tudo mostra o produto padrão. O cabeçalho product_name estava com erro de digitação ou faltando.
• País errado. A coluna tinha nomes de países por extenso. Converta para códigos ISO alpha-2.

Perguntas frequentes

Existe um limite de linhas?

Importe uma janela razoável, como os últimos 30 a 90 dias. Linhas fora da sua janela de retroatividade são armazenadas mas nunca exibidas, então importar anos de histórico só infla as contagens sem mudar o que os visitantes veem.

Posso marcar uma linha importada como verificada se sei que é real?

Não. Verificado significa webhook assinado, sem exceção manual. Essa regra é o que faz a marca valer alguma coisa para os seus visitantes.

Registros importados contam nas minhas impressões?

Impressões são contadas quando uma notificação é exibida, independentemente da fonte. Importar, por si só, não consome impressões.

A importação está disponível em todos os planos, inclusive no Free: crie um widget ou leia a documentação.