Un widget nuevo no tiene nada que decir hasta que tiene registros, y esperar al primer webhook puede llevar horas. La importación por CSV lo resuelve: exporta los pedidos recientes desde donde estén, asigna unas cuantas columnas y súbelo en la pestaña Data del widget. Las filas importadas se muestran de inmediato como notificaciones con la etiqueta "Imported". Nunca pasan a ser "Verified", y la segunda mitad de este artículo explica por qué ese es el resultado correcto y no una limitación que haya que esquivar.
El archivo
Solo name es obligatorio. Todo lo demás es opcional y mejora la notificación cuando está.
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
| Columna | Notas |
|---|---|
name |
Obligatoria. Se muestra según tu ajuste de formato de nombre, así que los nombres completos están bien |
city, state |
Opcionales. state se usa en el formato "ciudad, estado" |
country |
Opcional, código ISO de dos letras |
product_name |
Opcional. Si falta, se usa el nombre de producto por defecto del widget |
price |
Texto libre opcional, por ejemplo $49 |
avatar_url |
Opcional. Solo se usa cuando el estilo de avatar es "image" |
occurred_at |
ISO 8601 opcional. Por defecto, la hora de la importación |
Los nombres de las cabeceras tienen que coincidir. Si tu exportación usa First Name y Last Name, combínalos en una sola columna name en la hoja de cálculo antes de guardar.
Qué pasa al importar
- Las filas se guardan con la fuente
csvyverified: false. - "Skip duplicates" ignora las filas cuyo nombre y ciudad coinciden con un registro existente con menos de una hora de diferencia. Actívalo cuando vuelvas a importar una exportación que se solape.
- Las filas más antiguas que tu ventana de antigüedad se guardan pero no se muestran. Aun así, aparecen en los conteos de la página de verificación.
- Las filas sin
occurred_attoman la hora de la importación, así que cien filas sin marca de tiempo parecen todas haber ocurrido ahora mismo. Incluye las horas reales.
Este último punto importa más de lo que parece. Un widget que muestra "Sarah M. compró hace 2 minutos" para un pedido de marzo está mintiendo sobre cuándo ocurrió, aunque el pedido fuera real. Exporta la columna de fecha y hora; todas las plataformas de comercio la tienen.
Cómo exportar desde las fuentes más comunes
- Shopify: Pedidos, Exportar. (En Shopify es mejor instalar la app de Provedly; importa automáticamente los últimos 60 días como registros verificados).
- WooCommerce: lista de pedidos, Exportar, o cualquier plugin de exportación de pedidos, y luego renombra las columnas.
- Stripe: Pagos, Exportar, y luego asigna el nombre del cliente, la ciudad y el país de facturación, la descripción y el importe. A partir de ahí, usa el webhook de Stripe para que los pedidos nuevos lleguen verificados.
- Una hoja de cálculo de reservas o registros: ya es un CSV. Añade
occurred_atsi lo tienes.
Por qué las filas importadas nunca son "Verified"
La marca de verificado de Provedly es una afirmación que puede defender: el registro llegó por un webhook firmado por Stripe, Shopify o WooCommerce con un secreto que solo tienen ellos y tú. Un CSV es un archivo que hiciste tú. Puede ser una exportación fiel de pedidos reales; puede ser una columna de nombres escritos a mano un martes por la tarde. Desde fuera, las dos cosas son idénticas, y Provedly se niega a responder por lo que no puede comprobar.
Así que la notificación lleva una etiqueta "Imported" visible que ningún ajuste, plan ni petición a soporte puede quitar, y la página de verificación pública enlazada desde cada insignia muestra csv como fuente junto a los conteos y la última compra verificada. Un visitante al que le importe puede ver exactamente qué proporción de lo que se le muestra está verificada. Una raíz SHA-256 cada noche sella el historial para que esa proporción no pueda ajustarse a posteriori.
Compáralo con la alternativa habitual. A octubre de 2026, según sus propios listados, la mayoría de las herramientas de notificaciones permiten a los comerciantes subir o escribir compras y presentarlas igual que las reales. La norma de la FTC sobre reseñas y testimonios falsos entró en vigor a finales de 2024, y aunque está redactada pensando en reseñas y no en notificaciones, el principio de no presentar actividad inventada como auténtica es el mismo. Las etiquetas son una forma barata de estar en el lado correcto.
Patrón práctico: importa una vez y luego automatiza
El uso sano del CSV es un relleno histórico único para que el widget no esté vacío el primer día, seguido de una fuente en vivo. En pocos días, la proporción verificada de tu página de verificación sube y las filas importadas salen de la ventana de antigüedad. Si te ves importando cada semana, lo que quieres es la Records API o un webhook.
Un plan aproximado para el día del lanzamiento:
- Exporta los pedidos de los últimos 30 días, conserva la columna de fecha y hora e importa con "Skip duplicates" desactivado.
- Conecta Stripe, Shopify o WooCommerce, o integra la Records API.
- Revisa la página de verificación a la mañana siguiente: las fuentes deberían mostrar tanto
csvcomo tu fuente en vivo, con una "última compra verificada" reciente.
Lo que puede salir mal
- No aparece nada tras importar. Revisa
occurred_at. Si todas las filas son más antiguas que la ventana de antigüedad, se guardan pero quedan ocultas. Acorta la ventana o importa pedidos más recientes. - Los nombres se ven raros. Tu exportación puso el nombre de la empresa en el campo del cliente. Limpia la columna; la notificación lo mostrará con el formato de nombre, así que "Acme GmbH" se convierte en "Acme G.".
- Todo dice el producto por defecto. La cabecera
product_nameestaba mal escrita o faltaba. - País incorrecto. La columna tenía nombres de país completos. Conviértelos a códigos ISO alfa-2.
Preguntas frecuentes
¿Hay un límite de filas?
Importa un periodo razonable, como los últimos 30 a 90 días. Las filas fuera de tu ventana de antigüedad se guardan pero nunca se muestran, así que importar años de historial solo infla los conteos sin cambiar lo que ven los visitantes.
¿Puedo marcar una fila importada como verificada si sé que es real?
No. Verificado significa webhook firmado, sin excepciones manuales. Esa regla es lo que hace que la marca valga algo para tus visitantes.
¿Los registros importados cuentan para mis impresiones?
Las impresiones se cuentan cuando se muestra una notificación, sea cual sea la fuente. Importar no consume impresiones por sí mismo.
La importación está disponible en todos los planes, incluido Free: crea un widget o lee la documentación.