booking-notify_skill

Overview

This skill provides dual-channel booking notifications using Telegram for scheduled digests and Pushover for real-time emergency alerts with custom sounds. It runs a scheduled sync to detect new, rescheduled, or cancelled bookings and relays urgent events instantly via a webhook. The design prioritizes reliability with file-based state tracking and a circuit breaker to avoid cascade failures.

How this skill works

A scheduled sync (default 6h polling) fetches recent bookings from the Cal.com API, compares them to a local state file, and detects changes: new bookings, cancellations, and reschedules. Detected changes produce HTML-formatted Telegram messages for digests and per-event alerts. If Pushover credentials are provided, an instant webhook relay sends plain-text emergency notifications with custom sounds and acknowledgement options.

When to use it

• Keep teams informed of booking lifecycle events without manual checking
• Deliver urgent booking alerts (reschedule/new) that require immediate acknowledgement
• Provide an HTML daily digest or on-demand search via Telegram
• Integrate with continuous workflows that need calendar-sync signals
• Operate in Telegram-only environments but optionally add Pushover for escalation

Best practices

• Verify required environment variables (Cal.com op UUID, Telegram bot token, chat ID) before enabling the skill
• Keep the local state file backed up or versioned to avoid missed deltas after restores
• Enable Pushover only for emergency escalation; test custom sound and acknowledgement behavior
• Use the circuit breaker and monitor API error rates to prevent notification storms
• Deploy the webhook relay to a managed service for reliable Pushover delivery

Example use cases

• Daily HTML digest to a team chat summarizing new, cancelled, and upcoming bookings
• Real-time Pushover emergency alert for a high-priority interview reschedule requiring confirmation
• Webhook bridge that converts Cal.com events to plain-text Pushover messages with 'dune' sound
• Automated calendar sync workflow that triggers follow-up tasks on booking changes
• Manual run for immediate reconciliation or to re-send missed notifications after downtime