Как подключить телефонию Ringostat (для администратора)

Рассказываем, как подключить Ringostat к KeyCRM, чтобы упросить и ускорить работу ваших менеджеров.
Автор Владислав Пономарь
Обновлено 3 дня назад

Подключение 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 позволяет сразу начинать вызов с телефонии покупателю после начала звонка в CRM. Без deep link звонок поступает сначала на софтфон или IP-телефон менеджера, а после ответа уже начнется соединение с покупателем.


    Использование deep link необходимо активировать только если вы используете софтфон, который поддерживает эту технологию (например, MicroSIP или платный Zoiper).

    Если вы не уверены, то можете протестировать. Сначала активируйте, если исходящие звонки из CRM не будут работать, то деактивируйте. 

    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!

    Теги: рингостат, рінгостат, ringo, stat, ringostat, ринго, utm рингостат, utm телефония, метки по телефонии, ютм метки по звонкам
    Оцените эту статью