Documentação do Prynt Replay

Replay no seu próprio painel

Seu time de suporte ou de sucesso vê o que um cliente fez sem sair do seu back office: as sessões por empresa ou por usuário, reproduzidas ali mesmo.

Como funciona

  1. O navegador marca cada sessão com identify(userId, { accountId }) (como).
  2. O seu backend lista as sessões com a sua chave secreta: GET /v1/replay/sessions?accountId=….
  3. Quando alguém clica numa sessão, o seu backend pede um link de player (POST /v1/replay/sessions/<id>/embed) e a sua página mostra num <iframe>.

A chave secreta (sk_live_…) fica no seu servidor. Crie no console em Chaves API.

1. Liste as sessões de um 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 (até a retenção do seu plano), page, hasErrors=1, hasRage=1, minFrustration, path, device, country, sort (newest, oldest, longest, errors, frustration). 25 por página.

2. Peça um link de player

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 padrão. Peça logo antes de mostrar o player.
  • atMs: onde a reprodução começa.
  • O token é devolvido uma vez e só o hash é guardado. Abre aquela gravação, somente leitura.
  • O player mostra a gravação, suas páginas e marcas, mas não quem era o visitante: isso você já tem no seu painel.

3. Mostre

<!-- 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>

Se o seu painel envia uma Content-Security-Policy, permita o player:

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

Exemplos 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' => …]

Bom saber

  • Só as páginas /embed/replay/… podem ser emolduradas; o resto do console não.
  • Cada link criado fica no seu log de auditoria (replay.embed.create).
  • Gravações fora da retenção do seu plano devolvem 404.
  • Chaves de teste só veem sessões do ambiente de teste.

Próximo: Referência da API

Atualizado 2026-11-11 · Referência da API