Телефония
Что это#
Подсказка на экране в момент входящего звонка. Когда гость звонит в заведение, оператор связи присылает уведомление, система находит гостя по номеру и поднимает его карточку на Борде броней: имя, уровень, баланс бонусов, число визитов, ближайшая бронь. Хостес отвечает, уже зная, кто на линии.
Незнакомый номер тоже показывается, но без профиля.
Важно: звонок нигде не сохраняется — это живая подсказка в момент дозвона, а не журнал звонков и не запись разговоров. Маршрутизацией звонка система тоже не управляет: кто куда попадает, решает ваша АТС.
Раздел в кабинете#
Раздел Телефония. Настраивает только Владелец. Изменения журналируются.
Кого поддерживаем#
У трёх операторов разбор нативный — вебхук приходит в их собственном формате, ничего переводить не нужно:
| Оператор | Что делает владелец | Особенность |
|---|---|---|
| МегаФон — Виртуальная АТС | вставляет наш адрес в «Другая CRM (REST API)» | если включить определение имени клиента, имя гостя появится на экране трубки до снятия |
| Билайн — Облачная АТС | вставляет ключ API, адрес не нужен | подписку на звонки система оформляет и продлевает сама |
| МТС — Виртуальная АТС / Автосекретарь | вставляет наш адрес в CRM → «Собственная разработка» | если просит логин и пароль — логин любой, пароль = токен из адреса |
| Mango Office | вставляет наш адрес как адрес уведомлений | |
| Telphin, UIS, Sipuni | нативного разбора пока нет | настраиваются форматом «Универсальный (JSON)» |
| Универсальный (JSON) | шлёт наш формат на общий адрес | для любого оператора и самописной АТС |
Адрес приёма единый — различается только разбор тела.
Билайн — единственный, у кого нечего вписывать на его стороне: у него нет поля для адреса уведомления. Система сама ходит в его API по вашему ключу, оформляет подписку на события звонков и продлевает её — подписка живёт сутками. Состояние видно строкой «Подписка» прямо в разделе: если она долго «не оформлена» — ключ не принят.
Включение и адрес#
«Телефония включена» — пока выключено, входящие звонки игнорируются.
Адрес для оператора — ссылка с секретным токеном внутри. Показывается один раз в момент выпуска; дальше раздел говорит только «выдан» или «не выдан».
Формат «Универсальный (JSON)»: POST на выданный адрес с телом {"event":"incoming","phone":"+7…","callId":"…"}.
Как настроить#
- Откройте Телефония.
- Выберите оператора — под списком появится инструкция именно для него.
- Поставьте галочку «Телефония включена».
- Нажмите «Выдать адрес».
- Скопируйте показанный адрес целиком — он показывается один раз и содержит секретный токен.
- Сделайте то, что просит инструкция оператора: вставьте адрес в его кабинете (МегаФон, МТС, Mango) — либо, для Билайна, вставьте его ключ API в поле в нашем разделе.
- Позвоните с номера известного гостя и убедитесь, что карточка поднялась на борде.
Адрес потерян — нажмите «Выдать новый адрес». Старый сразу перестаёт работать, новый нужно прописать у оператора заново.
Номера этого заведения#
Отдельный блок в том же разделе — городские и мобильные номера, по которым гость звонит именно сюда.
Нужен, когда одна АТС обслуживает несколько заведений: в кабинете оператора адрес интеграции один на весь аккаунт, и без списка номеров все звонки достанутся тому заведению, в чьём кабинете заведена интеграция. Со списком звонок уходит на борд того зала, на чей номер позвонил гость.
Одно заведение — один владелец номера: занятый номер система второму заведению не отдаст.
Номеров нет — звонки достаются этому заведению целиком.
На что влияет#
- Карточка гостя всплывает на борде броней у хостес.
- На бонусы, брони и любые данные гостя телефония не влияет — она ничего не записывает.
Типичные ошибки#
- Адрес скопировали не целиком. Токен — часть адреса; копируйте строку полностью.
- Адрес выдали, но не прописали у оператора. Уведомления никуда не идут — карточка не поднимется.
- Выдали новый адрес и забыли обновить настройку у оператора. Звонки перестают доходить. Обновляйте адрес у оператора сразу после перевыпуска.
- Билайн: ждут поля для адреса. Его нет и не будет — Билайну нужен только ключ API из его личного кабинета.
- Билайн: «Подписка не оформлена» не проходит. Ключ не принят оператором — возьмите его заново в Облачной АТС.
- Телефония настроена, но галочка «включена» снята. Звонки игнорируются.
- Сеть на одной АТС: звонки валятся в одно заведение. Не заполнен список номеров — заполните его в каждом заведении.
- Ожидание журнала звонков или записи разговоров. Не предусмотрено — только подсказка в момент звонка.
- Карточка не поднимается для «своего» гостя. Номер, с которого звонят, не совпадает с телефоном в карточке (звонок с другого номера, скрытый номер).
- «Настройку телефонии меняет только владелец точки». Вы под другой ролью.