# Notifiche push su cui puoi agire.

> Aggiungi pulsanti di azione alle notifiche push con Pocket Alert. Apri un URL, invia una richiesta HTTP o copia del testo direttamente dalla schermata di blocco. Crea workflow di approvazione con un tocco per deploy e agenti AI.

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

Ultimo aggiornamento: 2026-10-25

Allega fino a tre pulsanti a qualsiasi push. Apri un link, invia una richiesta HTTP o copia un valore, senza sbloccare il telefono né aprire un laptop.

Documentazione: https://info.pocketalert.app/features/action-buttons.html

## Dall'avviso semplice all'azione con un tocco

1. **Scegli un tipo** — Decidi cosa deve fare il pulsante: aprire un URL, chiamare un endpoint o copiare un valore.
2. **Aggiungilo al messaggio** — Aggiungi un array actions al messaggio con fino a tre voci, ognuna con type, label e value.
3. **Toccalo dal telefono** — Invialo. I pulsanti compaiono sulla notifica e dentro il messaggio nell'app.

## Tre tipi di pulsante, un solo array

Una notifica che ti dice solo che qualcosa è successo ti obbliga ad agire altrove. I pulsanti colmano questo divario.

- **Vai dritto al punto** — Un pulsante view apre un URL (la build fallita, l'ordine, la dashboard) senza che tu debba cercare la scheda giusta.
- **Esegui una richiesta in background** — Un pulsante http invia una richiesta con il tuo metodo, le tue intestazioni e il tuo body. Riavvia un servizio o prendi in carico un incidente con un solo tocco.
- **Copia senza impacciarti** — Un pulsante copy mette un valore negli appunti. Codici una tantum, ID degli incidenti e token, senza dover selezionare il testo sul telefono.
- **Flussi di approvazione** — Due pulsanti http etichettati Approve e Decline trasformano una notifica push in un pannello di controllo a un tocco per qualsiasi cosa sia in attesa di una persona.
- **Sopravvivono al banner** — I pulsanti vivono dentro il messaggio, non solo nel banner. Scorri via la notifica e saranno ancora lì più tardi.
- **Pulsanti dai webhook** — I template dei webhook compilano gli URL dei pulsanti dal payload in arrivo, così ogni avviso rimanda al proprio issue, ordine o build.

## Come funzionano i pulsanti di azione

    
Aggiungi un array `actions` a qualsiasi messaggio che invii tramite API, webhook o server MCP. Ogni voce ha un `type`, una `label` e un `value` il cui significato dipende dal tipo: un URL per `view`, una descrizione JSON della richiesta per `http` e un testo letterale per `copy`.

    
I pulsanti vengono consegnati insieme alla push e visualizzati dal sistema operativo. Quando ne tocchi uno, l'app lo gestisce in locale: `http` e `copy` vengono eseguiti senza aprire nulla, mentre `view` porta in primo piano il browser.

    
## Il pattern di approvazione

    
La configurazione da costruire per prima è quella con due pulsanti `http`, Approve e Decline, che puntano a due endpoint tuoi. Si adatta a tutto ciò che resta in attesa di una persona: una pipeline di deploy bloccata in attesa di un via libera manuale, un rimborso sopra una certa soglia o un agente AI che non dovrebbe toccare la produzione senza supervisione.

    
Poiché la richiesta va dal telefono direttamente al tuo endpoint, tutto ciò che sta dietro a quegli URL è interamente tuo, compresa l'autenticazione.

    
## Limiti da conoscere

    
Massimo tre pulsanti. `view` e `http` richiedono un URL http(s) valido; qualsiasi altro valore restituisce `400`. I pulsanti funzionano sulla notifica di sistema sia che l'app sia aperta, in background o chiusa, con Pocket Alert 2.0.1 o successive; le versioni precedenti dell'app li mostrano solo all'interno del messaggio.

## FAQ

### Quanti pulsanti può avere una notifica?

Tre per messaggio. Vengono mostrati nell'ordine in cui li invii, su iOS e Android, e restano disponibili all'interno del messaggio anche dopo che il banner è stato chiuso.

### Cosa può fare un pulsante?

Tre tipi. `view` apre un URL, `http` invia una richiesta HTTP in background con il tuo metodo, le tue intestazioni e il tuo body, e `copy` copia un valore negli appunti. Solo `view` porta un'app in primo piano.

### Dove invia la richiesta un pulsante HTTP?

Direttamente dal tuo telefono al tuo endpoint. Pocket Alert non fa da proxy alla richiesta e non vede mai il body della risposta. Aggiungi l'intestazione di autenticazione che il tuo endpoint richiede e viene inviata insieme al pulsante.

### Le etichette dei pulsanti si vedono su iPhone?

Sì. Su iPhone e Android viene mostrata l'etichetta esatta che invii, sia sulla notifica sia all'interno del messaggio. Se iOS non riesce a preparare in tempo i pulsanti personalizzati, usa un'etichetta generica per tipo (Open, Run o Copy) e il pulsante continua a funzionare.

### I webhook possono aggiungere pulsanti automaticamente?

Sì. Un webhook può includere un template di azione con segnaposto `%path%` riempiti dal payload in arrivo, così un avviso di Sentry arriva con un pulsante Open issue che punta proprio a quel problema. I valori sostituiti vengono sottoposti a escape JSON, quindi un payload non può riscrivere l'URL.

### Cosa succede se tocco un pulsante due volte?

Toccando due volte, la richiesta viene inviata due volte: le ripetizioni non sono bloccate, di proposito. Se l'invio doppio è costoso, rendi l'endpoint idempotente. I pulsanti di azione sono una funzione a pagamento; nei piani gratuiti vengono rimossi lato server e il messaggio viene consegnato senza di essi.
