Подключение и настройка интеграции с Uspacy

Дата обновления контента: 18.05.2023

Uspacy — это CRM-система с современными инструментами для управления и контроля над продажами, организации внутренней коммуникации и совместной работы компании.

Интеграция телефонии UniTalk с Uspacy позволяет повысить качество обслуживания клиентов и вывести бизнес на новый уровень.

Для настройки интеграции зарегистрируйтесь или залогиньтесь в личном кабинете UniTalk.

Перейдите в раздел меню «Интеграции — АРІ» и создайте АРІ ключ, нажав кнопку.

Ключ будет сгенерирован в соответствующем окне.

3. Далее для передачи информации о звонках в Uspacy настраиваем вебхуки.

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

Заполняем поля формы:
3.1.1. Действие — Отправить вебхук
3.1.2. Название — Новый звонок
3.1.3. URL — https://unitalk.uspacy.app/unitalk_integration/v1/call_events/add

Ссылку следует скопировать из окна настроек UniTalk в личном кабинете Uspacy.

3.1.4. HTTP код — POST
3.1.5. Добавить HTTP заголовок:

Ключ — Authorization
Значение — вставьте скопированный АРI ключ

3.1.6. Тело запроса — Указанный JSON. В поле ниже скопируйте и вставьте следующие значения:

{
"event": "CALL_NEW",
"call": {
"id": "{{CALL_RANDOM_ID}}",
"dbid": "{{CALL_DB_ID}}",
"from": "{{CALLED_FROM}}",
"to": "{{CALLED_TO}}",
"outerNumber": "{{OUTER_NUMBER}}",
"direction": "{{CALL_DIRECTION}}",
"date": "{{CALL_START_TIME^^format=DEFAULT}}",
"utmSource": "{{UTM_SOURCE}}",
"utmMedium": "{{UTM_MEDIUM}}",
"utmCampaign": "{{UTM_CAMPAIGN}}",
"utmTerm": "{{UTM_TERM}}",
"utmContent": "{{UTM_CONTENT}}",
"googleId": "{{GOOGLE_CLIENT_ID}}",
"facebookClientId": "{{FACEBOOK_CLIENT_ID}}",
"referer": "{{REFERER}}",
"comment": "{{CALL_META}}",
"source": "{{CALL_TYPE}}",
"meta": "{{CALL_META}}"
}
}

Далее нажмите кнопку «Сохранить».

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

Заполняем поля формы:
3.2.1. Действие — Отправить вебхук
3.2.2. Название — Завершенный звонок
3.2.3. URL — https://unitalk.uspacy.app/unitalk_integration/v1/call_events/add
Ссылку следует скопировать из окна настроек UniTalk в личном кабинете Uspacy.

3.2.4. HTTP код — POST
3.2.5. Добавить HTTP заголовок:

Ключ — Authorization
Значение — вставьте скопированный АРІ ключ

3.2.6 Тело запроса — Указанный JSON. В поле ниже скопируйте и вставьте следующие значения:

{
"event": "CALL_END",
"call": {
"id": "{{CALL_RANDOM_ID}}",
"dbid": "{{CALL_DB_ID}}",
"from": "{{CALLED_FROM}}",
"to": "{{CALLED_TO}}",
"outerNumber": "{{OUTER_NUMBER}}",
"direction": "{{CALL_DIRECTION}}",
"date": "{{CALL_START_TIME^^format=DEFAULT}}",
"secondsFullTime": "{{CALL_SECONDS_FULL}}",
"secondsTalk": "{{CALL_SECONDS_TALK}}",
"utmSource": "{{UTM_SOURCE}}",
"utmMedium": "{{UTM_MEDIUM}}",
"utmCampaign": "{{UTM_CAMPAIGN}}",
"utmTerm": "{{UTM_TERM}}",
"utmContent": "{{UTM_CONTENT}}",
"googleId": "{{GOOGLE_CLIENT_ID}}",
"facebookClientId": "{{FACEBOOK_CLIENT_ID}}",
"referer": "{{REFERER}}",
"comment": "{{CALL_META}}",
"state": "{{CALL_STATUS}}",
"source": "{{CALL_TYPE}}",
"link": "{{CALL_AUDIO_LINK}}",
"meta": "{{CALL_META}}",
"cause": "{{CALL_END_CODE}}"
}
}

Далее нажмите кнопку «Сохранить».

4. Настраиваем обработку исходящих вебхуков для того, чтобы система отправляла данные при событиях звонка. Для этого добавьте созданные вебхуки в подраздел «Обработка событий звонков (Исходящие вебхуки)» раздела «Интеграции — АРІ».

5. Назначаем ответственных за линии пользователей. Для того, чтобы с телефонией работали несколько сотрудников, следует настроить для каждого из них отдельные SIP линии в разделе «Пользователи». На одного сотрудника может быть настроена одна SIP линия.

Для этого нажимаем кнопку «Добавить SIP линию».

Далее добавляем пользователя, нажав соответствующую кнопку.

Для этого введите email, после чего откроются остальные поля.

Далее следует указать роль, в списке выбрать созданную SIP линию, ввести имя и фамилию сотрудника, после чего нужно сгенерировать пароль.

Нажмите кнопку «Добавить». Готово! Сотрудник закреплен за SIP линией.

Введенный email и сгенерированный пароль будут использоваться для входа в расширение UniTalk Web Dialer для Google Chrome, а номер внутренней линии — для настроек интеграции в Uspacy.
6. Следующий шаг — настраиваем интеграцию в Uspacy.
Бесплатное приложение UniTalk представлено в разделе «Маркетплейс» Uspacy.

Для этого следует установить UniTalk в Uspacy. Нажимаем кнопку «Получить».

7. Переходим к настройкам уже установленного UniTalk.

Далее в соответствующее поле в разделе «Статус подключения» следует ввести АРЕ ключ, который был создан в настройках интеграции UniTalk.

После этого следует нажать кнопку «Проверить подключение».

Статус подключения должен измениться.

Поле «Uspacy вебхук» заполнения не требует, оно является служебным, а его значение использовалось при создании исходящих вебхуков в UniTalk.

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

Для каждого сотрудника в Uspacy следует указать отдельную линию, которая была создана в UniTalk. Для этого нажмите кнопку «Добавить».

В поле «Сотрудники» выберите соответствующего сотрудника. Чтобы ускорить поиск, начните вводить имя.

В поле «Внутренний номер или значение линии» введите ту SIP линию, за которую ответственен указанный сотрудник и которая была создана при настройках интеграции UniTalk.

Сохраните настройки, нажав галочку.

Чтобы осуществлять звонки клиентам, не нужно устанавливать сторонние программы на девайсы. Специальное расширение в Google Chrome позволяет принимать входящие звонки и осуществлять исходящие на любых страницах Google Chrome.

Для этого следует найти это расширение в веб-магазине Chrome. В поисковой строке начните вводить его название — UniTalk Web Dialer.