Чтобы использовать телефонию Verimor в Mavibot, необходимо получить API-ключ из вашего аккаунта Verimor и указать его в настройках интеграции.

Verimor — турецкий телекоммуникационный провайдер. Его продукт Bulut Santralim — это облачная АТС: сотрудники работают с внутренними номерами, а звонки маршрутизируются через эти номера.

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

Получение необходимых данных

  1. Активируйте услугу Bulut Santralim у Verimor и создайте внутренние номера для сотрудников.
  2. Откройте Online İşlem Merkezi → Bulut Santralim → Santral Ayarlarım и скопируйте API-ключ. Он выглядит так:
K12345678-1234-5678-4321-123456789012
  1. Запишите внутренние номера сотрудников. Они понадобятся для настройки доступа.

API-ключ является общим для всей АТС и используется как для звонков, так и для получения событий. Если вы перегенерируете его в панели управления Verimor, обязательно сохраните форму подключения заново. В противном случае и звонки, и события диалога перестанут работать.

Подключение

Во вкладке телефонии выберите Verimor и укажите:

  • API-ключ — ключ из раздела Santral Ayarlarım.
  • Исходящий номер — внешний номер, который увидит клиент, в формате 908505320000. Это поле необязательно. Если оставить пустым, будет использоваться номер, назначенный внутреннему номеру сотрудника.

Интеграция подключена.

Чтобы отключить интеграцию, очистите поле API-ключ и сохраните настройки.

Вам не нужно настраивать URL уведомлений вручную. Mavibot устанавливает его автоматически в вашей АТС при сохранении API-ключа.

Сотрудники

В настройках сотрудника укажите его внутренний номер (dahili) — обычно 3–4 цифры, например 1001.

Указывайте внутренний номер АТС, а не мобильный телефон сотрудника. Без него кнопка звонка в карточке клиента не будет работать для этого сотрудника.

Звонок из карточки клиента

Рядом с номером телефона клиента в карточке диалога появится кнопка звонка.

АТС сначала звонит на внутренний номер сотрудника. Только после того, как сотрудник ответит, она звонит клиенту.

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

Функции калькулятора

Звонок сотрудника клиенту

verimor_employee_call(client_phone, employee_extension, caller_id)

Параметры:

  • client_phone — номер телефона клиента. Обязательный. Используйте турецкий формат 908505320000 или 00493027590915 для международных звонков.
  • employee_extension — внутренний номер сотрудника, чей телефон будет звонить. Обязательный.
  • caller_id — номер, который увидит клиент. Необязательный. Если не указан, используется исходящий номер из настроек подключения.

Функция возвращает call_uuid — идентификатор звонка. Он также сохраняется в переменную verimor_call_uuid.

Перевод звонка

verimor_transfer_call(employee_extension, call_uuid)

Переводит текущий звонок на другой внутренний номер.

Параметры:

  • employee_extension — внутренний номер, на который будет переведен звонок. Обязательный.
  • call_uuid — идентификатор звонка. Необязательный. Если не указан, используется последний звонок клиента.

Завершение звонка

verimor_hangup_call(call_uuid)

Параметры:

  • call_uuid — идентификатор звонка. Необязательный. Если не указан, используется последний звонок клиента.

Получение ссылки на запись звонка

verimor_get_record_link(call_uuid)

Запрашивает новую ссылку на запись звонка.

Параметры:

  • call_uuid — идентификатор звонка. Необязательный. Если не указан, используется последний звонок клиента.

События во время звонка

По мере развития звонка в диалог отправляются события в следующем формате:

verimor_call_event answer

Возможные события:

Событие Когда срабатывает
ringing Звонок звонит
answer Звонок принят
hangup Звонок завершен
user_hangup Сотрудник завершил звонок

Звонки между сотрудниками не отображаются в диалоге.

Типичный сценарий «нет ответа → отправить сообщение в мессенджере» можно запустить с помощью hangup и проверки переменной verimor_call_answered.

Переменные клиента после звонка

Переменная Значение
verimor_call_uuid Идентификатор звонка
verimor_call_direction Направление: inbound — клиент звонит вам, outbound — вы звоните клиенту
verimor_call_extension Внутренний номер сотрудника, обработавшего звонок
verimor_call_duration Длительность звонка в секундах
verimor_call_answered 1 — звонок был принят, 0 — нет
verimor_hangup_cause Код, указывающий причину завершения звонка
verimor_has_record 1 — запись существует, 0 — записи нет
verimor_record_link Ссылка на запись звонка после вызова verimor_get_record_link()

Коды причин завершения звонка

Наиболее распространенные значения verimor_hangup_cause:

Код Значение
NORMAL_CLEARING Звонок был завершен и закончился нормально
USER_BUSY Занято
NO_ANSWER Нет ответа
ORIGINATOR_CANCEL Звонивший повесил трубку до ответа
CALL_REJECTED Звонок отклонен
UNALLOCATED_NUMBER Неверный номер
NO_USER_RESPONSE Абонент недоступен
NOT_ALLOWED_BY_IYS Нет разрешения в İYS, турецком реестре согласий на коммерческие звонки

Записи звонков

Запись звонков должна быть включена в настройках вашей АТС Verimor. Записи хранятся в вашем аккаунте Verimor.

⏳ Ссылки на записи действительны в течение 60 минут с момента их запроса. После этого они перестают работать. Verimor также допускает не более пяти запросов ссылок на записи в минуту на один API-ключ.

Что это значит:

  • Переменная verimor_record_link не заполняется автоматически. Сначала необходимо вызвать verimor_get_record_link().
  • В сценарии, который отправляет запись, вызывайте verimor_get_record_link() в момент отправки записи, а не заранее.
  • Сначала проверяйте verimor_has_record, чтобы не тратить лимит запросов на звонки без записи.
  • Если вам нужно сохранить запись навсегда, сохраните файл в собственное хранилище сразу после звонка.
  • Архив записей остается доступным в панели управления Verimor, где записи можно воспроизводить и скачивать позже.

Запись звонков регулируется законом. В Турции она подпадает под требования KVKK: клиент должен быть проинформирован о записи, а хранение персональных данных должно иметь законное основание. Владелец аккаунта Verimor несет ответственность за соблюдение применимых требований.

Устранение неполадок

Ошибка Причина / Решение
Gecersiz anahtar Неверный API-ключ. Получите актуальный ключ из раздела Santral Ayarlarım.
extension 1005 not found Внутренний номер не существует в вашей АТС. Убедитесь, что в настройках сотрудника указан существующий dahili.
«Внутренний номер Verimor не указан» Настройки сотрудника пусты или содержат мобильный телефон вместо внутреннего номера.
Звонки работают, но события не появляются в диалоге URL уведомлений не настроен. Сохраните форму подключения заново.
Звонки перестали работать после смены API-ключа Ключ был перегенерирован в панели управления Verimor. Введите новый ключ в форму подключения и сохраните.
Ссылка на запись не открывается Срок действия ссылки истек. Запросите новую с помощью verimor_get_record_link() или откройте запись в панели управления Verimor.
Ссылка на запись не возвращается Достигнут лимит пяти запросов в минуту, или у звонка нет записи. Проверьте verimor_has_record.