Как подключить Binotel к X10CRM: линии, звонки и записи
Подключение API, выбор режима, привязка сотрудников, вебхук и проверка тестовой линии.
Настройка Binotel включает доступ к API, маршрут звонка, привязку линии и передачу событий. Пройдите шаги последовательно. Если ещё выбираете схему, начните со страницы интеграции Binotel.
#Что подготовить
- Company ID, API Key и API Secret Binotel вашей компании.
- Номера для клиентов и внутренние линии сотрудников. Для звонков через телефонию CRM нужны также параметры SIP.
- Проекты X10CRM и пользователей, которым нужны привязки линий.
- Административный доступ или право управлять интеграциями. Согласуйте маршрутизацию и передачу событий с командой внедрения.
Откройте «Интеграции → Binotel». Адрес настроек в вашей CRM — /integrations/binotel/. Если пункта нет, администратор проверяет версию и права пользователя.
#Шаг 1. Сохраните подключение к API
- Введите Company ID, API Key и API Secret в блоке подключения к API.
- Выберите нужные проекты CRM. Для первой проверки достаточно согласованного тестового проекта.
- Включите подключение для проверки и сохраните настройки.
- Нажмите проверку соединения. При успехе обновятся справочник внутренних линий и время последней проверки API.
#Шаг 2. Выберите режим исходящих звонков
| Режим | Что настроить |
|---|---|
| Через настроенную телефонию CRM | Остаётся действующий способ вызова X10CRM. Для браузерных звонков через Binotel команда внедрения регистрирует его SIP-линию, назначает номер и маршруты. |
| Обратный вызов Binotel на SIP-линию | Привяжите линию к пользователю, проверьте проект заявки и право видеть телефон клиента. |
Сохранение ключей Binotel не меняет исходящий номер автоматически. Сделайте тестовый вызов и проверьте номер у получателя. Для браузерной схемы смотрите настройку телефонии.
#Шаг 3. Привяжите линии к менеджерам
- После успешной проверки API выберите добавление привязки линии.
- Выберите пользователя CRM и его внутренний номер Binotel.
- Сохраните и проверьте строку в таблице привязанных линий.
- Повторите для нужных сотрудников. Если номера изменились, обновите справочник проверкой соединения и отредактируйте привязки.
#Шаг 4. Проверьте входящие маршруты
Номер, который уже принимает телефония CRM, должен вести к нужному оператору или группе по её маршрутам. Поле отдельных входящих Binotel для такого номера оставляют пустым.
Если менеджеры отвечают в софтфонах Binotel вне телефонии CRM, укажите номера компании для журнала через пробел в международном формате. Проект для этих входящих выберите из проектов подключения.
#Шаг 5. Настройте передачу событий Binotel
- После сохранения подключения найдите блок вебхуков Binotel.
- Если адреса ещё нет, создайте его соответствующей кнопкой.
- Скопируйте одну полную ссылку из строки API CALL SETTINGS / COMPLETED. Передайте ответственному за Binotel для настройки обоих типов событий.
- Проведите тестовый звонок, проверьте время последнего вебхука и появление вызова в журнале.
Адрес содержит секрет подключения. Копируйте его полностью из своей CRM и не публикуйте в документах или открытых скриншотах. После смены секрета администратором обновите адрес и в Binotel.
#Шаг 6. Проверьте работу под аккаунтом менеджера
- Позвоните из тестовой заявки. Проверьте линию, исходящий номер и звук в обе стороны.
- Сделайте входящий от известного клиента и отдельно с нового номера. Проверьте маршрут и заявку.
- Сделайте пропущенный вызов и проверьте его в журнале.
- После разговора проверьте запись вызова в истории и отсутствие дубля.
- Когда аудио доступно, проверьте прослушивание под разрешённой ролью. При необходимости отдельно проверьте транскрипцию.
- Если номера должны быть скрыты, проверьте весь маршрут и рабочее место. Прямой callback без права видеть телефон недоступен.
#Где искать записи разговоров
Вызовы доступны в журнале и истории заявки. Аудио Binotel загружается в фоне и может появиться позже. Для разговоров через телефонию CRM действует её механизм записи. Доступ зависит от прав пользователя.
Наличие вызова в журнале не означает готовность расшифровки: нужны аудио, настроенный провайдер и завершённая обработка. Смотрите записи разговоров и транскрипцию.
#Типовые проблемы
| Проблема | Что проверить |
|---|---|
| Проверка соединения не проходит | Company ID, API Key, API Secret и доступ к API в кабинете Binotel. |
| Нет внутренней линии | Обновите справочник и проверьте наличие линии в Binotel. |
| Callback недоступен | Режим callback, привязку пользователя, проект заявки и право видеть телефон. |
| Звонок с неверного номера | Маршрут и исходящий номер телефонии CRM. API-ключи их не настраивают. |
| Вызов есть в Binotel, но отсутствует в CRM | Адрес вебхука, последнюю полученную информацию, проекты и номера учёта. Команда внедрения проверяет фоновую сверку. |
| Вызов есть, аудио нет | Доступность записи в Binotel, завершение загрузки и права пользователя. |
| Дубль или неверная заявка | Маршруты номеров, проект и переадресации. Передайте поддержке время и идентификатор тестового вызова. |
Для поддержки подготовьте время вызова, режим, пользователя CRM и описание результата. API-ключи, пароли SIP и секретную ссылку вебхука не отправляйте в обычной переписке.
