ДокументацияНастройка проекта

Телефония

для администратора школыПройти по шагам в Академии

«Телефония» — вкладка раздела «Интеграции». Здесь администратор подключает АТС, с которой работает отдел продаж, — и в TERVIO появляются «позвонить» в карточке клиента, журнал звонков, записи разговоров и ИИ-разбор (Звонки и разбор звонков). Вкладка есть, когда в проекте подключён модуль «Отдел продаж»: звонки — его часть.

С чего начать

  1. «Интеграции» → «Телефония» → «Подключить» на плитке своей АТС. Шаги — ниже и прямо на её странице.
  2. Впишите ключи из кабинета АТС → «Сохранить настройки» → «Проверить». Ответ «Готово: …» — TERVIO достучался до АТС; «Не подключилось: …» — в той же строке написано, что исправить.
  3. Привяжите сотрудников: Сотрудники → «Изменить» → «Внутренний номер в АТС» — выберите номер из списка АТС или впишите вручную → «Сохранить номер».
  4. Позвоните себе из карточки клиента: АТС наберёт ваш телефон, потом клиента. Через минуту звонок появится в переписке и в «Отделе продаж» → «Звонки».

Как работает звонок

  • Звонок обратный — менеджер нажимает «позвонить» — АТС сначала звонит ему на телефон или софтфон, он снимает трубку, и АТС соединяет его с клиентом. Гудков в браузере нет, гарнитура не нужна.
  • Журнал — TERVIO забирает журнал с АТС сам раз в минуту и раз в три часа перечитывает последние три дня — звонок не потеряется, даже если TERVIO ненадолго выключали. У МТС Exolve, UIS, МегаФона и onlinePBX журнал обновляется и при открытии вкладки «Звонки»; у Mango Office, Новофона, Sipuni и Телфина — только раз в минуту: их журнал собирается дольше или запросы к нему ограничены.
  • Записи — запись разговора TERVIO забирает у АТС ключами проекта в момент, когда её слушают или разбирают, — в браузер ссылки АТС не уходят.
  • Основная АТС — подключить можно несколько АТС — например, на время переезда. Звонит, читает журнал и отдаёт список сотрудников только основная; «Сделать основной» — на её странице. Сменили основную — проверьте внутренние номера сотрудников: у каждой АТС они свои.
  • Отключить — ключи стираются, звонить через эту АТС и забирать её журнал TERVIO перестаёт, записи её разговоров не открываются, пока АТС не подключат снова. Звонки, которые уже в журнале, остаются.
  • Ключи — после сохранения не показываются. Чтобы заменить — впишите новый; пустое поле оставит прежний. Кто и когда менял настройки — в Журнале.

МТС Exolve

Виртуальная АТС МТС Exolve. TERVIO говорит с ней по CRM API ВАТС: звонок, журнал и записи. Списка сотрудников этот API не отдаёт. Где в кабинете: Адрес ВАТС и ключ CRM API выдаёт МТС Exolve.

  1. Узнайте адрес своей ВАТС — домен вида exolve123456.vats.exolve.ru. Он стоит в SIP-адресе любого сотрудника после «@». Впишите его в поле «Адрес ВАТС» — TERVIO сам допишет путь к API.
  2. Попросите у поддержки МТС Exolve ключ CRM API для своей ВАТС (параметр token) и вставьте его в поле «Ключ CRM API». Ключ после сохранения не показывается.
  3. Нажмите «Сохранить настройки», затем «Проверить»: TERVIO запросит у ВАТС журнал за сегодня. Ответ «не принимает запросы с адреса TERVIO» значит, что МТС Exolve не пускает сервер TERVIO, — напишите в поддержку TERVIO: дорогу к Exolve настраивает платформа.
  • Сотрудники — Списка сотрудников ВАТС Exolve по API не отдаёт: в карточке каждого сотрудника впишите его SIP-номер вручную — 15 цифр до «@» в SIP-адресе.

Mango Office

Виртуальная АТС Mango Office через API коннектор: звонок, журнал, записи и список сотрудников с именами. Где в кабинете: Личный кабинет Mango Office → «Интеграции» → «API коннектор».

  1. В личном кабинете Mango Office выберите ВАТС и откройте «Интеграции» → «API коннектор». Если коннектор не подключён — «Подключить API коннектор»: для своей CRM у Mango нужна услуга «API: Возможность использовать API-конструктор».
  2. Скопируйте «Уникальный код АТС» и «Ключ для создания подписи» в одноимённые поля TERVIO. После сохранения ключи не показываются.
  3. Если в настройках API коннектора перечислены IP-адреса, с которых Mango принимает запросы, добавьте туда адрес сервера TERVIO (его подскажет поддержка TERVIO) или оставьте список пустым — иначе Mango отклонит запросы TERVIO.
  4. Чтобы слушать разговоры в TERVIO, включите в API коннекторе доступ к записям разговоров: записи должны храниться в облачном хранилище Mango.
  5. Необязательно: «Номер, который увидит клиент» — номер линии из личного кабинета, цифрами. Пустое поле — TERVIO номер линии в звонок не передаёт.
  6. Нажмите «Сохранить настройки», затем «Проверить»: TERVIO запросит список сотрудников ВАТС. Mango закрывает доступ на 2 минуты после неверных запросов — если ключ не подошёл, исправьте его и проверьте через 2 минуты.
  • Сотрудники — Mango Office отдаёт сотрудников с именами и внутренними номерами — в карточке сотрудника выберите его из списка. Сотрудник без внутреннего номера в Mango звонить из TERVIO не сможет.

Новофон

АТС Новофона через его API с ключом и секретом: звонок, журнал, записи и список внутренних номеров (без имён). Где в кабинете: Кабинет Новофона → «Пользователи АТС» → администратор → вкладка «API».

  1. В кабинете Новофона откройте «Пользователи АТС», выберите пользователя-администратора и вкладку «API». Включите «Использовать ключ API».
  2. Скопируйте Key (вида appid_…) в поле «Ключ API», а Secret — в «Секрет API». Секрет после сохранения не показывается.
  3. Нажмите «Сохранить настройки», затем «Проверить»: TERVIO запросит внутренние номера АТС. Адрес уведомлений в «Интеграции» → «Уведомления о событиях» вписывать не нужно — журнал звонков TERVIO забирает сам, раз в минуту.
  • Сотрудники — Новофон отдаёт только внутренние номера, без имён: в карточке сотрудника выберите его номер из списка (например, 100), сверившись с «Пользователями АТС» в кабинете Новофона.

UIS

Виртуальная АТС UIS через Data API и Call API: звонок, журнал, записи и список сотрудников с именами. Где в кабинете: Личный кабинет UIS → «Управление пользователями» → пользователь → «Использовать ключ API».

  1. Проверьте, что в UIS подключён Call API — компонент «Call API Базовый набор» («Тарифы и опции» или менеджер UIS). Без него UIS не начнёт звонок из TERVIO; журнал и список сотрудников TERVIO берёт через Data API.
  2. В личном кабинете UIS откройте «Управление пользователями» и настройки пользователя, от имени которого будет работать TERVIO (например, администратора). В разделе «Доступ к функциональности API» включите «Использовать ключ API» и поставьте галку «Доступ к Call API». Скопируйте ключ сразу: UIS показывает его только при создании.
  3. У ключа те же права, что у пользователя: ему нужен просмотр сотрудников и отчётов, а чтобы слушать разговоры в TERVIO — право прослушивать записи. Без него звонки придут в журнал без записей.
  4. Откройте API для сервера TERVIO: «Аккаунт» → «Безопасность» → «Права доступа», вкладка «Доступ к API» → «Добавить» — впишите адрес сервера TERVIO (его подскажет поддержка TERVIO) и сохраните. Пока список пуст, UIS не пускает к API ни один адрес.
  5. Вставьте ключ в поле «Ключ API», а в «Виртуальный номер, который увидит клиент» — номер, который вы арендуете в UIS, цифрами, например 74951234567. Без него UIS звонок не начнёт.
  6. Нажмите «Сохранить настройки», затем «Проверить»: TERVIO запросит у UIS аккаунт и список сотрудников. Звонок «Проверить» не проверяет — позвоните себе из карточки клиента.
  • Сотрудники — UIS соединяет по ID сотрудника, а не по внутреннему номеру: в карточке сотрудника выберите его из списка UIS по имени — рядом виден его внутренний номер в UIS.

Sipuni

Виртуальная АТС Sipuni через её API с номером кабинета и ключом интеграции: звонок, журнал и записи. Список сотрудников TERVIO у Sipuni не берёт — номера вписывают вручную. Где в кабинете: Кабинет Sipuni → «Интеграции» → «Интеграция по API».

  1. В кабинете Sipuni откройте «Интеграции» → «Интеграция по API», нажмите «Сгенерировать», затем «Сохранить» под полем «Ключ интеграции». Скопируйте ключ в поле «Ключ интеграции» TERVIO. В старом кабинете Sipuni это «Настройки» → «API».
  2. В «Номер кабинета Sipuni» впишите номер из левого меню кабинета («Кабинет №012345») — вместе с нулями в начале.
  3. На вкладке «Статистика» там же: если Sipuni предлагает «Подключить услугу», подключите её — через неё TERVIO забирает журнал звонков и записи.
  4. Чтобы слушать разговоры в TERVIO, включите запись: «Настройки» → «Запись звонков» — для сотрудников и схем, чьи звонки нужно записывать.
  5. Нажмите «Сохранить настройки», затем «Проверить»: TERVIO обратится к Sipuni с номером кабинета и ключом. Звонок «Проверить» не проверяет — позвоните себе из карточки клиента.
  • Сотрудники — Список сотрудников Sipuni отдаёт по API в виде, который нигде не описан, поэтому номер вписывают вручную: в карточке сотрудника — его внутренний номер в Sipuni, например 201.

Телфин

Виртуальная АТС «Телфин.Офис» через REST API с приложением АТС: звонок, журнал, записи и список внутренних номеров с именами. Где в кабинете: apiproxy.telphin.ru/app/register — приложение АТС с типом Trusted.

  1. Откройте apiproxy.telphin.ru/app/register и войдите логином и паролем администратора АТС «Телфин.Офис». Приложение создайте именно от имени администратора: TERVIO работает с правами того, кто его создал.
  2. В форме: «Application name» — любое, например TERVIO; «Application Type» — trusted; «Application Access» — Call API (так по умолчанию: TERVIO читает журнал и начинает звонки, настройки АТС не меняет). «Redirect URL» оставьте пустым и сохраните.
  3. Телфин покажет App ID и App secret. Скопируйте App ID в поле «App ID приложения», а App secret — в «App Secret приложения». Секрет после сохранения не показывается.
  4. Чтобы слушать разговоры в TERVIO, проверьте, что у внутренних номеров сотрудников включена запись разговоров.
  5. Нажмите «Сохранить настройки», затем «Проверить»: TERVIO получит доступ и запросит внутренние номера АТС.
  • Сотрудники — Телфин отдаёт внутренние номера с именами: в карточке сотрудника выберите его номер из списка — без префикса АТС, например 100.

МегаФон

Виртуальная АТС МегаФон через REST API для своей CRM: звонок, журнал, записи и список сотрудников с именами и внутренними номерами. Где в кабинете: Личный кабинет Виртуальной АТС МегаФон → «Настройки» → «Интеграция с CRM» → «Ваша CRM».

  1. В личном кабинете Виртуальной АТС МегаФон откройте «Настройки» → «Интеграция с CRM» и в конце списка выберите карточку «Ваша CRM». Впишите «Имя вашей CRM» — например, TERVIO.
  2. Нажмите «Скопировать ключ» у поля «Ключ для авторизации в АТС» и вставьте ключ в одноимённое поле TERVIO. После сохранения ключ не показывается.
  3. В поле «Адрес ВАТС» впишите адрес, по которому открывается личный кабинет ВАТС, — вида vats123456.megapbx.ru. TERVIO сам допишет путь к API.
  4. Поля «Адрес вашей CRM» и «Ключ для авторизации в вашей CRM» заполнять не нужно: журнал звонков TERVIO забирает у ВАТС сам, раз в минуту. Нажмите «Сохранить» в кабинете МегаФона.
  5. В TERVIO нажмите «Сохранить настройки», затем «Проверить»: TERVIO запросит список сотрудников ВАТС. Записи разговоров появятся в TERVIO, если запись звонков включена в ВАТС.
  • Сотрудники — МегаФон отдаёт сотрудников с именами и внутренними номерами — в карточке сотрудника выберите его из списка. Сотрудника без внутреннего номера в списке нет: заведите ему номер в кабинете ВАТС.

onlinePBX

АТС onlinePBX через её HTTP API по ключу API: звонок, журнал, записи и список внутренних номеров. Где в кабинете: Панель управления onlinePBX → «Интеграция» → «API».

  1. В панели управления onlinePBX откройте «Интеграция» → «API». Если ключа API ещё нет, сгенерируйте его.
  2. Скопируйте ключ в поле «Ключ API». После сохранения ключ не показывается. Сгенерировали в панели новый ключ — вставьте его сюда и сохраните снова.
  3. В поле «Домен АТС» впишите адрес своей АТС вида pbx12345.onpbx.ru — он виден в панели управления onlinePBX.
  4. Если в настройках API onlinePBX перечислены IP-адреса, которым разрешён доступ, добавьте туда адрес сервера TERVIO (его подскажет поддержка TERVIO) или очистите список — иначе onlinePBX ответит, что адрес запрещён.
  5. Нажмите «Сохранить настройки», затем «Проверить»: TERVIO запросит внутренние номера АТС. Записи разговоров появятся в TERVIO, если запись звонков включена в onlinePBX.
  • Сотрудники — onlinePBX отдаёт внутренние номера сотрудников (например, 100) — в карточке сотрудника выберите номер из списка, сверившись с панелью onlinePBX.

Если АТС общая с другим проектом

Каждый проект TERVIO читает журнал АТС целиком. Если одна АТС подключена к двум проектам, звонки, записи и задачи «перезвонить» клиентов одного проекта попадут в другой. Чтобы этого не было, на странице АТС в блоке «Если АТС общая с другим проектом» задайте, какие звонки принадлежат проекту, и нажмите «Сохранить отбор звонков». Отбор можно сохранить до ключей — тогда первое же чтение журнала заберёт только свои звонки.

  • Брать только звонки сотрудников проекта — звонок попадает в проект, если его принял или сделал действующий сотрудник проекта — по «Внутреннему номеру в АТС» в его карточке. У пропущенного входящего внутреннего номера нет: такой звонок возьмёт только отбор по номерам линий, без него он в проект не попадёт.
  • Номера линий проекта — звонок попадает в проект, если клиент позвонил на один из этих номеров или ему позвонили с него. Номер линии в журнале отдают МТС Exolve, Mango Office, МегаФон и onlinePBX; Новофон и Sipuni — только у входящих звонков; у UIS и Телфина его нет, там отбирайте по сотрудникам.
  • Оба отбора — проект берёт звонок, если подошёл любой из них. Подходит, когда у отдела общие сотрудники, а линии у проектов разные.
  • Что не меняется — исходящие из кнопки «Позвонить» проект получает всегда. Звонки, которые уже в журнале, отбор не удаляет. Отброшенные звонки TERVIO не хранит нигде.

onlinePBX: заведите для каждого проекта TERVIO отдельный ключ API в панели onlinePBX («Интеграция» → «API»), отдельный от ключа связки с amoCRM. Частые входы одним ключом с разных систем сбивают их сессии.

Привязать сотрудников

По внутреннему номеру АТС соединяет сотрудника с клиентом, а звонки из журнала ложатся на него. Номер — в карточке сотрудника: Сотрудники → «Изменить» → «Внутренний номер в АТС». Если АТС отдаёт список, номер выбирают из него: рядом видно имя (у Mango Office, UIS, Телфина и МегаФона) и кто в TERVIO уже занял этот номер. У UIS в списке — ID сотрудника в UIS: по нему UIS и соединяет. Нужного нет или АТС списка не отдаёт — «Другой номер — вписать вручную». Один номер — у одного сотрудника.

Пока номер не вписан, сотрудник не позвонит из TERVIO, а его звонки лягут в журнал без менеджера и не войдут в его средние в разборе звонков.

Если не работает

  • «Проверить» говорит, что ключи не подошли — скопируйте ключи из кабинета АТС заново, без пробелов по краям, и сохраните. У Mango Office после неверных запросов доступ закрывается на 2 минуты — проверьте снова через 2 минуты.
  • «АТС не знает вашего внутреннего номера» — номер в карточке сотрудника не совпадает с тем, что заведён на АТС. Выберите его из списка АТС или исправьте вручную.
  • МТС Exolve «не принимает запросы с адреса TERVIO» — МТС Exolve пускает к API не всякий адрес. Дорогу к Exolve настраивает платформа — напишите в поддержку TERVIO.
  • Mango Office отклоняет запросы — проверьте, что API коннектор подключён, а список IP-адресов в его настройках пуст или в нём есть адрес сервера TERVIO.
  • UIS «не пускает запросы с адреса TERVIO» — по умолчанию UIS закрывает API для всех адресов. Добавьте адрес сервера TERVIO в «Аккаунт» → «Безопасность» → «Права доступа», вкладка «Доступ к API», — его подскажет поддержка TERVIO.
  • UIS: звонки приходят без записей — у пользователя, чей ключ вписан в TERVIO, нет права прослушивать разговоры. Дайте его в «Управлении пользователями» UIS.
  • Sipuni «не нашёл кабинет с таким номером» — впишите номер кабинета из левого меню кабинета Sipuni вместе с нулями в начале, например 012345.
  • Телфин «приложение создано не от имени администратора» — создайте приложение заново на apiproxy.telphin.ru/app/register под логином администратора АТС и сохраните новые App ID и App secret.
  • МегаФон «не приняла ключ» — в кабинете ВАТС откройте «Настройки» → «Интеграция с CRM» → «Ваша CRM», скопируйте «Ключ для авторизации в АТС» заново и сохраните его в TERVIO. «Нет связи с ВАТС МегаФон» — проверьте «Адрес ВАТС»: это адрес вашего личного кабинета, вида vats123456.megapbx.ru.
  • onlinePBX «не пускает запросы с адреса TERVIO» — в настройках API onlinePBX включён список разрешённых IP-адресов. Добавьте адрес сервера TERVIO (его подскажет поддержка TERVIO) или очистите список.
  • Звонка нет в журнале — журнал приходит раз в минуту; у Mango Office его сборка может занять ещё немного. Внутренние звонки между сотрудниками в журнал TERVIO не попадают — только разговоры с клиентами.