Телефония

Что это#

Подсказка на экране в момент входящего звонка. Когда гость звонит в заведение, телефония присылает уведомление, система находит гостя по номеру и поднимает его карточку на Борде броней: имя, уровень, баланс бонусов, число визитов. Хостес отвечает, уже зная, кто на линии.

Незнакомый номер тоже показывается, но без профиля.

Важно: звонок нигде не сохраняется — это живая подсказка в момент дозвона, а не журнал звонков и не запись разговоров.

Раздел в кабинете#

Раздел Телефония. Настраивает только Владелец. Изменения журналируются.

Провайдер#

Провайдер	Как разбирается
Mango Office	Нативный разбор уведомления
Telphin	Нормализованное уведомление
UIS	Нормализованное уведомление
Sipuni	Нормализованное уведомление
Универсальный (JSON)	Наш нормализованный формат

Для провайдера без готового адаптера выберите «Универсальный (JSON)» и настройте в его кабинете отправку уведомления в этом формате. Адрес приёма единый — различается только разбор тела.

Включение и токен#

«Телефония включена» — пока выключено, входящие звонки игнорируются.

Вебхук-токен — секрет, которым ваш провайдер подписывает обращения к системе. Показывает состояние: «выдан» или «не выдан».

Как настроить#

Откройте Телефония.
Выберите провайдера.
Поставьте галочку «Телефония включена».
Нажмите «Выпустить токен».
Скопируйте показанный URL вебхука целиком — он показывается один раз и содержит секретный токен.
Вставьте этот URL в кабинете вашего провайдера телефонии как адрес уведомления о входящем звонке.
Сделайте тестовый звонок с номера известного гостя и убедитесь, что карточка поднялась на борде.

Если URL потерян — нажмите «Перевыпустить токен». Старый URL сразу перестаёт работать, новый нужно прописать у провайдера заново.

На что влияет#

Карточка гостя всплывает на борде броней у хостес.
На бонусы, брони и любые данные гостя телефония не влияет — она ничего не записывает.

Типичные ошибки#

URL скопировали без токена / по частям. Копируйте строку целиком.
Токен выпустили, но не прописали у провайдера. Уведомления никуда не идут — карточка не поднимется.
Перевыпустили токен и забыли обновить настройку у провайдера. Звонки перестают доходить. Всегда обновляйте URL у провайдера сразу после перевыпуска.
Телефония настроена, но галочка «включена» снята. Звонки игнорируются.
Ожидание журнала звонков или записи разговоров. Не предусмотрено — только подсказка в момент звонка.
Карточка не поднимается для «своего» гостя. Номер, с которого звонят, не совпадает с телефоном в карточке (звонок с другого номера, скрытый номер).
«Настройку телефонии меняет только владелец точки». Вы под другой ролью.