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.
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.
De una alerta simple a una acción de un toque
Elige un tipo
Decide qué debe hacer el botón: abrir una URL, llamar a un endpoint o copiar un valor.
Añádelo al mensaje
Añade un array actions a tu mensaje con hasta tres entradas, cada una con type, label y value.
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.
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.