Como funciona
- O navegador marca cada sessão com
identify(userId, { accountId })(como). - O seu backend lista as sessões com a sua chave secreta:
GET /v1/replay/sessions?accountId=…. - 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_codePHP
<?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.
Atualizado 2026-11-11 · Referência da API