Обязательные сценарии
Чтобы попасть на витрину Битрикс24.Маркет, ваша интеграция должна поддерживать несколько обязательных пользовательских сценариев:
- Входящий/исходящий звонок должен регистрироваться в Битрикс24 методом telephony.externalcall.register. Битрикс24 автоматически создаст нужные объекты в CRM: лид, контакт, сделку и т.д. Вам не нужно добавлять эти данные, Битрикс24 всё сделает сам в результате регистрации звонка;
- При регистрации входящего звонка нужно передавать в метод telephony.externalcall.register номер входящей линии, на который пришел звонок, чтобы поддержать сквозную аналитику Битрикс24;
- После успешного звонка нужно передавать запись разговора в Битрикс24 методом telephony.externalCall.attachRecord;
- Нужно поддержать сценарий click2call, добавив обработчик события исходящего звонка OnExternalCallStart.
- Нужно поддерживать сценарий заказа обратного звонка из CRM-форм Битрикс24, добавив обработчик события исходящего звонка OnExternalCallBackStart.
Телефонии, поддерживающие все обязательные пользовательские сценарии, будут выделены в каталоге Битрикс24.Маркет меткой "Рекомендуем".
Рекомендуемые сценарии
Помимо обязательных сценариев интеграции с телефонией, пользователи Битрикс24 ждут от качественных решений дополнительные возможности:
- Перенаправление звонка на ответственного менеджера. При входящем звонке интеграция может найти клиента в Битрикс24 по телефонному номеру, вызвав метод telephony.externalCall.searchCrmEntities. Метод вернет информацию о найденном клиенте, а также о сотруднике, который отвечает за клиента, чтобы вы могли направить звонок на этого сотрудника;
- Управление показом стандартной карточки звонка при перенаправлении звонка. Если после регистрации звонка в Битрикс24 правила обработки очереди (dial-плана) вашей ВАТС требуют перевода голосового трафика на другого сотрудника, вы можете показывать карточку звонка этому сотруднику, вызвав метод telephony.externalcall.show. Одновременно, следует убрать карточку звонка у других сотрудников, вызвав метод telephony.externalcall.hide
проверка приложений модератором
Перед публикацией вашей интеграции наши модераторы проверяют описанные выше ранее сценарии работы телефонии. Помимо этого, проверяется соответствие описаний карточки интеграции:
- Описания и данные в карточки должны соответствовать требованиям к публикации приложений в Битрикс24.Маркет;
- Карточка должна содержать тарифную сетку предоставляемых услуг или ссылку на страницу цен;
- Карточка должна содержать подробное описание функционала интеграции и инструкцию по её настройке.
Для ускорения проверки после подачи приложения на модерацию рекомендуется предоставлять модератору в чате доступы к личному кабинету АТС с привязанным внешним номером и несколькими внутренними.
— Бесплатные Сайты и CRM.