Ventas del checkout
Cómo conectar tu tienda Shopify a TraceClose
Crea la conexión Shopify en Configuración › Integraciones y copia la URL del webhook. En el panel de control de la tienda, en Configuración › Notificaciones › Webhooks, crea un webhook de pago del pedido y otro de reembolso con esa URL, y pega la clave de firma de la tienda en TraceClose.
Paso a paso
Crea la conexión en TraceClose
En Configuración › Integraciones, haz clic en Nueva conexión y, en el grupo Ventas del checkout, elige Shopify. Deja la pestaña abierta: la pantalla muestra la URL del webhook (con botón para copiar) y el campo Clave de firma.
Abre los webhooks de la tienda
En el panel de control de Shopify, abre Configuración › Notificaciones y baja hasta Webhooks. Quien los crea necesita acceso a la configuración de la tienda.
Copia la clave de firma
En la sección de webhooks, Shopify muestra la clave con la que firma los webhooks de la tienda (“Tus webhooks se firmarán con…”). Cópiala y pégala en el campo Clave de firma de TraceClose.
Crea el webhook del pago
Haz clic en Crear webhook. En Evento, elige el pago del pedido (Order payment); en Formato, JSON; en URL, pega la URL de TraceClose; en la versión de la API, la más reciente. Guarda.
Crea el webhook del reembolso
Repite con el evento de creación de reembolso (Refund create) y la misma URL. Así, el reembolso cancela la venta en TraceClose.
Elige las opciones y guarda
Decide el envío del Purchase a Meta (activado por defecto; si el píxel del checkout ya envía la compra, mira más abajo) y si el checkout no pagado se convierte en lead (desactivado por defecto). Haz clic en Guardar.
Prueba
En el menú ⋯ de la fila del webhook, usa Enviar prueba. El evento aparece en la conexión de TraceClose como último evento recibido.
Cuál es la URL
El panel muestra la URL lista para copiar, con el formato https://t.traceclose.com/webhooks/sales/shopify/<id-de-la-conexión>. Sirve solo para esa conexión.
Checkout iniciado y no pagado (opcional)
Para que el vendedor recupere a quien empezó la compra y no la terminó, activa checkout no pagado se convierte en lead en la conexión y crea un webhook más con el evento de creación de checkout (Checkout creation). El lead entra con su origen, sin venta y sin Purchase.
Qué pasa en TraceClose
- Cada venta aprobada se convierte en una venta en TraceClose, con el valor pagado y la moneda del pedido, acreditada al vendedor del lead. El lead pasa a la etapa ganada.
- TraceClose busca el lead por la referencia del enlace de checkout, después por el teléfono y después por el correo. Si no lo encuentra, crea el lead con el origen que guardó el checkout y lo asigna por la rotación.
- Un lead que ya existía conserva su origen y su vendedor: si llegó por un anuncio de clic a WhatsApp, sigue acreditado a ese anuncio.
- Un reembolso o un contracargo cancela la venta. Si la plataforma reenvía la misma entrega, nada se duplica.
Para que la venta se asocie al lead correcto aunque el comprador pague con otro correo u otro teléfono, usa Copiar enlace de checkout en el detalle del lead: pega la URL del producto y TraceClose agrega la referencia del lead en el parámetro de seguimiento de la plataforma. En Shopify, la referencia va en el parámetro tc_ref del enlace de la tienda, y Shopify guarda en el pedido la dirección por la que llegó el comprador. Las UTM de esa dirección también sirven como origen del lead nuevo.
Si el píxel de Meta ya está instalado en el checkout de la plataforma y envía el Purchase, elige quién envía la compra: desactiva el envío del Purchase en esta conexión con un clic (o desactiva el Purchase en el píxel del checkout). Así Meta recibe la venta una sola vez, y la venta sigue entrando en el panel y en el ROAS.
¿No funcionó? Revisa…
- El webhook desapareció de la lista: Shopify borra por su cuenta el webhook que responde con error muchas veces seguidas. Revisa la conexión en TraceClose (activa y con la clave correcta) y vuelve a crear el webhook.
- Error de autenticación en la conexión: la clave de TraceClose no coincide con la clave de firma de la tienda. Cópiala de nuevo y guárdala en Editar.
- La venta llegó, pero no se envió a Meta: consulta la venta no aparece en Meta.
Preguntas frecuentes
¿Necesito instalar una app en la tienda?
No. El webhook se crea en la configuración de la propia tienda, sin app.
¿Entra el pedido pagado con boleto o pix?
Entra cuando se confirma el pago, porque el webhook es el del pago del pedido.
¿El envío y el descuento entran en el valor?
El valor registrado es el total que pagó el comprador en el pedido, en la moneda de la tienda.
Ve el camino del anuncio hasta la venta en tu WhatsApp.
Prueba TraceClose gratis por 7 días con tu equipo. Sin tarjeta para probar.