Documentación de Prynt Replay

Replay en tu propio panel

Tu equipo de soporte o de éxito ve qué hizo un cliente sin salir de tu back office: sus sesiones por empresa o por usuario, reproducidas ahí mismo.

Cómo funciona

  1. El navegador marca cada sesión con identify(userId, { accountId }) (cómo).
  2. Tu backend lista las sesiones con tu clave secreta: GET /v1/replay/sessions?accountId=….
  3. Cuando alguien pulsa una sesión, tu backend pide un enlace de reproductor (POST /v1/replay/sessions/<id>/embed) y tu página lo muestra en un <iframe>.

La clave secreta (sk_live_…) se queda en tu servidor. Créala en la consola en Claves API.

1. Lista las sesiones de un cliente

curl "https://api.pryntid.com/v1/replay/sessions?website=example.com&accountId=company_17&days=30" \
  -H "Authorization: Bearer sk_live_YOUR_SECRET_KEY"
{
  "recordings": [
    { "id": 4821, "startedAt": "2026-11-11T14:02:10Z", "durationMs": 312000, "pages": 7,
      "entryPath": "/dashboard", "userId": "user_42", "accountId": "company_17",
      "device": "desktop", "browser": "Chrome", "errors": 1, "rageClicks": 3, "frustrationScore": 41 }
  ],
  "total": 1, "page": 1, "pageSize": 25
}

Filtros: accountId, userId, days (hasta la retención de tu plan), page, hasErrors=1, hasRage=1, minFrustration, path, device, country, sort (newest, oldest, longest, errors, frustration). 25 por página.

2. Pide un enlace de reproductor

curl -X POST https://api.pryntid.com/v1/replay/sessions/4821/embed \
  -H "Authorization: Bearer sk_live_YOUR_SECRET_KEY" \
  -H "Content-Type: application/json" \
  -d '{"minutes": 15, "atMs": 0}'

# 201 {"token": "…", "url": "https://app.pryntid.com/embed/replay/…?t=0", "expiresAt": "…"}
  • minutes: de 1 a 60, 15 por defecto. Pídelo justo antes de mostrar el reproductor.
  • atMs: dónde empieza la reproducción.
  • El token se devuelve una vez y solo se guarda su hash. Abre esa grabación, en solo lectura.
  • El reproductor muestra la grabación, sus páginas y marcas, pero no quién era el visitante: eso ya lo tienes en tu panel.

3. Muéstralo

<!-- Your admin page: ask YOUR backend for the url right before showing it -->
<iframe src="{{ player.url }}" title="Session replay"
        style="width:100%;height:720px;border:0;border-radius:12px"
        referrerpolicy="no-referrer" sandbox="allow-scripts allow-same-origin"></iframe>

Si tu panel envía una Content-Security-Policy, permite el reproductor:

Content-Security-Policy: frame-src 'self' https://app.pryntid.com

Ejemplos de backend

Node / Express

// Node / Express — your admin's backend
const PRYNT = 'https://api.pryntid.com';
const auth = { Authorization: `Bearer ${process.env.PRYNT_SECRET_KEY}`, 'Content-Type': 'application/json' };

app.get('/admin/companies/:id/sessions', requireAdmin, async (req, res) => {
  const q = new URLSearchParams({ website: 'example.com', accountId: req.params.id, days: '30' });
  const r = await fetch(`${PRYNT}/v1/replay/sessions?${q}`, { headers: auth });
  res.status(r.status).json(await r.json());
});

app.post('/admin/sessions/:id/player', requireAdmin, async (req, res) => {
  const r = await fetch(`${PRYNT}/v1/replay/sessions/${Number(req.params.id)}/embed`, {
    method: 'POST', headers: auth, body: JSON.stringify({ minutes: 15 }),
  });
  res.status(r.status).json(await r.json());   // { url, expiresAt }
});

Python / Flask

# Python / Flask — your admin's backend
import os, requests
PRYNT = 'https://api.pryntid.com'
AUTH = {'Authorization': f"Bearer {os.environ['PRYNT_SECRET_KEY']}"}

@app.get('/admin/companies/<company_id>/sessions')
@admin_required
def company_sessions(company_id):
    r = requests.get(f'{PRYNT}/v1/replay/sessions', headers=AUTH, timeout=8,
                     params={'website': 'example.com', 'accountId': company_id, 'days': 30})
    return r.json(), r.status_code

@app.post('/admin/sessions/<int:rec_id>/player')
@admin_required
def session_player(rec_id):
    r = requests.post(f'{PRYNT}/v1/replay/sessions/{rec_id}/embed', headers=AUTH, json={'minutes': 15}, timeout=8)
    return r.json(), r.status_code

PHP

<?php // PHP — your admin's backend
function prynt(string $method, string $path, array $body = null): array {
    $ch = curl_init('https://api.pryntid.com' . $path);
    curl_setopt_array($ch, [
        CURLOPT_CUSTOMREQUEST => $method, CURLOPT_RETURNTRANSFER => true, CURLOPT_TIMEOUT => 8,
        CURLOPT_HTTPHEADER => ['Authorization: Bearer ' . getenv('PRYNT_SECRET_KEY'), 'Content-Type: application/json'],
        CURLOPT_POSTFIELDS => $body === null ? null : json_encode($body),
    ]);
    $out = json_decode(curl_exec($ch), true);
    curl_close($ch);
    return $out ?? [];
}

$sessions = prynt('GET', '/v1/replay/sessions?' . http_build_query(['website' => 'example.com', 'accountId' => $companyId]));
$player   = prynt('POST', "/v1/replay/sessions/{$recordingId}/embed", ['minutes' => 15]);   // ['url' => …]

Conviene saber

  • Solo las páginas /embed/replay/… se pueden enmarcar; el resto de la consola no.
  • Cada enlace creado queda en tu registro de auditoría (replay.embed.create).
  • Las grabaciones fuera de la retención de tu plan devuelven 404.
  • Las claves de prueba solo ven sesiones del entorno de prueba.

Siguiente: Referencia de la API

Actualizado 2026-11-11 · Referencia de la API