Skip to content
FlySIPFlySIP Docs

Manage trusted numbers

A trusted number links a caller’s phone number (CLI) to a calling card account. When that number calls the Calling Card application, the caller is recognised by the number and does not enter the card number. These methods do the same as the Trusted Numbers screen of an account.

addCLIMapping

Section titled “addCLIMapping”

Adds a trusted number to a card.

Parameters

Section titled “Parameters”
Name Type Required Description
i_account int yes ID of the calling card account
cli string yes Source Phone Number: the caller’s number to trust
lang string yes Voice Menu Language for this caller: a two-letter code such as en or ru

Returns

Section titled “Returns”
Name Type Description
result string OK

Example

Section titled “Example”
request
call("addCLIMapping", {"i_account": 3092, "cli": "447700900123", "lang": "en"})
response
{"result": "OK"}

updateCLIMapping

Section titled “updateCLIMapping”

Changes a trusted number or its language.

Parameters

Section titled “Parameters”
Name Type Required Description
i_account int yes ID of the calling card account
old_cli string yes The current trusted number
new_cli string yes The new number
lang string no New voice menu language

Returns

Section titled “Returns”
Name Type Description
result string OK

Example

Section titled “Example”
request
call("updateCLIMapping", {"i_account": 3092, "old_cli": "447700900123", "new_cli": "447700900456"})
response
{"result": "OK"}

delCLIMapping

Section titled “delCLIMapping”

Removes a trusted number from a card.

Parameters

Section titled “Parameters”
Name Type Required Description
i_account int yes ID of the calling card account
cli string yes The trusted number to remove

Returns

Section titled “Returns”
Name Type Description
result string OK

Example

Section titled “Example”
request
call("delCLIMapping", {"i_account": 3092, "cli": "447700900456"})
response
{"result": "OK"}

listCLIMappings

Section titled “listCLIMappings”

Lists the trusted numbers of a card.

Parameters

Section titled “Parameters”
Name Type Required Description
i_account int yes ID of the calling card account

Returns

Section titled “Returns”
Name Type Description
result string OK
list array One element per trusted number, each a pair of the CLI and its language

Example

Section titled “Example”
request
call("listCLIMappings", {"i_account": 3092})
response
{"result": "OK", "list": [["447700900123", "en"], ["13105550142", "ru"]]}

findCLIMapping

Section titled “findCLIMapping”

Finds the card that a number is trusted for.

Parameters

Section titled “Parameters”
Name Type Required Description
cli string yes The caller’s number
i_customer int yes ID of the customer that owns the card: the authenticated customer or one of its sub-customers

Returns

Section titled “Returns”
Name Type Description
result string OK
i_account int ID of the calling card account
cli string The trusted number
lang string Its voice menu language
username string Username of the account
authname string Authentication name of the account

Example

Section titled “Example”
request
call("findCLIMapping", {"cli": "447700900123", "i_customer": 3})
response
{
    "result": "OK",
    "i_account": 3092,
    "cli": "447700900123",
    "lang": "en",
    "username": "1001",
    "authname": "1001",
}
Section titled “Related”