Conectar

Cómo enviar los leads del formulario de tu sitio a TraceClose

Actualizado el 28 de septiembre de 2026

Paso a paso

1. Crea la conexión Site

   En Configuración › Integraciones › Nueva conexión, elige la plataforma Site. Las funciones Fuente de leads y Visitas del sitio ya vienen marcadas; desmarca la que no vayas a usar.

2. Genera y guarda el secreto

   Haz clic en Generar secreto y después en Copiar secreto. Guárdalo en el servidor del sitio: después de guardar la conexión, no vuelve a aparecer.

3. Pásalo a quien administra el sitio

   Haz clic en el nombre de la conexión. La pantalla muestra la URL del webhook y la guía Cómo enviar desde tu sitio, con el botón Copiar ejemplo.

4. Prueba con un lead

   Envía un registro de prueba desde el formulario y revisa si el lead aparece en el Kanban.

Para quién es

Para quien capta clientes por el sitio web (registro, cotización, cita, checkout) y quiere ver el ROAS por campaña, conjunto de anuncios y anuncio con la venta real, aunque el cliente no pase por WhatsApp. Funciona con código propio y con herramientas de automatización que hagan una llamada HTTP.

Qué envía el sitio

• Lead ("event": "lead"): el externalId (el id en tu sistema) y el correo o el teléfono. Opcionales: nombre, fecha (occurredAt) y el origen en attribution: UTM, fbclid, fbc, fbp, gclid, página de entrada, eventId del píxel, navegador, IP y el visitorId de la etiqueta de visitas.
• Venta ("event": "sale"): el externalId del pedido, el lead (por leadExternalId, correo o teléfono), amountMinor y currency.

amountMinor es el valor en la unidad mínima de la moneda, sin separador decimal: US$ 499,00 va como 49900 con currency USD.

Seguridad del envío

Solo el servidor del sitio llama al webhook, nunca el navegador. Cada envío lleva el encabezado x-traceclose-signature con sha256= y el HMAC-SHA256 del cuerpo o, si la herramienta no calcula HMAC, Authorization: Bearer con el secreto. Respuestas: 200 recibido (también si es repetido), 401 firma o conexión inválida, 400 cuerpo fuera del formato (se indica el campo con error). Ante un error 5xx o de red, vuelve a enviar: la misma entrega no entra dos veces.

Qué pasa en TraceClose

• El lead se busca por el id, después por el teléfono y después por el correo. Si no lo encuentra, se crea en la etapa de entrada y se asigna por la rotación.
• Un lead que ya existe conserva su vendedor y solo recibe los datos que le faltaban. El origen solo se guarda si todavía no tenía uno (gana el primer contacto).
• Con anuncio identificado, fbclid, gclid o fbc, el lead es Tráfico pago con el método Sitio web (UTM). Solo con UTM, queda como Orgánico.
• La venta se acredita al vendedor de origen, lleva el lead a la etapa ganada y, si esa etapa tiene el Purchase y el envío de conversiones está activado, genera el evento para Meta.
• Reenviar el mismo lead o la misma venta no duplica nada.

Si tu sitio ya dispara Lead o Purchase con el píxel de Meta, envía el mismo event_id en eventId: Meta descarta el repetido. Sin eventId, no dispares el mismo evento con el píxel, o se contará dos veces.

Ejemplo

Ejemplo ficticio: Empresa Ejemplo recibe por el formulario la solicitud de cotización de María (maria@ejemplo.com), que viene del anuncio 120200000000000003. El servidor envía el lead registro-1001 con las UTM. Dos días después, el checkout envía la venta pedido-5001 con amountMinor: 49900 y USD. María pasa a la etapa ganada, la venta de US$ 499,00 entra en los ingresos del anuncio y el Purchase sale hacia Meta.

¿No funcionó? Revisa…

• 401 en todo: el secreto es distinto del guardado, la conexión está desactivada o la URL es de otra conexión. ¿Perdiste el secreto? Genera otro en Editar y cámbialo en el sitio.
• 400: falta el correo o el teléfono, o el valor llegó con coma o decimales.
• Una venta que llegó antes que el lead: TraceClose reintenta durante algunos minutos y, si no lo encuentra, crea el lead con el contacto de la venta.
• El evento no llega a Meta: la venta no aparece en Meta.

Preguntas frecuentes