Documentación

Si usas la app de Provedly para Shopify, no instales nada: el app embed del tema lo carga todo. El Plugin de WordPress sigue funcionando tal cual.

El snippet del sitio cubre casi todos los casos. Cada widget y cada barra también tiene su propia etiqueta, en Advanced dentro de su pestaña Embed, para dos situaciones: una barra en línea que debe mostrarse en un punto exacto de la página (aparece donde pegas su etiqueta) y los creadores de páginas que solo aceptan código por bloque. Una página con ambos tipos de etiquetas nunca carga un elemento dos veces.

El endpoint de configuración solo responde a los dominios que figuran en el sitio. Los subdominios están incluidos, así que example.com cubre shop.example.com. Añade los hosts de pruebas de forma explícita. Dejar la lista vacía permite cualquier dominio, algo que no recomendamos.

1. El snippet del sitio hace una sola petición, GET https://provedly.app/api/s/{site key}/manifest, que devuelve cada widget y barra activos con sus ajustes y hasta 30 registros recientes por widget, además de la versión actual del código.
2. Después carga el código del widget y el de la barra, solo si la página los necesita. Ambos son archivos versionados que tu navegador guarda en caché hasta la siguiente versión.
3. El ciclo de notificaciones empieza después del retraso inicial que hayas fijado. Cada notificación mostrada envía una impresión a /track.
4. Mientras la pestaña está abierta, un latido llama a /presence cada 30 segundos para el contador en vivo.

Añade un elemento donde quieras que aparezca el número, por ejemplo bajo el título del producto o el botón Añadir al carrito. En Shopify, usa un bloque Custom liquid en el editor del tema. El snippet del sitio lo rellena con el mismo número real que la notificación (visitantes vistos en los últimos 90 segundos) y lo oculta por debajo de tu mínimo.

<div data-provedly-live data-template="{n} people are viewing this product right now"></div>

Añade data-style="card" para una versión en tarjeta con el número grande y un enlace Verify a tu página de verificación, o data-dot="off" para quitar el punto. Si hay varios widgets en una página, pon el token de un widget en el atributo (data-provedly-live="pp_…") para elegir uno.

Vídeos paso a paso: cualquier sitio web o WordPress y Shopify.

• Las claves empiezan por provedly_ y pertenecen al espacio de trabajo, no a un widget concreto.
• La clave se muestra una sola vez, al crearla. Solo guardamos un hash, así que cópiala enseguida.
• Revoca una clave cuando quieras desde la misma página. Las peticiones con una clave revocada reciben un 401.

Los widgets y las barras aceptan su id (un UUID) o su token. Los sitios aceptan su id o su dominio.

Las barras nuevas se crean en pausa. Actívala con PATCH /bars/{bar} {"status": "active"}.

Las lecturas devuelven los mismos campos, así que puedes leer un widget o una barra, cambiar un valor y enviarlo de vuelta. Las reglas de URL aceptan una lista de rutas o una ruta por línea. Si el cambio coloca dos elementos activos en el mismo sitio de las mismas páginas, la respuesta incluye una entrada warnings.

La marca, la página pública de verificación, los registros de ejemplo y el diseño detallado se gestionan en el panel.

Impresiones y clics de widgets y barras, pedidos e ingresos verificados, pedidos e ingresos asistidos por la prueba, y un desglose por widget para el número de días elegido.

{ "error": "...", "message": "..." }

401  missing or invalid key
403  read-only key used for a change
404  not in this workspace
422  refused: validation, plan limit, or an ended or archived bar

Cada clave puede hacer 120 peticiones por minuto.

get_account, list_sites, list_widgets, list_bars, get_stats, set_widget_status, update_widget, set_bar_status, create_bar, update_bar, add_record, get_install_snippet.

• Se aplican los mismos límites del plan que en el panel.
• Las barras que crea un asistente empiezan en pausa hasta que pidas activarlas.
• Una clave de solo lectura no puede cambiar nada.
• Los registros añadidos con la API o MCP nunca se marcan como verificados. Solo lo son los webhooks firmados de Stripe, Shopify y WooCommerce.

• «¿Cuántas impresiones y pedidos verificados tuvieron mis widgets en los últimos 7 días?»
• «Crea una barra de cuenta regresiva en example.com para las rebajas de invierno que terminan el 1 de diciembre a las 9:00, hora de Nueva York.»
• «Pausa todos los widgets de mi sitio de pruebas.»
• «Dame el código de instalación de mi tienda.»

Solo las cifras de ese espacio de trabajo. El parámetro tz es opcional.

Los campos de serie incluyen today, yesterday, change_pct, last_7d, last_30d, total, trend_24h, trend_7d, trend_30d.

Las cifras se recalculan como máximo una vez por minuto. Cada clave puede hacer 60 peticiones por minuto.

201 Created
{ "id": 812, "hash": "9c1e0b7a…", "verified": false, "occurred_at": "2026-10-15T14:03:00+00:00" }

401 Unauthorized   wrong or missing bearer key
422 Unprocessable  validation errors, including a duplicate external_id

El widget muestra los registros de la API, pero nunca los marca como verificados. La marca de verificado está reservada a los webhooks firmados. Consulta Webhooks.

• Fila de encabezado obligatoria, columnas en cualquier orden, las columnas extra se ignoran.
• Fechas en ISO 8601. Si falta la fecha, se usa la hora de la importación.
• "Skip duplicates" ignora las filas cuyo nombre y ciudad coinciden con un registro existente en menos de una hora.
• Las filas importadas tienen el origen csv y no están verificadas. Las filas más antiguas que tu ventana de antigüedad se guardan, pero no se muestran.

1. En la pestaña Data del widget, añade una fuente de Stripe. Copia la URL del endpoint:

https://provedly.app/api/hooks/stripe/pp_your_widget_token

2. En Stripe, ve a Developers, Webhooks, Add endpoint. Pega la URL y selecciona los eventos que envía tu checkout: checkout.session.completed para pagos únicos con Checkout, invoice.paid para suscripciones y payment_intent.succeeded solo si cobras con Payment Intents sin Checkout. Una compra se registra una sola vez aunque se disparen varios de ellos.
3. Copia el secreto de firma (whsec_…) en el campo de secreto de la fuente en Provedly.
4. Envía un evento de prueba desde Stripe. La fuente muestra "last event" en pocos segundos.

Leemos el nombre del cliente, el país y la ciudad de envío o facturación cuando existen, la primera línea del pedido como producto y el total formateado como precio.

1. Instala Provedly desde la Shopify App Store (ficha disponible pronto).
2. En la página de inicio de la app, haz clic en "Open theme editor", comprueba que el app embed de Provedly está activado y guarda. Sin código ni etiqueta script.
3. Los pedidos se convierten en registros verificados automáticamente: se importan los últimos 60 días al instalar y cada pedido nuevo llega mediante un webhook firmado.

La app funciona dentro de tu admin de Shopify con las mismas herramientas de diseño, datos y analítica que este panel. Los planes se cobran a través de Shopify en tu factura habitual; el plan Free no necesita método de pago. Los nombres y ciudades de los compradores solo aparecen cuando Shopify aprueba el acceso de la app a los datos de clientes; hasta entonces las notificaciones dicen "Someone just purchased…".

1. Añade una fuente de Shopify en la pestaña Data y copia la URL:

https://provedly.app/api/hooks/shopify/pp_your_widget_token

2. En el admin de Shopify, ve a Settings, Notifications, Webhooks y crea un webhook para Order payment (orders/paid), formato JSON, con esa URL. Order creation también funciona si quieres incluir pedidos no pagados; el mismo pedido nunca se registra dos veces.
3. Copia el secreto compartido que aparece bajo la lista de webhooks en el campo de secreto de la fuente.

Las cargas se verifican con la cabecera HMAC-SHA256. Si la comprobación falla, se registra y se descarta. Sin secreto, los eventos se aceptan pero aparecen como "No signing secret set" en tu panel y no se marcan como verificados.

1. Añade una fuente de WooCommerce en la pestaña Data, copia la URL y elige un secreto de firma (cualquier texto de 8 caracteres o más):

https://provedly.app/api/hooks/woocommerce/pp_your_widget_token

2. Con el plugin: instala Provedly desde WordPress.org (Plugins, Add New, busca "Provedly"), abre Provedly en el menú de administración, pega el token del widget, la URL y el secreto, y guarda. El plugin imprime las etiquetas script, crea el webhook de WooCommerce y pasa el id del visitante a cada pedido para la atribución.
3. Manualmente: WooCommerce, Settings, Advanced, Webhooks, Add webhook. Tema Order updated, la URL de entrega de arriba, el mismo secreto, versión de API WP REST API v3.

WooCommerce firma cada envío con HMAC-SHA256 en X-WC-Webhook-Signature. Solo los pedidos en Processing o Completed se convierten en registros, una vez cada uno, así que los pedidos pendientes, fallidos o cancelados nunca aparecen.

El panel cuenta un pedido como asistido por la prueba solo cuando el comprador llevaba un id de visitante que vio una notificación del mismo widget en los 30 días anteriores a la compra. No se estima nada. En las tiendas Shopify que usan la app es automático: el widget escribe el id de visitante en el carrito como el atributo provedly_visitor y el webhook del pedido lo lee de vuelta.

En cualquier otro caso, reenvía tú mismo el id de visitante. El widget lo guarda en la cookie propia pv_vid y lo expone como window.Provedly.visitorId().

• Stripe: define metadata.provedly_visitor en la Checkout Session o el PaymentIntent.
• API de registros: envíalo en el campo opcional visitor.

// at checkout time, on your site
const visitor = window.Provedly?.visitorId();
// Stripe: pass it as metadata.provedly_visitor
// Records API: POST { ..., "visitor": visitor }

Recuentos de compras verificadas de 24 horas, 7 días y desde el inicio; la ventana y el mínimo del contador en vivo; si se muestran ejemplos; si solo se muestran compras verificadas; cada fuente con sus recuentos y su último registro; los proveedores conectados; las compras verificadas recientes como hashes; y las raíces SHA-256 nocturnas del registro. Los nombres y las ciudades nunca aparecen. Lee la página de confianza para entender el porqué.

El hash de cada registro se devuelve al crearlo con la API. La raíz de un día es el SHA-256 de la lista ordenada de los hashes de los registros de ese día. Guarda tus hashes y podrás recalcular la raíz tú mismo.

Si "Verified purchases only" está activado y el widget aún no tiene registros verificados, no tiene nada que mostrar. La página del widget te avisa de ello. Desactiva el ajuste o conecta una tienda.

Espera aproximadamente un minuto y recarga la página. Con los snippets por elemento, las nuevas versiones del código pueden tardar unos minutos.

• Abre la consola del navegador. Un 403 en /api/w/…/config significa que el dominio de la página no está entre los dominios permitidos del sitio.
• El widget necesita al menos un registro dentro de la ventana de antigüedad. Añade un registro de ejemplo para probar.
• Comprueba que el estado del widget es "active" y que al espacio de trabajo le quedan impresiones este mes.
• Segmentación por ruta: una lista de inclusión que no coincide con la ruta actual mantiene el widget en silencio.

Se oculta por debajo del mínimo que fijaste (2 por defecto). Abre la página en dos navegadores, o en una ventana privada, y espera al primer latido. También necesita "Enable live counter" activado.

Falta el secreto de firma o es incorrecto. La tarjeta de la fuente muestra "No signing secret set" o el número de eventos deja de aumentar. Vuelve a pegar el secreto y reenvía un evento de prueba.

Sube el z-index en la sección Look del widget. El valor por defecto es 9999.