hechakuaa_bot/GUIA_TELEGRAM.md

# Pedrito Hechakuaa — Guía de uso del bot de Telegram

**Pedrito** es tu asistente judicial en Telegram. Te avisa cuando tenés notificaciones nuevas en el Poder Judicial y te deja consultar el estado de cualquier expediente sin salir de Telegram.

---

## Cómo empezar a usar Pedrito

### Paso 1 — Tener Telegram instalado

Pedrito funciona dentro de Telegram. Si no lo tenés:

- **Celular**: descargalo desde el App Store (iPhone) o Google Play (Android), se llama **Telegram**
- **Computadora**: también tiene app para Windows, Mac y versión web en [web.telegram.org](https://web.telegram.org)

Registrate con tu número de celular si es la primera vez.

---

### Paso 2 — Encontrar el bot

El bot se llama **@hechakuaa_bot**. Hay dos formas de abrirlo:

**Opción A — Buscar dentro de Telegram:**
1. Tocá la lupa de búsqueda (arriba en la app)
2. Escribí `hechakuaa_bot`
3. Tocá el resultado que aparece con el nombre **pedrito_hechakuaa**

**Opción B — Link directo:**
El administrador puede mandarte un link directo como este: `https://t.me/hechakuaa_bot`. Al abrirlo desde el celular te lleva directamente al chat con el bot.

---

### Paso 3 — Activarlo

Una vez en el chat con el bot, tocá el botón **Iniciar** que aparece abajo, o escribí:

```
/start
```

Pedrito responde confirmando que está activo y monitoreando tu cuenta del PJ.

> Si el bot no responde o dice que no estás autorizado, avisale al administrador — tu número de Telegram tiene que estar habilitado primero.

---

## Qué hace Pedrito automáticamente

Sin que vos hagas nada, Pedrito revisa el PJ **cada hora** de lunes a viernes entre las **7:00 y las 18:00**. Si aparece una notificación nueva, te manda un mensaje al instante.

Fuera de ese horario no te molesta. Si necesitás revisar en cualquier momento (finde, feriado, a las 11 de la noche), usá `/notif`.

---

## Comandos

### `/start`
Muestra el estado del bot y la lista de comandos disponibles.

---

### `/notif`
Revisa tus notificaciones **ahora mismo**, sin esperar a la próxima revisión automática.

Útil cuando:
- Estás esperando una notificación urgente
- Querés confirmar que no hay novedades antes de una audiencia
- Es finde o feriado y el bot no está revisando en automático

**Si hay novedades**, te las manda una por una.
**Si no hay novedades**, te responde con una confirmación:

```
✅ Sin novedades desde las 10:30 de hoy.
```

---

### `/estado`
Muestra cuándo fue la última vez que Pedrito revisó el PJ y cuántas notificaciones tiene registradas.

```
Estado de Pedrito Hechakuaa

Último chequeo: 21/05/2026 10:30
Notificaciones registradas: 47

Para revisar ahora: /notif
```

---

### `/exp`
Consulta el detalle de un expediente por número o por texto de carátula.

**Por número y año** (la forma más precisa):
```
/exp 198/2026
```

**Solo por número** (si no recordás el año):
```
/exp 198
```

**Por texto de carátula** (si no recordás el número):
```
/exp rodríguez municipalidad
```

---

### `/ayuda`
Muestra la lista de comandos disponibles.

---

## Cómo se ven las notificaciones

Cuando aparece una notificación nueva, Pedrito te manda esto:

---

📋 **Nueva notificación judicial**

Rodríguez c/ Municipalidad Capital
Exp. 1234/2024 — 1er Juzgado Civil Capital

Tipo: Auto Interlocutorio
Fecha: 21/05/2026

⚠️ Para acusar esta notificación entrá directamente en el sistema del PJ.

**[ Ir al sistema del PJ ]**

---

El botón **"Ir al sistema del PJ"** te lleva directo a la pantalla de notificaciones en `apps.csj.gov.py`.

---

## Cómo se ve la consulta de expediente

**Resultado único** — cuando buscás por número y año exacto:

---

📂 **Exp. 198/2026**
Rodríguez c/ Municipalidad Capital
1era Circunscripción | Activo

**Últimas actuaciones:**
• 20/05/2026 — Auto Interlocutorio: Resolución N° 123
• 15/05/2026 — Providencia: Autos y vistos
• 10/05/2026 — Notificación: Cédula de notificación

*(15 actuaciones en total)*

---

**Múltiples resultados** — cuando buscás por carátula o número sin año:

---

Se encontraron **3** expedientes para "rodríguez":

**1. Exp. 198/2026** — Rodríguez c/ Municipalidad Capital
   1era Circunscripción | Activo

**2. Exp. 456/2025** — Rodríguez Díaz c/ Empresa SA
   1era Circunscripción | Archivado

**3. Exp. 89/2024** — Rodríguez c/ Estado Paraguayo
   2da Circunscripción | Activo

Para ver detalle: /exp {numero}/{anio}

---

**Sin resultados:**

---

No encontré expedientes para "999999/1900".
Probá con la carátula o con número/año.

---

## ⚠️ Importante: Pedrito no acusa notificaciones

Pedrito solo **lee** el sistema del PJ, nunca escribe. Para acusar una notificación tenés que entrar vos directamente a [apps.csj.gov.py](https://apps.csj.gov.py) y hacerlo desde ahí. Acusar tiene efecto procesal — Pedrito nunca va a hacer eso por vos.

---

## Preguntas frecuentes

**¿Por qué Pedrito no me respondió?**
Solo responde a la cuenta de Telegram habilitada por el administrador. Si creaste una cuenta nueva o cambiaste de número, avisá para que te habiliten.

**¿Por qué no recibí una notificación que ya aparece en el PJ?**
Puede haber aparecido fuera del horario de monitoreo automático (antes de las 7 o después de las 18, o en fin de semana). Mandá `/notif` para revisar en el momento.

**¿Pedrito puede perderse una notificación?**
Si el sistema del PJ estuvo caído o sin conexión durante varias horas, es posible que Pedrito no haya podido revisar. En ese caso te avisa con un mensaje de advertencia. Para estar seguro, mandá `/notif` cuando volvés de un día sin conexión.

**¿Qué pasa si cambio la contraseña del PJ?**
Pedrito va a dejar de funcionar y te va a avisar por Telegram. Contactá al administrador para que actualice las credenciales — es un proceso de 2 minutos.

**¿Quién más puede ver mis notificaciones?**
Nadie. Pedrito solo responde a tu chat de Telegram. Si alguien más encuentra el bot, no puede interactuar con él.