From 89a32a1f6e4e9acf22c29cbbd64cbb1882c676ee Mon Sep 17 00:00:00 2001
From: "gpt-engineer-app[bot]"
 <159125892+gpt-engineer-app[bot]@users.noreply.github.com>
Date: Thu, 23 Apr 2026 20:36:38 +0000
Subject: [PATCH] Changes

Co-authored-by: domfelipe <53182096+domfelipe@users.noreply.github.com>
---
 README.md | 15 +++++++++++++++
 1 file changed, 15 insertions(+)

diff --git a/README.md b/README.md
index 1f21e85..1bfbbec 100644
--- a/README.md
+++ b/README.md
@@ -39,6 +39,21 @@ Já configuradas via `.env` (gerado automaticamente pelo Lovable Cloud):
 - `ADMIN_TELEGRAM_CHAT_ID` — chat ID do admin que recebe as notificações (ex: `179720882`).
 - (opcional, Fase 5) credenciais SSH para Hermes
 
+## Keep-alive dos agentes (substitui UptimeRobot)
+
+A Edge Function `keep-alive-agents` mantém todos os containers Railway ativos automaticamente — **não há nada para configurar por agente**. A cada 4 minutos:
+
+1. Carrega todos os `agent_instances` com `status = 'active'` e `telegram_bot_token_vault_id` preenchido.
+2. Faz `GET https://api.telegram.org/bot{token}/getMe` para cada um (em paralelo, com falhas isoladas).
+3. Esse tráfego de saída do container Hermes evita que o Railway hiberne instâncias ociosas.
+
+Agendado via `pg_cron` (job `keep-alive-agents-every-4min`, schedule `*/4 * * * *`). Consultar/desagendar:
+
+```sql
+SELECT * FROM cron.job WHERE jobname = 'keep-alive-agents-every-4min';
+SELECT cron.unschedule('keep-alive-agents-every-4min');
+```
+
 ---
 
 ## Fase 3 — Telegram Onboarding (✅ entregue)