Notificações push em que você pode agir.
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.
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.
De um alerta simples a uma ação de um toque
Escolha um tipo
Decida o que o botão deve fazer: abrir uma URL, chamar um endpoint ou copiar um valor.
Adicione à mensagem
Adicione um array actions à sua mensagem com até três entradas, cada uma com type, label e value.
Toque pelo celular
Envie. Os botões aparecem na notificação e dentro da mensagem no aplicativo.
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.
Dúvidas respondidas
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.
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.
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.
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.
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.
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.
Pare de só ler alertas. Comece a responder a eles.
Adicione um array de actions à sua próxima mensagem e a notificação deixa de ser só algo que você lê. Ela passa a ser algo que você toca.