Botões de ação
Uma notificação pode ter até três botões. Em vez de ler um alerta e depois abrir o notebook para resolver, você age direto na tela de bloqueio: abre a execução, dispara o reinício, copia o código.
Os três tipos
| Tipo | O que o botão faz | value contém |
|---|---|---|
view | Abre uma URL | A URL, por exemplo https://status.example.com |
http | Envia uma requisição HTTP em segundo plano | Uma string JSON: {"url":"…","method":"POST","headers":{…},"body":"…"} |
copy | Copia texto para a área de transferência | O texto literal a ser copiado |
Para http, só url é obrigatório — method usa GET por padrão. Quando body está presente e nenhum tipo de conteúdo é definido, Content-Type: application/json é adicionado automaticamente.
http e copy funcionam sem abrir o app, mesmo quando ele está fechado. view traz o app ou o navegador para o primeiro plano.
Onde os botões aparecem
Os botões são exibidos na notificação do sistema no iOS e no Android, com o app aberto, em segundo plano ou fechado, e também ficam dentro da própria mensagem. Essa segunda parte é importante: se você arrastar o banner para fora, os botões continuam lá quando abrir a mensagem depois.
- Rótulos são exibidos exatamente como você envia, em ambas as plataformas. Se o iOS não conseguir preparar os botões personalizados a tempo, ele usa um rótulo genérico por tipo — Abrir, Executar, Copiar — e os botões continuam funcionando.
- Tela de bloqueio.
httpecopyfuncionam direto da tela de bloqueio, sem desbloquear.viewabre o app ou o navegador, então o celular pede para desbloquear primeiro. No Android, os botões só aparecem na tela de bloqueio se ela estiver configurada para mostrar o conteúdo das notificações. - Requisições com falha. Se uma requisição
httpfalhar (status diferente de 2xx/3xx ou erro de rede), aparece uma notificação com um botão Tentar novamente. Uma requisição que pode ter chegado ao seu servidor nunca é repetida automaticamente. - Versão do app. Os botões na notificação do sistema exigem o app Pocket Alert 2.0.1 ou superior. Versões anteriores mostram os botões apenas dentro da mensagem.
Fluxos de aprovação
Dois botões http — Aprovar e Recusar — transformam uma notificação em um painel de controle com um toque. O padrão funciona para qualquer coisa que fique pausada esperando uma pessoa:
- Um pipeline de deploy que trava esperando aprovação manual
- Um agente de LLM que precisa de aval antes de gastar dinheiro ou mexer em produção
- Um reembolso acima de um limite
- Uma porta, um portão, uma luz, uma garagem
A requisição vai direto do celular para o seu endpoint. O Pocket Alert não faz proxy dela e não vê o corpo da resposta.
A idempotência é sua responsabilidade
Tocar duas vezes no mesmo botão http envia a requisição duas vezes — não bloqueamos repetições. Se disparar em duplicidade for caro, torne o endpoint idempotente.
Botões vindos de webhooks
Webhooks podem carregar um modelo de ação com placeholders %path%, preenchidos a partir do payload recebido. Um alerta do Sentry pode chegar com um botão Abrir issue funcionando, apontando para aquela issue específica; um evento do Stripe, com um botão Ver pagamento para aquela cobrança.
Os valores substituídos recebem escape JSON antes de o modelo ser interpretado, então um campo do payload com aspas não consegue sair do lugar e reescrever a URL. Se um botão resolver para algo inválido, por exemplo um botão Runbook quando o alerta não tem URL de runbook, só esse botão é descartado; os demais botões e a mensagem continuam sendo entregues. Um botão malformado nunca faz você perder o alerta.
Você pode definir o modelo no console ao criar ou editar um webhook, ou pela API de webhooks.
Limites e validação
- No máximo 3 botões por mensagem; eles aparecem na ordem em que você os envia.
- O array
actionspode ter no máximo 2048 bytes depois de codificado em JSON. Ele viaja dentro do push, que tem limite de 4 KB, então ummessagelongo é encurtado para dar espaço. viewehttpexigem uma URLhttp(s)válida. Qualquer outra coisa retorna400na API; em um modelo de webhook, o botão inválido é descartado.- Valores de
typedesconhecidos retornam400.
Recurso pago
Botões de ação são removidos das mensagens em planos gratuitos, no servidor. A mensagem em si é entregue normalmente.
Relacionado
- Criar mensagem — o array
actionse a referência completa da requisição - Níveis de prioridade — o quanto alto o alerta toca
- Configurações de webhook — modelos de ação em webhooks de entrada