API для телефонии
1. Общие сведения об API API позволяет подключить к ПланФикс любую вашу собственную Облачную АТС. Интеграция ПланФикс и Облачной АТС решает несколько бизнес-задач: - получение имени звонящего по номеру телефона, для того, чтобы его можно было отобразить на экране телефона или sip-клиента; - автоматическая маршрутизация входящего звонка от клиента на менеджера, который закреплен за этим клиентом; - отображение информации о входящем звонке непосредственно внутри ПланФикс (всплывающее окно при звонке) - сохранение в ПланФиксе истории всех звонков и записей разговоров; - совершение исходящих звонков сразу из интерфейса ПланФикса. Интеграция должна быть двухсторонней. Поэтому часть запросов ПланФикс посылает в сторону Облачной АТС на указанные точки входа, а часть запросов, наоборот, Облачная АТС посылает в сторону ПланФикса на единую точку входа. Взаимодействие производится по протоколу HTTPS. Авторизация осуществляется по адресу ПланФикса или Облачной АТС соответственно и авторизационному ключу, полученному в процессе настройки интеграции.
2. Принцип авторизации и взаимодействия HTTPS: - Запросы к ПланФикс принимаются только по протоколу HTTPS. Это обеспечивает достаточный уровень безопасности для общения систем через Интернет. - В целях безопасности ваших данных, пожалуйста, реализуйте прием запросов на стороне АТС также с использованием HTTPS. Ключ (token): - Дополнительно для авторизации каждого запроса к ПланФикс используется специальный ключ (token). Получить его можно в настройках интеграции. - Пожалуйста, реализуйте прием запросов на стороне АТС также с использованием ключа (token). Сгенерируйте ключ и вставьте его в соответствующее поле в разделе настройки интеграции. - Ключи создаются один раз при настройке интеграции. При необходимости, вы можете сменить ключ на своей стороне и обновить его интерфейсе ПланФикса. Запросы от Облачной АТС к ПланФиксу: - Запросы необходимо отправлять на указанный в настройках интеграции адрес для приема уведомлений. - В теле запроса в специальном поле «token» необходимо всегда передавать специальный ключ. Запросы от ПланФикса к Облачной АТС: - ПланФикс будет отправлять все запросы на указанный в настройках интеграции адрес. - В теле сообщений ПланФикс будет передавать указанный вами в веб-кабинете ключ (token). Ответы - Все ответы на запросы Облачной АТС ПланФикс присылает в формате JSON в теле ответа. - Все ответы на запросы ПланФикса Облачная АТС должна присылать в формате JSON в теле ответа. 3. Список команд API От Облачной АТС к ПланФикс: - contact (POST) - event (POST) - record (POST) От ПланФикса к Облачной АТС: - makeCall (POST)