Описание

Услуга "Умный отбой (smart_cancel)" позволяет отменять вызов, в пределах заданного таймера, без сохранения этого вызова как пропущенного, в истории вызовов, на аппарате вызываемого абонента (абонента В). Это может быть полезно при ошибочном наборе номера.

С точки зрения обмена SIP-сообщениями при "Умном отбое (smart_cancel)" в запрос CANCEL добавляется заголовок "Reason" с параметрами "SIP;cause=200".
Для корректной работы услуги оконечный терминал (ТА) должен уметь корректно обрабатывать данный заголовок.

Для использования услуги требуется лицензия, для услуги "smart_cancel" пакет ECSS-ADV+ или ECSS-FULL+.

/domain/test_domain/ss/limit --show-ss    
┌──────────┬────┬─────────┬─────────┬──────────────────────────┬─────────────────────────┐
│   Name   │Used│Available│  Limit  │       Description        │         SS List         │
├──────────┼────┼─────────┼─────────┼──────────────────────────┼─────────────────────────┤
. . .
│ECSS-ADV+ │0   │10000    │undefined│Дополнительные услуги)    │smart_cancel             │
. . .
│ECSS-FULL+│5   │10000    │undefined│Дополнительные услуги     │smart_cancel             │
. . .
└──────────┴────┴─────────┴─────────┴──────────────────────────┴─────────────────────────┘


Использование

 Для того чтобы абонент А мог использовать "Умный отбой (smart_cancel)" , данная услуга должна быть активирована.

Пример

  • Абонент B(42007) активировал услугу "smart_cancel" (через "Портал абонента"), таймер ожидания отбоя 5 сек.(по умолчанию 2 сек.).
  • Абонент A(42007)набирает номер абонента B(42009).
  • SSW проключает вызов на абонента В(42009), и запускается таймер ожидания отбоя абонента А.
  • В случае истечения таймера (абонент А не сбросил звонок), звонок в сторону В обрабатывается без услуги "smart_cancel" (и в "Истории вызовов" не будет упоминания об использовании услуги).
  • В случае отбоя со стороны абонента А до истечения таймера, звонок в сторону В будет обрабатывается с услугой "smart_cancel" (и в "Истории вызовов" будет индикация об использовании услуги).
  • В случае использования услуги со значением таймера = "всегда" (-1), звонок в сторону В будет всегда обрабатывается с услугой "smart_cancel" (и в "Истории вызовов" всегда будет индикация об использовании услуги).
  • SSW посылает в сторону абонента В, в сообщении "CANCEL", дополнительное поле "Reason: SIP;cause=200".

В случае срабатывания услуги "Умный отбой (smart_cancel)" запись о использовании услуги будет добавлена в  CDR файл, а так же отображаться в приложении "История вызовов" 

Пример записи в CDR файле:

TYPEDATIMEKOD_AKOD_BACTSUSBSERVUSERSERVINDICCONN_ID
Service2025.04.15 09:11:374200742009invocation42007smart_cancel365763832

Пример информации в "Истории вызовов":


INVITE sip:42009@test_domain SIP/2.0
Via: SIP/2.0/UDP 10.0.20.134:5062;rport;branch=z9hG4bKr4t59K3a11Qam
Max-Forwards: 70
From: "sub_A_42007" <sip:42007@test_domain>;tag=1jXjeH1XaUp5D
To: <sip:42009@test_domain>
Call-ID: e2a57a00-9aa6-1200-77a5-6813e20928d4
CSeq: 120681 INVITE
Contact: <sip:42007@10.0.20.134:5062;transport=udp>
User-Agent: VP-15P/2.9.4.5 sofia-sip/1.25
Allow: INVITE, ACK, BYE, CANCEL, OPTIONS, PRACK, MESSAGE, SUBSCRIBE, NOTIFY, REFER, UPDATE, INFO
Supported: timer, 100rel, replaces, remote-ring
Allow-Events: message-summary, talk, hold, dialog, refer, check-sync
Session-Expires: 1800
Min-SE: 120
Content-Type: application/sdp
Content-Disposition: session
Content-Length: 417

v=0
o=- 7287806257745151006 8205349087654111653 IN IP4 10.0.20.134
s=Session SDP
c=IN IP4 10.0.20.134
t=0 0
m=audio 23000 RTP/AVP 8 18 0 4 103 104 96
a=rtpmap:8 PCMA/8000
a=rtpmap:18 G729/8000
a=fmtp:18 annexb=no
a=rtpmap:0 PCMU/8000
a=rtpmap:4 G723/8000
a=fmtp:4 annexa=no
a=rtpmap:103 G726-24/8000
a=rtpmap:104 G726-32/8000
a=rtpmap:96 telephone-event/8000
a=fmtp:96 0-15
a=silenceSupp:off - - - -



INVITE sip:42009@10.0.20.138:5061 SIP/2.0
Via: SIP/2.0/UDP 10.0.20.31:5060;branch=z9hG4bK-o-1744684949128819-041231-101
From: "sub_A_42007" <sip:42007@test_domain;user=phone>;tag=ecssO1744684949128824041231
To: <sip:42009@test_domain;user=phone>
Call-ID: 06d0a73953c91733
CSeq: 1 INVITE
User-Agent: Eltex ECSS-10
Max-Forwards: 69
Contact: <sip:42007@10.0.20.31:5060;line=0f2e2de6fc5bf33f>
X-Call-Ref: 3846253010
Accept: multipart/mixed, application/sdp
Allow: INVITE, ACK, BYE, CANCEL, PRACK, REGISTER, INFO, REFER, NOTIFY, OPTIONS, SUBSCRIBE, MESSAGE, UPDATE, PUBLISH
Allow-Events: presence, dialog, conference, as-feature-event, keep-alive
P-Eltex-Info: test_domain 42009@test_domain/- 3846253010 sip1@ecss1 <0.4123.1>/1 outgoing
Category: 10
Session-Expires: 1800;refresher=uac
Min-SE: 300
Supported: 100rel, timer, replaces
Remote-Party-ID: "sub_A_42007" <sip:42007@test_domain>;party=calling;screen=yes;privacy=off
Content-Type: application/sdp
Content-Length: 691

v=0
o=- 2208989045 3953673749 IN IP4 10.0.20.82
s=ECSS-10
b=AS:3166
t=0 0
m=audio 12066 RTP/AVP 8 0 9 96
c=IN IP4 10.0.20.82
a=rtpmap:8 PCMA/8000/1
a=rtpmap:0 PCMU/8000/1
a=rtpmap:9 G722/8000/1
a=rtpmap:96 telephone-event/8000
a=fmtp:96 0-16
a=rtcp:12067 IN IP4 10.0.20.82
a=sendrecv
a=ssrc:1698705706 cname:366e008e78890496
m=video 12068 RTP/AVP 100 96
c=IN IP4 10.0.20.82
b=TIAS:3000000
a=rtpmap:100 H264/90000
a=fmtp:100 packetization-mode=0;profile-level-id=42e01E
a=rtpmap:96 H263-1998/90000
a=fmtp:96 CIF=1;QCIF=1
a=rtcp:12069 IN IP4 10.0.20.82
a=sendrecv
a=imageattr:* recv [x=640,y=480,q=0.50]
a=ssrc:1124371637 cname:366e008e78890496
a=rtcp-fb:* nack pli

CANCEL sip:42009@test_domain SIP/2.0
Via: SIP/2.0/UDP 10.0.20.134:5062;rport;branch=z9hG4bKr4t59K3a11Qam
Max-Forwards: 70
From: "sub_A_42007" <sip:42007@test_domain>;tag=1jXjeH1XaUp5D
To: <sip:42009@test_domain>
Call-ID: e2a57a00-9aa6-1200-77a5-6813e20928d4
CSeq: 120681 CANCEL
Reason: Q.850;cause=16;text="Normal call clearing"
Content-Length: 0

CANCEL sip:42009@10.0.20.138:5061 SIP/2.0
Via: SIP/2.0/UDP 10.0.20.31:5060;branch=z9hG4bK-o-1744684949128819-041231-101
From: "sub_A_42007" <sip:42007@test_domain;user=phone>;tag=ecssO1744684949128824041231
To: <sip:42009@test_domain;user=phone>
Call-ID: 06d0a73953c91733
CSeq: 1 CANCEL
Max-Forwards: 69
Reason: Q.850;cause=16;text="Normal call clearing"
Reason: SIP;cause=200
P-Eltex-Info: system: Call is cancelled by initiator
Content-Length: 0


Управление услугой с телефонного аппарата

С телефонного аппарата управление услугой "Умный отбой (smart_cancel)" невозможен. Активизацию услуги / коррекция таймера, возможна только  через "Портал абонента".
Так же изменить конфигурацию может оператор через CLI / Web интерфейс.

Настройка параметров услуги через интерфейс командной строки

Для активации услуги "Умный отбой (smart_cancel)" через интерфейс командной строки выполните следующие команды:

  • для администратора системы:
    /cluster/storage/<CLUSTER>/ss/enable <DOMAIN> <ADDRESS> smart_cancel
    /cluster/storage/<CLUSTER>/ss/activate <DOMAIN> <ADDRESS> smart_cancel <ATR>
  • для оператора виртуальной АТС:
    /domain/<DOMAIN>/ss/enable <ADDRESS> smart_cancel
    /domain/<DOMAIN>/ss/activate <ADDRESS> smart_cancel <ATR>

где

<CLUSTER> — имя кластера хранения долговременных данных (DS);
<DOMAIN> — имя виртуальной АТС, которой принадлежит абонент(ы);
<ADDRESS> — номер(а) абонентов, для которых выполняется настройка услуги, символ "*" используется для указания всех абонентов заданного домена;
<ATR> — настраиваемые параметры услуги:

  • timeout — таймер указывающий время, в течении которого при отбое будет добавляется заголовок "Reason" с параметрами "SIP;cause=200".
    Если значение timeout будет выставлено в "-1", то для всех вызовов при отбое будет добавляется заголовок "Reason" с параметрами "SIP;cause=200".
    Возможны значения [ -1, 0-5 ] сек. , значение по умолчанию 2 сек.
Диапазоны номеров указываются в фигурных скобках. Например: 71{1-2,9} соответствует номерам 711, 712, 719.

Описание команд для управления услугами через интерфейс командной строки CLI приведено в Справочнике команд CLI, разделы /cluster/storage/<STORAGE>/ss и /domain/<DOMAIN>/ss.

Пример настройки CLI

Активировать услугу "Умный отбой (smart_cancel)" для абонента с номером 42001 виртуальной АТС "test_domain", таймер установить на значение 5 сек.

Активация услуги "smart_cancel" через интерфейс командной строки:

/domain/test_domain/ss/enable 42001 smart_cancel 
1 users divided into 1 parts
[**********************************************************************] 35mks    

Success: Supplementary service smart_cancel enabled for domain "test_domain", address "42001"

Read properties from enabled supplementary services
[**********************************************************************] 61mks  

/domain/test_domain/ss/activate 42001 smart_cancel timeout = 5
1 users divided into 1 parts
[**********************************************************************] 29mks    

Success: Supplementary service smart_cancel activated for domain "test_domain" address "42001"

Пример настройки через Web

Активация услуги "smart_cancel" через web-конфигуратор:

Настройки выполняются в разделе "Supplementary services" ("Дополнительные услуги") приложения "Subscriber card" ("Карточка абонента").

Настройка услуги для всех абонентов определенной виртуальной АТС, а также для определенного абонента в отдельности выполняется в приложении "Subscriber card" ("Карточка абонента").

  1. Выберите номер телефона абонента — 42001;
  2. Разрешите использовать услугу абоненту — установите . Установите флаг напротив услуги "Умный отбой (smart_cancel)".
  3. Для деактивации услуги — снимите флаг.
  4. Для сохранения настроек нажмите кнопку "Сохранить" ("Save").


 

Пример настройки через Портал абонента


Обязательным условием , настройки услуг через Портал абонента, данная услуга должна быть назначена на абонента (через CLI или Web). Через Портал абонента можно только вкл/выкл изменить параметры , но нельзя добавить или убрать услуги.

Активация услуги "smart_cancel" через Портал абонента:

  1. Выберите закладку "Услуги";
  2. Установите переключатель напротив услуги "Умный отбой (smart_cancel)" в положение вкл .
  3. Установите требуемое значение таймера на ожидания отбоя.
  4. Для сохранения настроек нажмите кнопку "Сохранить".