Telephony Xtended Serv Interf (Preview)
Integrate with BluIP's telephony system to take your call to the next level. Telephony Xtended Service Interface (XSI).
This connector is available in the following products and regions:
| Service | Class | Regions |
|---|---|---|
| Copilot Studio | Premium | All Power Automate regions except the following: - US Government (GCC) - US Government (GCC High) - China Cloud operated by 21Vianet - US Department of Defense (DoD) |
| Logic Apps | Standard | All Logic Apps regions except the following: - Azure Government regions - Azure China regions - US Department of Defense (DoD) |
| Power Apps | Premium | All Power Apps regions except the following: - US Government (GCC) - US Government (GCC High) - China Cloud operated by 21Vianet - US Department of Defense (DoD) |
| Power Automate | Premium | All Power Automate regions except the following: - US Government (GCC) - US Government (GCC High) - China Cloud operated by 21Vianet - US Department of Defense (DoD) |
| Contact | |
|---|---|
| Name | BluIP Support |
| URL | https://support.bluip.com |
| developers@bluip.com |
| Connector Metadata | |
|---|---|
| Publisher | BluIP, Inc. |
| Website | https://www.bluip.com/ |
| Privacy policy | https://www.bluip.com/company/legal/privacy-policy |
| Categories | Productivity;Communication |
Telephony Xtended Serv Interf
Integrate with BluIP's telephony system to take your call to the next level. Telephony Xtended Service Interface (XSI).
Pre-requisites
A BluIP user, group, enterprise, or system admin account.
API documentation
How to get credentials
Contact BluIP's support team for a demo account or details about your current account.
Creating a connection
The connector supports the following authentication types:
| Default | Parameters for creating connection. | All regions | Not shareable |
Default
Applicable: All regions
Parameters for creating connection.
This is not shareable connection. If the power app is shared with another user, another user will be prompted to create new connection explicitly.
| Name | Type | Description | Required |
|---|---|---|---|
| Username | securestring | MasterAccess Username (User, Group, Enterprise, or System Admin) | True |
| Password | securestring | MasterAccess Password | True |
Throttling Limits
| Name | Calls | Renewal Period |
|---|---|---|
| API calls per connection | 100 | 60 seconds |
Actions
| Call Answer |
Answer a call. |
| Call End |
Hangup/End a call. |
| Call Hold |
Put a call on hold. |
| Get User Calls |
Get user calls. |
| Get User Profile |
Get user profile. |
| New Call |
Make a call |
| Raw Request |
Send a raw request. Find more resources at: https://labxsp1.masteraccess.com/com.broadsoft.xsi-actions/test/v2.0/ |
| Toggle Agent ACD State |
Toggle the Agent ACD State. |
| Toggle Call Recording |
Toggle call recording state. |
| Transfer a Call |
Transfer a call. |
| Transfer Call to Voicemail |
Transfer call to voicemail. |
Call Answer
Answer a call.
Parameters
| Name | Key | Required | Type | Description |
|---|---|---|---|---|
|
User ID
|
userId | string |
A BluIP User ID. |
|
|
Call ID
|
callId | string |
Call Call ID. |
Returns
Call End
Hangup/End a call.
Parameters
| Name | Key | Required | Type | Description |
|---|---|---|---|---|
|
User ID
|
userId | string |
A BluIP User ID. |
|
|
Call ID
|
callId | True | string |
Call ID of a call. |
Returns
Call Hold
Put a call on hold.
Parameters
| Name | Key | Required | Type | Description |
|---|---|---|---|---|
|
User ID
|
userId | string |
A BluIP User ID. |
|
|
Call ID
|
callId | True | string |
Call ID of a call. |
Returns
Get User Calls
Get user calls.
Parameters
| Name | Key | Required | Type | Description |
|---|---|---|---|---|
|
User ID
|
userId | True | string |
A BluIP User ID. |
Returns
| Name | Path | Type | Description |
|---|---|---|---|
|
|
array of object | ||
|
Call ID
|
callId | string |
Ex: callhalf-29519312843:0 |
|
URI
|
uri | string |
Ex: /v2.0/user/user@provider.com/calls/callhalf-29519312843:0 |
Get User Profile
Get user profile.
Parameters
| Name | Key | Required | Type | Description |
|---|---|---|---|---|
|
User ID
|
userId | True | string |
service@provider.com |
Returns
| Name | Path | Type | Description |
|---|---|---|---|
|
User ID
|
details.userId | string |
user@bluip.com |
|
First Name
|
details.firstName | string |
Jordan |
|
Last Name
|
details.lastName | string |
Smith |
|
Hirangana Last Name
|
details.hiranganaLastName | string |
Smith |
|
Hirangana First Name
|
details.hiranganaFirstName | string |
Jordan |
|
Last Name
|
details.nameDialingName.nameDialingLastName | string |
Smith |
|
First Name
|
details.nameDialingName.nameDialingFirstName | string |
Jordan |
|
Group ID
|
details.groupId | integer | |
|
Service Provider/Enterprise ID
|
details.serviceProvider | string | |
|
Number
|
details.number | integer | |
|
Extension
|
details.extension | integer | |
|
Mobile
|
additionalDetails.mobile | string | |
|
Yahoo ID
|
additionalDetails.yahooId | string | |
|
Pager
|
additionalDetails.pager | string | |
|
Email Address
|
additionalDetails.emailAddress | string | |
|
Title
|
additionalDetails.title | string | |
|
Location
|
additionalDetails.location | string | |
|
Department
|
additionalDetails.department | string | |
|
IM&P
|
additionalDetails.impId | string | |
|
Password Expires Days
|
passwordExpiresDays | integer | |
|
FAC URI
|
fac | string | |
|
Registrations URI
|
registrations | string | |
|
Schedule List URI
|
scheduleList | string | |
|
Portal Password Change URI
|
portalPasswordChange | string | |
|
Country Code
|
countryCode | string |
New Call
Make a call
Parameters
| Name | Key | Required | Type | Description |
|---|---|---|---|---|
|
User ID
|
userID | string |
A BluIP User ID. |
|
|
Phone Number
|
address | True | string |
Phone number. |
Returns
Raw Request
Send a raw request. Find more resources at: https://labxsp1.masteraccess.com/com.broadsoft.xsi-actions/test/v2.0/
Parameters
| Name | Key | Required | Type | Description |
|---|---|---|---|---|
|
User ID
|
userId | True | string |
A BluIP User ID. |
|
Resource/Path
|
path | True | string |
Pick a resource or enter the path to a resource. |
|
Payload
|
payload | string |
Leave empty to "GET" or include payload to "PUT" data. |
|
|
Accept
|
Accept | string |
Accept |
Returns
Toggle Agent ACD State
Toggle the Agent ACD State.
Parameters
| Name | Key | Required | Type | Description |
|---|---|---|---|---|
|
Agent ACD State
|
agentACDState | True | string |
Agent ACD State |
|
User ID
|
userID | string |
User ID |
Returns
Toggle Call Recording
Toggle call recording state.
Parameters
| Name | Key | Required | Type | Description |
|---|---|---|---|---|
|
Action
|
action | True | string | |
|
Call ID
|
callId | True | string | |
|
User ID
|
userId | True | string |
Returns
- response
- object
Transfer a Call
Transfer a call.
Parameters
| Name | Key | Required | Type | Description |
|---|---|---|---|---|
|
User ID
|
userId | string |
A BluIP User ID. |
|
|
Call ID
|
callId | True | string |
Call ID of a call. |
|
Phone Number
|
address | True | string |
Phone number to transfer to. |
Returns
Transfer Call to Voicemail
Transfer call to voicemail.
Parameters
| Name | Key | Required | Type | Description |
|---|---|---|---|---|
|
User ID
|
userId | string |
A BluIP User ID. |
|
|
Call ID
|
callId | True | string |
Call ID of a call. |
Returns
Triggers
| On Call Center Agent ACD State Change |
React to a call center agent's ACD (Automatic Call Distribution) state change. |
| On Call Center Monitoring Change |
React to call center average wait time, calls vs. agent count, etc. |
| On Call Center Queue Change |
React to calls in a call center queue. |
| On Call Event |
When something happens to a call. |
| On Do Not Disturb Change |
React to a user's DND state change. |
| On Voice Mail Message Summary |
React to new or removed voicemail messages. |
| Raw Event Subscription |
Events. |
On Call Center Agent ACD State Change
React to a call center agent's ACD (Automatic Call Distribution) state change.
Parameters
| Name | Key | Required | Type | Description |
|---|---|---|---|---|
|
User ID
|
userId | string |
User level subscription. |
|
|
Group ID
|
groupId | string |
Group level subscriptions. |
|
|
Enterprise/Service Provider ID
|
enterpriseId | string |
Enterprise/Service Provider level subscriptions. |
Returns
| Name | Path | Type | Description |
|---|---|---|---|
|
State
|
state | string |
Available, Sign-In, Sign-Out, Unavailable, Wrap-Up |
|
Value
|
stateTimestamp.value | integer |
1568212016997 |
|
Sign In Timestamp
|
signInTimestamp | integer |
1568212016997 |
|
Total Available Time
|
totalAvailableTime | integer |
17, etc. |
|
Unavailable Code
|
unavailableCode | integer |
1, 2, 3, 4, etc. |
|
Value
|
averageWrapUpTime.value | integer |
0 |
|
Event ID
|
eventId | string |
37bacb10-82a5-47ba-8a6f-f9335433e584 |
|
User/Target ID
|
targetId | string |
user@bluip.com |
On Call Center Monitoring Change
React to call center average wait time, calls vs. agent count, etc.
Parameters
| Name | Key | Required | Type | Description |
|---|---|---|---|---|
|
Group ID
|
groupId | string |
Group level subscriptions. |
|
|
Enterprise/Service Provider ID
|
enterpriseId | string |
Enterprise/Service Provider level subscriptions. |
Returns
| Name | Path | Type | Description |
|---|---|---|---|
|
Value
|
averageHandlingTime.value | integer |
0 |
|
Value
|
expectedWaitTime.value | integer |
0 |
|
Value
|
averageSpeedOfAnswer.value | integer |
14622 |
|
Value
|
longestWaitTime.value | integer |
5005 |
|
Value
|
numCallsInQueue.value | integer |
1 |
|
Number of Agents Assigned
|
numAgentsAssigned | integer |
1 |
|
Number of Agents Staffed
|
numAgentsStaffed | integer |
1 |
|
Number of Staffed Agents Idle
|
numStaffedAgentsIdle | integer |
0 |
|
Number of Staffed Agents Unavailable
|
numStaffedAgentsUnavailable | integer |
0 |
|
Event ID
|
eventId | string |
795db7d3-1461-48dd-8a33-65cfdc9dab00 |
|
Call Center User/Target ID
|
targetId | string |
BluIPCCDemo@bluip.com |
On Call Center Queue Change
React to calls in a call center queue.
Parameters
| Name | Key | Required | Type | Description |
|---|---|---|---|---|
|
Group ID
|
groupId | string |
Group level subscriptions. |
|
|
Enterprise/Service Provider ID
|
enterpriseId | string |
Enterprise/Service Provider level subscriptions. |
Returns
| Name | Path | Type | Description |
|---|---|---|---|
|
Call ID
|
callId | string |
callhalf-31139148485:0 |
|
External Tracking ID
|
extTrackingId | string |
130080177:2 |
|
Name
|
remoteParty.name | string |
Jordan Smith |
|
Text
|
remoteParty.address.#text | string | |
|
Country Code
|
remoteParty.address.countryCode | string |
1, 44, etc. |
|
Call Type
|
remoteParty.callType | string |
Network, Group |
|
Add Time
|
addTime | integer |
1568213984179 |
|
ACD Name
|
acdName | string |
BluIP Demo Call Center |
|
Text
|
acdNumber.#text | string | |
|
Country Code
|
acdNumber.countryCode | string |
1, 44, etc. |
|
ACD Priority
|
acdPriority | string |
3-Low |
|
Add Time In Priority Bucket
|
addTimeInPriorityBucket | integer |
1568213984179 |
|
Type
|
type | string |
ACDCallAbandonedEvent, ACDCallAddedEvent, ACDCallOfferedToAgentEvent, ACDWhisperStartedEvent,Available, Sign-In, Sign-Out, Unavailable, Wrap-UpACDCallAnsweredByAgentEvent |
|
Event ID
|
eventId | string |
0b5bc6c2-bc74-4234-93f9-2945aca8b215 |
|
Call Center User/Target ID
|
targetId | string |
BluIPCCDemo@bluip.com |
|
Answering User/Target ID
|
answeringUserId | string |
user@bluip.com |
|
Answering Call ID
|
answeringCallId | string |
callhalf-31139148489:0 |
|
Remove Time
|
removeTime | integer |
1568213990637 |
On Call Event
When something happens to a call.
Parameters
| Name | Key | Required | Type | Description |
|---|---|---|---|---|
|
User ID
|
userId | string |
User level subscription. |
|
|
Group ID
|
groupId | string |
Group level subscriptions. |
|
|
Enterprise/Service Provider ID
|
enterpriseId | string |
Enterprise/Service Provider level subscriptions. |
|
|
Type
|
type | string |
Specific type of call event. |
Returns
| Name | Path | Type | Description |
|---|---|---|---|
|
Type
|
type | string |
CallAnsweredEvent, CallBargedInEvent, CallCollectingEvent, CallHeldEvent, HookStatusEvent, CallMonitoredEvent, CallOriginatedEvent, CallOriginatingEvent, CallPickedUpEvent, CallReceivedEvent, CallRecordingPausedEvent, CallRecordingResumedEvent, CallRecordingStartedEvent, CallRecordingStartingEvent, CallRecordingStoppedEvent, CallRedirectedEvent, CallReleasedEvent, CallReleasingEvent, CallRetrievedEvent, CallTransferredEvent, CallUpdatedEvent |
|
Hook Status
|
hookStatus | string |
Off-Hook, On-Hook |
|
Event ID
|
eventId | string |
d5e21e5d-7f54-4db3-8351-4302e8dbf941 |
|
User/Target ID
|
targetId | string |
user@bluip.com |
|
Event
|
event | string |
Advanced Call |
|
Call ID
|
callId | string |
callhalf-31126219817:0 |
|
External Tracking ID
|
extTrackingId | string |
129987974:2 |
|
Network Call ID
|
networkCallId | string |
2002829250_115291504@207.223.XX.XXX |
|
Personality
|
personality | string |
Terminator, Originator |
|
State
|
state | string |
Alerting, Active, Held, Detached |
|
Start Time
|
startTime | integer |
1568204580687 |
|
Name
|
remoteParty.name | string |
Jordan Smith |
|
Text
|
remoteParty.address.#text | string | |
|
Country Code
|
remoteParty.address.countryCode | string |
1 |
|
NPA
|
remoteParty.address.npa | string |
818-XXX-XXXX |
|
NXX
|
remoteParty.address.nxx | string |
XXX-867-XXXX |
|
Call Type
|
remoteParty.callType | string |
Network, Group |
|
User ID
|
remoteParty.userId | string |
user@bluip.com |
|
Text
|
remoteParty.userDN.#text | string | |
|
Country Code
|
remoteParty.userDN.countryCode | string |
1, 44, etc. |
|
Type
|
endpoint.type | string |
AccessEndpoint |
|
Address of Record
|
endpoint.addressOfRecord | string |
user@bluip.com |
|
Appearance
|
appearance | integer |
1, 2, etc. |
|
Allow Answer
|
allowAnswer | string | |
|
Answer Time
|
answerTime | integer |
1568204585231 |
|
Allowed Recording Controls
|
allowedRecordingControls | string |
none, pause, resume |
|
Security Classification
|
securityClassification | string |
Classified, Unclassified |
|
Recorded
|
recorded | string | |
|
Recording State
|
recordingState | string |
Started, Paused |
|
Allow Retrieve
|
allowRetrieve | string | |
|
Held Time
|
heldTime | integer |
1568204589829 |
|
Total Held Time
|
totalHeldTime | integer |
4172 |
|
Call
|
call | array of |
Array of calls when more than one call is assosiated. |
|
Detached Time
|
detachedTime | integer |
1568204605894 |
|
Release Time
|
releaseTime | integer |
1568204620298 |
|
Releasing Party
|
releasingParty | string |
localRelease, remoteRelease |
|
Text
|
redirect.address.#text | string | |
|
Country Code
|
redirect.address.countryCode | string |
1, 44, etc. |
|
Reason
|
redirect.reason | string |
transfer |
|
Redirect Time
|
redirect.redirectTime | integer |
1568204605894 |
On Do Not Disturb Change
React to a user's DND state change.
Parameters
| Name | Key | Required | Type | Description |
|---|---|---|---|---|
|
User ID
|
userId | string |
User level subscription. |
|
|
Group ID
|
groupId | string |
Group level subscriptions. |
|
|
Enterprise/Service Provider ID
|
enterpriseId | string |
Enterprise/Service Provider level subscriptions. |
Returns
| Name | Path | Type | Description |
|---|---|---|---|
|
Active
|
active | boolean |
true, false |
|
Ring Splash
|
ringSplash | boolean |
true, false |
|
Event ID
|
eventId | string |
d6986908-461e-40b9-85ca-e717851f776c |
|
User/Target ID
|
targetId | string |
user@bluip.com |
On Voice Mail Message Summary
React to new or removed voicemail messages.
Parameters
| Name | Key | Required | Type | Description |
|---|---|---|---|---|
|
User ID
|
userId | string |
User level subscription. |
|
|
Group ID
|
groupId | string |
Group level subscriptions. |
|
|
Enterprise/Service Provider ID
|
enterpriseId | string |
Enterprise/Service Provider level subscriptions. |
Returns
| Name | Path | Type | Description |
|---|---|---|---|
|
New Messages
|
newMessages | integer |
1, 2, 3, etc. |
|
Old Messages
|
oldMessages | integer |
1, 2, 3, etc. |
Raw Event Subscription
Events.
Parameters
| Name | Key | Required | Type | Description |
|---|---|---|---|---|
|
User ID
|
userId | string |
User level subscription. |
|
|
Group ID
|
groupId | string |
Group level subscriptions. |
|
|
Enterprise/Service Provider ID
|
enterpriseId | string |
Enterprise/Service Provider level subscriptions. |
|
|
Event
|
event | True | string |
Event to subscribe to. |
|
Type
|
type | string |
Specific type of event: CallAnsweredEvent, CallReceivedEvent |
Returns
| Name | Path | Type | Description |
|---|---|---|---|
|
User/Target ID
|
targetId | string |
Event target user. |
|
Event
|
event | string |
Event type. |
|
Event ID
|
eventId | string |
The event ID. |
|
Type
|
type | string |
Event type. |
Definitions
object
This is the type 'object'.