# Boutons d’action

Une notification peut contenir jusqu’à trois boutons. Plutôt que de lire une alerte puis d’ouvrir un ordinateur portable pour agir, vous agissez depuis l’écran verrouillé : ouvrez l’exécution, déclenchez le redémarrage, copiez le code.

## Les trois types

| Type | Action du bouton | `value` contient |
|------|----------------------|---------------|
| `view` | Ouvre une URL | L’URL, par ex. `https://status.example.com` |
| `http` | Envoie une requête HTTP en arrière-plan | Une chaîne JSON : `{"url":"…","method":"POST","headers":{…},"body":"…"}` |
| `copy` | Copie un texte dans le presse-papiers | Le texte exact à copier |

Pour `http`, seul `url` est obligatoire — `method` vaut `GET` par défaut. Lorsque `body` est présent et qu’aucun type de contenu n’est défini, `Content-Type: application/json` est ajouté automatiquement.

`http` et `copy` s’exécutent sans ouvrir l’application, même lorsqu’elle est fermée. `view` place l’application ou le navigateur au premier plan.

## Où apparaissent les boutons

Les boutons s’affichent dans la notification système sur iOS et Android, que l’application soit ouverte, en arrière-plan ou fermée, et ils sont aussi présents dans le message lui-même. Cette seconde partie est importante : si vous faites glisser la bannière, les boutons restent disponibles lorsque vous ouvrez le message plus tard.

- **Libellés** : ils sont affichés exactement tels que vous les envoyez, sur les deux plateformes. Si iOS ne peut pas préparer les boutons personnalisés à temps, il utilise un libellé générique par type — **Ouvrir**, **Exécuter**, **Copier** — et les boutons fonctionnent quand même.
- **Écran verrouillé.** `http` et `copy` s’exécutent depuis l’écran verrouillé sans déverrouillage. `view` ouvre l’application ou le navigateur, le téléphone demande donc d’abord le déverrouillage. Sur Android, les boutons ne s’affichent sur l’écran verrouillé que si celui-ci est configuré pour afficher le contenu des notifications.
- **Requêtes en échec.** Si une requête `http` échoue (statut autre que 2xx/3xx ou erreur réseau), une notification avec un bouton **Réessayer** apparaît. Une requête susceptible d’avoir atteint votre serveur n’est jamais relancée automatiquement.
- **Version de l’application.** Les boutons de notification système nécessitent l’application Pocket Alert 2.0.1 ou ultérieure. Les versions antérieures n’affichent les boutons que dans le message.

## Flux d’approbation

Deux boutons `http` — **Approuver** et **Refuser** — transforment une notification en panneau de contrôle d’un seul geste. Ce schéma convient à tout processus qui attend une validation humaine :

- Un pipeline de déploiement bloqué dans l’attente d’une approbation manuelle
- Un agent LLM qui a besoin d’une validation avant de dépenser de l’argent ou de toucher à la production
- Un remboursement au-delà d’un seuil
- Une porte, un portail, une lumière, un garage

La requête part directement du téléphone vers votre point de terminaison. Pocket Alert ne la relaie pas et ne voit pas le corps de la réponse.

> **Warning: La gestion des doubles appels vous incombe**
>
> Appuyer deux fois sur le même bouton `http` envoie la requête deux fois — nous ne bloquons pas les répétitions. Si un double envoi est coûteux, rendez le point de terminaison idempotent.

## Boutons issus des webhooks

Les webhooks peuvent transporter un modèle d’action avec des espaces réservés `%path%`, remplis à partir de la charge utile entrante. Une alerte Sentry peut arriver avec un bouton **Ouvrir le ticket** fonctionnel pointant vers ce ticket précis ; un événement Stripe avec un bouton **Voir le paiement** pour ce paiement.

Les valeurs substituées sont échappées au format JSON avant l’analyse du modèle : un champ de la charge utile contenant des guillemets ne peut donc pas sortir du cadre et réécrire l’URL. Si un bouton aboutit à une valeur invalide, par exemple un bouton **Runbook** lorsque l’alerte ne contient pas d’URL de runbook, seul ce bouton est supprimé ; les autres boutons et le message sont tout de même livrés. Un bouton mal formé ne vous fait jamais perdre l’alerte.

Vous pouvez définir le modèle dans la console lors de la création ou de la modification d’un webhook, ou via l’[API des webhooks](https://info.pocketalert.app/api/webhooks/create.md#action-buttons-template).

## Limites et validation

- Maximum **3** boutons par message ; ils s’affichent dans l’ordre d’envoi.
- Le tableau `actions` peut peser au maximum **2048 octets** une fois encodé en JSON. Il voyage dans la notification push, limitée à 4 Ko : un `message` long est donc raccourci pour faire de la place.
- `view` et `http` exigent une URL `http(s)` valide. Toute autre valeur renvoie `400` sur l’API ; dans un modèle de webhook, le bouton invalide est supprimé.
- Les valeurs `type` inconnues renvoient `400`.

> **Warning: Fonctionnalité payante**
>
> Les boutons d’action sont retirés côté serveur des messages envoyés avec l’offre gratuite. Le message lui-même est livré normalement.

## Voir aussi

- [Créer un message](https://info.pocketalert.app/api/messages/create.md) — le tableau `actions` et la référence complète de la requête
- [Niveaux de priorité](https://info.pocketalert.app/features/priority-levels.md) — l’intensité avec laquelle l’alerte se fait remarquer
- [Paramètres des webhooks](https://info.pocketalert.app/api/webhooks/settings.md) — modèles d’action sur les webhooks entrants
