{"metadata":{"image":[],"title":"","description":""},"api":{"url":"","auth":"required","settings":"","results":{"codes":[]},"params":[]},"next":{"description":"","pages":[]},"title":"FindMe Update List Settings","type":"basic","slug":"findme-update-list-settings","excerpt":"API used to update an existing FindMe","body":"[block:api-header]\n{\n \"title\": \"Use the FindMe Update List Settings API to update an existing FindMe\"\n}\n[/block]\nUse the FindMe Update List Settings API to update an existing FindMe within a DialogTech's account.\n[block:callout]\n{\n \"type\": \"info\",\n \"title\": \"Base URL for FindMe Update List Settings\",\n \"body\": \"https://secure.dialogtech.com/ibp_api.php\"\n}\n[/block]\n\n[block:api-header]\n{\n \"title\": \"Parameter List\"\n}\n[/block]\n\n[block:parameters]\n{\n \"data\": {\n \"h-0\": \"Parameter\",\n \"h-1\": \"Required\",\n \"h-2\": \"Accepts\",\n \"h-3\": \"Max Length\",\n \"h-4\": \"Notes\",\n \"h-5\": \"Usage\",\n \"0-0\": \"action\",\n \"0-1\": \"Yes\",\n \"0-2\": \"String: **findme.update_list_settings**\",\n \"0-3\": \"n/a\",\n \"0-4\": \"Only accepts **findme.update_list_settings** to update an existing FindMe\",\n \"0-5\": \"Defines the API Call as \\\"FindMe Update List Settings\\\" type\",\n \"1-0\": \"access_key\",\n \"1-1\": \"Yes\",\n \"1-2\": \"String\",\n \"1-3\": \"n/a\",\n \"2-0\": \"secret_access_key\",\n \"2-1\": \"Yes\",\n \"2-2\": \"String\",\n \"2-3\": \"n/a\",\n \"1-4\": \"Access Key from the Key Manager within a DialogTech account\",\n \"1-5\": \"Credentials used for access to the API for a particular DialogTech account\",\n \"2-5\": \"Credentials used for access to the API for a particular DialogTech account\",\n \"2-4\": \"Secret Access Key from the Key Manager within a DialogTech account\",\n \"4-0\": \"name\",\n \"5-0\": \"usr_findme_type\",\n \"4-1\": \"No\",\n \"4-2\": \"String\",\n \"5-2\": \"**1** or **2**\",\n \"5-1\": \"No\",\n \"4-3\": \"n/a\",\n \"5-3\": \"6\",\n \"4-4\": \"Names the FindMe\",\n \"5-4\": \"**1** - Individual FindMe *(Default)*\\n**2** - Customer Service Hunt Group\",\n \"4-5\": \"Defines the name of the FindMe\",\n \"5-5\": \"Modifies the **FindMe default audio prompts** to use verbiage similar to calling a single individual *(Individual FindMe)*, or any individual in a group *(Customer Service Hunt Group)*\",\n \"6-0\": \"loop_count\",\n \"6-1\": \"No\",\n \"6-2\": \"String\",\n \"6-3\": \"1\",\n \"6-4\": \"Accepts values **0 to 5** (default is 1)\",\n \"6-5\": \"Determines the total number of times the predefined list of numbers would be attempted in its entirety before moving to the *no answer action*\",\n \"7-0\": \"distribution_type\",\n \"7-1\": \"No\",\n \"7-2\": \"**1** or **2**\",\n \"7-3\": \"1\",\n \"7-4\": \"**value not present on URL** - Attempt the list sequentially on each call (default)\\n**1** - Randomized order \\n**2** - Round robin order\",\n \"7-5\": \"Determines if the predefined list of numbers should be attempted in round-robin order or randomly.\",\n \"8-0\": \"record\",\n \"8-1\": \"No\",\n \"8-2\": \"**1** or **2**\",\n \"8-3\": \"1\",\n \"8-4\": \"**0** - Do not record the call (default)\\n**1** - Record the call\",\n \"8-5\": \"Determines if the call will be recorded or not.\",\n \"9-0\": \"screen_method\",\n \"9-1\": \"No\",\n \"9-2\": \"**0** or **1** or **2**\",\n \"9-3\": \"1\",\n \"9-4\": \"**0** - Record the caller's name (default)\\n**1** - Whisper the `whisper_phrase` value using text-to-speech\\n**2** - Whisper the audio file provided via `whisper_audio` *(note: The audio file must be an existing audio file within the account)*\",\n \"9-5\": \"Determines how the caller will be screened prior to being connected\",\n \"10-0\": \"screen_prompt\",\n \"10-1\": \"No\",\n \"10-2\": \"String\",\n \"10-3\": \"n/a\",\n \"10-4\": \"Default is a standardized pre-recorded prompt provided by DialogTech\",\n \"10-5\": \"Determines the screen message played when `screen_method=0`\",\n \"11-0\": \"dtmf_only\",\n \"11-1\": \"No\",\n \"11-2\": \"**0** or **1**\",\n \"11-3\": \"1\",\n \"11-4\": \"**0** - Accept voice input as well as keypress input on call-acceptance prompts\\n**1** - Only accept keypress input on call-acceptance prompts\",\n \"11-5\": \"Determines how the user receiving the call can accept the call, **0** allows the user to say *Yes* or press 1 to accept a call. **1** requires the user to press 1 to accept the call.\",\n \"12-0\": \"holdmusic\",\n \"13-0\": \"holdrepeat\",\n \"14-0\": \"timeout\",\n \"12-1\": \"No\",\n \"12-2\": \"String\",\n \"12-3\": \"n/a\",\n \"12-5\": \"Audio file to play to caller as caller waits for destination to answer. .\",\n \"12-4\": \"Default is a standardized pre-recorded prompt provided by DialogTech *(note: The audio file must be an existing audio file within the FindMe directory in the account)*\",\n \"13-5\": \"Determines how often the hold message is played to the caller\",\n \"13-4\": \"**0** - Play once per FindMe session\\n**1** - Play once between attempts\\n**2** - Play continuously between attempts\",\n \"13-3\": \"1\",\n \"13-2\": \"**0** or **1** or **2**\",\n \"13-1\": \"No\",\n \"14-1\": \"No\",\n \"14-2\": \"**10-60**\",\n \"14-3\": \"2\",\n \"14-4\": \"Default is 30\",\n \"14-5\": \"Number of seconds to ring each destination before determining that attempt is not answered, and moving to the next number or action\",\n \"15-0\": \"whisper_phrase\",\n \"15-1\": \"No\",\n \"15-2\": \"String\",\n \"15-3\": \"n/a\",\n \"15-5\": \"Phrase spoken to person who answers phone\",\n \"15-4\": \"To be used with `screen_method` *(default is no phrase)*\",\n \"17-0\": \"findme_action\",\n \"17-1\": \"No\",\n \"17-2\": \"String\",\n \"17-3\": \"n/a\",\n \"17-4\": \"`See FindMe Action Table Below`\",\n \"17-5\": \"Determines which application a call is sent to after it is determined that no numbers in the FindMe list have accepted the call.\",\n \"18-0\": \"findme_action_parameter\",\n \"18-1\": \"No\",\n \"18-2\": \"String\",\n \"18-3\": \"n/a\",\n \"18-4\": \"`See FindMe Action Table Below`\",\n \"18-5\": \"Building Block ID associated with the `findme_action`\",\n \"19-0\": \"advanced_audio_id\",\n \"19-1\": \"No\",\n \"19-2\": \"String\",\n \"19-3\": \"n/a\",\n \"19-4\": \"Please call our Customer Support Team to help retrieve the appropriate value if you would like to use a custom audio-prompt set.\",\n \"19-5\": \"If there is already a configured *Advanced Audio Prompt Set* in another FindMe you can use that set ID here to use the same audio-prompt set\",\n \"20-0\": \"auto_accept\",\n \"20-1\": \"No\",\n \"20-2\": \"String\",\n \"20-3\": \"n/a\",\n \"20-4\": \"**0** - Agent will be prompted to accept the call *(note: can be used with `dtmf_only` to require a keypress to accept the call)*\\n**1** - The first number that answers, receives the call without any option to accept/deny the call\\n**2** - The last number attempted will be sent the call. Call screening will be disabled if transferred in this way.\\n**3** - The last number attempted will be sent the call. Call screening will remain enabled if transferred in this way.\",\n \"20-5\": \"Determines how the recipient of the call will be prompted (or not) to accept the call\",\n \"21-0\": \"simul\",\n \"21-1\": \"No\",\n \"21-2\": \"String\",\n \"21-3\": \"n/a\",\n \"21-4\": \"*The maximum value will be determined by the account type, and the number of available **Simultaneous FindMe Ports** are available with the account*\",\n \"21-5\": \"Determines the number of simultaneous calls to make to the various numbers in the FindMe list.\",\n \"16-0\": \"whisper_audio\",\n \"16-1\": \"No\",\n \"16-2\": \"String\",\n \"16-3\": \"n/a\",\n \"16-4\": \"To be used with `screen_method`\",\n \"16-5\": \"The name of an audio file in your Whisper Phrase Audio files folder\",\n \"3-0\": \"findme_id\",\n \"3-1\": \"Yes\",\n \"3-2\": \"String\",\n \"3-3\": \"n/a\",\n \"3-4\": \"ID of the existing FindMe\",\n \"3-5\": \"Defines which FindMe is being updated.\"\n },\n \"cols\": 6,\n \"rows\": 22\n}\n[/block]\n\n[block:api-header]\n{\n \"title\": \"Using this API\"\n}\n[/block]\nThese code examples are meant to show a basic method of accessing DialogTech's FindMe Update List Settings API.\n[block:code]\n{\n \"codes\": [\n {\n \"code\": \"\",\n \"language\": \"text\",\n \"name\": \"PHP Example\"\n },\n {\n \"code\": \"curl -X \\\"\\\"\",\n \"language\": \"text\",\n \"name\": \"cURL\"\n }\n ]\n}\n[/block]\n**Example Response**\n[block:code]\n{\n \"codes\": [\n {\n \"code\": \"\",\n \"language\": \"xml\",\n \"name\": \"xml\"\n }\n ]\n}\n[/block]","updates":[],"order":16,"isReference":false,"hidden":true,"sync_unique":"","link_url":"","link_external":false,"_id":"591328c2c188f10f0050339f","version":{"version":"1.0","version_clean":"1.0.0","codename":"","is_stable":true,"is_beta":false,"is_hidden":false,"is_deprecated":false,"categories":["558d9c33beb7c719007f631d","558db0bc7afc102f008ed863","558db0d07afc102f008ed864","558db3c84cd25f0d00b7ecb2","558dbace7afc102f008ed894","558dbd104cd25f0d00b7ecca","558dbd4c4cd25f0d00b7eccb","559d3e858639bd21008e90a6","55bb8ca5a8400c2d00873e70","58fdfb438fbd2819000db9eb","590829c7ade4172d006a87b8","59082a11beedcf0f00235d87","5908bd2cba2afd23007d6d12","5908d1f64f544425002b6aae","591e5e9e2c1b1f0f000fa4e5","5a283434aba91f002834ea86","5a69fe5cde745d002c936c66","5a81e6ef761cf300127317f8","5a81e7d63b1e120012bed5a1","5f6cf225ba56a40011bff62d","5f970e8b7617eb041ae758bb","602adb88243fbc0056918566","602adbb91828a600535980c4"],"_id":"558d9c33beb7c719007f631c","createdAt":"2015-06-26T18:38:43.154Z","project":"558d9c32beb7c719007f6319","releaseDate":"2015-06-26T18:38:43.153Z","__v":23},"__v":0,"user":"58cadf93d223510f005d27db","category":{"sync":{"isSync":false,"url":""},"pages":[],"title":"Administration APIs","slug":"administration-apis","order":1,"from_sync":false,"reference":false,"_id":"590829c7ade4172d006a87b8","createdAt":"2017-05-02T06:40:07.955Z","project":"558d9c32beb7c719007f6319","__v":0,"version":"558d9c33beb7c719007f631c"},"createdAt":"2017-05-10T14:50:42.043Z","project":"558d9c32beb7c719007f6319","githubsync":"","parentDoc":null}
FindMe Update List Settings
Use the FindMe Update List Settings API to update an existing FindMe within a DialogTech's account.
Base URL for FindMe Update List Settings
action
Yes
String: findme.update_list_settings
n/a
Only accepts findme.update_list_settings to update an existing FindMe
Defines the API Call as "FindMe Update List Settings" type
access_key
Yes
String
n/a
Access Key from the Key Manager within a DialogTech account
Credentials used for access to the API for a particular DialogTech account
secret_access_key
Yes
String
n/a
Secret Access Key from the Key Manager within a DialogTech account
Credentials used for access to the API for a particular DialogTech account
findme_id
Yes
String
n/a
ID of the existing FindMe
Defines which FindMe is being updated.
name
No
String
n/a
Names the FindMe
Defines the name of the FindMe
usr_findme_type
No
1 or 2
6
1 - Individual FindMe (Default)
2 - Customer Service Hunt Group
Modifies the FindMe default audio prompts to use verbiage similar to calling a single individual (Individual FindMe), or any individual in a group (Customer Service Hunt Group)
loop_count
No
String
1
Accepts values 0 to 5 (default is 1)
Determines the total number of times the predefined list of numbers would be attempted in its entirety before moving to the no answer action
distribution_type
No
1 or 2
1
value not present on URL - Attempt the list sequentially on each call (default)
1 - Randomized order
2 - Round robin order
Determines if the predefined list of numbers should be attempted in round-robin order or randomly.
record
No
1 or 2
1
0 - Do not record the call (default)
1 - Record the call
Determines if the call will be recorded or not.
screen_method
No
0 or 1 or 2
1
0 - Record the caller's name (default)
1 - Whisper the whisper_phrase
value using text-to-speech
2 - Whisper the audio file provided via whisper_audio
(note: The audio file must be an existing audio file within the account)
Determines how the caller will be screened prior to being connected
screen_prompt
No
String
n/a
Default is a standardized pre-recorded prompt provided by DialogTech
Determines the screen message played when screen_method=0
dtmf_only
No
0 or 1
1
0 - Accept voice input as well as keypress input on call-acceptance prompts
1 - Only accept keypress input on call-acceptance prompts
Determines how the user receiving the call can accept the call, 0 allows the user to say Yes or press 1 to accept a call. 1 requires the user to press 1 to accept the call.
holdmusic
No
String
n/a
Default is a standardized pre-recorded prompt provided by DialogTech (note: The audio file must be an existing audio file within the FindMe directory in the account)
Audio file to play to caller as caller waits for destination to answer. .
holdrepeat
No
0 or 1 or 2
1
0 - Play once per FindMe session
1 - Play once between attempts
2 - Play continuously between attempts
Determines how often the hold message is played to the caller
timeout
No
10-60
2
Default is 30
Number of seconds to ring each destination before determining that attempt is not answered, and moving to the next number or action
whisper_phrase
No
String
n/a
To be used with screen_method
(default is no phrase)
Phrase spoken to person who answers phone
whisper_audio
No
String
n/a
To be used with screen_method
The name of an audio file in your Whisper Phrase Audio files folder
findme_action
No
String
n/a
See FindMe Action Table Below
Determines which application a call is sent to after it is determined that no numbers in the FindMe list have accepted the call.
findme_action_parameter
No
String
n/a
See FindMe Action Table Below
Building Block ID associated with the findme_action
advanced_audio_id
No
String
n/a
Please call our Customer Support Team to help retrieve the appropriate value if you would like to use a custom audio-prompt set.
If there is already a configured Advanced Audio Prompt Set in another FindMe you can use that set ID here to use the same audio-prompt set
auto_accept
No
String
n/a
0 - Agent will be prompted to accept the call (note: can be used with dtmf_only
to require a keypress to accept the call)
1 - The first number that answers, receives the call without any option to accept/deny the call
2 - The last number attempted will be sent the call. Call screening will be disabled if transferred in this way.
3 - The last number attempted will be sent the call. Call screening will remain enabled if transferred in this way.
Determines how the recipient of the call will be prompted (or not) to accept the call
simul
No
String
n/a
The maximum value will be determined by the account type, and the number of available Simultaneous FindMe Ports are available with the account
Determines the number of simultaneous calls to make to the various numbers in the FindMe list.
These code examples are meant to show a basic method of accessing DialogTech's FindMe Update List Settings API.
Example Response