-
-
Notifications
You must be signed in to change notification settings - Fork 1
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
- Loading branch information
1 parent
fd9e279
commit 5094787
Showing
23 changed files
with
1,010 additions
and
43 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
|
@@ -8,31 +8,47 @@ In this method, you can update your AAs  | |
|
||
### Parameters  | ||
|
||
* auto\_attendant\_user\_ids (list): List of service user IDs (AA IDs), the status given will be applied to these. | ||
* status (bool): Boolean value of True (Activate) or False (Deactivate) which will be applied to list of AAs. | ||
* service_provider_id (str): Service Provider ID where Group is hosted. | ||
* group_id (str): Group ID where target Auto Attendant is located. | ||
* auto_attendant_user_id (str): Target Auto Attendant User ID. | ||
* updates (dict): Updates to be applied to Auto Attendant. | ||
|
||
### Return | ||
|
||
* JSON Data: This method returns json representation of AA updated. | ||
* Dict: Updated version of the Auto Attendant with updates applied. | ||
|
||
### How To Use: | ||
|
||
The below code will set the AA to deactivated. | ||
|
||
{% code overflow="wrap" %} | ||
```python | ||
from odins_spear import api | ||
|
||
my_api= api.Api(base_url="https://base_url/api/vx", username="john.smith", password="ODIN_INSTANCE_1") | ||
my_api.authenticate() | ||
|
||
auto_attendants = [ | ||
"[email protected]" | ||
] | ||
|
||
my_api.put.auto_attendants_status( | ||
auto_attendant_user_ids= auto_attendants, | ||
status= False | ||
my_changes = { | ||
"serviceInstanceProfile": { | ||
"name": "Name of Auto Attendant", | ||
"callingLineIdLastName": "Auto Attendant", | ||
"callingLineIdFirstName": "Main", | ||
"hiraganaLastName": "mock-aa-test-1", | ||
"hiraganaFirstName": "Auto Attendant", | ||
"language": "English", | ||
"timeZone": "America/Denver", | ||
"timeZoneDisplayName": "(GMT-06:00) (US) Mountain Time", | ||
"aliases": [] | ||
}, | ||
"type": "Basic", | ||
"enableVideo": False, | ||
"extensionDialingScope": "Group", | ||
"nameDialingScope": "Group", | ||
} | ||
|
||
my_api.put.auto_attendant( | ||
service_provider_id="serviceProviderID", | ||
group_id="groupID" | ||
auto_attendant_user_id="AAUserID", | ||
updates=my_changes | ||
) | ||
``` | ||
{% endcode %} | ||
|
111 changes: 111 additions & 0 deletions
111
docs/docs/methods/auto-attendants/get-auto-attendant.md
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,111 @@ | ||
--- | ||
description: my_api.get.auto_attendant() | ||
--- | ||
|
||
# 🤙🏼 GET - Auto Attendant | ||
|
||
Returns detailed information of a singel Auto Attendant. | ||
|
||
### Parameters  | ||
|
||
* service_user_id (str): User ID of target Auto Attendant. | ||
|
||
### Returns | ||
|
||
* dict: Detailed information of target Auto Attendant. | ||
|
||
### How To Use: | ||
|
||
{% code overflow="wrap" %} | ||
```python | ||
from odins_spear import api | ||
|
||
my_api= api.Api(base_url="https://base_url/api/vx", username="john.smith", password="ODIN_INSTANCE_1") | ||
my_api.authenticate() | ||
|
||
|
||
my_api.get.auto_attendant( | ||
service_user_id="auto_attendant_user_id" | ||
) | ||
``` | ||
{% endcode %} | ||
|
||
### Example Returned Data (Formatted) | ||
```json | ||
{ | ||
"serviceInstanceProfile": { | ||
"name": "mock-aa-test-1", | ||
"callingLineIdLastName": "mock-aa-test-1", | ||
"callingLineIdFirstName": "mock-aa-test-1", | ||
"hiraganaLastName": "mock-aa-test-1", | ||
"hiraganaFirstName": "Auto Attendant", | ||
"language": "English", | ||
"timeZone": "America/Denver", | ||
"timeZoneDisplayName": "(GMT-06:00) (US) Mountain Time", | ||
"aliases": [] | ||
}, | ||
"type": "Basic", | ||
"enableVideo": false, | ||
"extensionDialingScope": "Group", | ||
"nameDialingScope": "Group", | ||
"nameDialingEntries": "LastName + FirstName", | ||
"businessHoursMenu": { | ||
"announcementSelection": "Default", | ||
"enableFirstMenuLevelExtensionDialing": false, | ||
"keys": [ | ||
{ | ||
"key": "0", | ||
"action": "Transfer To Operator", | ||
"description": null, | ||
"phoneNumber": null, | ||
"submenuId": null | ||
}, | ||
{ | ||
"key": "1", | ||
"action": "Extension Dialing", | ||
"description": null, | ||
"phoneNumber": null, | ||
"submenuId": null | ||
}, | ||
{ | ||
"key": "2", | ||
"action": "Name Dialing", | ||
"description": null, | ||
"phoneNumber": null, | ||
"submenuId": null | ||
} | ||
] | ||
}, | ||
"afterHoursMenu": { | ||
"announcementSelection": "Default", | ||
"enableFirstMenuLevelExtensionDialing": false, | ||
"keys": [ | ||
{ | ||
"key": "0", | ||
"action": "Transfer To Operator", | ||
"description": null, | ||
"phoneNumber": null, | ||
"submenuId": null | ||
}, | ||
{ | ||
"key": "1", | ||
"action": "Extension Dialing", | ||
"description": null, | ||
"phoneNumber": null, | ||
"submenuId": null | ||
}, | ||
{ | ||
"key": "2", | ||
"action": "Name Dialing", | ||
"description": null, | ||
"phoneNumber": null, | ||
"submenuId": null | ||
} | ||
] | ||
}, | ||
"serviceUserId": "mock-aa-test-1", | ||
"serviceProviderId": "odin.mock.ent1", | ||
"groupId": "odin.mock.grp1", | ||
"isEnterprise": true | ||
} | ||
``` |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,57 @@ | ||
--- | ||
description: my_api.get.auto_attendants() | ||
--- | ||
|
||
# 📞 GET - Auto Attendants | ||
|
||
Returns a complete list of all Auto Attendants in a single group. | ||
|
||
### Parameters  | ||
|
||
* service_provider_id (str): Service Provider where Group is hosted. | ||
* group_id (str): Target Group where Auto Attendants are hosted. | ||
### Returns | ||
|
||
* List: List of Auto Attendants with basic info on them. | ||
|
||
### How To Use: | ||
|
||
{% code overflow="wrap" %} | ||
```python | ||
from odins_spear import api | ||
|
||
my_api= api.Api(base_url="https://base_url/api/vx", username="john.smith", password="ODIN_INSTANCE_1") | ||
my_api.authenticate() | ||
|
||
my_api.get.auto_attendants( | ||
service_provider_id="serviceProviderId", | ||
group_id="groupId" | ||
) | ||
``` | ||
{% endcode %} | ||
|
||
### Example Returned Data (Formatted) | ||
```json | ||
[ | ||
{ | ||
"serviceUserId": "testAA", | ||
"name": "My Test AA", | ||
"video": false, | ||
"phoneNumber": 123456789, | ||
"extension": "6060", | ||
"department": "Department Name", | ||
"isActive": true, | ||
"type": "Basic" | ||
}, | ||
{ | ||
"serviceUserId": "OtherAA", | ||
"name": "Another AA", | ||
"video": false, | ||
"phoneNumber": null, | ||
"extension": null, | ||
"department": null, | ||
"isActive": true, | ||
"type": "Basic" | ||
} | ||
] | ||
``` |
46 changes: 46 additions & 0 deletions
46
docs/docs/methods/call-centers/get-group-call-center-bounced-calls.md
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,46 @@ | ||
--- | ||
description: my_api.get.group_call_center_bounced_calls() | ||
--- | ||
|
||
# 📞 GET - Group Call Center Bounced Calls | ||
|
||
Retrieves the number of rings before a call is bounced from the specified call center. | ||
|
||
### Parameters  | ||
|
||
* service_user_id (str): Target Call Center ID | ||
|
||
|
||
### Returns | ||
|
||
* Dict: Amount of Rings before a call is Bounced | ||
|
||
### How To Use: | ||
|
||
{% code overflow="wrap" %} | ||
```python | ||
from odins_spear import api | ||
|
||
my_api= api.Api(base_url="https://base_url/api/vx", username="john.smith", password="ODIN_INSTANCE_1") | ||
my_api.authenticate() | ||
|
||
my_api.get.group_call_center_bounced_calls( | ||
service_user_id="[email protected]" | ||
) | ||
``` | ||
{% endcode %} | ||
|
||
### Example Returned Data (Formatted) | ||
```json | ||
{ | ||
"isActive": true, | ||
"numberOfRingsBeforeBouncingCall": 5, | ||
"enableTransfer": false, | ||
"bounceCallWhenAgentUnavailable": true, | ||
"alertCallCenterCallOnHold": true, | ||
"alertCallCenterCallOnHoldSeconds": 30, | ||
"bounceCallCenterCallOnHold": false, | ||
"bounceCallCenterCallOnHoldSeconds": 60, | ||
"serviceUserId": "[email protected]" | ||
} | ||
``` |
53 changes: 53 additions & 0 deletions
53
docs/docs/methods/call-centers/get-group-call-center-forced-forwarding.md
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,53 @@ | ||
--- | ||
description: my_api.get.group_call_center_forced_forwarding() | ||
--- | ||
|
||
# 📞 GET - Group Call Center Forced Forwarding | ||
|
||
Retrieves the forwarding number for a call center if it is set to forward calls, along with any associated audio messages. | ||
|
||
### Parameters  | ||
|
||
* service_user_id (str): Target Call Center ID | ||
|
||
### Returns | ||
|
||
* Dict: Number to be Forwarded to, alongside any Audio Messages. | ||
|
||
### How To Use: | ||
|
||
{% code overflow="wrap" %} | ||
```python | ||
from odins_spear import api | ||
|
||
my_api= api.Api(base_url="https://base_url/api/vx", username="john.smith", password="ODIN_INSTANCE_1") | ||
my_api.authenticate() | ||
|
||
my_api.get.group_call_center_forced_forwarding( | ||
service_user_id="[email protected]" | ||
) | ||
``` | ||
{% endcode %} | ||
|
||
### Example Returned Data (Formatted) | ||
```json | ||
{ | ||
"serviceUserId": "[email protected]", | ||
"enabled": false, | ||
"forwardToPhoneNumber": null, | ||
"allowEnableViaFAC": true, | ||
"playAnnouncementBeforeForwarding": false, | ||
"audioMessageSource": "File", | ||
"videoMessageSource": "Default", | ||
"audioUrlList": [], | ||
"videoUrlList": [], | ||
"audioFileList": [ | ||
{ | ||
"name": "HandoverMusic.wav", | ||
"mediaType": "WAV", | ||
"level": "User" | ||
} | ||
], | ||
"videoFileList": [] | ||
} | ||
``` |
Oops, something went wrong.