01Нативная телефония, а не строчка в истории
Приложение регистрирует разговор агента как звонок Bitrix24: заводит его, закрывает длительностью и статусом, прикрепляет аудиофайл и расшифровку. В детализации телефонии он выглядит как обычный звонок сотрудника, а не как заметка робота.
- Аудио и расшифровка появляются у контакта или компании и в детализации телефонии: активность звонка Bitrix создаёт именно у них — сделку этот метод не принимает.
- В сделку уходит комментарий с итогом и расшифровкой, а сама сделка переезжает на тот этап, который вы назначили этому исходу разговора.
- Пока приложение на портале не установлено, запись всё равно доедет — файлом во вложении комментария. Это запасной путь: он включается сам и так же сам уступает место нативному звонку после установки.
- Контрагента агент ищет в CRM по номеру ещё во время приветствия; новый номер он дописывает к карточке, а не затирает существующие.
02«Позвонить голосовым агентом» — обычный шаг бизнес-процесса
При установке приложение регистрирует на портале робота для сделок. Менеджер добавляет его в процесс как любой другой шаг и выбирает агента из списка — набирать номер руками не нужно.
- Шаг ждёт результата: робот возвращает в процесс статус (поговорили, не ответили, сбой), исход разговора, короткий итог и длительность.
- Процесс не зависает. Если разговор так и не состоялся, шаг всё равно получает ответ по дедлайну, а не остаётся ждать вечно.
- Отказ виден человеку: нет номера у контрагента, агент не найден, звонки выключены — робот пишет причину комментарием в сделку вместо молчания.
- Новый агент попадает в список робота после переустановки приложения: набор вариантов Bitrix фиксирует в момент регистрации робота, а не читает при каждом запуске.
03Кабинет внутри портала, без второго пароля
Приложение регистрирует вкладку в карточке сделки, вкладку в карточке компании и пункт в левом меню. Внутри — тот же кабинет ALTCALL, что и на отдельном домене.
- Сторонние cookie во встройках не используются вообще (браузеры их режут): вход идёт по одноразовому подписанному тикету, повторный переход по той же ссылке уже не открывается.
- Кнопку «Позвонить» видит только сотрудник, чей аккаунт портала привязан к пользователю ALTCALL и у которого есть право работать с обзвонами.
- Подлинность запроса от портала проверяется контрольным вызовом к самому Bitrix, причём домен для этой проверки берётся из настроек сервера, а не из тела запроса.
04Приложение и SIP-коннектор — разные вещи
Их постоянно путают на первом созвоне. Коннектор — транспорт для людей: облачная АТС Bitrix24 регистрируется на телефонии, чтобы менеджер звонил с номера компании. Приложение — агент и его данные внутри CRM. Одно не заменяет другое.
- Телефонные методы Bitrix доступны только приложению — через обычный входящий вебхук их нет вовсе. Поэтому нативный звонок агента без приложения не появится.
- Коннектор нужен, чтобы исходящий менеджера уходил с номера компании; голосовой агент по нему не работает.
- ⚠️ Если у вашего оператора связи одна SIP-регистрация на логин, реквизиты оператора в Bitrix24 вводить нельзя: портал заберёт номер у агента.
05Что нужно, чтобы включить
Работы на стороне портала — на один заход администратора. Секрет приложения хранится у нас зашифрованным и обратно в интерфейсе не показывается; домен портала и идентификатор приложения видны в вашем кабинете и правятся там же.
- Локальное приложение на портале, тип «Использует только API», с правами на CRM, телефонию, встройки, бизнес-процессы и пользователей.
- Обработчик установки — адрес нашего сервера; идентификатор и секрет приложения вносятся в настройках вашей компании в кабинете.
- Отдельный пользователь портала «Голосовой робот» — от его имени звонок агента появляется в телефонии.
- Дальше — кнопка «Установить» в кабинете. Тот же клик обновляет список агентов у робота, когда вы заведёте нового.