Botones de acción

Notificaciones push en las que puedes actuar.

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.

Hasta 3 botonesview · http · copyiOS & AndroidActualizado el
Qué obtienes

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.

Primeros pasos

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.

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.

FAQ

Preguntas y respuestas

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.

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.

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.

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.

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.

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.

Deja de leer alertas. Empieza a responderlas.

Añade un array de actions a tu próximo mensaje y la notificación deja de ser algo que solo lees. Pasa a ser algo que pulsas.