Telefonie Xtended Serv Interf (Vorschau)
Integrieren Sie das Telefoniesystem von BluIP, um Ihren Anruf auf die nächste Ebene zu führen. Telefonie Xtended Service Interface (XSI).
Dieser Connector ist in den folgenden Produkten und Regionen verfügbar:
| Dienstleistung | Class | Regions |
|---|---|---|
| Copilot Studio | Premium | Alle Power Automate-Regionen mit Ausnahme der folgenden Bereiche: - US Government (GCC) - US Government (GCC High) - China Cloud betrieben von 21Vianet - US Department of Defense (DoD) |
| Logik-Apps | Norm | Alle Logik-Apps-Regionen mit Ausnahme der folgenden Bereiche: – Azure Government-Regionen - Azure China-Regionen - US Department of Defense (DoD) |
| Power Apps | Premium | Alle Power Apps-Regionen mit Ausnahme der folgenden: - US Government (GCC) - US Government (GCC High) - China Cloud betrieben von 21Vianet - US Department of Defense (DoD) |
| Power Automate | Premium | Alle Power Automate-Regionen mit Ausnahme der folgenden Bereiche: - US Government (GCC) - US Government (GCC High) - China Cloud betrieben von 21Vianet - US Department of Defense (DoD) |
| Kontakt | |
|---|---|
| Name | BluIP-Unterstützung |
| URL | https://support.bluip.com |
| developers@bluip.com |
| Connectormetadaten | |
|---|---|
| Herausgeber | BluIP, Inc. |
| Webseite | https://www.bluip.com/ |
| Datenschutzrichtlinie | https://www.bluip.com/company/legal/privacy-policy |
| Kategorien | Produktivität; Kommunikation |
Telefonie Xtended Serv Interf
Integrieren Sie das Telefoniesystem von BluIP, um Ihren Anruf auf die nächste Ebene zu führen. Telefonie Xtended Service Interface (XSI).
Voraussetzungen
Ein BluIP-Benutzer-, Gruppen-, Unternehmens- oder Systemadministratorkonto.
API-Dokumentation
So erhalten Sie Anmeldeinformationen
Wenden Sie sich an das Supportteam von BluIP, um ein Demokonto oder Details zu Ihrem aktuellen Konto zu erhalten.
Erstellen einer Verbindung
Der Connector unterstützt die folgenden Authentifizierungstypen:
| Vorgabe | Parameter zum Erstellen einer Verbindung. | Alle Regionen | Nicht teilbar |
Vorgabe
Anwendbar: Alle Regionen
Parameter zum Erstellen einer Verbindung.
Dies ist keine freigabefähige Verbindung. Wenn die Power-App für einen anderen Benutzer freigegeben wird, wird ein anderer Benutzer aufgefordert, eine neue Verbindung explizit zu erstellen.
| Name | Typ | Description | Erforderlich |
|---|---|---|---|
| Nutzername | securestring | MasterAccess-Benutzername (Benutzer-, Gruppen-, Unternehmens- oder Systemadministrator) | Richtig |
| Kennwort | securestring | MasterAccess-Kennwort | Richtig |
Drosselungsgrenzwerte
| Name | Aufrufe | Verlängerungszeitraum |
|---|---|---|
| API-Aufrufe pro Verbindung | 100 | 60 Sekunden |
Aktionen
| Abrufen von Benutzeranrufen |
Rufen Sie Benutzeranrufe ab. |
| Anruf an Voicemail durchstellen |
Anruf an Voicemail durchstellen. |
| Anrufantwort |
Annehmen eines Anrufs. |
| Anrufende |
Auflegen/Beenden eines Anrufs |
| Anrufwarteschleife |
Setzen Sie einen Anruf in die Warteschleife. |
| Benutzerprofil abrufen |
Benutzerprofil abrufen. |
| Durchstellen eines Anrufs |
Durchstellen eines Anrufs. |
| Neuer Anruf |
Anrufen |
| Raw-Anforderung |
Senden Sie eine unformatierte Anforderung. Weitere Ressourcen finden Sie unter: https://labxsp1.masteraccess.com/com.broadsoft.xsi-actions/test/v2.0/ |
| Umschalten der Anrufaufzeichnung |
Umschalten des Zustands der Anrufaufzeichnung. |
| Umschalten des ACD-Status des Agents |
Schalten Sie den Agent ACD-Status um. |
Abrufen von Benutzeranrufen
Rufen Sie Benutzeranrufe ab.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Benutzer-ID
|
userId | True | string |
Eine BluIP-Benutzer-ID. |
Gibt zurück
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
|
array of object | ||
|
Anruf-ID
|
callId | string |
Ex: callhalf-29519312843:0 |
|
URI
|
uri | string |
Beispiel: /v2.0/user//user@provider.comcalls/callhalf-29519312843:0 |
Anruf an Voicemail durchstellen
Anruf an Voicemail durchstellen.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Benutzer-ID
|
userId | string |
Eine BluIP-Benutzer-ID. |
|
|
Anruf-ID
|
callId | True | string |
Anruf-ID eines Anrufs. |
Anrufantwort
Annehmen eines Anrufs.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Benutzer-ID
|
userId | string |
Eine BluIP-Benutzer-ID. |
|
|
Anruf-ID
|
callId | string |
Anruf-ID. |
Anrufende
Auflegen/Beenden eines Anrufs
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Benutzer-ID
|
userId | string |
Eine BluIP-Benutzer-ID. |
|
|
Anruf-ID
|
callId | True | string |
Anruf-ID eines Anrufs. |
Anrufwarteschleife
Setzen Sie einen Anruf in die Warteschleife.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Benutzer-ID
|
userId | string |
Eine BluIP-Benutzer-ID. |
|
|
Anruf-ID
|
callId | True | string |
Anruf-ID eines Anrufs. |
Benutzerprofil abrufen
Benutzerprofil abrufen.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Benutzer-ID
|
userId | True | string |
service@provider.com |
Gibt zurück
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
Benutzer-ID
|
details.userId | string |
user@bluip.com |
|
Vorname
|
details.firstName | string |
Jordanien |
|
Nachname
|
details.lastName | string |
Smith |
|
Hirangana Nachname
|
details.hiranganaLastName | string |
Smith |
|
Hirangana Vorname
|
details.hiranganaFirstName | string |
Jordanien |
|
Nachname
|
details.nameDialingName.nameDialingLastName | string |
Smith |
|
Vorname
|
details.nameDialingName.nameDialingFirstName | string |
Jordanien |
|
Gruppen-ID
|
details.groupId | integer | |
|
Dienstanbieter/Unternehmens-ID
|
details.serviceProvider | string | |
|
Number
|
details.number | integer | |
|
Extension
|
details.extension | integer | |
|
Mobiltelefon
|
additionalDetails.mobile | string | |
|
Yahoo-ID
|
additionalDetails.yahooId | string | |
|
Pager
|
additionalDetails.pager | string | |
|
E-Mail-Adresse
|
additionalDetails.emailAddress | string | |
|
Title
|
additionalDetails.title | string | |
|
Standort
|
additionalDetails.location | string | |
|
Abteilung
|
additionalDetails.department | string | |
|
Chat&P
|
additionalDetails.impId | string | |
|
Kennwort läuft Tage ab
|
passwordExpiresDays | integer | |
|
FAC-URI
|
fac | string | |
|
Registrierungs-URI
|
registrations | string | |
|
Listen-URI planen
|
scheduleList | string | |
|
Portalkennwortänderungs-URI
|
portalPasswordChange | string | |
|
Ländercode
|
countryCode | string |
Durchstellen eines Anrufs
Durchstellen eines Anrufs.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Benutzer-ID
|
userId | string |
Eine BluIP-Benutzer-ID. |
|
|
Anruf-ID
|
callId | True | string |
Anruf-ID eines Anrufs. |
|
Rufnummer
|
address | True | string |
Telefonnummer, zu der sie übertragen werden sollen. |
Neuer Anruf
Anrufen
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Benutzer-ID
|
userID | string |
Eine BluIP-Benutzer-ID. |
|
|
Rufnummer
|
address | True | string |
Telefonnummer. |
Raw-Anforderung
Senden Sie eine unformatierte Anforderung. Weitere Ressourcen finden Sie unter: https://labxsp1.masteraccess.com/com.broadsoft.xsi-actions/test/v2.0/
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Benutzer-ID
|
userId | True | string |
Eine BluIP-Benutzer-ID. |
|
Ressource/Pfad
|
path | True | string |
Wählen Sie eine Ressource aus, oder geben Sie den Pfad zu einer Ressource ein. |
|
Nutzlast
|
payload | string |
Lassen Sie "GET" leer, oder fügen Sie Nutzlast zu "PUT"-Daten ein. |
|
|
Akzeptieren
|
Accept | string |
Akzeptieren |
Umschalten der Anrufaufzeichnung
Umschalten des Zustands der Anrufaufzeichnung.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Maßnahme
|
action | True | string | |
|
Anruf-ID
|
callId | True | string | |
|
Benutzer-ID
|
userId | True | string |
Gibt zurück
- response
- object
Umschalten des ACD-Status des Agents
Schalten Sie den Agent ACD-Status um.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Agent ACD-Status
|
agentACDState | True | string |
Agent ACD-Status |
|
Benutzer-ID
|
userID | string |
Benutzer-ID |
Auslöser
| On Call-Ereignis |
Wenn etwas mit einem Anruf passiert. |
| On Do Not Disturb Change |
Reagieren Sie auf die DND-Zustandsänderung eines Benutzers. |
| Raw-Ereignisabonnement |
Ereignisse. |
| Zusammenfassung der Voicemailnachricht |
Reagieren Sie auf neue oder entfernte Voicemailnachrichten. |
| Änderung der Anrufcenterwarteschleife |
Reagieren Sie auf Anrufe in einer Anrufcenterwarteschleife. |
| Änderung der Anrufcenterüberwachung |
Reagieren Sie auf die durchschnittliche Wartezeit, Anrufe im Vergleich zur Agentanzahl usw. |
| Änderung des AcD-Status des Call Center-Agents |
Reagieren Sie auf die AcD-Statusänderung eines Anrufcenter-Agents (Automatische Anrufverteilung). |
On Call-Ereignis
Wenn etwas mit einem Anruf passiert.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Benutzer-ID
|
userId | string |
Abonnement auf Benutzerebene. |
|
|
Gruppen-ID
|
groupId | string |
Abonnements auf Gruppenebene. |
|
|
Unternehmens-/Dienstanbieter-ID
|
enterpriseId | string |
Abonnements auf Enterprise-/Dienstanbieterebene. |
|
|
Typ
|
type | string |
Spezifischer Typ des Anrufereignisses. |
Gibt zurück
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
Typ
|
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 |
|
Ereignis-ID
|
eventId | string |
d5e21e5d-7f54-4db3-8351-4302e8dbf941 |
|
Benutzer-/Ziel-ID
|
targetId | string |
user@bluip.com |
|
Event
|
event | string |
Erweiterter Anruf |
|
Anruf-ID
|
callId | string |
callhalf-31126219817:0 |
|
Externe Nachverfolgungs-ID
|
extTrackingId | string |
129987974:2 |
|
Netzwerkanruf-ID
|
networkCallId | string |
2002829250_115291504@207.223.XX.XXX |
|
Persönlichkeit
|
personality | string |
Terminator, Absender |
|
Staat
|
state | string |
Warnung, Aktiv, gehalten, getrennt |
|
Startzeit
|
startTime | integer |
1568204580687 |
|
Name
|
remoteParty.name | string |
Jordan Smith |
|
Text
|
remoteParty.address.#text | string | |
|
Ländercode
|
remoteParty.address.countryCode | string |
1 |
|
NPA
|
remoteParty.address.npa | string |
818-XXX-XXXX |
|
NXX
|
remoteParty.address.nxx | string |
XXX-867-XXXX |
|
Anruftyp
|
remoteParty.callType | string |
Netzwerk, Gruppe |
|
Benutzer-ID
|
remoteParty.userId | string |
user@bluip.com |
|
Text
|
remoteParty.userDN.#text | string | |
|
Ländercode
|
remoteParty.userDN.countryCode | string |
1, 44 usw. |
|
Typ
|
endpoint.type | string |
AccessEndpoint |
|
Adresse des Datensatzes
|
endpoint.addressOfRecord | string |
user@bluip.com |
|
Erscheinungsbild
|
appearance | integer |
1, 2 usw. |
|
Antwort zulassen
|
allowAnswer | string | |
|
Antwortzeit
|
answerTime | integer |
1568204585231 |
|
Zulässige Aufzeichnungssteuerelemente
|
allowedRecordingControls | string |
none, pause, resume |
|
Sicherheitsklassifizierung
|
securityClassification | string |
Klassifiziert, nicht klassifiziert |
|
Aufgenommen
|
recorded | string | |
|
Aufzeichnungszustand
|
recordingState | string |
Gestartet, angehalten |
|
Abrufen zulassen
|
allowRetrieve | string | |
|
Gehaltene Zeit
|
heldTime | integer |
1568204589829 |
|
Gesamt gehaltene Zeit
|
totalHeldTime | integer |
4172 |
|
Anruf
|
call | array of |
Array von Anrufen, wenn mehr als ein Anruf assosiated wird. |
|
Losgelöste Zeit
|
detachedTime | integer |
1568204605894 |
|
Veröffentlichungszeit
|
releaseTime | integer |
1568204620298 |
|
Veröffentlichungsparty
|
releasingParty | string |
localRelease, remoteRelease |
|
Text
|
redirect.address.#text | string | |
|
Ländercode
|
redirect.address.countryCode | string |
1, 44 usw. |
|
Ursache
|
redirect.reason | string |
Übertragen |
|
Umleitungszeit
|
redirect.redirectTime | integer |
1568204605894 |
On Do Not Disturb Change
Reagieren Sie auf die DND-Zustandsänderung eines Benutzers.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Benutzer-ID
|
userId | string |
Abonnement auf Benutzerebene. |
|
|
Gruppen-ID
|
groupId | string |
Abonnements auf Gruppenebene. |
|
|
Unternehmens-/Dienstanbieter-ID
|
enterpriseId | string |
Abonnements auf Enterprise-/Dienstanbieterebene. |
Gibt zurück
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
Active
|
active | boolean |
true, false |
|
Ring-Begrüßung
|
ringSplash | boolean |
true, false |
|
Ereignis-ID
|
eventId | string |
d6986908-461e-40b9-85ca-e717851f776c |
|
Benutzer-/Ziel-ID
|
targetId | string |
user@bluip.com |
Raw-Ereignisabonnement
Ereignisse.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Benutzer-ID
|
userId | string |
Abonnement auf Benutzerebene. |
|
|
Gruppen-ID
|
groupId | string |
Abonnements auf Gruppenebene. |
|
|
Unternehmens-/Dienstanbieter-ID
|
enterpriseId | string |
Abonnements auf Enterprise-/Dienstanbieterebene. |
|
|
Event
|
event | True | string |
Ereignis, das abonniert werden soll. |
|
Typ
|
type | string |
Spezifischer Ereignistyp: CallAnsweredEvent, CallReceivedEvent |
Gibt zurück
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
Benutzer-/Ziel-ID
|
targetId | string |
Ereigniszielbenutzer. |
|
Event
|
event | string |
Ereignistyp. |
|
Ereignis-ID
|
eventId | string |
Die Ereignis-ID. |
|
Typ
|
type | string |
Ereignistyp. |
Zusammenfassung der Voicemailnachricht
Reagieren Sie auf neue oder entfernte Voicemailnachrichten.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Benutzer-ID
|
userId | string |
Abonnement auf Benutzerebene. |
|
|
Gruppen-ID
|
groupId | string |
Abonnements auf Gruppenebene. |
|
|
Unternehmens-/Dienstanbieter-ID
|
enterpriseId | string |
Abonnements auf Enterprise-/Dienstanbieterebene. |
Gibt zurück
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
Neue Nachrichten
|
newMessages | integer |
1, 2, 3 usw. |
|
Alte Nachrichten
|
oldMessages | integer |
1, 2, 3 usw. |
Änderung der Anrufcenterwarteschleife
Reagieren Sie auf Anrufe in einer Anrufcenterwarteschleife.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Gruppen-ID
|
groupId | string |
Abonnements auf Gruppenebene. |
|
|
Unternehmens-/Dienstanbieter-ID
|
enterpriseId | string |
Abonnements auf Enterprise-/Dienstanbieterebene. |
Gibt zurück
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
Anruf-ID
|
callId | string |
callhalf-31139148485:0 |
|
Externe Nachverfolgungs-ID
|
extTrackingId | string |
130080177:2 |
|
Name
|
remoteParty.name | string |
Jordan Smith |
|
Text
|
remoteParty.address.#text | string | |
|
Ländercode
|
remoteParty.address.countryCode | string |
1, 44 usw. |
|
Anruftyp
|
remoteParty.callType | string |
Netzwerk, Gruppe |
|
Zeit hinzufügen
|
addTime | integer |
1568213984179 |
|
ACD-Name
|
acdName | string |
BluIP Demo Call Center |
|
Text
|
acdNumber.#text | string | |
|
Ländercode
|
acdNumber.countryCode | string |
1, 44 usw. |
|
ACD-Priorität
|
acdPriority | string |
3-Niedrig |
|
Zeit im Prioritäts-Bucket hinzufügen
|
addTimeInPriorityBucket | integer |
1568213984179 |
|
Typ
|
type | string |
ACDCallAbandonedEvent, ACDCallAddedEvent, ACDCallOfferedToAgentEvent, ACDWhisperStartedEvent,Available, Sign-In, Sign-Out, Unavailable, Wrap-UpACDCallAnsweredByAgentEvent |
|
Ereignis-ID
|
eventId | string |
0b5bc6c2-bc74-4234-93f9-2945aca8b215 |
|
Anrufcenter-Benutzer-/Ziel-ID
|
targetId | string |
BluIPCCDemo@bluip.com |
|
Annehmen der Benutzer-/Ziel-ID
|
answeringUserId | string |
user@bluip.com |
|
Anruf-ID annehmen
|
answeringCallId | string |
callhalf-31139148489:0 |
|
Zeit entfernen
|
removeTime | integer |
1568213990637 |
Änderung der Anrufcenterüberwachung
Reagieren Sie auf die durchschnittliche Wartezeit, Anrufe im Vergleich zur Agentanzahl usw.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Gruppen-ID
|
groupId | string |
Abonnements auf Gruppenebene. |
|
|
Unternehmens-/Dienstanbieter-ID
|
enterpriseId | string |
Abonnements auf Enterprise-/Dienstanbieterebene. |
Gibt zurück
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
Wert
|
averageHandlingTime.value | integer |
0 |
|
Wert
|
expectedWaitTime.value | integer |
0 |
|
Wert
|
averageSpeedOfAnswer.value | integer |
14.622 |
|
Wert
|
longestWaitTime.value | integer |
5005 |
|
Wert
|
numCallsInQueue.value | integer |
1 |
|
Anzahl der zugewiesenen Agents
|
numAgentsAssigned | integer |
1 |
|
Anzahl der Mitarbeiter
|
numAgentsStaffed | integer |
1 |
|
Anzahl der Mitarbeiter im Leerlauf
|
numStaffedAgentsIdle | integer |
0 |
|
Anzahl der nicht verfügbaren Mitarbeiter
|
numStaffedAgentsUnavailable | integer |
0 |
|
Ereignis-ID
|
eventId | string |
795db7d3-1461-48dd-8a33-65cfdc9dab00 |
|
Anrufcenter-Benutzer-/Ziel-ID
|
targetId | string |
BluIPCCDemo@bluip.com |
Änderung des AcD-Status des Call Center-Agents
Reagieren Sie auf die AcD-Statusänderung eines Anrufcenter-Agents (Automatische Anrufverteilung).
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Benutzer-ID
|
userId | string |
Abonnement auf Benutzerebene. |
|
|
Gruppen-ID
|
groupId | string |
Abonnements auf Gruppenebene. |
|
|
Unternehmens-/Dienstanbieter-ID
|
enterpriseId | string |
Abonnements auf Enterprise-/Dienstanbieterebene. |
Gibt zurück
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
Staat
|
state | string |
Verfügbar, Anmelden, Abmelden, nicht verfügbar, Wrap-Up |
|
Wert
|
stateTimestamp.value | integer |
1568212016997 |
|
Anmeldezeitstempel
|
signInTimestamp | integer |
1568212016997 |
|
Verfügbare Gesamtzeit
|
totalAvailableTime | integer |
17 usw. |
|
Nicht verfügbarer Code
|
unavailableCode | integer |
1, 2, 3, 4 usw. |
|
Wert
|
averageWrapUpTime.value | integer |
0 |
|
Ereignis-ID
|
eventId | string |
37bacb10-82a5-47ba-8a6f-f9335433e584 |
|
Benutzer-/Ziel-ID
|
targetId | string |
user@bluip.com |
Definitionen
Objekt
Dies ist der Typ 'object'.