Телефония
Облачные АТС подключаются в разделе «Интеграции». Общие правила (виды подключения, статусы карточки, «Только чтение», отключение) описаны на странице «Подключение сервисов». Как агент спрашивает перед действиями вроде звонка или переадресации, рассказано в «Как агент меняет данные».
В каталоге телефония лежит в категории «Мессенджеры» вместе с чатами и агрегаторами переписки (Wazzup24, Umnico, Chat2Desk и другие): их подключение описано на их страницах интеграций.
Mango Office
Виртуальная АТС: звонки, callback, SMS, статистика, записи разговоров. Подробнее на странице интеграции.
Что умеет агент
Собирает статистику звонков по группам и сотрудникам, находит пропущенные, читает записи разговоров, запускает callback и отправляет SMS в пределах прав API коннектора.
Создай отчёт по данным из @mango_office за 1–14 июня по группе «Служба поддержки»: всего входящих, принятых и пропущенных звонков; отдельно: перезвонил сам, перезвонили, не дозвонились, спам.
Что нужно заранее
Учётная запись владельца или администратора ВАТС в кабинете lk.mango-office.ru.
Шаги
Откройте «API коннектор»
В кабинете Mango Office: «Интеграции» → «API коннектор».
Подключите API коннектор
Если услуга не активна, нажмите «Подключить API коннектор», отметьте «Я принимаю условия» и подтвердите. Пока коннектор выключен, реквизиты не показываются.
Перенесите два значения
«Уникальный код вашей АТС» в поле «API-ключ», «Ключ для создания подписи» в «Соль API». Значения разные, путать их нельзя: соль участвует в подписи запросов.
Включите события звонков
Скопируйте «Адрес вебхука» из карточки подключения целиком и вставьте его в настройках API коннектора в адрес внешней системы.
Ограничения
- События приходят три: звонок завершён, состояние звонка изменилось, запись разговора готова. По ним срабатывают задачи, например разбор каждого пропущенного звонка.
- Статистика звонков в API Mango Office готовится в два шага: агент заказывает отчёт и ждёт его готовности, поэтому ответ приходит не мгновенно.
Как отозвать доступ
Нажмите «Отключить» у нас. В кабинете Mango Office API коннектор отключается в том же разделе «Интеграции».
Неполадки
- «Ключи не приняты»: перепутаны код АТС и ключ для подписи, либо коннектор выключен.
- События не приходят: адрес вебхука вставлен не целиком или не в тот API коннектор.
Билайн Облачная АТС
Облачная АТС: звонки, переадресация, запись разговоров, чёрные списки, детализация. Подробнее на странице интеграции.
Что умеет агент
Читает детализацию и записи разговоров, управляет переадресацией и чёрными списками.
Что нужно заранее
Доступ к кабинету cloudpbx.beeline.ru по учётным данным из договора и включённая услуга «Интеграция по API». Услуга платная у Билайна.
Шаги
Включите интеграцию по API
«Настройки» → вкладка «API» → переключатель «Интеграция по API».
Выпустите токен
На табе «Version 2.0» нажмите «Создать новый токен» и вставьте его в поле «Токен Portal API».
Если токена нет, на табе «Version 1.0» выдаётся пара логин и пароль: вставьте их в «Имя пользователя» и «Пароль», а «Токен Portal API» оставьте пустым. Это реквизиты вкладки «API», а не вход в кабинет.
Ограничения
Пока услуга «Интеграция по API» выключена, запросы к АТС не проходят. Событий звонков Билайн нам не присылает: новые звонки проверяет задача по расписанию.
Как отозвать доступ
Нажмите «Отключить» у нас. В кабинете Билайна выключите «Интеграцию по API» или удалите токен.
Неполадки
- «Ключи не приняты»: вставлены логин и пароль кабинета вместо реквизитов вкладки «API».
Гравител Облачная АТС
Облачная АТС: звонки, SMS, история, сотрудники, номера, АОН, кампании обзвона. Подробнее на странице интеграции.
Что умеет агент
Читает историю звонков, сотрудников и номера, запускает звонки, SMS и кампании обзвона.
Шаги
Установите интеграцию по REST API
На gravitel.ru нажмите «Войти в АТС», затем меню «Интеграции» → «Интеграция по REST API» → «Установить». Соседняя «Интеграция по API Гравител» из прошлого поколения не подойдёт.
Откройте её настройки
«Название интеграции» любое. «Адрес вашей CRM» и «Ключ для авторизации в Вашей CRM» заполнять не нужно.
Перенесите адрес и ключ
В подразделе «Авторизация» лежат адрес и ключ АТС. Ключ вставьте в «API-ключ», а в «Домен Gravitel» только домен вашей АТС (участок пути после /v1/), а не весь адрес.
Ограничения
Событий звонков Гравител нам не присылает: новые звонки проверяет задача по расписанию.
Как отозвать доступ
Нажмите «Отключить» у нас. В кабинете АТС удалите «Интеграцию по REST API».
Неполадки
- «Ключи не приняты»: в «Домен Gravitel» вставлен весь адрес, а не домен АТС, или установлена интеграция прошлого поколения.
Sipuni
IP-телефония: история и пропущенные звонки, записи разговоров, статусы сотрудников. Подробнее на странице интеграции.
Что умеет агент
Читает историю и пропущенные звонки, записи разговоров и статусы сотрудников.
Что нужно заранее
Подключённая услуга API статистики в кабинете Sipuni.
Шаги
Подключите API статистики
В старом кабинете: «Настройки» → «API» → «Статистика» → «Подключить услугу». В новом: «Интеграции» → «Интеграция по API» → «Статистика».
Скопируйте ключ интеграции
«Настройки» → «Интеграция по API» (в старом кабинете «Настройки» → «API»). Если ключа нет, нажмите «Сгенерировать» и «Сохранить». Вставьте его в «Секретный ключ».
Перенесите номер кабинета
Номер показан в правом верхнем углу. Вставьте его в «Номер кабинета Sipuni» целиком, вместе с начальными нулями.
Ограничения
Номер кабинета и ключ интеграции должны принадлежать одному аккаунту. Событий звонков Sipuni нам не присылает: новые звонки проверяет задача по расписанию.
Как отозвать доступ
Нажмите «Отключить» у нас. Ключ интеграции управляется в кабинете Sipuni, в разделе «Интеграция по API».
Неполадки
- «Ключи не приняты»: номер кабинета без начальных нулей, и подпись запроса не сходится.
Частые вопросы
Где взять ключи Mango Office?
В кабинете lk.mango-office.ru под владельцем или администратором ВАТС: «Интеграции» → «API коннектор». «Уникальный код вашей АТС» вставьте в поле «API-ключ», «Ключ для создания подписи» в «Соль API».
Как агенту узнавать о пропущенных звонках сразу?
События звонков присылает Mango Office: скопируйте «Адрес вебхука» из карточки подключения и вставьте его в настройках API коннектора. По событиям запускаются задачи, например разбор каждого пропущенного звонка. У других АТС событий нет, звонки проверяет задача по расписанию.
Подключение Sipuni не проходит. Почему?
Чаще всего номер кабинета перенесён без начальных нулей: без них подпись запроса не сходится. Скопируйте номер целиком из правого верхнего угла кабинета.
Смотрите также
Не нашли ответ? Как связаться