Share via

Telephony Xtended Serv Interf (Preview)

  • Reference

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

Operation ID:
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

Operation ID:
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

Operation ID:
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

Operation ID:
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

Operation ID:
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

Operation ID:
call.New

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

Operation ID:
raw

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

Operation ID:
toggle.AgentACDState

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

Operation ID:
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

Operation ID:
call.Transfer

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

Operation ID:
call.TransfertoVoicemail

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

Operation ID:
events.callCenterAgent

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

Operation ID:
events.callCenterMonitoring

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

Operation ID:
events.callCenterQueue

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

Operation ID:
events.call

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

Operation ID:
events.doNotDisturb

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

Operation ID:
events.voicemail

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

Operation ID:
events

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