Digite pelo menos duas letras para buscar em todas as páginas da documentação.

↑ ↓ para navegar ↵ para abrir esc para fechar

Usando o rdev

Notificações

O rdev avisa quando o seu agente de IA precisa de você. Deixe um agente trabalhando no seu servidor, feche o laptop e receba uma notificação no celular quando o agente terminar, aguardar a sua aprovação ou encontrar um erro.

Como funciona

A notificação é enviada direto do seu servidor para um canal que é seu. Ela nunca passa pelos servidores do rdev, então o texto que o seu agente escreve fica entre o seu servidor e você.

Todos os planos incluem notificações:

Plano Canais
Single Um canal pessoal
Pro Vários canais
Team Um canal por usuário, mais um canal compartilhado da equipe

Eventos

Você escolhe de quais eventos quer ser avisado:

  • Terminar: o agente concluiu a tarefa.
  • Aguardar aprovação: o agente quer executar um comando que precisa da sua permissão.
  • Parar por um erro: algo deu errado e o agente parou.

Canais suportados

  • ntfy: a nossa sugestão padrão. É gratuito, não precisa de conta, tem apps para celular e também pode rodar no seu próprio servidor.
  • Gotify: um servidor de notificações hospedado por você.
  • Telegram: mensagens do seu próprio bot.
  • Slack e Discord: uma mensagem em um canal, por um webhook de entrada.
  • Pushover: notificações push para os seus dispositivos.
  • Webhook: um evento JSON enviado para qualquer URL, para as suas próprias integrações.

O que a mensagem contém

Por padrão, uma notificação é um resumo curto, como "rdev · myapp · finished", sem o texto do agente. Se preferir, você pode mudar para a mensagem completa: a última resposta do agente é incluída, com tudo o que parecer um segredo (chaves de API, tokens, senhas, chaves privadas) mascarado e o texto encurtado para um tamanho seguro.

Agentes suportados

O Claude Code e o Codex enviam notificações de fábrica: o rdev os conecta para você pelas configurações gerenciadas deles, então a configuração permanece no lugar. Outros agentes podem enviar notificações se suportarem hooks ou puderem executar um comando quando terminarem.

Configurando pelo painel

Abra o servidor em Servidores na barra lateral e depois em Acesso. No card Notificações, Adicionar canal abre o formulário do canal, com o ntfy selecionado:

  1. O formulário gera um nome de tópico aleatório que ninguém consegue adivinhar. Instale o app ntfy no celular, toque em + e assine esse tópico, ou abra no celular o link https://ntfy.sh/<topic> exibido abaixo dele, ou escaneie o QR code dele com a câmera do celular. O QR code é desenhado no seu navegador; o tópico nunca chega ao painel. Para o seu próprio servidor ntfy, informe o endereço dele e um token de acesso, se ele precisar de um.
  2. Criptografar e salvar. As configurações do canal (o tópico, os tokens e as URLs de webhook) são criptografadas no seu navegador para este servidor: o painel nunca as vê e não consegue exibi-las depois. O card mostra apenas um rótulo curto para cada canal, e alterar um canal significa informar as configurações dele de novo. Em Alterar você também pode mudar o canal para outro tipo (Gotify em vez de ntfy, por exemplo); no plano Single, de canal único, é assim que você muda o tipo.
  3. Enviar teste no canal. A resposta do servidor, como "sent" ou o motivo da falha, aparece na página.

Para Gotify, Telegram, Slack, Discord, Pushover ou um webhook, escolha-o no formulário e informe as configurações dele. Abaixo dos canais, você escolhe os eventos (terminar, aguardar aprovação, parar por um erro) e se a última resposta do agente é incluída. O plano Single envia para um canal; Pro e Team podem adicionar mais. O guia de configuração do painel tem um passo opcional Receba notificações no seu celular, que é marcado quando um servidor tem um canal. Isso exige o rdev 0.2.0-beta.36 ou posterior; até o servidor executá-lo, o card pede que você atualize.

Configurando pelo servidor

Você também pode configurar o canal no seu servidor. O ntfy é o mais rápido: instale o app dele no celular, escolha um nome de tópico que ninguém consiga adivinhar e execute:

sudo rdev notify setup ntfy --topic my-secret-topic

Depois envie uma mensagem de teste para verificar se ela chega:

rdev notify test

Adicione --server https://ntfy.example.com para o seu próprio servidor ntfy e --token se ele precisar de um. Os canais Gotify, Telegram, Slack, Discord, Pushover e webhook vão em /etc/rdev/notify.toml, que o rdev notify setup cria; o seu agente de IA pode adicionar um para você e enviar um teste. No Pro e no Team você pode listar vários canais ali; o Single envia para o primeiro.

Se um canal estiver inacessível, os outros canais ainda recebem a notificação, e o seu agente continua trabalhando: um problema de notificação nunca interrompe uma tarefa.

Notificações no painel

Além dos seus próprios canais, o painel guarda uma lista curta dos mesmos eventos em Notificações, na barra lateral, com o número de não lidas ao lado; no celular, o sino no topo abre essa lista. Ela mostra o projeto, o agente, o que aconteceu (esperando por você, terminou, parou por um erro) e o servidor, nunca o texto do agente. Toque em uma para abrir a tela dela. Abrir a lista marca tudo como lido. Marque algumas e exclua-as, ou use Excluir tudo. As notificações são guardadas por 30 dias. Todos que gerenciam o servidor as recebem, então no plano Team proprietários e administradores também veem os agentes dos membros.