Телефония

Здесь заведение подключает свою АТС к колл-центру Mison. Когда оператор отвечает на входящий звонок, АТС сообщает об этом Mison, и в открытой у оператора форме нового заказа сам подставляется номер звонящего, а по нему находится карточка клиента.

Настройка одна на логин (сеть): одна АТС и один список операторов для всех точек.

Где находится

Внешние сервисы → Телефония

Какие АТС поддерживаются

В поле Тип сейчас доступен один провайдер — Sarkor (облачная АТС sip.uz). Других АТС в Mison нет: если заведение работает с другой телефонией, автоматическая подстановка номера у него не заработает.

Как это устроено

1. Клиент звонит, оператор снимает трубку.
2. АТС Sarkor отправляет в Mison событие «звонок принят» (ACCEPTED) с номером клиента и внутренним номером оператора, который ответил.
3. Mison находит логин заведения по ключу из события, а по внутреннему номеру — сотрудника из списка Сотрудники на этой странице.
4. У этого сотрудника в колл-центре, в открытой форме нового заказа, в поле телефона клиента подставляется номер звонящего и запускается поиск клиента.

Другие события АТС (входящий вызов до ответа, завершение звонка и т. п.) Mison не обрабатывает — важен только момент, когда оператор ответил.

Чек-лист подключения

№	Что сделать	Где
1	Создать ключ интеграции и скопировать его	Внешние сервисы → API
2	Выбрать тип АТС и привязать внутренние номера к сотрудникам	Внешние сервисы → Телефония
3	Прописать в Sarkor адрес для событий и ключ	Настройки CRM-интеграции в кабинете Sarkor
4	Проверить тестовым звонком	Колл-центр, форма нового заказа

Шаг 1. Ключ интеграции

АТС подписывает каждое событие ключом (параметр crm_token). Этот ключ — API-KEY из раздела Ключи интеграции, по нему Mison понимает, к какому заведению относится звонок.

1. Откройте Внешние сервисы → API (страница Ключи интеграции).
2. Нажмите Создать.
3. Заполните Название — например, «Телефония Sarkor». Остальные поля для телефонии не нужны.
4. Сохраните ключ.
5. В строке ключа откройте меню и нажмите Копировать — в буфер попадёт значение из колонки API-KEY.

tip

Заведите для АТС отдельный ключ, а не используйте ключ, выданный интегратору сайта или приложения. Тогда его можно заменить, не ломая другие интеграции.

Шаг 2. Настройка раздела «Телефония»

Элемент	Что делает
Тип	Провайдер АТС. Выберите Sarkor. Обязательное поле
Блок с параметрами	Появляется после выбора типа. Показывает, куда и как АТС должна отправлять события — см. ниже. Только для чтения
Сотрудники и кнопка +	Список операторов, у которых будет подставляться номер. Кнопка + добавляет строку
Сотрудник	Сотрудник Mison, под чьим входом оператор работает в колл-центре
ID	Внутренний номер (extension) этого оператора в АТС Sarkor
Кнопка × в строке	Удаляет привязку сотрудника
Отмена	Возвращает на страницу Интеграции без сохранения
Сохранить	Записывает настройку

Блок с параметрами для Sarkor выглядит так:

Строка	Значение
webhook_url	https://backend.mison.uz/api/v1/integrations/atc/sarkor — адрес, на который АТС отправляет события
method	POST
auth	Ключ передаётся в теле запроса в поле crm_token, значение — API-KEY из шага 1

Порядок действий:

1. Откройте Внешние сервисы → Телефония.
2. В поле Тип выберите Sarkor.
3. Нажмите + рядом с заголовком Сотрудники.
4. В поле Сотрудник выберите оператора колл-центра.
5. В поле ID введите его внутренний номер в АТС — ровно так, как он записан в Sarkor (например, 703).
6. Повторите шаги 3–5 для каждого оператора.
7. Нажмите Сохранить.

Примечание

В списке Сотрудник показываются только активные сотрудники той торговой точки, под которой вы сейчас работаете в кабинете. Один сотрудник может быть в списке только один раз. Если сотрудника потом уволили (деактивировали), номер ему подставляться перестанет.

warning

Внутренний номер сверяется с АТС посимвольно. Если в Sarkor у оператора номер 703, а в поле ID введено 703 с пробелом или другой номер, звонок до оператора дойдёт, но номер в Mison не подставится.

Шаг 3. Настройка на стороне Sarkor

В CRM-интеграции АТС Sarkor нужно указать два значения из Mison:

Что	Значение
Адрес для событий (webhook)	https://backend.mison.uz/api/v1/integrations/atc/sarkor
CRM-токен	API-KEY из шага 1

Sarkor должен отправлять события звонков методом POST. Mison ожидает в событии такие поля:

Поле	Что это	Пример
crm_token	Ключ заведения	API-KEY из Ключей интеграции
type	Тип события, обрабатывается только ACCEPTED	ACCEPTED
phone	Номер клиента	998901234567
ext	Внутренний номер ответившего оператора	703

Что видит оператор при звонке

Оператор работает в колл-центре под своим входом — тем сотрудником, который привязан к внутреннему номеру на этой странице.

1. Оператор заранее открывает форму нового заказа в колл-центре.
2. Клиент звонит, оператор снимает трубку.
3. В поле телефона клиента подставляется номер звонящего.
4. Если клиент с таким номером уже есть — подтягивается его карточка: имя, второй телефон, адреса, заметка, баланс лояльности, число заказов. Если клиента нет — форма остаётся для ввода нового клиента.

Номер подставляется только в таких условиях:

Условие	Почему важно
Открыта форма нового заказа	В редактирование существующего заказа номер не подставляется
Форма открыта до звонка	Событие, пришедшее раньше открытия формы, игнорируется
Ответил именно этот оператор	Номер получает только сотрудник, чей внутренний номер ответил на звонок, остальные операторы его не видят

Настройка самого колл-центра (типы заказов, оплаты, меню) описана на странице Колл-центр.

Как проверить работу

1. Убедитесь, что в разделе Телефония выбран Sarkor и у оператора заполнен ID.
2. Попросите оператора войти в колл-центр под своим сотрудником и открыть новый заказ.
3. Позвоните на номер колл-центра и дождитесь, пока оператор ответит.
4. В форме заказа должен появиться номер, с которого вы звоните.

Если номер не появился, проверку можно сделать без звонка: отправить на адрес https://backend.mison.uz/api/v1/integrations/atc/sarkor POST-запрос с телом {"crm_token": "API-KEY заведения", "type": "ACCEPTED", "phone": "998901234567", "ext": "703"}. Ответ {"success": true} значит, что Mison принял событие; если при этом у оператора с номером 703 в открытой форме появился номер — проблема на стороне настроек Sarkor.

Частые вопросы

При сохранении ошибка «Поле integration provider id обязательно для заполнения.» Не выбран Тип. Выберите Sarkor и сохраните снова.

Ошибка «Поле users.0.user id обязательно для заполнения.» В одной из строк блока Сотрудники не выбран сотрудник (цифра в тексте — номер строки, считая с нуля). Выберите сотрудника или удалите пустую строку кнопкой ×.

Ошибка «Поле users.1.user id имеет повторяющееся зачение.» Один и тот же сотрудник добавлен дважды. Оставьте одну строку.

Ошибка «Дубликат» при первом сохранении. Телефония у этого логина уже сохранена. Обновите страницу — откроется существующая настройка, правьте её.

Удалил только что добавленного сотрудника, а после обновления страницы он вернулся. Строки, добавленные после первого сохранения, получают связь с сервером только после перезагрузки страницы. Обновите страницу и удалите сотрудника ещё раз.

Звонки идут, оператор отвечает, но номер не подставляется. Проверьте по порядку: оператор вошёл в колл-центр именно под тем сотрудником, который привязан на этой странице; форма нового заказа была открыта до звонка; ID совпадает с внутренним номером в Sarkor; в Sarkor прописаны адрес https://backend.mison.uz/api/v1/integrations/atc/sarkor и актуальный API-KEY; сотрудник активен.

Заведение работает не с Sarkor, а с другой АТС. Другие АТС в Mison не подключаются — в поле Тип есть только Sarkor.