Files
hechakuaa_bot/GUIA_TELEGRAM.md
markosbenitez 7743919695 Initial commit — Pedrito Hechakuaa v0
Bot de Telegram para monitoreo de notificaciones judiciales del PJ Paraguay.
Multi-tenant con onboarding conversacional, audit log, y polling automático.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-05-25 10:58:32 -03:00

5.9 KiB

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

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 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.