Как подключить Binotel к X10CRM: линии, звонки и записи

Подключение API, выбор режима, привязка сотрудников, вебхук и проверка тестовой линии.

Настройка Binotel включает доступ к API, маршрут звонка, привязку линии и передачу событий. Пройдите шаги последовательно. Если ещё выбираете схему, начните со страницы интеграции Binotel.

#Что подготовить

  • Company ID, API Key и API Secret Binotel вашей компании.
  • Номера для клиентов и внутренние линии сотрудников. Для звонков через телефонию CRM нужны также параметры SIP.
  • Проекты X10CRM и пользователей, которым нужны привязки линий.
  • Административный доступ или право управлять интеграциями. Согласуйте маршрутизацию и передачу событий с командой внедрения.

Откройте «Интеграции → Binotel». Адрес настроек в вашей CRM — /integrations/binotel/. Если пункта нет, администратор проверяет версию и права пользователя.

#Шаг 1. Сохраните подключение к API

  1. Введите Company ID, API Key и API Secret в блоке подключения к API.
  2. Выберите нужные проекты CRM. Для первой проверки достаточно согласованного тестового проекта.
  3. Включите подключение для проверки и сохраните настройки.
  4. Нажмите проверку соединения. При успехе обновятся справочник внутренних линий и время последней проверки API.

#Шаг 2. Выберите режим исходящих звонков

РежимЧто настроить
Через настроенную телефонию CRMОстаётся действующий способ вызова X10CRM. Для браузерных звонков через Binotel команда внедрения регистрирует его SIP-линию, назначает номер и маршруты.
Обратный вызов Binotel на SIP-линиюПривяжите линию к пользователю, проверьте проект заявки и право видеть телефон клиента.

Сохранение ключей Binotel не меняет исходящий номер автоматически. Сделайте тестовый вызов и проверьте номер у получателя. Для браузерной схемы смотрите настройку телефонии.

#Шаг 3. Привяжите линии к менеджерам

  1. После успешной проверки API выберите добавление привязки линии.
  2. Выберите пользователя CRM и его внутренний номер Binotel.
  3. Сохраните и проверьте строку в таблице привязанных линий.
  4. Повторите для нужных сотрудников. Если номера изменились, обновите справочник проверкой соединения и отредактируйте привязки.

#Шаг 4. Проверьте входящие маршруты

Номер, который уже принимает телефония CRM, должен вести к нужному оператору или группе по её маршрутам. Поле отдельных входящих Binotel для такого номера оставляют пустым.

Если менеджеры отвечают в софтфонах Binotel вне телефонии CRM, укажите номера компании для журнала через пробел в международном формате. Проект для этих входящих выберите из проектов подключения.

#Шаг 5. Настройте передачу событий Binotel

  1. После сохранения подключения найдите блок вебхуков Binotel.
  2. Если адреса ещё нет, создайте его соответствующей кнопкой.
  3. Скопируйте одну полную ссылку из строки API CALL SETTINGS / COMPLETED. Передайте ответственному за Binotel для настройки обоих типов событий.
  4. Проведите тестовый звонок, проверьте время последнего вебхука и появление вызова в журнале.

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

#Шаг 6. Проверьте работу под аккаунтом менеджера

  1. Позвоните из тестовой заявки. Проверьте линию, исходящий номер и звук в обе стороны.
  2. Сделайте входящий от известного клиента и отдельно с нового номера. Проверьте маршрут и заявку.
  3. Сделайте пропущенный вызов и проверьте его в журнале.
  4. После разговора проверьте запись вызова в истории и отсутствие дубля.
  5. Когда аудио доступно, проверьте прослушивание под разрешённой ролью. При необходимости отдельно проверьте транскрипцию.
  6. Если номера должны быть скрыты, проверьте весь маршрут и рабочее место. Прямой callback без права видеть телефон недоступен.

#Где искать записи разговоров

Вызовы доступны в журнале и истории заявки. Аудио Binotel загружается в фоне и может появиться позже. Для разговоров через телефонию CRM действует её механизм записи. Доступ зависит от прав пользователя.

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

#Типовые проблемы

ПроблемаЧто проверить
Проверка соединения не проходитCompany ID, API Key, API Secret и доступ к API в кабинете Binotel.
Нет внутренней линииОбновите справочник и проверьте наличие линии в Binotel.
Callback недоступенРежим callback, привязку пользователя, проект заявки и право видеть телефон.
Звонок с неверного номераМаршрут и исходящий номер телефонии CRM. API-ключи их не настраивают.
Вызов есть в Binotel, но отсутствует в CRMАдрес вебхука, последнюю полученную информацию, проекты и номера учёта. Команда внедрения проверяет фоновую сверку.
Вызов есть, аудио нетДоступность записи в Binotel, завершение загрузки и права пользователя.
Дубль или неверная заявкаМаршруты номеров, проект и переадресации. Передайте поддержке время и идентификатор тестового вызова.

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