Интеграция IP-телефонии по API Restoplace

Интеграция виртуальной облачной АТС (ip-телефонии) позволяет выводить в личном кабинете входящие звонки, с отображением информации о госте (имя, активные созданные брони), с возможностью создать новую бронь на основе входящего звонка. Как работать со звонками в Restoplace смотрите в руководстве хостес

Пример отображения звонков в электронной книге резервов Restoplace

Интеграция по API

ССЫЛКА ДЛЯ ЗАПРОСОВ REST API:

https://telephony.restoplace.cc/api/incoming/

ПЕРЕДАВАЕМЫЕ ПАРАМЕТРЫ:

{ 
    "secret": "b1e1e9abc81711b91ea54dc40545d6b2c9123", 
    "call_id": "111111.1", 
    "status": "call", 
    "phone": "79000000000", 
    "extension_id": ""
}

secret — секретный ключ, сгенерированный в личном кабинете Restoplace (обязательно) Где взять секретный ключ в Restoplace

call_id — Уникальный внутренний номер звонка в вашей системе IP-телефонии (обязательно)

status — статус входящего звонка (обязательно)

extension_id — внутренний номер сотрудника (не обязательно)

СПИСОК ПЕРЕДАВАЕМЫХ СТАТУСОВ ЗВОНКА (status)

Параметр	Описание
call	входящий звонок, трубку ещё не взяли
talking	входящий звонок, оператор взял трубку и разговаривает
ended	звонок завершён успешно
missed	звонок пропущен, не взяли трубку

ВНУТРЕННИЙ НОМЕР СОТРУДНИКА (extension_id)

Внутренний номер необходим для вывода звонков в Restoplace у сотрудников, которые относятся только к ним. Так же будут выводится звонки со статусом «call», у которого не указан внутренний номер сотрудника (т.к. внутренний номер ещё не присвоен в самой IP-телефонии). Если у сотрудника не указан внутренний номер в настройках Restoplace, то будут выводится все поступающие входящие звонки.

Как добавить внутренние номера сотрудников в Restoplace

Примеры ответов запросов

ОТВЕТ УДАЧНОГО ЗАПРОСА:

{
"method": "call",
"success": "Звонок добавлен"
}

method — метод запроса success — текст успешного запроса

ОТВЕТ НЕВЕРНОГО ЗАПРОСА:

{
  "error": "Invalid Key"
}

error — текст ошибки запроса

Где взять «секретный ключ» в Restoplace

На главном экране сервиса app.restoplace.cc, перейдите в адрес заведения. Вы попадёте в книгу резервов адреса. Нажмите кнопку «Настройки» в правом верхнем углу.

Настройка адреса Restoplace

В левом меню настроек адреса, раскройте пункт «Интеграции» и выберите подпункт «IP-телефония», включите галочку «Интеграция по API», нажмите «Создать ключ» и скопируйте ваш секретный ключ

Секретный ключ IP-телефонии в Restoplace

Как добавить внутренние номера сотрудников (не обязательно)

Внутренний номер необходим для вывода звонков в Restoplace у сотрудников, которые относятся только к ним. Если у сотрудника в Restoplace установлен внутренний номер, то у него будут выводится звонки, у которых был указан внутренний номер сотрудника. Если у сотрудника не указан внутренний номер в настройках Restoplace, то будут выводится все поступающие входящие звонки.

Для добавления внутренних номеров сотрудников, в админке app.restoplace.cc, перейдите в «адрес заведения» — «Настройки адреса»— «Интеграции» — «IP-телефония»

Нажмите кнопку «+ Добавить сотрудника», выберите сотрудника из добавленных в Restoplace и введите его внутренний номер. Нажмите «Сохранить»

Как добавить сотрудников в Restoplace смотрите в отдельной инструкции

Внутренние номера сотрудников в Restoplace