Share via


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
Logic Apps Standard All Logic Apps regions except the following:
     -   Azure Government regions
     -   Azure China regions
     -   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)
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)
Contact
Name BluIP Support
URL https://support.bluip.com
Email 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

https://support.bluip.com

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

+18188675309

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

+17026904381

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

+18188675309

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

+17026904400;ext=4400

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

+18188675309

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'.