Telegram

Интеграции

Интеграция с Telegram Mini App — запись клиентов, уведомления сотрудникам и собственные боты.

Обзор

Bronjoy интегрируется с Telegram тремя способами:

Клиентское Mini App — клиенты записываются через Telegram Mini App
Уведомления сотрудникам — сотрудники получают уведомления о записях с кнопками действий
Собственные боты — организации могут подключить свой Telegram-бот для white-label решения

Сценарий для клиентов

Клиенты могут авторизоваться и взаимодействовать с Bronjoy через Telegram Mini App.

Аутентификация

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

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

Значение init_data приходит из Telegram Mini App API. Bronjoy проверяет подпись HMAC-SHA256 и создаёт или связывает аккаунт клиента.

Действия с записью через inline-кнопки

Когда клиент получает подтверждение записи в Telegram, inline-кнопки позволяют выполнить действия напрямую:

Отменить запись — отправляет callback cancel_appointment:{id}

Бот обрабатывает callback и подтверждает отмену прямо в чате.

Сценарий для сотрудников

Аутентификация

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

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

Привязка и отвязка аккаунта Telegram

Сотрудники с существующим аккаунтом могут привязать свой Telegram:

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

{
  "init_data": "..."
}

Чтобы отвязать:

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

Уведомления сотрудникам

При создании новой записи сотрудник получает сообщение в Telegram, содержащее:

Имя клиента и детали услуги
Дату и время
Inline-кнопки: Подтвердить / Отклонить

Сотрудники могут подтверждать или отклонять записи прямо в Telegram, не открывая панель управления.

Онбординг через Telegram

Новые пользователи могут создать организацию или присоединиться к ней через 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"
}

Собственный Telegram-бот (white-label)

Организации могут подключить свой Telegram-бот, чтобы работать под собственным брендом. Вместо стандартного бота Bronjoy клиенты взаимодействуют с ботом организации.

Подключение собственного бота

Только для владельца. Требуется флаг функциональности custom_telegram_bot.

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

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

Bronjoy проверяет токен через Telegram API, настраивает вебхук и добавляет кнопку меню со ссылкой на ваше Mini App.

Проверка статуса подключения

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

Возвращает информацию о боте, статус вебхука и текущие ошибки, если они есть.

Отключение

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

Удаляет вебхук и отключает собственный бот. Вместо него снова используется стандартный бот Bronjoy.