# Notificaciones push en las que puedes actuar.

> Añade botones de acción a tus notificaciones push con Pocket Alert. Abre una URL, lanza una petición HTTP o copia texto directamente desde la pantalla de bloqueo. Crea flujos de aprobación con un toque para despliegues y agentes de IA.

<!-- source: https://pocketalert.app/es/features/action-buttons -->

Última actualización: 2026-10-25

Adjunta hasta tres botones a cualquier push. Abre un enlace, lanza una petición HTTP o copia un valor, sin desbloquear el teléfono ni abrir un portátil.

Documentación: https://info.pocketalert.app/features/action-buttons.html

## De una alerta simple a una acción de un toque

1. **Elige un tipo** — Decide qué debe hacer el botón: abrir una URL, llamar a un endpoint o copiar un valor.
2. **Añádelo al mensaje** — Añade un array actions a tu mensaje con hasta tres entradas, cada una con type, label y value.
3. **Púlsalo desde tu teléfono** — Envíalo. Los botones aparecen en la notificación y dentro del mensaje de la aplicación.

## Tres tipos de botón, un solo array

Una notificación que solo te informa de algo es una notificación con la que tienes que actuar en otro sitio. Los botones cierran esa brecha.

- **Ve directo al punto** — Un botón view abre una URL (la compilación fallida, el pedido, el panel) sin que tengas que buscar la pestaña.
- **Ejecuta una petición en segundo plano** — Un botón http lanza una petición con tu método, cabeceras y cuerpo. Reinicia un servicio o confirma un incidente con un toque.
- **Copia sin complicaciones** — Un botón copy deja un valor en el portapapeles. Códigos de un solo uso, IDs de incidentes y tokens sin tener que seleccionar texto en el teléfono.
- **Flujos de aprobación** — Dos botones http con las etiquetas Approve y Decline convierten una push en un panel de control de un toque para cualquier cosa que espere a una persona.
- **Sobreviven al banner** — Los botones viven dentro del mensaje, no solo en el banner. Desliza la notificación y seguirán ahí más tarde.
- **Botones desde webhooks** — Las plantillas de webhook rellenan las URLs de los botones con datos del payload, así que cada alerta enlaza a su propio issue, pedido o compilación.

## Cómo funcionan los botones de acción

    
Añade un array `actions` a cualquier mensaje que envíes por la API, un webhook o el servidor MCP. Cada entrada tiene un `type`, un `label` y un `value` cuyo significado depende del tipo: una URL para `view`, una descripción JSON de la petición para `http` y texto literal para `copy`.

    
Los botones se entregan con la push y los muestra el sistema operativo. Cuando pulsas uno, la aplicación lo gestiona localmente: `http` y `copy` se ejecutan sin abrir nada, mientras que `view` trae el navegador al primer plano.

    
## El patrón de aprobación

    
La configuración que conviene crear primero son dos botones `http`, Approve y Decline, que apuntan a dos endpoints propios. Encaja cualquier proceso que se detenga esperando a una persona: un pipeline de despliegue bloqueado por una confirmación manual, un reembolso por encima de un umbral o un agente de IA que no debería tocar producción sin supervisión.

    
Como la petición va del teléfono directamente a tu endpoint, lo que haya detrás de esas URLs es totalmente tuyo, incluida la autenticación.

    
## Límites que conviene conocer

    
Tres botones como máximo. `view` y `http` requieren una URL http(s) válida; cualquier otra cosa devuelve `400`. Los botones funcionan en la notificación del sistema tanto si la aplicación está abierta, en segundo plano o cerrada, con Pocket Alert 2.0.1 o posterior; las versiones anteriores solo los muestran dentro del mensaje.

## Preguntas frecuentes

### ¿Cuántos botones puede tener una notificación?

Tres por mensaje. Se muestran en el orden en que los envías, tanto en iOS como en Android, y siguen disponibles dentro del propio mensaje después de descartar el banner.

### ¿Qué puede hacer un botón?

Tres tipos. `view` abre una URL, `http` envía una petición HTTP en segundo plano con tu propio método, cabeceras y cuerpo, y `copy` pone un valor en el portapapeles. Solo `view` trae una aplicación al primer plano.

### ¿Adónde envía su petición un botón HTTP?

Directamente desde tu teléfono hasta tu endpoint. Pocket Alert no actúa como proxy de la petición y nunca ve el cuerpo de la respuesta. Añade la cabecera de autenticación que tu endpoint espere y viajará con el botón.

### ¿Se muestran mis etiquetas de botón en el iPhone?

Sí. Tanto iPhone como Android muestran la etiqueta exacta que envías, en la notificación y dentro del mensaje. Si iOS no puede preparar los botones personalizados a tiempo, usa una etiqueta genérica por tipo (Open, Run o Copy) y el botón sigue funcionando.

### ¿Los webhooks pueden añadir botones automáticamente?

Sí. Un webhook puede incluir una plantilla de acción con marcadores `%path%` que se rellenan con datos del payload entrante, así una alerta de Sentry llega con un botón Open issue que apunta a ese issue concreto. Los valores sustituidos se escapan como JSON, de modo que un payload no puede reescribir la URL.

### ¿Qué pasa si pulso un botón dos veces?

Al pulsarlo dos veces, la petición se envía dos veces. Las repeticiones no se bloquean, a propósito. Si enviarla dos veces es costoso, haz que el endpoint sea idempotente. Los botones de acción son una función de pago; en los planes gratuitos se eliminan en el servidor y el mensaje se entrega sin ellos.
