Подключение Ringostat к KeyCRM осуществляется в несколько шагов, вы сможете:

• Обрабатывать звонки в KeyCRM;
• Видеть кто звонит;
• Создавать покупателей и заказы прямо из карточки звонка;
• Видеть всю историю звонков, с записями.

Шаг 1. Получаем необходимую информацию с кабинета Ringostat

Перейдите в личном кабинете Ringostat в раздел «Интеграции», найдите «KeyCRM» и нажмите «Подключить»:

Скопируйте данные с полей «API Key» и «ID проекта», оставьте эту вкладку открытой и переходите к следующему шагу.

Шаг 2. Создаем и настраиваем канал телефонии в KeyCRM

Перейдите в «Настройки» → «Коммуникации» → вкладка «Телефония» и нажмите кнопку «Добавить новую службу».

В появившемся окне на вкладке «Основные»:

1. Название — ведите название телефонии;
2. Сервис телефонии — выберите «Ringostat»;
3. Ringostat API Key — введите API Key из кабинета Ringostat;
4. Ringostat Project ID — введите ID проекта из кабинета Ringostat;
5. Ссылка на Webhook — скопируйте ссылку для дальнейших настроек;
6. Использовать deep link —  активируйте, если вы используете софтфон, поддерживающий эту технологию;
7. Связь с воронками – включите и выберите значение:
   • Нет — карточки НЕ будут создаваться автоматически;
   • Одноразовый — карточки будут созданы только один раз при условии, что еще нет карточки с этим номером;
   • Повторяющийся — карточки будут создаваться всегда при повторных вызовах при условии, что у номера нет карточки в рабочих статусах (все статусы кроме успешного и отклоненных);
8. Тип звонка — выберите тип звонков, с которых будут создаваться карточки: только входящие, только исходящие или все входящие и исходящие;
9. Воронка — укажите воронку для создания карточки. Если у вас только одна воронка, она выбирается автоматически, а самого поля с выбором не будет;
10. Источник — выберите источник, с которым будет создаваться карточка. Если не выбрать – карточка создается с пустым значением в поле источника.

Как работает функция deep link

Deep link – функция, которая сразу совершает звонок в программе по умолчанию на устройстве.

Особенности работы:

• Если у вас на устройстве приложение по умолчанию для звонков софтфон, он активен и в настройках телефонии активирована функция deep link: когда вы нажимаете «Позвонить» в CRM – открывается сразу это приложение для совершения звонка клиенту.
• Использование deep link нужно активировать только при использовании софтфона, который поддерживает эту технологию (например, MicroSIP или платный Zoiper). Если не уверены, можете протестовать. Сначала активируйте, если исходящие вызовы с CRM не будут работать, то деактивируйте.
• Если отключить deep link - вызов будет происходить через телефонию. Сначала CRM отправит в телефонию запрос на начало звонка, телефония получив его совершит вызов на софтфон или IP телефон менеджеру, менеджер поднимает трубку и начинается соединение с клиентом.
• IP телефоны функцию deep link не поддерживают, поэтому при работе с ними она должна  быть выключена.  

Шаг 3. Подключение менеджеров

Скопируйте внутренние номера сотрудников в личном кабинете Ringostat. Для этого перейдите в «Общие настройки» → «Сотрудники» и откройте редактирование сотрудника:

В окне настроек перейдите на вкладку «Номера пользователей» и заполните данные:  

• Внутренний номер — номер или sip аккаунт менеджера на котором он работает внутри Ringostat;
• Менеджер — пользователь CRM, который соответствует этому номеру.

В списке для выбора будут пользователи, которым предоставлен доступ к телефонии.

После внесенной информации обязательно нажмите «Добавить» для сохранения канала и переходите к следующему шагу.

Шаг 4. Подключение интеграции в Ringostat

Вернитесь к настройкам интеграции в кабинете Ringostat  «Шаг 1», вставьте скопированную ранее ссылку на Webhook и активируйте интеграцию: 

Шаг 4. Разместите вебхук для переадресации звонков на ответственного менеджера покупателя

Перейдите в «Настройки» → «Виртуальная АТС» → «Webhook номер» и нажмите кнопку «Добавить Webhook номер переадресации»:

В открывшемся окне введите название для вебхука и сохраните его. Он появится на этой странице, чтобы настроить его, нажмите на карандаш.

В поле внесите данные:

• URL – ссылка на вебхук по настройкам подключения в «Шаг 2»;
• Метод отправки данных – POST;
• Тип отправки данных – json;
• Тип получения данных – json;
• Поле номера переадресации (для json) – dst_phone;
• Таймаут в секундах – 30;
• Настройка Webhook отправляемых параметров:
  from – номер абонента;
  direction – тип;
  state – константа ping.

После ввода данных нажмите «Сохранить».

Сохранение UTM меток из звонков

Если входящий звонок поступает с UTM метками, то они сохраняются в:

• карточке воронки, созданной автоматически;
• карточке воронки, созданной из карточки звонка;
• заказе, созданном из карточки звонка.

Если из карточки звонка было создано несколько карточек или заказов, то метки будут сохранены во всех.

Чтобы настроить передачу меток из телефонии, нужно обратиться в поддержку Ringostat. И попросить настроить передачу UTM меток в хуках на событие «Перед звонком»:

Просматривать отчеты по меткам можно в аналитике по воронкам в сводных таблицах и в аналитике по заказам в сводных таблицах.

Теперь вы можете работать с телефонией в KeyCRM!