# Haz que las excepciones llegue a tu teléfono.

> Recibe las excepciones de Sentry, Rollbar y Bugsnag como notificaciones push. Apunta el webhook de tu rastreador de errores a Pocket Alert y entérate de los nuevos problemas en menos de un segundo.

<!-- source: https://pocketalert.app/es/use-cases/error-tracking-alerts -->

Última actualización: 2026-08-11

Cuando Sentry, Rollbar o Bugsnag detectan una nueva excepción, el título y la gravedad llegan a tu teléfono en menos de un segundo. Detecta el error antes de que tus usuarios lo reporten.

## Tres pasos para recibir alertas de errores en tu teléfono

1. **Crea un webhook** — Crea un webhook de Pocket Alert con una plantilla de mensaje GJSON y copia su URL de recepción.
2. **Conecta la herramienta** — Pega la URL en una Internal Integration de Sentry (o en un webhook de Rollbar/Bugsnag) y asóciala a una regla de alerta.
3. **Mapea y envía** — GJSON mapea data.event.title, culprit, level y web_url en tu notificación push. La siguiente excepción hará vibrar tu teléfono.

## Del stack trace a la pantalla de bloqueo

Tu herramienta de seguimiento de errores ya envía un webhook. Pocket Alert lo convierte en una notificación push que no puedes pasar por alto.

- **Compatible con cualquier herramienta de seguimiento** — Sentry, Rollbar, Bugsnag, Honeybadger y Airbrake disparan un webhook saliente con cada nueva incidencia. Apúntalo a Pocket Alert y ya está.
- **Mapea los campos con GJSON** — Las rutas GJSON extraen data.event.title, data.event.culprit y data.event.level del payload y los llevan a tu notificación.
- **Nivel y regla en la notificación** — Muestra el nivel del error y la regla que se ha disparado directamente en la notificación push, para que una excepción fatal se distinga de una advertencia.
- **Un canal por entorno** — Cada aplicación tiene su propia URL de webhook, así que producción, staging y un servicio concreto se mantienen en canales separados.
- **Entrega en menos de un segundo** — La excepción llega a tu teléfono en menos de un segundo, mucho antes que el resumen por correo.
- **URL de webhook secreta** — La URL del webhook es el secreto de tu aplicación, a través de HTTPS. Rótala cuando necesites un endpoint nuevo.

## Envía alertas de errores a tu teléfono

### 1. Crea un webhook de Pocket Alert

En la página [Webhooks](https://pocketalert.app/es/webhooks), crea un webhook cuya plantilla GJSON `message` lea el payload de alertas de incidencias de Sentry (todo está anidado bajo `data.event`):

```
curl -X POST "https://api.pocketalert.app/v1/webhooks" \
  -H "Token: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"name":"Sentry","default_level":"critical","message":"[%data.event.level%] %data.event.title%\n%data.event.culprit%\n%data.event.web_url%","application_id":"qm47b9pzxzxg"}'
```

Obtendrás una URL de entrada como `https://p4a.me/wh/1234abcd`.

### 2. Apunta Sentry a esa URL

En [Configuración → Developer Settings → Internal Integration](https://docs.sentry.io/organization/integrations/integration-platform/webhooks/issue-alerts/), define la Webhook URL como tu URL de recepción y activa la Alert Rule Action. Después crea una regla de alerta de incidencias y añade la integración como acción:

```
Webhook URL:  https://p4a.me/wh/1234abcd
Permissions:  Issue & Event (Read)
Action:       Alert Rule Action — enabled

Alerts → Create Alert → When a new issue is created
→ Then send a notification via [your integration]
```

Sentry envía un POST con `{"action":"triggered","data":{"event":{"title":...,"culprit":...,"level":...,"web_url":...}}}`; las rutas GJSON anteriores extraen esos campos para la notificación push.

### 3. Otras herramientas (Rollbar, Bugsnag)

Rollbar (Configuración → Notifications → Webhook) y Bugsnag (Integrations → Generic webhook) envían un payload más plano. Ajusta la plantilla a sus campos, por ejemplo `%data.item.title%` para Rollbar o `%error.exceptionClass%` para Bugsnag, y pega la misma URL de recepción.

La [documentación de ajustes de webhooks](https://info.pocketalert.app/api/webhooks/settings.html) recoge todas las rutas GJSON y opciones de webhook.

## Preguntas frecuentes

### ¿Cómo recibo alertas de errores en el teléfono?

En Sentry crea una Internal Integration con una URL de webhook que apunte a tu URL de recepción de Pocket Alert y con la Alert Rule Action activada. Después añádela a una regla de alerta de incidencias. Cuando se dispare la regla, Sentry envía un POST con la incidencia y la notificación llega a tu teléfono en menos de un segundo.

### ¿Cómo funciona el mapeo de campos?

Los webhooks de alertas de incidencias de Sentry anidan los datos bajo data.event. Pocket Alert los lee con rutas GJSON, así que asignas data.event.title al título de la notificación y data.event.culprit (o web_url) al cuerpo. La notificación te indica exactamente qué incidencia se ha disparado.

### ¿Puedo mostrar el nivel del error y la regla?

La carga incluye data.event.level (warning, error, fatal) y el nombre de la regla en data.triggered_rule. Usa ambos en tu plantilla de mensaje GJSON para que una excepción fatal se distinga de una advertencia.

### ¿Puedo separar producción y staging?

Asigna una aplicación a cada entorno. Un webhook de producción y otro de staging llegan a canales separados, y puedes silenciar staging sin tocar producción.

### ¿Necesito instalar un agente?

Nada. Pocket Alert solo recibe el webhook que tu herramienta ya envía, así que no hay ningún agente ni SDK que instalar. Sentry, Rollbar, Bugsnag, Honeybadger y Airbrake admiten webhooks salientes.

### ¿Una excepción de producción puede saltarse No molestar?

Sí. Añade "level":"critical" al mensaje y, en Android, se publica en un canal de notificaciones dedicado que se salta No molestar; solo tienes que conceder el acceso a No molestar una vez. En iPhone, las notificaciones de prioridad alta y crítica llegan como notificaciones sensibles al tiempo que atraviesan los modos de Concentración. Cada mensaje acepta un nivel de silent a critical, así que una advertencia de staging puede quedarse en silencio mientras una excepción fatal de producción te despierta. En el plan gratuito, critical se entrega como high: sigue siendo instantánea, pero sin saltarse No molestar.
