RUNBOOK job-reporte-ventas-telegram¶
| Sintoma | Causa probable | Accion |
|---|---|---|
| exit 2 "Falta la variable..." | .env incompleto |
Completar ATHENAS_DB_URL, TELEGRAM_TOKEN, TELEGRAM_CHAT_ID |
| "No hay datos de ventas para informar" | Las tablas dwh.tbl_reporte_ejecutivo_ventas_* estan vacias (carga del DWH pendiente) |
Revisar el proceso que las carga; relanzar |
| "Error Telegram: {... 'group chat was upgraded to a supergroup' ...}" | El grupo cambio de ID (ya paso el 06/08/2026) | Actualizar TELEGRAM_CHAT_ID (migrate_to_chat_id viene en la respuesta) |
| "Error Telegram: |
Sin red hacia api.telegram.org | Verificar salida a internet de la VM; el token nunca se loguea |
| "Telegram no entrego N mensaje(s)" y exit 1 | Telegram rechazo tras el reintento | Revisar el log; relanzar; si el canal es no critico usar TELEGRAM_FALLO_TOLERADO=true |
| "Error registrando tbl_control_procesos" | BD inaccesible o permisos | Los mensajes ya salieron; revisar BD |
Relanzar: python -m reporte_ventas_telegram (reenvia ambos mensajes, no hay estado).
Probar sin enviar: --dry-run.
Fuente: repositorio job-reporte-ventas-telegram, versión 3bff6fc (con cambios locales). Página generada con tools/publicar_docs.py.