Integrar el snippet
Los endpoints públicos que usa el snippet para medir tu web. En una instalación normal no llamas a ninguno a mano: el snippet lo hace por ti. Aquí están por si integras a mano.
🔧 Para tu equipo técnico
En una instalación normal no llamas a ninguno de estos endpoints a mano: pones el snippet en tu web (ver Instalación) y él los usa por ti —config al cargar, eventos al navegar, el checkout al comprar—. Esta página existe por si integras desde un entorno donde no puedes poner el snippet y necesitas llamar directamente.
Antes de empezar
- Base:
https://track.alloop.ch - Públicos por diseño. El snippet vive en webs de cualquier cliente, así que estos endpoints aceptan peticiones desde el navegador (CORS abierto). No exponen secretos.
- Identifican al cliente por
client_id, tu identificador de cuenta. Los endpoints de ingesta esperan además tu token de sitio en la cabeceraX-Alloop-Token(el snippet lo lleva incrustado). - El identificador de visitante lo genera y lo añade el snippet automáticamente. Si integras a mano, basta con enviar los campos de negocio (abajo); el resto lo completa alloop.
Configuración y estado
GET /config/{client_id}
La configuración pública (sin secretos) que el snippet pide al cargar: qué medir y cómo. No
necesita token. Si el client_id no existe, responde 404.
curl https://track.alloop.ch/config/tu-clienteGET /api/health
Estado del servicio. Útil para un monitor externo. Responde {"ok": true, ...} cuando todo va bien.
curl https://track.alloop.ch/api/healthIniciar una compra
POST /checkout
Abre un pago de la comunidad y devuelve la URL a la que mandar al comprador. Es la vía correcta para vender la comunidad: así la venta se mide con el importe y el contacto reales, sin duplicar.
| Campo | Tipo | Req. | Qué es |
|---|---|---|---|
client_id | texto | sí | Tu identificador de cuenta. |
price_id | texto | sí | El precio a cobrar (te lo da alloop al configurar el producto). |
success_url | texto | no | A dónde volver tras pagar. Si lo omites, se usa tu página de gracias configurada. |
curl -X POST https://track.alloop.ch/checkout \
-H "Content-Type: application/json" \
-H "X-Alloop-Token: <tu-token-de-sitio>" \
-d '{"client_id":"tu-cliente","price_id":"price_...","success_url":"https://tuacademia.com/gracias"}'La comunidad se vende siempre por este endpoint, no con enlaces de pago sueltos. Es lo que hace que la venta llegue a tu panel con el importe y el contacto exactos, ya casada con el cobro. Un enlace suelto entra "sin origen" y sin importe fiable.
Registrar actividad
Estos los dispara el snippet a medida que la persona navega. Los listamos para que sepas qué está midiendo por debajo; rara vez los llamarás a mano.
POST /event
Un evento genérico (visita, clic, hito). Envías client_id, el nombre del event y, si
quieres, properties con datos no personales del evento.
Los datos personales (email, teléfono) nunca van dentro de properties: van en sus propios
campos, para que queden unidos a la persona y no dispersos por cada evento. El snippet ya lo
hace así.
POST /form
Un lead: alguien deja sus datos en un formulario. Envías client_id, el form (qué formulario
fue) y los campos de contacto (name, email, phone). Con eso la persona queda creada y
unida a su origen.
POST /activity · POST /video-milestone · POST /bot-step · POST /stitch
Señales finas que el snippet emite solo: pulso de actividad, hitos de reproducción de vídeo, pasos de un formulario multipaso y unión de identidades. No necesitas llamarlos.
Todo lo demás
El resto de superficies —pagos por webhook, membresía, tutor IA y chat en vivo— las usan tu plugin y tus integraciones, no se llaman a mano desde la web. Las tienes enumeradas en el índice de la referencia.
Leer tus datos
La API de lectura (/api/v1) devuelve la misma verdad que tu panel, en JSON. Pensada para conectar tus propias herramientas o dársela a una IA para que la analice.
Glosario
Los términos de datos que usas para decidir, explicados en lenguaje llano y con un ejemplo de academia. Sin jerga, sin humo.