Telegram

Overview

Bronjoy integrates with Telegram in three ways:

1. Client Mini App — clients book appointments through a Telegram Mini App
2. Staff notifications — staff receive booking notifications with action buttons
3. Custom bots — organizations can connect their own Telegram bot for white-label experience

Client Telegram Flow

Clients can authenticate and interact with Bronjoy through a Telegram Mini App.

Authentication

POST /api/client/auth/telegram
Content-Type: application/json

{
  "init_data": "query_id=...&user=...&auth_date=...&hash=..."
}

The init_data comes from the Telegram Mini App API. Bronjoy validates the HMAC-SHA256 signature and creates/links the client account.

Appointment actions via inline buttons

When a client receives a booking confirmation on Telegram, inline buttons allow direct actions:

• Cancel appointment — sends a callback to cancel_appointment:{id}

The bot processes the callback and confirms the cancellation in-chat.

Staff Telegram Flow

Authentication

POST /api/org/auth/telegram
Content-Type: application/json

{
  "init_data": "query_id=...&user=...&auth_date=...&hash=..."
}

Link/unlink Telegram account

Staff with an existing account can link their Telegram:

POST /api/org/telegram/link
Authorization: Bearer your-token
Content-Type: application/json

{
  "init_data": "..."
}

To unlink:

POST /api/org/telegram/unlink
Authorization: Bearer your-token

Staff notifications

When a new appointment is created, staff receive a Telegram message with:

• Client name and service details
• Date and time
• Inline buttons: Confirm / Decline

Staff can approve or reject appointments directly from Telegram without opening the dashboard.

Onboarding via Telegram

New users can create or join an organization through Telegram:

POST /api/org/telegram/create-organization
Authorization: Bearer your-token
Content-Type: application/json

{
  "name": "My Salon",
  "category": "beauty"
}

POST /api/org/telegram/join-organization
Authorization: Bearer your-token
Content-Type: application/json

{
  "invite_code": "ABC123"
}

Custom Telegram Bot (White-Label)

Organizations can connect their own Telegram bot for a branded experience. Instead of the default Bronjoy bot, clients interact with the organization's bot.

Connect a custom bot

Owner only. Requires the custom_telegram_bot feature flag.

POST /api/org/telegram-bot/connect
Authorization: Bearer your-owner-token
Content-Type: application/json

{
  "bot_token": "123456:ABC-DEF1234ghIkl-zyx57W2v1u123ew11"
}

Bronjoy validates the token via the Telegram API, sets up the webhook, and configures a menu button linking to your Mini App.

Check connection status

GET /api/org/telegram-bot
Authorization: Bearer your-owner-token

Returns bot info, webhook status, and any pending errors.

Disconnect

POST /api/org/telegram-bot/disconnect
Authorization: Bearer your-owner-token

Removes the webhook and disconnects the custom bot. The default Bronjoy bot is used instead.

Best Practices

• Connect a custom bot if your brand identity matters — clients will see your bot name and avatar
• Set up the staff bot early — it dramatically reduces response time to new bookings
• Encourage clients to use Telegram for booking — it reduces friction compared to email/phone auth