Telefonie Xtended Serv Interf (preview)
Integreer met het telefoniesysteem van BluIP om uw oproep naar het volgende niveau te brengen. Telefonie Xtended Service Interface (XSI).
Deze connector is beschikbaar in de volgende producten en regio's:
| Dienst | Class | Regions |
|---|---|---|
| Copilot Studio | Premium | Alle Power Automate-regio's , met uitzondering van het volgende: - Amerikaanse overheid (GCC) - Amerikaanse overheid (GCC High) - China Cloud beheerd door 21Vianet - Us Department of Defense (DoD) |
| Logic-apps | Standaard | Alle Logic Apps-regio's , met uitzondering van het volgende: - Azure Government-regio's - Azure China-regio's - Us Department of Defense (DoD) |
| Power Apps | Premium | Alle Power Apps-regio's , met uitzondering van het volgende: - Amerikaanse overheid (GCC) - Amerikaanse overheid (GCC High) - China Cloud beheerd door 21Vianet - Us Department of Defense (DoD) |
| Power Automate | Premium | Alle Power Automate-regio's , met uitzondering van het volgende: - Amerikaanse overheid (GCC) - Amerikaanse overheid (GCC High) - China Cloud beheerd door 21Vianet - Us Department of Defense (DoD) |
| Contactpersoon | |
|---|---|
| Naam | BluIP-ondersteuning |
| URL | https://support.bluip.com |
| E-mailen | developers@bluip.com |
| Connectormetagegevens | |
|---|---|
| Uitgever | BluIP, Inc. |
| Webpagina | https://www.bluip.com/ |
| Privacybeleid | https://www.bluip.com/company/legal/privacy-policy |
| Categorieën | Productiviteit; Communicatie |
Telefonie Xtended Serv Interf
Integreer met het telefoniesysteem van BluIP om uw oproep naar het volgende niveau te brengen. Telefonie Xtended Service Interface (XSI).
Pre-requisites
Een BluIP-gebruikers-, groeps-, ondernemings- of systeembeheerdersaccount.
API-documentatie
Referenties ophalen
Neem contact op met het ondersteuningsteam van BluIP voor een demo-account of details over uw huidige account.
Een verbinding maken
De connector ondersteunt de volgende verificatietypen:
| standaard | Parameters voor het maken van verbinding. | Alle regio's | Niet deelbaar |
Verstek
Van toepassing: Alle regio's
Parameters voor het maken van verbinding.
Dit is geen deelbare verbinding. Als de power-app wordt gedeeld met een andere gebruiker, wordt een andere gebruiker gevraagd om expliciet een nieuwe verbinding te maken.
| Naam | Typologie | Description | Verplicht |
|---|---|---|---|
| Gebruikersnaam | beveiligde string | MasterAccess-gebruikersnaam (gebruiker, groep, onderneming of systeembeheerder) | Klopt |
| Wachtwoord | beveiligde string | MasterAccess-wachtwoord | Klopt |
Beperkingslimieten
| Name | Aanroepen | Verlengingsperiode |
|---|---|---|
| API-aanroepen per verbinding | 100 | 60 seconden |
Acties
| ACD-status van agent in-/uitschakelen |
Schakel de ACD-status van de agent in. |
| Een gesprek doorschakelen |
Een gesprek doorschakelen. |
| Gebruikersoproepen ophalen |
Gebruikersoproepen ophalen. |
| Gebruikersprofiel ophalen |
Gebruikersprofiel ophalen. |
| Gesprekseinde |
Een oproep ophangen/beëindigen. |
| Gespreksopruiming |
Zet een gesprek in de wacht. |
| Nieuw gesprek |
Een oproep uitvoeren |
| Onbewerkte aanvraag |
Verzend een onbewerkte aanvraag. Meer informatiebronnen vinden op: https://labxsp1.masteraccess.com/com.broadsoft.xsi-actions/test/v2.0/ |
| Oproep doorschakelen naar voicemail |
Oproep doorschakelen naar voicemail. |
| Oproepantwoord |
Een oproep beantwoorden. |
| Oproepopname in-/uitschakelen |
Schakel de status van de oproepopname in. |
ACD-status van agent in-/uitschakelen
Schakel de ACD-status van de agent in.
Parameters
| Name | Sleutel | Vereist | Type | Description |
|---|---|---|---|---|
|
Acd-status van agent
|
agentACDState | True | string |
Acd-status van agent |
|
Gebruikers-ID
|
userID | string |
Gebruikers-ID |
Een gesprek doorschakelen
Een gesprek doorschakelen.
Parameters
| Name | Sleutel | Vereist | Type | Description |
|---|---|---|---|---|
|
Gebruikers-ID
|
userId | string |
Een BluIP-gebruikers-id. |
|
|
Oproep-id
|
callId | True | string |
Oproep-id van een oproep. |
|
Telefoonnummer
|
address | True | string |
Telefoonnummer om over te zetten naar. |
Gebruikersoproepen ophalen
Gebruikersoproepen ophalen.
Parameters
| Name | Sleutel | Vereist | Type | Description |
|---|---|---|---|---|
|
Gebruikers-ID
|
userId | True | string |
Een BluIP-gebruikers-id. |
Retouren
| Name | Pad | Type | Description |
|---|---|---|---|
|
|
array of object | ||
|
Oproep-id
|
callId | string |
Bijvoorbeeld: callhalf-29519312843:0 |
|
URI
|
uri | string |
Bijvoorbeeld: /v2.0/user/user@provider.comcalls/callhalf-29519312843:0 |
Gebruikersprofiel ophalen
Gebruikersprofiel ophalen.
Parameters
| Name | Sleutel | Vereist | Type | Description |
|---|---|---|---|---|
|
Gebruikers-ID
|
userId | True | string |
service@provider.com |
Retouren
| Name | Pad | Type | Description |
|---|---|---|---|
|
Gebruikers-ID
|
details.userId | string |
user@bluip.com |
|
Voornaam
|
details.firstName | string |
Jordanië |
|
Achternaam
|
details.lastName | string |
Smith |
|
Hirangana Last Name
|
details.hiranganaLastName | string |
Smith |
|
Hirangana Voornaam
|
details.hiranganaFirstName | string |
Jordanië |
|
Achternaam
|
details.nameDialingName.nameDialingLastName | string |
Smith |
|
Voornaam
|
details.nameDialingName.nameDialingFirstName | string |
Jordanië |
|
Groeps-id
|
details.groupId | integer | |
|
Serviceprovider/enterprise-id
|
details.serviceProvider | string | |
|
Number
|
details.number | integer | |
|
Extension
|
details.extension | integer | |
|
Mobiel
|
additionalDetails.mobile | string | |
|
Yahoo ID
|
additionalDetails.yahooId | string | |
|
Pager
|
additionalDetails.pager | string | |
|
E-mailadres
|
additionalDetails.emailAddress | string | |
|
Title
|
additionalDetails.title | string | |
|
Locatie
|
additionalDetails.location | string | |
|
Afdeling
|
additionalDetails.department | string | |
|
IM&P
|
additionalDetails.impId | string | |
|
Wachtwoord verloopt dagen
|
passwordExpiresDays | integer | |
|
FAC-URI
|
fac | string | |
|
Registraties-URI
|
registrations | string | |
|
Schemalijst-URI
|
scheduleList | string | |
|
URI voor wachtwoordwijziging in portal
|
portalPasswordChange | string | |
|
Landcode
|
countryCode | string |
Gesprekseinde
Een oproep ophangen/beëindigen.
Parameters
| Name | Sleutel | Vereist | Type | Description |
|---|---|---|---|---|
|
Gebruikers-ID
|
userId | string |
Een BluIP-gebruikers-id. |
|
|
Oproep-id
|
callId | True | string |
Oproep-id van een oproep. |
Gespreksopruiming
Zet een gesprek in de wacht.
Parameters
| Name | Sleutel | Vereist | Type | Description |
|---|---|---|---|---|
|
Gebruikers-ID
|
userId | string |
Een BluIP-gebruikers-id. |
|
|
Oproep-id
|
callId | True | string |
Oproep-id van een oproep. |
Nieuw gesprek
Een oproep uitvoeren
Parameters
| Name | Sleutel | Vereist | Type | Description |
|---|---|---|---|---|
|
Gebruikers-ID
|
userID | string |
Een BluIP-gebruikers-id. |
|
|
Telefoonnummer
|
address | True | string |
Telefoonnummer. |
Onbewerkte aanvraag
Verzend een onbewerkte aanvraag. Meer informatiebronnen vinden op: https://labxsp1.masteraccess.com/com.broadsoft.xsi-actions/test/v2.0/
Parameters
| Name | Sleutel | Vereist | Type | Description |
|---|---|---|---|---|
|
Gebruikers-ID
|
userId | True | string |
Een BluIP-gebruikers-id. |
|
Resource/pad
|
path | True | string |
Kies een resource of voer het pad naar een resource in. |
|
Payload
|
payload | string |
Laat leeg aan 'GET' of voeg nettolading toe aan PUT-gegevens. |
|
|
Accepteren
|
Accept | string |
Accepteren |
Oproep doorschakelen naar voicemail
Oproep doorschakelen naar voicemail.
Parameters
| Name | Sleutel | Vereist | Type | Description |
|---|---|---|---|---|
|
Gebruikers-ID
|
userId | string |
Een BluIP-gebruikers-id. |
|
|
Oproep-id
|
callId | True | string |
Oproep-id van een oproep. |
Oproepantwoord
Een oproep beantwoorden.
Parameters
| Name | Sleutel | Vereist | Type | Description |
|---|---|---|---|---|
|
Gebruikers-ID
|
userId | string |
Een BluIP-gebruikers-id. |
|
|
Oproep-id
|
callId | string |
Oproep-id aanroepen. |
Oproepopname in-/uitschakelen
Schakel de status van de oproepopname in.
Parameters
| Name | Sleutel | Vereist | Type | Description |
|---|---|---|---|---|
|
Handeling
|
action | True | string | |
|
Oproep-id
|
callId | True | string | |
|
Gebruikers-ID
|
userId | True | string |
Retouren
- response
- object
Triggers
| Bij Niet storen wijzigen |
Reageren op de DND-statuswijziging van een gebruiker. |
| Bij wijziging van de bewaking van het callcentrum |
Reageer op de gemiddelde wachttijd van het callcenter, oproepen versus aantal agents, enzovoort. |
| Bij wijziging van oproepcentrumwachtrij |
Reageren op oproepen in een oproepcentrumwachtrij. |
| Gebeurtenis bij gesprek |
Wanneer er iets gebeurt met een oproep. |
| Onbewerkt gebeurtenisabonnement |
Gebeurtenissen. |
| Overzicht van voicemailberichten |
Reageren op nieuwe of verwijderde voicemailberichten. |
| Statuswijziging van callcenteragent acd |
Reageer op de statuswijziging van de ACD (Automatische oproepdistributie) van een callcenteragent. |
Bij Niet storen wijzigen
Reageren op de DND-statuswijziging van een gebruiker.
Parameters
| Name | Sleutel | Vereist | Type | Description |
|---|---|---|---|---|
|
Gebruikers-ID
|
userId | string |
Abonnement op gebruikersniveau. |
|
|
Groeps-id
|
groupId | string |
Abonnementen op groepsniveau. |
|
|
Ondernemings-/serviceprovider-id
|
enterpriseId | string |
Abonnementen op enterprise-/serviceproviderniveau. |
Retouren
| Name | Pad | Type | Description |
|---|---|---|---|
|
Active
|
active | boolean |
waar, onwaar |
|
Ringspatten
|
ringSplash | boolean |
waar, onwaar |
|
Gebeurtenis-id
|
eventId | string |
d6986908-461e-40b9-85ca-e717851f776c |
|
Gebruikers-/doel-id
|
targetId | string |
user@bluip.com |
Bij wijziging van de bewaking van het callcentrum
Reageer op de gemiddelde wachttijd van het callcenter, oproepen versus aantal agents, enzovoort.
Parameters
| Name | Sleutel | Vereist | Type | Description |
|---|---|---|---|---|
|
Groeps-id
|
groupId | string |
Abonnementen op groepsniveau. |
|
|
Ondernemings-/serviceprovider-id
|
enterpriseId | string |
Abonnementen op enterprise-/serviceproviderniveau. |
Retouren
| Name | Pad | Type | Description |
|---|---|---|---|
|
Waarde
|
averageHandlingTime.value | integer |
0 |
|
Waarde
|
expectedWaitTime.value | integer |
0 |
|
Waarde
|
averageSpeedOfAnswer.value | integer |
14622 |
|
Waarde
|
longestWaitTime.value | integer |
5005 |
|
Waarde
|
numCallsInQueue.value | integer |
1 |
|
Aantal toegewezen agents
|
numAgentsAssigned | integer |
1 |
|
Aantal medewerkers met personeel
|
numAgentsStaffed | integer |
1 |
|
Aantal niet-actieve medewerkers
|
numStaffedAgentsIdle | integer |
0 |
|
Aantal medewerkers niet beschikbaar
|
numStaffedAgentsUnavailable | integer |
0 |
|
Gebeurtenis-id
|
eventId | string |
795db7d3-1461-48dd-8a33-65cfdc9dab00 |
|
Gebruiker/doel-id van het callcentrum
|
targetId | string |
BluIPCCDemo@bluip.com |
Bij wijziging van oproepcentrumwachtrij
Reageren op oproepen in een oproepcentrumwachtrij.
Parameters
| Name | Sleutel | Vereist | Type | Description |
|---|---|---|---|---|
|
Groeps-id
|
groupId | string |
Abonnementen op groepsniveau. |
|
|
Ondernemings-/serviceprovider-id
|
enterpriseId | string |
Abonnementen op enterprise-/serviceproviderniveau. |
Retouren
| Name | Pad | Type | Description |
|---|---|---|---|
|
Oproep-id
|
callId | string |
callhalf-31139148485:0 |
|
Externe tracerings-id
|
extTrackingId | string |
130080177:2 |
|
Naam
|
remoteParty.name | string |
Jordan Smith |
|
Tekst
|
remoteParty.address.#text | string | |
|
Landcode
|
remoteParty.address.countryCode | string |
1, 44, enzovoort. |
|
Oproeptype
|
remoteParty.callType | string |
Netwerk, groep |
|
Tijd toevoegen
|
addTime | integer |
1568213984179 |
|
ACD-naam
|
acdName | string |
BluIP Demo Call Center |
|
Tekst
|
acdNumber.#text | string | |
|
Landcode
|
acdNumber.countryCode | string |
1, 44, enzovoort. |
|
ACD-prioriteit
|
acdPriority | string |
3-laag |
|
Tijd toevoegen in prioriteitsbucket
|
addTimeInPriorityBucket | integer |
1568213984179 |
|
Typologie
|
type | string |
ACDCallAbandonedEvent, ACDCallAddedEvent, ACDCallOfferedToAgentEvent, ACDWhisperStartedEvent,Available, Sign-In, Sign-Out, Unavailable, Wrap-UpACDCallAnsweredByAgentEvent |
|
Gebeurtenis-id
|
eventId | string |
0b5bc6c2-bc74-4234-93f9-2945aca8b215 |
|
Gebruiker/doel-id van het callcentrum
|
targetId | string |
BluIPCCDemo@bluip.com |
|
Gebruiker/doel-id beantwoorden
|
answeringUserId | string |
user@bluip.com |
|
Oproep-id beantwoorden
|
answeringCallId | string |
callhalf-31139148489:0 |
|
Tijd verwijderen
|
removeTime | integer |
1568213990637 |
Gebeurtenis bij gesprek
Wanneer er iets gebeurt met een oproep.
Parameters
| Name | Sleutel | Vereist | Type | Description |
|---|---|---|---|---|
|
Gebruikers-ID
|
userId | string |
Abonnement op gebruikersniveau. |
|
|
Groeps-id
|
groupId | string |
Abonnementen op groepsniveau. |
|
|
Ondernemings-/serviceprovider-id
|
enterpriseId | string |
Abonnementen op enterprise-/serviceproviderniveau. |
|
|
Typologie
|
type | string |
Specifiek type oproep gebeurtenis. |
Retouren
| Name | Pad | Type | Description |
|---|---|---|---|
|
Typologie
|
type | string |
CallAnsweredEvent, CallBargedInEvent, CallCollectingEvent, CallHeldEvent, HookStatusEvent, CallMonitoredEvent, CallOriginatedEvent, CallOriginatingEvent, CallPickedUpEvent, CallReceivedEvent, CallRecordingPausedEvent, CallRecordingResumedEvent, CallRecordingStartedEvent, CallRecordingStartingEvent, CallRecordingStoppedEvent, CallRedirectedEvent, CallReleasedEvent, CallReleasingEvent, CallRetrievedEvent, CallTransferredEvent, CallUpdatedEvent |
|
Hookstatus
|
hookStatus | string |
Bij de haak, aan de haak |
|
Gebeurtenis-id
|
eventId | string |
d5e21e5d-7f54-4db3-8351-4302e8dbf941 |
|
Gebruikers-/doel-id
|
targetId | string |
user@bluip.com |
|
Event
|
event | string |
Geavanceerd gesprek |
|
Oproep-id
|
callId | string |
callhalf-31126219817:0 |
|
Externe tracerings-id
|
extTrackingId | string |
129987974:2 |
|
Netwerkoproep-id
|
networkCallId | string |
2002829250_115291504@207.223.XX.XXX |
|
Persoonlijkheid
|
personality | string |
Terminator, Originator |
|
Staat
|
state | string |
Waarschuwingen, actief, vastgehouden, losgekoppeld |
|
Begintijd
|
startTime | integer |
1568204580687 |
|
Naam
|
remoteParty.name | string |
Jordan Smith |
|
Tekst
|
remoteParty.address.#text | string | |
|
Landcode
|
remoteParty.address.countryCode | string |
1 |
|
VZW
|
remoteParty.address.npa | string |
818-XXX-XXXX |
|
NXX
|
remoteParty.address.nxx | string |
XXX-867-XXXX |
|
Oproeptype
|
remoteParty.callType | string |
Netwerk, groep |
|
Gebruikers-ID
|
remoteParty.userId | string |
user@bluip.com |
|
Tekst
|
remoteParty.userDN.#text | string | |
|
Landcode
|
remoteParty.userDN.countryCode | string |
1, 44, enzovoort. |
|
Typologie
|
endpoint.type | string |
AccessEndpoint |
|
Adres van record
|
endpoint.addressOfRecord | string |
user@bluip.com |
|
Uiterlijk
|
appearance | integer |
1, 2, enz. |
|
Antwoord toestaan
|
allowAnswer | string | |
|
Antwoordtijd
|
answerTime | integer |
1568204585231 |
|
Toegestane opnamebesturingselementen
|
allowedRecordingControls | string |
geen, onderbreken, hervatten |
|
Beveiligingsclassificatie
|
securityClassification | string |
Geclassificeerd, niet geclassificeerd |
|
Opgenomen
|
recorded | string | |
|
Opnamestatus
|
recordingState | string |
Gestart, onderbroken |
|
Ophalen toestaan
|
allowRetrieve | string | |
|
Vastgehouden tijd
|
heldTime | integer |
1568204589829 |
|
Totale tijd in de tijd van de vastgehouden tijd
|
totalHeldTime | integer |
4172 |
|
Call
|
call | array of |
Matrix van aanroepen wanneer meer dan één aanroep wordt gespileerd. |
|
Losgekoppelde tijd
|
detachedTime | integer |
1568204605894 |
|
Releasetijd
|
releaseTime | integer |
1568204620298 |
|
Release party
|
releasingParty | string |
localRelease, remoteRelease |
|
Tekst
|
redirect.address.#text | string | |
|
Landcode
|
redirect.address.countryCode | string |
1, 44, enzovoort. |
|
Reden
|
redirect.reason | string |
overdracht |
|
Omleidingstijd
|
redirect.redirectTime | integer |
1568204605894 |
Onbewerkt gebeurtenisabonnement
Gebeurtenissen.
Parameters
| Name | Sleutel | Vereist | Type | Description |
|---|---|---|---|---|
|
Gebruikers-ID
|
userId | string |
Abonnement op gebruikersniveau. |
|
|
Groeps-id
|
groupId | string |
Abonnementen op groepsniveau. |
|
|
Ondernemings-/serviceprovider-id
|
enterpriseId | string |
Abonnementen op enterprise-/serviceproviderniveau. |
|
|
Event
|
event | True | string |
Gebeurtenis waarop u zich wilt abonneren. |
|
Typologie
|
type | string |
Specifiek type gebeurtenis: CallAnsweredEvent, CallReceivedEvent |
Retouren
| Name | Pad | Type | Description |
|---|---|---|---|
|
Gebruikers-/doel-id
|
targetId | string |
Doelgebruiker voor gebeurtenis. |
|
Event
|
event | string |
Gebeurtenistype. |
|
Gebeurtenis-id
|
eventId | string |
De gebeurtenis-id. |
|
Typologie
|
type | string |
Gebeurtenistype. |
Overzicht van voicemailberichten
Reageren op nieuwe of verwijderde voicemailberichten.
Parameters
| Name | Sleutel | Vereist | Type | Description |
|---|---|---|---|---|
|
Gebruikers-ID
|
userId | string |
Abonnement op gebruikersniveau. |
|
|
Groeps-id
|
groupId | string |
Abonnementen op groepsniveau. |
|
|
Ondernemings-/serviceprovider-id
|
enterpriseId | string |
Abonnementen op enterprise-/serviceproviderniveau. |
Retouren
| Name | Pad | Type | Description |
|---|---|---|---|
|
Nieuwe berichten
|
newMessages | integer |
1, 2, 3, enzovoort. |
|
Oude berichten
|
oldMessages | integer |
1, 2, 3, enzovoort. |
Statuswijziging van callcenteragent acd
Reageer op de statuswijziging van de ACD (Automatische oproepdistributie) van een callcenteragent.
Parameters
| Name | Sleutel | Vereist | Type | Description |
|---|---|---|---|---|
|
Gebruikers-ID
|
userId | string |
Abonnement op gebruikersniveau. |
|
|
Groeps-id
|
groupId | string |
Abonnementen op groepsniveau. |
|
|
Ondernemings-/serviceprovider-id
|
enterpriseId | string |
Abonnementen op enterprise-/serviceproviderniveau. |
Retouren
| Name | Pad | Type | Description |
|---|---|---|---|
|
Staat
|
state | string |
Beschikbaar, Aanmelden, Afmelden, Niet beschikbaar, Wrap-Up |
|
Waarde
|
stateTimestamp.value | integer |
1568212016997 |
|
Tijdstempel voor aanmelden
|
signInTimestamp | integer |
1568212016997 |
|
Totale beschikbare tijd
|
totalAvailableTime | integer |
17, enz. |
|
Niet-beschikbare code
|
unavailableCode | integer |
1, 2, 3, 4, enzovoort. |
|
Waarde
|
averageWrapUpTime.value | integer |
0 |
|
Gebeurtenis-id
|
eventId | string |
37bacb10-82a5-47ba-8a6f-f9335433e584 |
|
Gebruikers-/doel-id
|
targetId | string |
user@bluip.com |
Definities
Voorwerp
Dit is het type 'object'.