Api

Интерфейс прикладного программирования

Инициализация

На странице Проекты получаем HTML-код виджета такого вида и вставляем на свою страницу.

<script async type="text/javascript" src="//api.pozvonim.com/widget/callback/v3/bc0642be22052cf391890be6b947019d/connect" id="check-code-pozvonim" charset="UTF-8"></script>

Для подключения API перед только что вставленным кодом добавляем код инициализации либо в настройках виджета указать API Callback где значение имя функции доступной из глобального объекта window. Например вы объявили функцию window.testApi = function (){};, то в настройках указываете testApi

И не забудьте включить API в настройках.
<script type="text/javascript">
var PozvonimcomWidgetConfig = {
	ready: function () {}
};
</script>

Теперь вам доступно API виджета. Полный список опций и callback'ов виджета указан в блоке Параметры

Пространство имен и получение объекта виджета

После полной инициализации виджета, он будет доступен в глобальном пространстве имен PozvonimcomWidget так же получить доступ можно через объект window.PozconimcomWidget, он сообщит вам о готовности. При помощи вызова функции которую вы указали в переменной ready , функция будет вызвана в контексте объекта виджета, то есть по this вы можете получить объект виджета

Для примера сделаем чтобы виджет сразу же показался как загрузится

<script type="text/javascript">
var PozvonimcomWidgetConfig = {
    ready: function () {
        this.api.show();
    }
};
</script>

Параметры и события и методы

Ниже перечислены все доступные параметры настройки виджета.

  • Параметры

  • callback.ready  — Callback готовности умного виджета обратной связи
  • События

  • hide  — Событие закрытие виджета
  • show  — Событие открытия виджета
  • call  — Событие звонка
  • call.delayed  — Событие отложенного звонка
  • call.delayed.respond  — Событие успешной подписки на отложенный звонок
  • call.blacklist  — Событие заблокированного звонка
  • call.success  — Событие успешного звонка
  • call.success.respond  — Событие успешного звонка, когда сервер начинает звонить менеджеру
  • call.offline  — Событие отложенного звонка
  • call.balance  — Событие недостатка средств
  • Методы

  • api.show  — Открыть виджет
  • api.hide  — Закрыть виджет
  • api.call  — Выполнить звонок из виджета
  • api.on  — Подписаться на событие
  • api.getClient  — Получить информацию о клиенте
  • api.getOptions  — Получить настройки виджета
  • api.getPhone  — Получить номер телефона
  • api.setPhone  — Ввести номер телефона
  • api.getDelayed  — Получить дату отложенного звонка
  • api.setDelayed  — Установить дату отложенного звонка
  • api.Button.show  — Показать кнопку
  • api.Button.hide  — Скрыть кнопку