Ringostat: настройка с нуля — пошаговый пример

Эта страница — практический пример: берём проект Ringostat и доводим его до состояния, когда каждый входящий становится заявкой, карточка клиента открывается у менеджера во время звонка, а записи и пропущенные лежат в CRM. Сначала выберите схему номеров — от неё зависят шаги 4 и 5. Справка по всем полям — в статье Подключение Ringostat.

#Шаг 0. Выберите схему номеров

Второе решение — где менеджер говорит. Через встроенный телефон CRM (в браузере: карточка открывается во время звонка, разговор не рвётся при переходе между заявками) или через приложение Ringostat, как раньше. Журнал, заявки, записи и пропущенные работают одинаково в обоих случаях. Сравнение — в разделе Два режима.

#Шаг 1. Подготовка в Ringostat

• Каждый менеджер заведён в Ringostat сотрудником (не только SIP-аккаунтом) и имеет свой SIP-аккаунт. CRM видит именно сотрудников.
• Схема А: на каждый личный номер — схема звонка на SIP-аккаунт его менеджера.
• Схема Б: общий номер ведёт на один SIP-аккаунт — его и подключим к телефону CRM (например, office). Если менеджеры остаются в приложении Ringostat — на группу их SIP-аккаунтов.
• В каждой схеме укажите, куда идёт звонок, если никто не ответил: другой сотрудник, голосовая почта. Иначе клиент услышит «занято».
• Включите запись разговоров, если она нужна в CRM.

#Шаг 2. Ключ API

Кабинет Ringostat → Интеграции → Ringostat API. Скопируйте ID проекта и Auth-key.

#Шаг 3. Подключение в CRM

1. CRM → Настройки → Телефония → Ringostat → «Добавить подключение».
2. Вставьте ID проекта Ringostat и Auth-key, часовой пояс — Europe/Kyiv.
3. Проекты CRM — проект, в котором должны появляться заявки из звонков.
4. Режим звонков: «SIP-транк через телефон xCRM», если менеджеры говорят в CRM; «Ringostat Callback» — если в приложении Ringostat.
5. Включите Журнал звонков, Записи разговоров и Заявка на незнакомый номер.
6. «Сохранить настройки» — CRM проверит ключ и загрузит сотрудников.

#Шаг 4. Сотрудники и номера

На той же странице — таблица «Сотрудники и SIP-аккаунты Ringostat». Для каждого менеджера выберите «Пользователь CRM» и заполните «Номера Ringostat» по вашей схеме, затем «Сохранить сопоставление».

CRM импортирует звонки только привязанных сотрудников. Кто работает в другой системе и не имеет пользователя в CRM — просто не привязывайте его.

#Шаг 5. Телефон CRM (если менеджеры говорят в CRM)

Пропустите этот шаг для режима Ringostat Callback. Для телефона CRM на каждый SIP-аккаунт Ringostat, который должен звонить в CRM, делаются три вещи — по инструкции Телефония в CRM:

1. 01

   SIP-транк

   Шаг 3 телефонии: хост sip.ringostat.net, порт 5060, логин и пароль SIP-аккаунта из Ringostat, «Регистрироваться у провайдера» включено.

2. 02

   Номер

   Шаг 4: номер, привязанный к этому транку. Заполните «Проект CRM» и «Владелец номера» — в этот проект и на этого владельца ляжет заявка с нового входящего.

3. 03

   Маршрут

   Шаг 7: схема А — номер → оператор, чей это SIP-аккаунт; схема Б — номер → группа приёма со всеми менеджерами линии.

4. 04

   Привязка и применение

   В настройках Ringostat выберите этот транк в поле «SIP-транк Ringostat», затем примените конфигурацию.

#Шаг 6. Вебхук

Без вебхука звонок появляется в CRM через 1–2 минуты после окончания разговора. С вебхуком заявка создаётся в момент звонка. Создать вебхук можно только в кабинете Ringostat.

1. В CRM на странице Ringostat скопируйте Webhook URL.
2. Кабинет Ringostat → Интеграции → Webhooks → Добавить.
3. Первый вебхук: событие «Перед звонком» (входящий), метод POST, формат JSON, адрес — Webhook URL с ?event=start в конце.
4. Второй вебхук: событие «После звонка» (входящий), то же самое, но в конце адреса ?event=finish.
5. В оба добавьте параметры: название латиницей, значение — одноимённая переменная Ringostat.

uniqueid
caller
dst
call_type
employee_number
connected_with
billsec
duration
disposition

#Шаг 7. Проверка контрольными звонками

Менеджер входит в CRM и держит вкладку открытой (для телефона CRM браузер один раз спросит доступ к микрофону — «Разрешить»). Далее — три звонка с номера, которого нет в CRM:

#Как ведёт себя CRM во время звонка

#Типичные ошибки

#Чек-лист

• Схема номеров выбрана, в Ringostat настроены схемы звонков и запасной вариант на «не ответили»
• Менеджеры — сотрудники Ringostat с SIP-аккаунтами
• Подключение в CRM сохранено, сотрудники загружены
• Каждый менеджер привязан, номера вписаны по схеме, у общей линии есть ответственный
• Для телефона CRM: транк, номер с проектом и владельцем, маршрут, конфигурация применена
• Два вебхука в Ringostat
• Три контрольных звонка прошли