Skip to Content

Query Information of a Ring Group

Query the detailed information of a ring group.

Request URL

GET {base_url}/{api_path}/ringgroup/get?access_token={access_token}

Request parameters

ParameterRequiredTypeDescription
idYesIntegerThe unique ID of the ring group.
Note:You can query the ring group's ID using Search Specific Ring Groups.

Response parameters

ParameterTypeDescription
errcodeIntegerReturned error code.
  • 0: Succeed.
  • Non-zero value: Failed.
Note: You can check the error code and error message in Error Code and Error Message.
errmsgStringReturned message.
  • SUCCESS: Succeed.
  • FAILURE: Failed.
dataObject <Ring_Group_Detail>The detailed information of the ring group.

Ring_Group_Detail

ParameterTypeDescription
idIntegerThe unique ID of the ring group.
numberStringThe ring group number.
nameStringThe ring group name.
ring_strategyStringThe ring strategy of the ring group.
  • ring_all: Ring all available extensions simultaneously.
  • sequentially: Ring all available extensions sequentially.
  • memory_hunt: Ring the first available extension in the member list. If no answer within the ring time, progressively ring the next available extension, until all the available extensions in the list rang.
  • custom: Ring extensions according to their individual ring delays and stop ringing after their individual ring timeouts.
ring_timeoutInteger

The waiting time (in seconds) before ringing the next member or routing the call to Failover Destination.

Note: The parameter is valid only when the value of ring_strategy is ring_all, sequentially or memory_hunt.
member_listArray <Ring_Group_Member>The information of each member in the ring group.
fail_destString

The destination type for ring group calls unanswered within ring timeout.

  • end_call: Hang Up.
  • extension: Extension.
  • ext_vm: Extension Voicemail.
  • group_vm: Group Voicemail.
  • ivr: IVR.
  • call_flow: Call Flow
  • ring_group: Ring Group.
  • queue: Queue.
  • external_num: External Number.
  • play_greeting: Play Prompt and Exit.
fail_dest_prefixString

The destination prefix for ring group calls unanswered within ring timeout.

Note: The definition of this parameter depends on the value of fail_dest.
  • If fail_dest is external_num, this parameter indicates the dial-out prefix of the external number.
  • If fail_dest is play_greeting, this parameter indicates the play count of the prompt.
fail_dest_valueString

The detailed destination for ring group calls unanswered within ring timeout.

Note:The definition of this parameter depends on the value of fail_dest.
  • If fail_dest is play_greeting, this parameter indicates the filename of custom prompt.
  • If fail_dest is extension, ext_vm, group_vm, ivr, call_flow, ring_group, or queue, this parameter indicates the destination ID.
  • If fail_dest is external_num, this parameter indicates the external number.
alert_infoString

The keyword added to Alert-info header in INVITE request, determining which ringtone to be play to identify ring group calls.

welcome_promptStringThe filename of custom prompt or the name of MoH (music on hold) playlist. The audio is played to callers before members answer the calls.
mohStringThe name of the MoH (music on hold) playlist whose audio is played to callers when the calls are put on hold.
join_promptStringThe filename of the custom prompt used to be played to callers only once when the calls join the ring group.
play_full_join_promptIntegerWhether the system plays full join prompt to callers before ringing members.
  • 0: Disable - The system rings members as configured regardless of whether the join prompt is fully played.
  • 1: Enable - The system rings members after playing full join prompt.
client_unique_ringtoneStringThe filename of the ringtone for members' Linkus clients.
no_agent_online_destString

The destination type for ring group calls with no online extensions.

  • end_call: Hang Up.
  • extension: Extension.
  • ext_vm: Extension Voicemail.
  • group_vm: Group Voicemail.
  • ivr: IVR.
  • call_flow: Call Flow
  • ring_group: Ring Group.
  • queue: Queue.
  • external_num: External Number.
  • play_greeting: Play Prompt and Exit.
no_agent_online_prefixString

The destination prefix for ring group calls with no online extensions.

Note: The definition of this parameter depends on the value of no_agent_online_dest.
  • If no_agent_online_dest is external_num, this parameter indicates the dial-out prefix of the external number.
  • If no_agent_online_dest is play_greeting, this parameter indicates the play count of the prompt.
no_agent_online_valueString

The detailed destination for ring group calls with no online extensions.

Note: The definition of this parameter depends on the value of no_agent_online_dest.
  • If no_agent_online_dest is play_greeting, this parameter indicates the filename of custom prompt.
  • If no_agent_online_dest is extension, ext_vm, group_vm, ivr, call_flow, ring_group, or queue, this parameter indicates the destination ID.
  • If no_agent_online_dest is external_num, this parameter indicates the external number.
enb_miss_callIntegerWhether missed ring group calls are recorded in call logs of extensions included in failover destination.
  • 0: Disable - The missed calls are not recorded in call logs.
  • 1: Enable - The missed calls are recorded in call logs.

Ring_Group_Member

ParameterTypeDescription
valueStringThe ID of the ring group member.
Note:The parameter is valid only when the value of ring_strategy is ring_all, sequentially or memory_hunt.
typeStringThe type of the ring group member.
  • extension: Extension.
  • ext_group: Extension group.
Note:The parameter is valid only when the value of ring_strategy is ring_all, sequentially or memory_hunt.
textStringThe name of the ring group member.
Note:The parameter is valid only when the value of ring_strategy is ring_all, sequentially or memory_hunt.
text2StringThe definition of this parameter depends on the value of type.
  • If type is extension, the parameter indicates the extension number.
  • If type is ext_group, the parameter indicates the name of the extension group.
Note:The parameter is valid only when the value of ring_strategy is ring_all, sequentially or memory_hunt.
sub_optionArray <Custom_Strategy_Member>The extensions and extension groups included in the ring group member entry.
Note: The parameter is valid only when the value of ring_strategy is custom.
delay_timeIntegerThe time delay (in seconds) before ringing all extensions included in the ring group member entry.
Note: The parameter is valid only when the value of ring_strategy is custom.
timeoutIntegerThe waiting time (in seconds) before ringing the next member or routing the call to Failover Destination.
Note: The parameter is valid only when the value of ring_strategy is custom.

Custom_Strategy_Member

ParameterTypeDescription
valueStringThe ID of the ring group member.
typeStringThe type of the ring group member.
  • extension: Extension.
  • ext_group: Extension group.
textStringThe name of the ring group member.
text2StringThe definition of this parameter depends on the value of type.
  • If type is extension, the parameter indicates the extension number.
  • If type is ext_group, the parameter indicates the name of the extension group.

Examples

Request example

Query the detailed information of the specified ring group (ID: 8023).

GET /openapi/v1.0/ringgroup/get?access_token=mlF8b3omcSD822Sosdc6kyiFkdYkC8UG&id=8023 HTTP/1.1
Host: 192.168.5.150:8088

Response example

HTTP/1.1 200 OK
{
    "errcode": 0,
    "errmsg": "SUCCESS",
    "data": {
        "id": 8023,
        "number": "6300",
        "name": "Technical Support",
        "ring_strategy": "ring_all",
        "ring_timeout": 20,
        "member_list": [
            {
                "value": "3071",
                "type": "extension",
                "text": "Evelyn",
                "text2": "3200",
                "delay_time": 0,
                "timeout": 0,
                "sub_option": null
            },
            {
                "value": "3074",
                "type": "extension",
                "text": "Dave Haris",
                "text2": "3202",
                "delay_time": 0,
                "timeout": 0,
                "sub_option": null
            },
            {
                "value": "3075",
                "type": "extension",
                "text": "Terrell Smith",
                "text2": "3021",
                "delay_time": 0,
                "timeout": 0,
                "sub_option": null
            }
        ],
        "fail_dest": "end_call",
        "fail_dest_prefix": "",
        "fail_dest_value": "",
        "alert_info": "ring-group-support",
        "welcome_prompt": "SoftBreeze",
        "moh": "SoftBreeze",
        "join_prompt": "DID.wav",
        "play_full_join_prompt": 1,
        "client_unique_ringtone": "",
        "no_agent_online_dest": "end_call",
        "no_agent_online_prefix": "",
        "no_agent_online_value": "",
        "enb_miss_call": 0
    }
}