Как подключить телефонию

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

Настройки телефонии находятся в разделе «Звонки» → вкладка «Настройки» → «Телефония». Соседняя подвкладка «Правила разбора» — про то, как AI оценивает разговоры: см. разбор звонков.

Наверху вкладки — плашка состояния: когда был последний звонок и сколько их прошло за последние 30 дней. Кнопка «Проверить подключение» тут же проверит, что всё настроено верно.

Три способа подключения

• Мегафон ВАТС — если у вас уже есть облачная АТС оператора Мегафон. Самый быстрый способ: несколько полей и включение интеграции в личном кабинете ВАТС.
• Свой SIP — мы разворачиваем телефонию на своей стороне и подключаем транк оператора (Zadarma или МТТ) под ваш номер. Подходит, если Мегафона нет или вы хотите единую точку входа для звонков без отдельной облачной АТС.
• Приложение — определитель звонков без всякой АТС: обычный телефон заведения с нашим приложением ресепшна сам сообщает о звонках. Самый простой способ, если АТС нет вообще.

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

Webhook URL — для Мегафона и своего SIP

Под выбором провайдера — блок с адресом (Webhook URL) и кнопкой копирования. Это адрес, который нужно вставить в настройках у оператора связи, чтобы события звонков доходили до WellCa. Адрес свой для каждого способа подключения и меняется автоматически при переключении провайдера. Для способа «Приложение» этот блок не нужен — приложение отправляет события само.

Как подключить Мегафон ВАТС

1. Войдите в личный кабинет ВАТС Мегафон (<ваш-аккаунт>.megapbx.ru) под администратором.
2. Откройте «Настройки» → «Интеграции» → «CRM» и включите интеграцию.
3. Скопируйте Webhook URL из блока выше кнопкой копирования и вставьте его в поле адреса CRM в личном кабинете Мегафона.
4. Задайте в ВАТС ключ crm_key и укажите тот же ключ в поле «CRM-ключ (crm_key)» во вкладке «Настройки» — по нему система отличает ваши звонки от звонков других заведений.
5. В разделе API личного кабинета скопируйте адрес ВАТС и ключ API, вставьте их в поля «Адрес ВАТС» и «Ключ API».
6. Включите в Мегафоне отправку событий: входящий звонок, ответ, завершение и история звонков.
7. Заполните номера заведения (см. ниже) и нажмите «Сохранить».
8. Нажмите «Проверить подключение» и позвоните на свой номер для контроля.

Как подключить свой SIP

1. Обратитесь к нам — мы заведём вам домен на своей АТС и подключим транк оператора под ваш номер.
2. Мы выдадим секрет вебхука — вставьте его в поле «Секрет вебхука».
3. Заполните блок «Данные SIP-транка (от оператора)»: оператор (Zadarma, МТТ или «Другой»), сервер, порт, логин (SIP ID), пароль и транспорт. Все эти данные берутся в личном кабинете оператора связи в разделе SIP/транк. По ним мы поднимаем регистрацию на своей АТС, поэтому без них линия не заработает.

• Сервер указывается как адрес узла оператора, например sip.zadarma.com. Если вы вставите строку вида sip://sip.zadarma.com:5060, система сама уберёт лишнее и подставит порт.
• Порт по умолчанию — 5060 (для TLS обычно 5061). Транспорт можно оставить «По умолчанию (UDP)», если оператор не требует иного.
• Пароль хранится закрытым: в поле видны только последние символы. Не трогайте его, если не меняете — при сохранении останется прежний.

1. Укажите свои номера в списке номеров заведения (см. ниже).
2. Нажмите «Сохранить» и позвоните на свой номер: в блоке состояния наверху должен появиться свежий звонок.
3. Запись разговора сохраняется автоматически на нашей стороне — отдельная настройка не нужна.

Как подключить приложение на телефоне

Этот способ не требует АТС: определителем становится обычный телефон заведения, на который звонят гости.

1. Выберите провайдера «Приложение» — под переключателем появится блок с кнопкой «Скачать APK», ссылкой и QR-кодом. Скачайте файл на компьютер кнопкой или отсканируйте QR-код тем самым телефоном, чтобы скачать приложение сразу на него.
2. Установите приложение на телефон. Android спросит разрешение на установку из неизвестных источников — разрешите.
3. Войдите в приложении под администратором того заведения, к которому подключаете телефон.
4. Откройте страницу «Синк» и включите тумблер «Определитель номера». Android спросит доступ к телефону и журналу звонков — без этого разрешения приложение звонки не увидит.
5. Момент включения тумблера — это и есть привязка телефона к заведению. Под тумблером написано, к какому заведению телефон привязан; звонки будут уходить именно туда.
6. Дальше можно выйти из администратора и работать под учётной записью ресепшна: определитель остаётся включённым и продолжает передавать звонки в привязанное заведение. Переключение заведения в приложении на это не влияет — если нужно перевести телефон на другую точку, нажмите на карточке «Синк» кнопку перепривязки.
7. Нажмите «Сохранить» в настройках телефонии и позвоните на телефон заведения — в блоке состояния появится свежий звонок, а на устройствах всплывёт карточка гостя.

Ограничения способа: событие о звонке приходит с телефона, поэтому запись разговора не ведётся (Android не даёт приложениям доступ к аудио звонка) — записи есть только у Мегафона и своего SIP. Определитель работает на Android; на iPhone такой возможности нет.

Зачем нужны номера заведения

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

Один номер телефона может быть закреплён только за одним заведением. Если вы попытаетесь добавить номер, который уже занят другим заведением, интерфейс покажет ошибку — уточните номер или снимите его с прежнего заведения.

Если список номеров пуст, входящие звонки не попадут в это заведение — заполните номера обязательно, даже если у вас одна точка. Для способа «Приложение» заведение определяется привязкой телефона, но номера всё равно полезно заполнить — по ним звонки узнаются в отчётах.

Секреты и унаследованные значения

Ключи и секреты (Ключ API, CRM-ключ, секрет вебхука, пароль SIP) в интерфейсе всегда показаны замаскированными, например ••••1234, — реальное значение не отображается повторно. Если вы просто просматриваете настройки и не трогаете такое поле, при сохранении оно останется прежним.

Если поле подсвечено пометкой «взято из серверной конфигурации» — значит, значение сейчас общее, заданное нами при подключении. Впишите туда своё значение и сохраните — оно заменит общее для вашего заведения.

Как проверить, что всё работает

• Кнопка «Проверить подключение» наверху вкладки — быстрая проверка без реального звонка. Для способа «Приложение» она показывает, доходили ли звонки с телефона.
• Позвоните на подключённый номер заведения — в блоке состояния должны обновиться «Последний звонок» и счётчик за 30 дней.
• При входящем звонке на подключённые устройства (например, офлайн-приложение ресепшна) должна всплывать карточка гостя.

Если звонки не приходят

• Проверьте, что Webhook URL из блока выше действительно вставлен в личном кабинете оператора (Мегафон) или совпадает с тем, что мы вам выдали (свой SIP) — при смене провайдера адрес меняется, и старый перестаёт работать.
• Для Мегафона — убедитесь, что в личном кабинете включена отправка всех нужных событий (входящий, ответ, завершение, история) и что ключ crm_key совпадает в обеих системах.
• Для своего SIP — проверьте блок «Данные SIP-транка»: без сервера и логина мы не сможем поднять регистрацию у оператора, и проверка подключения об этом предупредит.
• Для приложения — на телефоне должен быть включён тумблер «Определитель номера», выданы разрешения на телефон и журнал звонков, а привязка на карточке — указывать нужное заведение. Если телефон долго был без интернета, события уйдут, как только связь появится.
• Проверьте, что номер, на который звонят, есть в списке номеров заведения — иначе звонок может не найтись или попасть не в ту точку.
• Если поле с ключом или секретом недавно сохраняли пустым по ошибке — впишите значение заново и сохраните: пустое поле не восстанавливается само.
• Для своего SIP, если ничего не помогает, напишите нам — настройка на нашей стороне могла не подхватить транк оператора.

Дальше

• Офлайн-приложение ресепшна (ПК и планшет) — как выглядит всплывающая карточка гостя при входящем звонке и где ещё скачать приложение.
• Карта гостя — что видит сотрудник в карточке, которая открывается по звонку.

Кому всплывает карточка звонка

Карточка входящего звонка появляется у тех сотрудников, у кого в правах должности есть доступ к разделу «Телефония». По умолчанию это ресепшн, админ зала, старший админ и управляющий; повар, бармен и официант её не видят — вместе с карточкой к ним не уходят и данные звонящего (телефон, баланс, заметки о госте).

Если карточка нужна другой должности — или наоборот, кому-то мешает, — снимите или выдайте право «Телефония» в «Настройки» → «Права доступа» у соответствующей должности.

Как выключить карточку себе

Управляющему и владельцу звонки обычно приходят «за компанию» и только мешают. Выключить их можно себе, не затрагивая ресепшн:

1. в разделе «Брони» нажмите колокольчик в правом верхнем углу — он гасит и всплывающие сообщения гостей, и карточки звонков;
2. либо нажмите значок перечёркнутого колокольчика прямо в карточке звонка — это то же самое, только не надо искать настройку.

Настройка личная и запоминается: она переживает перезагрузку страницы и действует на других устройствах под этой же учётной записью. Крестик в карточке — другое дело: он скрывает только текущий звонок, следующий всплывёт снова.

Связанная тема: уведомления персоналу в Telegram и MAX.