Агентство · Интеграции

Каналы связи и подключения

Уведомления платформы и сообщения пассажирам

Telegram агентства

Бот агентства · @silkroad_hy_bot

Бот платформы — вход и подтверждения; бот агентства — уведомления и сообщения клиентам.

Зачем два бота

Два бота: бот платформы HY B2B — вход сотрудников и подтверждение действий; бот агентства @silkroad_hy_bot — уведомления сотрудникам и сообщения клиентам. Официальный бот платформы никогда не просит пароль или код из SMS.

Кому идут ответы клиентов

✓{{r.t}} {{r.d}}

Открыть Telegram Inbox →

Если владелец не ответил

Через {{tgSlaMin}} мин или если владелец не на смене — тред уходит в очередь офиса «Без владельца», клиент получает автоответ.

Часы ответа офиса: 09:00–21:00 · вне часов — автоответ с временем ответа.

Проверки канала

ПДнСогласие клиента фиксируется в треде, /stop отзывает · документы в превью маскируются · переписка хранится 3 года, удаление и выгрузка — через DPO (S4) · личные Telegram сотрудников не подключаются.

Подключение к бизнес-аккаунту

Откройте корпоративный аккаунт агентства (+998 71 ••• •• 04) → Настройки → Telegram для бизнеса → Чат-боты.
Добавьте бота платформы @hy_b2b_business_bot. К аккаунту подключается только один бизнес-бот.
Разрешите боту отвечать от имени аккаунта и выберите, к каким чатам у него доступ.

Доступ к чатам

Исключены: 2 личных контакта директора. Любой чат можно поставить на паузу в Telegram — тогда сотрудники не видят его в Inbox.

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

Шаг 1. Создайте бота в Telegram

Откройте в Telegram официальный бот для создания ботов (BotFather).
Отправьте команду /newbot и задайте имя: «SilkRoad Travel — уведомления».
Задайте адрес бота, оканчивающийся на «bot», например silkroad_hy_bot.
Скопируйте токен доступа — он понадобится на следующем шаге. Никому не пересылайте токен в чатах.

Почему свой бот

Пассажиры видят название вашего агентства, а не платформы. Платформа хранит токен в зашифрованном хранилище и показывает его только маскированным.

Отключить бота можно в любой момент — сообщения уйдут по SMS и e-mail.

Шаг 2. Вставьте токен

Токен бота

После сохранения токен показывается так: 7412••••••:AAH•••••••••••Qx

Бот

SilkRoad Travel — уведомления

@silkroad_hy_bot

Токен действителен

Тестовое сообщение

Отправлено в канал «SilkRoad — операции» 24.02.2027 10:59

Доставлено за 0,8 с

Права бота

Отправка сообщений ✓ · Администратор канала ✓ · Чтение переписки — не требуется

Шаг 4. Какие события отправлять

Шаг 5. Получатели

Получатель	Тип	События	Статус
SilkRoad — операции	Канал агентства	Расписание, исключения (waiver), ADM, объявления HQ	Подключён
Кассиры (12 из 86)	Личные чаты сотрудников	Сроки «Выписать до» своих броней, оплата получена	74 не подключились
Пассажиры	По согласию из ссылки брони	Ссылка на оплату, изменение рейса, напоминание о вылете	1 284 подписки

Пассажир подписывается сам со страницы брони (пример — экран «Подписка пассажира»). Без согласия сообщения пассажиру в Telegram не отправляются.

Посмотреть экран подписки пассажира

E-mail: домен отправителя

DMARC не настроен

Домен

Адрес отправителя

Адрес для ответов

Запись	Тип	Имя	Значение	Статус
{{r.k}}	{{r.type}}	{{r.name}}	{{r.val}}	{{r.st}}

Пока домен не подтверждён полностью, письма уходят с адреса платформы с подписью «от имени SilkRoad Travel».

SMS

Имя отправителя

SILKROAD

Одобрено оператором

Провайдер

SMS-шлюз платформы

Тарификация — по договору платформы

За февраль

3 912 SMS

Доставлено 98,6% · 1 742 400 UZS · счёт платформы 28.02 → строка во взаиморасчётах

Шаблоны

Вебхуки в CRM агентства

URL

https://crm.silkroad.uz/hooks/hy

События

booking.created, ticket.issued, balance.debited, payment.captured, payment.split_settled (сплит платежа), schedule.changed, waiver.opened

Секрет подписи

whsec_••••••••••3f9a

Надёжность за 7 дней

99,2% · повторы: 3 попытки, до 1 ч

Время	Событие	Объект	Ответ	Длительность
{{h.time}}	{{h.ev}}	{{h.obj}}	{{h.code}}	{{h.ms}}

API-ключи

Название

Права

offers:read bookings:read tickets:issue — запрещено политикой HQ

Срок90 дней · IP-ограничение: 185.74.5.0/24

Название	Ключ	Права	Создан	Истекает	Использован
{{k.n}}	{{k.key}}	{{k.scope}}	{{k.c}}	{{k.e}}	{{k.u}}

Ключ показывается полностью один раз при создании. Выписка билетов через API недоступна агентствам по политике HQ — только через терминал.

Выгрузка в 1С:Бухгалтерию

последняя 24.02 06:30 · 1 286 записей

Формат

EnterpriseData (XML) · запасной CSV

Расписание

ежедневно 06:30, после суточного отчёта T+1

Куда

папка обмена 1С · buh@silkroad.uz

Что выгружается и маппинг счетов

Объекты: продажи, возвраты, обмены, EMD, сборы агентства, комиссия на балансе, ADM и ACM, пополнения и погашения кредита, курсовые разницы (курс ЦБ РУз), услуги платформы.

Статья платформы	Дебет	Кредит	Комментарий
Пополнение депозита у EuroAsia GSA	4890	5110	аванс контрагенту
Выписка: к перечислению авиакомпании	6990	4890	по агентскому договору, не выручка
Комиссия агентства	4890	9030	вознаграждение агента
Сбор агентства	4010	9030 · 6410 (НДС)	по налоговому режиму
Курсовые разницы	9620	9540	курс ЦБ РУз на дату

Файл EnterpriseData сформирован · 3 914 записей

Маппинг меняет бухгалтер; изменение маппинга и создание ключей выгрузки — с подтверждением второго сотрудника. Та же выгрузка доступна в «Отчётах» и «Взаиморасчётах».

Журнал доставки сообщений

Все каналы Только ошибки

Время	Канал	Получатель	Событие	Бронь	Статус
{{l.time}}	{{l.ch}}	{{l.to}}	{{l.ev}}	{{l.pnr}}	{{l.st}}

Получатели маскируются. Недоставленное в Telegram автоматически уходит по SMS, если пассажир дал согласие на оба канала.