- What it does
- Configuration
- What you need
- Setting up announcements
- I want to…
- Bar and play an announcement to international calls dialed without the international call prefix
- Play an announcement before international calls
- Bar international calls dialed without the international call prefix, except calls to Canada
- Play an announcement before international calls, except calls to Canada
- Allow international calls dialed without the international call prefix, except calls to the US,
- I want to…
What it does
The International Call Management service provides support for barring and playing announcements for international calls based on the format of the dialed digits, and the identified country of the destination address.
Outbound calls can be barred if a call is determined to be international and the international dialing prefix is not explicitly present in the dialed digits. An announcement can be played before the call is barred. Additionally, if a call is determined to be international a pre-call announcement can be played to the calling party. The default options can be overridden based on the destination country.
The |
Restrictions
The destination country can only be identified if the country uses the North American Numbering Plan (ie international prefix is 1
).
Countries outside the NANP will be treated with the default handling.
Interactions with other services
Roaming and international status determination
If North American Numbering Plan (NANP) analysis is enabled, the details determined by NANP will be used to establish the international and roaming status of the call (by comparing the access network country code, the home network country code, and the destination country code).
Call Barring
The MMTel Outgoing call barring service (OCB) always takes precedence over international call management. If barring is triggered, the call will be terminated without playing an international call management announcement.
Number translation services in general
International Call Management looks at the original dialed number as received by the RVT when doing its analysis. This means that changes to the number by services that provide number translation (such as Location Based Dialing) will not be considered by this service.
Configuration
The example for sentinel-volte-gsm-config.yaml
and example for sentinel-volte-cdma-config.yaml
show example configuration relevant to international call management in the
sentinel-volte/mmtel/international-call-management
and
sentinel-volte/mmtel/north-american-numbering-plan
sections.
What you need
-
❏ Whether the system should bar international calls dialed without an international prefix.
-
❏ Optionally, the ID of the announcement to be played before barring calls.
-
❏ Optionally, the ID of the announcement to be played before international calls are connected.
-
❏ Optionally, per-country overrides for the above, along with the 2 digit upper case ISO country code for countries to be overridden.
Setting up announcements
International Call Management configuration only needs the announcement ID of the announcement that should be played. The details of that announcement should be configured beforehand. For details about how to do this, see Announcements.
I want to…
Bar and play an announcement to international calls dialed without the international call prefix
In the
default-international-call-management
section,
set bar-calls-with-missing-prefix
to true
and
set bar-calls-with-missing-prefix-announcement-id
to the ID of the selected announcement.
international-call-management:
default-international-call-management:
bar-calls-with-missing-prefix: true
bar-calls-with-missing-prefix-announcement-id: 200
Play an announcement before international calls
In the default-international-call-management
section, set
international-call-announcement-id
to the ID of the selected announcement.
international-call-management:
default-international-call-management:
international-call-announcement-id: 200
Bar international calls dialed without the international call prefix, except calls to Canada
In the north-american-numbering-plan-analysis
section,
set enable-nanp-analysis
to true
.
In the default-international-call-management
section,
set bar-calls-with-missing-prefix
to true
.
Ensure the call-management-by-country-code list
is present and uncommented.
Add a list item with an iso-country-code
of CA
and
a bar-calls-with-missing-prefix
value of false
.
north-american-numbering-plan-analysis:
enable-nanp-analysis: true
international-call-management:
default-international-call-management:
bar-calls-with-missing-prefix: true
call-management-by-country-code:
- iso-country-code: "CA"
bar-calls-with-missing-prefix: false
Play an announcement before international calls, except calls to Canada
In the north-american-numbering-plan-analysis
section,
set enable-nanp-analysis
to true
.
In the default-international-call-management
section,
set international-call-announcement-id
to the ID of the selected announcement.
Ensure the call-management-by-country-code list
is present and uncommented.
Add a list item with an iso-country-code
of CA
.
Ensure that the international-call-announcement-id
within the country code list is unset.
The unset value in the CA
profile will not fall back to the default value - a missing international-call-announcement-id
at any level means that no announcement will be played at that level.
north-american-numbering-plan-analysis:
enable-nanp-analysis: true
international-call-management:
default-international-call-management:
international-call-announcment-id: 200
call-management-by-country-code:
- iso-country-code: "CA"
Allow international calls dialed without the international call prefix, except calls to the US,
In the north-american-numbering-plan-analysis
section,
set enable-nanp-analysis
to true
.
In the default-international-call-management
section,
set bar-calls-with-missing-prefix
to false
.
Ensure the call-management-by-country-code list
is present and uncommented.
Add a list item with an iso-country-code
of US
and
a bar-calls-with-missing-prefix
value of true
.
Add a bar-calls-with-missing-prefix-announcement-id
and an
international-call-announcement-id
if desired.
north-american-numbering-plan-analysis:
enable-nanp-analysis: true
international-call-management:
default-international-call-management:
bar-calls-with-missing-prefix: false
call-management-by-country-code:
- iso-country-code: "US"
bar-calls-with-missing-prefix: true
bar-calls-with-missing-prefix-announcement-id: 101
international-call-announcement-id: 102