Instalar por plataforma
Cualquier sitio web
Instalar npm install @blipit/browser
El SDK de navegador de Blipit pesa 10 KB. Captura los errores no capturados, los rechazos de promesas no gestionados y las peticiones fallidas, guarda los clics y las peticiones que llevaron a cada error, registra las web vitals, pone un botón Reportar un error en cada página y puede grabar un session replay cuando ocurre un error. Instálalo desde npm en una app empaquetada, o añade una etiqueta script a cualquier página.
1Obtén tus claves
Inicia sesión en app.blipit.io y abre Claves API en la barra lateral y luego tu proyecto. Cada proyecto tiene dos claves. La clave pública empieza por blipit_pk_: va en el código del navegador y de las apps, solo puede enviar eventos y cualquiera puede verla sin riesgo. La clave secreta empieza por blipit_sk_: se queda en tu servidor o en Odoo, nunca en un navegador, porque también puede leer y cambiar incidencias. La clave secreta solo se muestra una vez, justo al crearla, así que cópiala entonces; si la pierdes, pulsa Crear una nueva clave secreta y la anterior deja de funcionar al instante. Algunos SDKs también necesitan el id del proyecto, que aparece en la misma página.
2Con npm
Llama a init una vez en tu archivo de entrada, antes de que la app se renderice, con la clave pública. Con Vite (React, Vue, Svelte), guarda la clave en .env como VITE_BLIPIT_KEY; solo las variables VITE_ llegan al navegador, y el servidor de desarrollo lee .env solo al arrancar.
npm install @blipit/browserVITE_BLIPIT_KEY=blipit_pk_your_public_keyimport * as Blipit from "@blipit/browser";
Blipit.init({
key: import.meta.env.VITE_BLIPIT_KEY,
environment: import.meta.env.MODE,
release: "2026.09.28",
replay: { onErrorSampleRate: 1 },
});3Sin bundler: una etiqueta script
Pega esto en el <head> de cada página, o en el espacio para código personalizado de tu plataforma, con tu clave pública escrita. No pasa nada: la clave pública solo puede enviar eventos.
<script src="https://blipit.io/sdk/blipit.js"></script>
<script>
Blipit.init({ key: "blipit_pk_your_public_key", environment: "production", release: "2026.09.28", replay: { onErrorSampleRate: 1 } });
</script>4Mantén las claves fuera de git
Guarda las claves en variables de entorno o en los ajustes de secretos de tu hosting, nunca en código que subas con commit, y añade tus archivos .env a .gitignore. Una clave pública en una página web es normal. Si alguna vez una clave secreta acaba en git, en una página pública, en una captura o en un chat, abre Claves API, pulsa Crear una nueva clave secreta y pega la nueva clave donde se usaba la anterior: la clave anterior deja de funcionar al instante.
.env
.env.local
.env.*.local5Dile a Blipit quién es el usuario (opcional)
Tras el inicio de sesión, adjunta el usuario para que las incidencias muestren quién se vio afectado y los replays puedan buscarse por usuario.
Blipit.setUser({ id: "42", email: "ana@example.com" });6React, Vue, Angular y Svelte: reporta los errores capturados
Los frameworks capturan los errores dentro de los componentes antes de que el navegador los vea, así que pásalos también a Blipit. Los errores no capturados en cualquier otro sitio se reportan solos.
createRoot(document.getElementById("root")!, {
onCaughtError: (error) => Blipit.captureException(error),
onUncaughtError: (error) => Blipit.captureException(error),
}).render(<App />);class ErrorBoundary extends React.Component<{ children: React.ReactNode }, { failed: boolean }> {
state = { failed: false };
static getDerivedStateFromError() {
return { failed: true };
}
componentDidCatch(error: Error) {
Blipit.captureException(error);
}
render() {
return this.state.failed ? <p>Something went wrong.</p> : this.props.children;
}
}const app = createApp(App);
app.config.errorHandler = (err) => Blipit.captureException(err);
app.mount("#app");import { ErrorHandler } from "@angular/core";
import * as Blipit from "@blipit/browser";
class BlipitErrorHandler implements ErrorHandler {
handleError(error: unknown) {
Blipit.captureException(error);
console.error(error);
}
}
export const appConfig = { providers: [{ provide: ErrorHandler, useClass: BlipitErrorHandler }] };import * as Blipit from "@blipit/browser";
import type { HandleClientError } from "@sveltejs/kit";
export const handleError: HandleClientError = ({ error }) => {
Blipit.captureException(error);
};10Rellena el formulario de reporte y añade contexto
Llama a setUser tras el inicio de sesión: el nombre y el correo de quien reporta se rellenan solos, y recibe un correo cuando respondes o cambias el estado. setReportMetadata añade tus propios campos, como el plan o el tamaño del carrito, a cada reporte; se ejecuta cuando se envía un reporte, así que los valores están al día.
Blipit.setUser({ id: "42", username: "Ana Lima", email: "ana@example.com" });
Blipit.setReportMetadata(() => ({ plan: "pro", cartItems: cart.length }));11Todas las opciones y funciones
- key: la clave pública (blipit_pk_). Obligatoria.
- environment y release: se muestran en cada evento; release habilita las regresiones y los source maps. environment toma por defecto production.
- debug: true registra en la consola lo que hace el SDK, con líneas que empiezan por [blipit].
- sampleRate (de 0 a 1), ignoreErrors (cadenas o patrones) y beforeSend (edita un evento, o devuelve null para descartarlo) controlan lo que se envía. autoMuteExtensions (activado por defecto) descarta los errores que solo vienen de extensiones del navegador.
- webVitals (activado por defecto), replay ({ sessionSampleRate, onErrorSampleRate }) y autoSessionTracking (tasas sin fallos, necesita release).
- feedbackWidget: false oculta el botón Reportar un error, o un objeto con position, style, text, color, font, match y shortcut lo cambia. theme: "light", "dark" o "auto" define el tema del formulario de reporte.
- user ({ id, name, email }) y company (un nombre o { id, name }) rellenan el formulario de reporte y se añaden a los reportes.
- endpoint: solo para una ingesta self-hosted; el valor por defecto es https://in.blipit.io/api/v1/events.
- Funciones: captureException(error), captureMessage(text, level), setUser, setTag(key, value), addBreadcrumb({ category, message }), openReport(), attachReport(element), reportButton(options), updateWidget(options), setReportMetadata(fn), showFeedback() y flush(), que devuelve una promesa cuando se han enviado los eventos en cola.
- Los cambios en los ajustes del widget hechos en el panel llegan a los navegadores en menos de una hora, porque el SDK los guarda ese tiempo; una ventana privada muestra el cambio al instante.
12Comprueba que funciona
Recarga tu sitio. El botón Reportar un error aparece en la esquina inferior derecha y, en menos de un minuto, la vista de página aparece en Web vitals en app.blipit.io. Después envía un evento de prueba: llama una vez a captureMessage desde tu código o, con la etiqueta script, ejecuta la línea de abajo en la consola del navegador. Aparece en Incidencias en unos segundos.
Blipit.captureMessage("Hello from " + location.host, "info");Conviene saber
- Opciones: sampleRate (0 a 1), ignoreErrors (cadenas o patrones), beforeSend para descartar o editar un evento, maxBreadcrumbs, webVitals (activado por defecto), autoSessionTracking para tasas sin fallos (necesita release).
- blipit.io/sdk/blipit.js siempre sirve la última versión (0.3.23). Las versiones fijas están en blipit.io/sdk/0.3.23/blipit.js si quieres controlar las actualizaciones.
- Si tu sitio envía una Content Security Policy, permite script-src https://blipit.io (la etiqueta script, y el editor del reporte y el complemento de replay, que se cargan desde blipit.io/sdk/<version>/ la primera vez que se usan), connect-src https://in.blipit.io (los eventos, las capturas y las grabaciones de pantalla van todos a in.blipit.io), img-src data: (la captura se dibuja a partir de una imagen de la página) y media-src blob: (las grabaciones se reproducen en el reporte). La captura vuelve a cargar las imágenes y fuentes de la página, así que sus hosts también deben estar en connect-src; si no, quedan en blanco. No hace falta cambiar style-src. Con la etiqueta script, llama a Blipit.init desde tu propio archivo .js o da un nonce al script en línea, porque una política estricta bloquea los scripts en línea. Para que las grabaciones de pantalla tengan voz, la cabecera Permissions-Policy de tu sitio debe permitir microphone=(self), y display-capture=(self) para grabar la pantalla; con microphone=() las grabaciones funcionan sin sonido.
- Mantener Blipit actualizado: la guía Mantener Blipit actualizado (docs.blipit.io/updates) explica el banner de actualización, los correos para versiones importantes, el aviso en tu consola de desarrollo y el comando de actualización para esta plataforma.
- Un proyecto por app y plataforma: cada proyecto elige su plataforma al crearse (Android, iOS, React Native, Flutter, Web, Backend u Odoo) y Blipit rechaza con un error claro los datos de cualquier otra plataforma, así que una app de iOS y una de Android necesitan dos proyectos con dos claves. Las versiones, las compilaciones, las tasas de fallos y las builds de tienda son distintas en cada plataforma, y mezclarlas en un proyecto hace que todas sean incorrectas. Un proyecto Web también acepta la parte de servidor de la misma app web (el servidor de Next.js o Node), y un proyecto de React Native o Flutter también acepta sus propios informes de fallos nativos de Android e iOS.
¿Atascado? Escribe a support@blipit.io. Las claves y el id de cada proyecto están en Claves API en app.blipit.io.





