// документация

Подключение телефонии и CRM

Чтобы SIREN начал разбирать разговоры, ему нужен доступ к записям. Есть три способа — выберите тот, что ближе к вашей ситуации. Дольше всего обычно ищут раздел с ключами, поэтому ниже указано, где именно они лежат.

amoCRMЗвонки подтягиваются из карточек сделок и контактов≈ 10 минутMango OfficeПрямое подключение к АТС: записи и непринятые звонки≈ 15 минутЗагрузка файловЕсли телефония не поддерживается≈ 2 минуты

amoCRM

Звонки подтягиваются из карточек сделок и контактов

≈ 10 минут

Подходит, если записи разговоров уже складываются в amoCRM — неважно, какая под ней телефония. SIREN забирает записи из примечаний к сделкам и контактам, поэтому отдельно подключать АТС не нужно.

  1. 1

    Создайте интеграцию в amoCRM

    Настройки → Интеграции → «Создать интеграцию» → «Создать свою» (внешняя интеграция).

  2. 2

    Укажите ссылку для перенаправления

    В поле «Ссылка для перенаправления» вставьте адрес целиком, без пробелов и лишних символов:

    https://sirencall.ru/api/integrations/amocrm/callback
  3. 3

    Выдайте доступы и сохраните

    Отметьте галочки «Предоставить доступ» и сохраните интеграцию.

  4. 4

    Скопируйте три значения

    Откройте вкладку «Ключи и доступы»: ID интеграции (Client ID), Секретный ключ (Client Secret) и Код авторизации.

    Код авторизации одноразовый и живёт 20 минут. Берите его прямо перед подключением и сразу жмите «Подключить» — если не успели, сгенерируйте новый.

  5. 5

    Введите данные в SIREN

    Кабинет → Интеграции → amoCRM. Поддомен — это часть адреса до .amocrm.ru: для mycompany.amocrm.ru впишите mycompany.

После подключения

  • Автоимпорт включается сам: новые звонки начнут подтягиваться и анализироваться без вашего участия.
  • Историю можно догрузить: выберите период и нажмите «Загрузить и проанализировать». Минуты этих звонков списываются с тарифа, повторно загруженное не оплачивается.
  • Если раньше вы пользовались другим сервисом, так вы сразу получите динамику за прошлые месяцы, а не начнёте с нуля.

Mango Office

Прямое подключение к АТС: записи и непринятые звонки

≈ 15 минут

Прямая интеграция с АТС. Кроме записей разговоров SIREN получает данные о непринятых звонках — их не видно ни в одной CRM, а это прямые потерянные обращения.

  1. 1

    Откройте раздел API в Mango

    Личный кабинет Mango Office → «Настройки» → «API» (раздел «Интеграции / API»).

  2. 2

    Скопируйте код АТС

    Значение «Код вашей АТС» — это идентификатор, он же vpbx_api_key. Вставьте его в поле «VPBX API Key» в SIREN.

  3. 3

    Скопируйте ключ подписи

    Значение «Ключ для подписи запросов (соль)» вставьте в поле «API Salt». Он нужен, чтобы Mango принимал наши запросы за записями.

  4. 4

    Сохраните в SIREN

    Кабинет → Интеграции → Mango Office → сохраните ключ и соль.

  5. 5

    Включите push-уведомления о звонках

    В Mango включите push-уведомления и укажите адрес:

    https://sirencall.ru/api/webhooks/mango

    Mango сам добавит подпуть события (/events/recording и другие) — дописывать его не нужно.

  6. 6

    Обязательно включите событие «Сводка о звонке»

    В тех же push-уведомлениях отметьте событие summary, а не только «Запись разговора».

    Без него не будет статистики непринятых: у неотвеченного звонка нет записи, и такой звонок просто не дойдёт до системы. Это самая частая причина, по которой «непринятые» остаются пустыми.

После подключения

  • Бонус за подключение начисляется после первого принятого звонка — так мы убеждаемся, что интеграция реально работает.
  • Записи не хранятся у нас: файл удаляется сразу после анализа, а плеер в карточке подтягивает запись из Mango по требованию.

Загрузка файлов

Если телефония не поддерживается

≈ 2 минуты

Universal-вариант: выгрузите записи из своей АТС и загрузите их в SIREN вручную. Анализ будет тот же самый — отличается только способ доставки записей.

  1. 1

    Выгрузите записи из своей телефонии

    Подойдут любые аудиофайлы: mp3, wav, m4a, ogg, flac, aac. Можно выгрузить сразу за период.

  2. 2

    Откройте раздел «Загрузка»

    Кабинет → Загрузка. Перетащите файлы в окно или выберите их кнопкой — можно несколько сразу.

  3. 3

    Дождитесь анализа

    Каждый звонок распознаётся и разбирается — обычно это меньше минуты на запись. Результат появляется в разделе «Звонки» по мере готовности.

    Слишком короткие записи (короче минимальной длительности, заданной в настройках) пропускаются и минуты тарифа не тратят.

После подключения

  • Имя оператора берётся из имени файла, если оно там есть — так разбор сразу ляжет на нужного администратора.
  • Способы можно совмещать: например, подключить amoCRM для текущих звонков и разово догрузить архив файлами.

Что вы увидите после подключения

Каждый разговор попадает в список с результатом, оценкой по вашему скрипту, типом обращения и тегами. Теги и фильтры кликабельны — можно за один клик собрать, например, все звонки с неотработанными возражениями.

Список звонков в SIREN: результат, оценка по скрипту, теги и фильтры
Список звонков — так он выглядит через несколько минут после первого разговора.

Посмотреть вживую можно без регистрации: откройте демо-кабинет — там реальный интерфейс с обезличенными данными.

Частые вопросы

Нужно ли подключать и телефонию, и CRM?

Нет. Достаточно одного источника записей. Если разговоры уже попадают в amoCRM — хватит её. Прямое подключение Mango даёт сверх этого статистику непринятых звонков, которой в CRM нет.

Вы храните записи разговоров?

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

Можно ли проанализировать звонки за прошлые месяцы?

Да, если они есть в amoCRM: в разделе «Интеграции» выберите период и нажмите «Загрузить и проанализировать». Для остальных случаев подойдёт ручная загрузка файлов. Минуты таких звонков списываются с тарифа как у обычных.

Почему в «Непринятых» пусто, хотя Mango подключён?

Почти всегда причина одна: в push-уведомлениях Mango включено только событие «Запись разговора». У неотвеченного звонка записи нет, поэтому нужно дополнительно включить событие «Сводка о звонке» (summary).

Сколько времени занимает подключение?

amoCRM — около десяти минут, Mango — около пятнадцати вместе с настройкой уведомлений. Дольше всего обычно ищут раздел с ключами в кабинете провайдера.

Не получилось подключить?

Напишите нам — подключим за вас. Обычно это занимает один короткий созвон: нужен доступ в кабинет вашей телефонии или CRM.