Skip to main content

easy_huntings

Creates, updates, deletes, gets or lists an easy_huntings resource.

Overview​

Nameeasy_huntings
TypeResource
Idovh.telephony.easy_huntings

Fields​

The following fields are returned by SELECT queries:

successful operation

NameDatatypeDescription
service_namestring (wire: serviceName)
anonymous_rejectionbooleanReject (hangup) anonymous calls (wire: anonymousRejection)
descriptionstringDescription of the service
feature_typestringFeature of the service (aiAgent, carrierSip, cloudHunting, cloudIvr, conference, contactCenterSolution, contactCenterSolutionExpert, ddi, easyHunting, empty, fax, freefax, mgcp, oldConference, plugAndFax, redirect, sip, svi, voicefax, voicemail, vxml) (wire: featureType)
is_ccsbooleanDoes the service have extended CCS options enabled? (wire: isCCS)
max_wait_timeintegerMax wait time when caller is in queue (in seconds) (wire: maxWaitTime)
queue_sizeintegerMax number of callers in queue (wire: queueSize)
service_typestringGeneral type of the service (alias, line) (wire: serviceType)
show_caller_numberstringThe presented number when bridging calls (alias, both, caller) (wire: showCallerNumber)
status_ivr_enabledbooleanEnable/Disable the status change IVR on your callcenter. The IVR is enabled by default. (wire: statusIvrEnabled)
strategystringThe calls dispatching strategy (cumulationByAgentOrder, longestHangupAgent, longestIdleAgent, random, ringAll, roundRobin, sequentiallyByAgentOrder)
tone_on_closingintegerTone played just before call is hang up (wire: toneOnClosing)
tone_on_holdintegerTone played when caller is put on hold (wire: toneOnHold)
tone_on_openingintegerTone played when call is picked up (wire: toneOnOpening)
voicemailstring (phone-number)The voicemail used by the EasyPABX

Methods​

The following methods are available for this resource:

NameAccessible byRequired ParamsOptional ParamsDescription
getselectbilling_account, service_nameGet a contact center service
listselectbilling_accountx_pagination_modeList contact center services
updateupdatebilling_account, service_nameUpdate a contact center service
sound_uploadexecbillingAccount, serviceNameUpload a sound

Parameters​

Parameters can be passed in the WHERE clause of a query. Check the Methods section to see which parameters are required or optional for each operation.

NameDatatypeDescription
api_hoststringThe OVHcloud API host. Selected by OVH_ENDPOINT (ovh-eu, ovh-ca or ovh-us; default ovh-eu). (default: api.eu.ovhcloud.com, x-stackQL-envVarSelector: {"envVar":"OVH_ENDPOINT","default":"ovh-eu","values":{"ovh-eu":"api.eu.ovhcloud.com","ovh-ca":"api.ca.ovhcloud.com","ovh-us":"api.us.ovhcloud.com"}})
billingAccountstringThe name of your billingAccount
billing_accountstringThe name of your billingAccount (wire: billingAccount)
serviceNamestring
service_namestring (wire: serviceName)
x_pagination_modestringSent as CachedObjectList-Pages by default so the list returns the full objects rather than their identifiers. (wire: X-Pagination-Mode)

SELECT examples​

Get a contact center service

SELECT
service_name,
anonymous_rejection,
description,
feature_type,
is_ccs,
max_wait_time,
queue_size,
service_type,
show_caller_number,
status_ivr_enabled,
strategy,
tone_on_closing,
tone_on_hold,
tone_on_opening,
voicemail
FROM ovh.telephony.easy_huntings
WHERE billing_account = '{{ billing_account }}' -- required
AND service_name = '{{ service_name }}' -- required
;

UPDATE examples​

Update a contact center service

UPDATE ovh.telephony.easy_huntings
SET
anonymous_rejection = {{ anonymous_rejection }},
description = '{{ description }}',
max_wait_time = {{ max_wait_time }},
queue_size = {{ queue_size }},
show_caller_number = '{{ show_caller_number }}',
status_ivr_enabled = {{ status_ivr_enabled }},
strategy = '{{ strategy }}',
tone_on_closing = {{ tone_on_closing }},
tone_on_hold = {{ tone_on_hold }},
tone_on_opening = {{ tone_on_opening }},
voicemail = '{{ voicemail }}'
WHERE
billing_account = '{{ billing_account }}' --required
AND service_name = '{{ service_name }}' --required;

Lifecycle Methods​

EXEC variables use wire (API) names.

Upload a sound

EXEC ovh.telephony.easy_huntings.sound_upload
@billingAccount='{{ billingAccount }}' --required,
@serviceName='{{ serviceName }}' --required
@@json=
'{
"documentId": "{{ documentId }}",
"name": "{{ name }}",
"url": "{{ url }}"
}'
;