openai-status-bot/README.md

openai-status-bot

Telegram bot that watches OpenAI Status every minute and sends updates to subscribed chats. State and subscriptions are stored in Redis.

Features

• Checks OpenAI status on a configurable interval, default 1m
• Notifies subscribers about new incident updates
• Notifies subscribers when component status changes
• Uses Redis for subscribers, component status checkpoints, and seen incident updates
• Supports Telegram supergroup topics via message_thread_id
• Includes Docker Compose for local Redis + bot runtime

Bot Commands

Command	Description
/start	Subscribe current chat or topic
/stop	Unsubscribe current chat or topic
/status	Show current OpenAI status
/components	Show all OpenAI component statuses
/history [count]	Show recent incidents, default 5, max 10
/help	Show command help

Quick Start

cp .env.example .env
# edit .env and set TELEGRAM_BOT_TOKEN
docker compose up --build

For local development without Docker:

go mod tidy
go run ./cmd/openai-status-bot

Configuration

Variable	Default	Description
TELEGRAM_BOT_TOKEN	required	Telegram bot token from BotFather
REDIS_ADDR	localhost:6379	Redis address
REDIS_PASSWORD	empty	Redis password
REDIS_DB	0	Redis database number
OPENAI_STATUS_BASE_URL	https://status.openai.com	OpenAI status page base URL
POLL_INTERVAL	1m	Status check interval
HTTP_TIMEOUT	10s	HTTP request timeout
LOG_LEVEL	info	debug, info, warn, or error

Notes

The first successful poll seeds Redis and does not send historical incidents. Notifications start from later changes.