# Notificações push em que você pode agir.

> Adicione botões de ação às notificações push com o Pocket Alert. Abra uma URL, dispare uma requisição HTTP ou copie texto direto da tela de bloqueio. Crie fluxos de aprovação com um toque para deploys e agentes de IA.

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

Última atualização: 2026-10-25

Anexe até três botões a qualquer push. Abra um link, dispare uma requisição HTTP ou copie um valor, sem desbloquear o celular nem abrir um notebook.

Documentação: https://info.pocketalert.app/features/action-buttons.html

## De um alerta simples a uma ação de um toque

1. **Escolha um tipo** — Decida o que o botão deve fazer: abrir uma URL, chamar um endpoint ou copiar um valor.
2. **Adicione à mensagem** — Adicione um array actions à sua mensagem com até três entradas, cada uma com type, label e value.
3. **Toque pelo celular** — Envie. Os botões aparecem na notificação e dentro da mensagem no aplicativo.

## Três tipos de botão, um único array

Uma notificação que apenas informa algo é uma notificação que você precisa resolver em outro lugar. Os botões fecham essa lacuna.

- **Vá direto ao ponto** — Um botão view abre uma URL, como o build que falhou, o pedido ou o painel, sem que você precise procurar a aba.
- **Execute uma requisição em segundo plano** — Um botão http dispara uma requisição com o seu método, cabeçalhos e corpo. Reinicie um serviço ou reconheça um incidente com um toque.
- **Copie sem complicação** — Um botão copy coloca um valor na área de transferência. Códigos de uso único, IDs de incidentes e tokens, sem precisar selecionar texto no celular.
- **Fluxos de aprovação** — Dois botões http com os rótulos Aprovar e Recusar transformam uma push em um painel de controle de um toque para qualquer coisa que dependa de uma pessoa.
- **Eles sobrevivem ao banner** — Os botões ficam dentro da mensagem, não só no banner. Deslize a notificação para o lado e eles continuam lá depois.
- **Botões a partir de webhooks** — Modelos de webhook preenchem as URLs dos botões a partir do payload recebido, então cada alerta leva à sua própria issue, pedido ou build.

## Como funcionam os botões de ação

    
Adicione um array `actions` a qualquer mensagem enviada pela API, por um webhook ou pelo servidor MCP. Cada entrada tem um `type`, um `label` e um `value` cujo significado depende do tipo: uma URL para `view`, uma descrição JSON da requisição para `http` e um texto literal para `copy`.

    
Os botões são entregues junto com a push e renderizados pelo sistema operacional. Quando você toca em um deles, o aplicativo o processa localmente: `http` e `copy` são executados sem abrir nada, enquanto `view` traz o navegador para o primeiro plano.

    
## O padrão de aprovação

    
A configuração que vale a pena construir primeiro são dois botões `http`, Aprovar e Recusar, apontando para dois endpoints seus. Qualquer processo que pare aguardando uma pessoa se encaixa: um pipeline de deploy bloqueado por aprovação manual, um reembolso acima de um limite ou um agente de IA que não deve mexer em produção sem supervisão.

    
Como a requisição vai do celular diretamente para o seu endpoint, o que você colocar por trás dessas URLs é totalmente seu, inclusive a autenticação.

    
## Limites que vale conhecer

    
No máximo três botões. `view` e `http` exigem uma URL http(s) válida, e qualquer outra coisa retorna `400`. Os botões funcionam na notificação do sistema com o aplicativo aberto, em segundo plano ou fechado, a partir do Pocket Alert 2.0.1; versões mais antigas do aplicativo os mostram apenas dentro da mensagem.

## Perguntas frequentes

### Quantos botões uma notificação pode ter?

Três por mensagem. Eles aparecem na ordem em que você os envia, tanto no iOS quanto no Android, e continuam disponíveis dentro da própria mensagem depois que o banner é dispensado.

### O que um botão pode fazer?

Três tipos. `view` abre uma URL, `http` envia uma requisição HTTP em segundo plano com o seu próprio método, cabeçalhos e corpo, e `copy` coloca um valor na área de transferência. Só o `view` traz um aplicativo para o primeiro plano.

### Para onde um botão HTTP envia a requisição?

Direto do seu celular para o seu endpoint. O Pocket Alert não faz proxy da requisição e nunca vê o corpo da resposta. Adicione o cabeçalho de autenticação que o seu endpoint espera e ele viaja junto com o botão.

### Os rótulos dos meus botões aparecem no iPhone?

Sim. Tanto o iPhone quanto o Android mostram exatamente o rótulo que você envia, na notificação e dentro da mensagem. Se o iOS não conseguir preparar os botões personalizados a tempo, ele usa um rótulo genérico por tipo (Abrir, Executar ou Copiar) e o botão continua funcionando.

### Os webhooks podem adicionar botões automaticamente?

Sim. Um webhook pode trazer um modelo de ação com placeholders `%path%` preenchidos a partir do payload recebido, então um alerta do Sentry chega com um botão Abrir issue apontando para aquela issue específica. Os valores substituídos recebem escape de JSON, então um payload não consegue reescrever a URL.

### O que acontece se eu tocar em um botão duas vezes?

Ao tocar duas vezes, a requisição é enviada duas vezes. Repetições não são bloqueadas, de propósito. Se disparar duas vezes for custoso, torne o endpoint idempotente. Os botões de ação são um recurso pago; nos planos gratuitos eles são removidos no servidor e a mensagem é entregue sem eles.
