Téléphonie Xtended Serv Interf (préversion)
Intégrez le système de téléphonie de BluIP pour passer votre appel au niveau suivant. Xtended Service Interface (XSI) de téléphonie.
Ce connecteur est disponible dans les produits et régions suivants :
| Service | classe | Régions |
|---|---|---|
| Copilot Studio | Premium | Toutes les régions Power Automate , à l’exception des éléments suivants : - Us Government (GCC) - Us Government (GCC High) - China Cloud géré par 21Vianet - Us Department of Defense (DoD) |
| Applications logiques | Norme | Toutes les régions Logic Apps , à l’exception des suivantes : - Régions Azure Government - Régions Azure Chine - Us Department of Defense (DoD) |
| Power Apps | Premium | Toutes les régions Power Apps , à l’exception des suivantes : - Us Government (GCC) - Us Government (GCC High) - China Cloud géré par 21Vianet - Us Department of Defense (DoD) |
| Power Automate | Premium | Toutes les régions Power Automate , à l’exception des éléments suivants : - Us Government (GCC) - Us Government (GCC High) - China Cloud géré par 21Vianet - Us Department of Defense (DoD) |
| Contact | |
|---|---|
| Nom | Prise en charge de BluIP |
| URL | https://support.bluip.com |
| Messagerie électronique | developers@bluip.com |
| Métadonnées du connecteur | |
|---|---|
| Éditeur | BluIP, Inc. |
| Site internet | https://www.bluip.com/ |
| Politique de confidentialité | https://www.bluip.com/company/legal/privacy-policy |
| Catégories | Productivité; Communication |
Téléphonie Xtended Serv Interf
Intégrez le système de téléphonie de BluIP pour passer votre appel au niveau suivant. Xtended Service Interface (XSI) de téléphonie.
Conditions préalables
Un compte d’utilisateur, de groupe, d’entreprise ou d’administrateur système BluIP.
Documentation sur l’API
Comment obtenir des informations d’identification
Contactez l’équipe du support technique de BluIP pour obtenir un compte de démonstration ou des détails sur votre compte actuel.
Création d’une connexion
Le connecteur prend en charge les types d’authentification suivants :
| Par défaut | Paramètres de création de connexion. | Toutes les régions | Non partageable |
Faire défaut
Applicable : Toutes les régions
Paramètres de création de connexion.
Cette connexion n’est pas partageable. Si l’application power est partagée avec un autre utilisateur, un autre utilisateur est invité à créer une connexion explicitement.
| Nom | Type | Descriptif | Obligatoire |
|---|---|---|---|
| Nom d’utilisateur | securestring | Nom d’utilisateur MasterAccess (utilisateur, groupe, entreprise ou administrateur système) | Vrai |
| Mot de passe | securestring | Mot de passe MasterAccess | Vrai |
Limitations
| Nom | Appels | Période de renouvellement |
|---|---|---|
| Appels d’API par connexion | 100 | 60 secondes |
Actions
| Activer/désactiver l’enregistrement des appels |
Activer/désactiver l’état d’enregistrement des appels. |
| Activer/désactiver l’état ACD de l’agent |
Activez l’état ACD de l’agent. |
| Fin de l’appel |
Blocage/Fin d’un appel. |
| Nouvel appel |
Effectuer un appel |
| Obtenir des appels utilisateur |
Obtenir des appels utilisateur. |
| Obtenir le profil utilisateur |
Obtenir le profil utilisateur. |
| Requête brute |
Envoyez une requête brute. Recherchez d’autres ressources à l’adresse suivante : https://labxsp1.masteraccess.com/com.broadsoft.xsi-actions/test/v2.0/ |
| Réponse aux appels |
Répondez à un appel. |
| Suspension des appels |
Mettez un appel en attente. |
| Transférer l’appel vers la messagerie vocale |
Transférer l’appel vers la messagerie vocale. |
| Transférer un appel |
Transférer un appel. |
Activer/désactiver l’enregistrement des appels
Activer/désactiver l’état d’enregistrement des appels.
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
Action
|
action | True | string | |
|
ID d’appel
|
callId | True | string | |
|
ID d’utilisateur
|
userId | True | string |
Retours
- response
- object
Activer/désactiver l’état ACD de l’agent
Activez l’état ACD de l’agent.
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
État ACD de l’agent
|
agentACDState | True | string |
État ACD de l’agent |
|
ID d’utilisateur
|
userID | string |
ID d’utilisateur |
Fin de l’appel
Blocage/Fin d’un appel.
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
ID d’utilisateur
|
userId | string |
ID d’utilisateur BluIP. |
|
|
ID d’appel
|
callId | True | string |
ID d’appel d’un appel. |
Nouvel appel
Effectuer un appel
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
ID d’utilisateur
|
userID | string |
ID d’utilisateur BluIP. |
|
|
Numéro de téléphone
|
address | True | string |
Numéro de téléphone. |
Obtenir des appels utilisateur
Obtenir des appels utilisateur.
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
ID d’utilisateur
|
userId | True | string |
ID d’utilisateur BluIP. |
Retours
| Nom | Chemin d’accès | Type | Description |
|---|---|---|---|
|
|
array of object | ||
|
ID d’appel
|
callId | string |
Ex : callhalf-29519312843:0 |
|
URI
|
uri | string |
Ex : /v2.0/user/user@provider.com/calls/callhalf-29519312843:0 |
Obtenir le profil utilisateur
Obtenir le profil utilisateur.
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
ID d’utilisateur
|
userId | True | string |
service@provider.com |
Retours
| Nom | Chemin d’accès | Type | Description |
|---|---|---|---|
|
ID d’utilisateur
|
details.userId | string |
user@bluip.com |
|
Prénom
|
details.firstName | string |
Jordanie |
|
Nom de famille
|
details.lastName | string |
Lopez |
|
Nom hirangana
|
details.hiranganaLastName | string |
Lopez |
|
Prénom Hirangana
|
details.hiranganaFirstName | string |
Jordanie |
|
Nom de famille
|
details.nameDialingName.nameDialingLastName | string |
Lopez |
|
Prénom
|
details.nameDialingName.nameDialingFirstName | string |
Jordanie |
|
ID de groupe
|
details.groupId | integer | |
|
Fournisseur de services/ID d’entreprise
|
details.serviceProvider | string | |
|
Number
|
details.number | integer | |
|
Extension
|
details.extension | integer | |
|
Téléphone mobile
|
additionalDetails.mobile | string | |
|
Yahoo ID
|
additionalDetails.yahooId | string | |
|
Radiomessagerie
|
additionalDetails.pager | string | |
|
Adresse électronique
|
additionalDetails.emailAddress | string | |
|
Titre
|
additionalDetails.title | string | |
|
Emplacement
|
additionalDetails.location | string | |
|
Département
|
additionalDetails.department | string | |
|
Messagerie instantanée
|
additionalDetails.impId | string | |
|
Le mot de passe expire les jours
|
passwordExpiresDays | integer | |
|
FAC URI
|
fac | string | |
|
URI des inscriptions
|
registrations | string | |
|
URI de liste de planification
|
scheduleList | string | |
|
URI de modification du mot de passe du portail
|
portalPasswordChange | string | |
|
Code pays
|
countryCode | string |
Requête brute
Envoyez une requête brute. Recherchez d’autres ressources à l’adresse suivante : https://labxsp1.masteraccess.com/com.broadsoft.xsi-actions/test/v2.0/
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
ID d’utilisateur
|
userId | True | string |
ID d’utilisateur BluIP. |
|
Ressource/chemin d’accès
|
path | True | string |
Choisissez une ressource ou entrez le chemin d’accès à une ressource. |
|
Charge utile
|
payload | string |
Laissez vide pour « GET » ou incluez la charge utile pour les données « PUT ». |
|
|
Accept
|
Accept | string |
Accept |
Réponse aux appels
Répondez à un appel.
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
ID d’utilisateur
|
userId | string |
ID d’utilisateur BluIP. |
|
|
ID d’appel
|
callId | string |
Appeler l’ID d’appel. |
Suspension des appels
Mettez un appel en attente.
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
ID d’utilisateur
|
userId | string |
ID d’utilisateur BluIP. |
|
|
ID d’appel
|
callId | True | string |
ID d’appel d’un appel. |
Transférer l’appel vers la messagerie vocale
Transférer l’appel vers la messagerie vocale.
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
ID d’utilisateur
|
userId | string |
ID d’utilisateur BluIP. |
|
|
ID d’appel
|
callId | True | string |
ID d’appel d’un appel. |
Transférer un appel
Transférer un appel.
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
ID d’utilisateur
|
userId | string |
ID d’utilisateur BluIP. |
|
|
ID d’appel
|
callId | True | string |
ID d’appel d’un appel. |
|
Numéro de téléphone
|
address | True | string |
Numéro de téléphone à transférer vers. |
Déclencheurs
| Abonnement aux événements bruts |
Événements. |
| Modification de la file d’attente du centre d’appels |
Réagir aux appels dans une file d’attente du centre d’appels. |
| Modification de l’analyse du centre d’appels |
Réagir au temps d’attente moyen du centre d’appels, appels et nombre d’agents, etc. |
| Modification de l’état ACD de l’agent du centre d’appels |
Réagir au changement d’état ACD (Distribution automatique des appels) d’un agent du centre d’appels. |
| Résumé des messages vocaux |
Réagir aux messages de messagerie vocale nouveaux ou supprimés. |
| Sur Ne pas déranger la modification |
Réagir au changement d’état DND d’un utilisateur. |
| Événement à l’appel |
Lorsque quelque chose arrive à un appel. |
Abonnement aux événements bruts
Événements.
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
ID d’utilisateur
|
userId | string |
Abonnement au niveau de l’utilisateur. |
|
|
ID de groupe
|
groupId | string |
Abonnements au niveau du groupe. |
|
|
ID du fournisseur de services/d’entreprise
|
enterpriseId | string |
Abonnements de niveau Entreprise/Fournisseur de services. |
|
|
Événement
|
event | True | string |
Événement auquel s’abonner. |
|
Type
|
type | string |
Type spécifique d’événement : CallAnsweredEvent, CallReceivedEvent |
Retours
| Nom | Chemin d’accès | Type | Description |
|---|---|---|---|
|
ID utilisateur/cible
|
targetId | string |
Utilisateur cible d’événement. |
|
Événement
|
event | string |
Type d’événement. |
|
ID de l’événement
|
eventId | string |
ID d’événement. |
|
Type
|
type | string |
Type d’événement. |
Modification de la file d’attente du centre d’appels
Réagir aux appels dans une file d’attente du centre d’appels.
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
ID de groupe
|
groupId | string |
Abonnements au niveau du groupe. |
|
|
ID du fournisseur de services/d’entreprise
|
enterpriseId | string |
Abonnements de niveau Entreprise/Fournisseur de services. |
Retours
| Nom | Chemin d’accès | Type | Description |
|---|---|---|---|
|
ID d’appel
|
callId | string |
callhalf-31139148485:0 |
|
ID de suivi externe
|
extTrackingId | string |
130080177:2 |
|
Nom
|
remoteParty.name | string |
Jordan Smith |
|
Texto
|
remoteParty.address.#text | string | |
|
Code pays
|
remoteParty.address.countryCode | string |
1, 44, etc. |
|
Type d’appel
|
remoteParty.callType | string |
Réseau, groupe |
|
Ajouter du temps
|
addTime | integer |
1568213984179 |
|
Nom ACD
|
acdName | string |
Centre d’appels de démonstration BluIP |
|
Texto
|
acdNumber.#text | string | |
|
Code pays
|
acdNumber.countryCode | string |
1, 44, etc. |
|
Priorité ACD
|
acdPriority | string |
3-Low |
|
Ajouter du temps dans le compartiment priorité
|
addTimeInPriorityBucket | integer |
1568213984179 |
|
Type
|
type | string |
ACDCallAbandonedEvent, ACDCallAddedEvent, ACDCallOfferedToAgentEvent, ACDWhisperStartedEvent,Available, Sign-In, Sign-Out, Indisponible, Wrap-UpACDCallAnsweredByAgentEvent |
|
ID de l’événement
|
eventId | string |
0b5bc6c2-bc74-4234-93f9-2945aca8b215 |
|
ID utilisateur/cible du Centre d’appels
|
targetId | string |
BluIPCCDemo@bluip.com |
|
Réponse à l’ID utilisateur/cible
|
answeringUserId | string |
user@bluip.com |
|
ID d’appel de réponse
|
answeringCallId | string |
callhalf-31139148489:0 |
|
Supprimer l’heure
|
removeTime | integer |
1568213990637 |
Modification de l’analyse du centre d’appels
Réagir au temps d’attente moyen du centre d’appels, appels et nombre d’agents, etc.
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
ID de groupe
|
groupId | string |
Abonnements au niveau du groupe. |
|
|
ID du fournisseur de services/d’entreprise
|
enterpriseId | string |
Abonnements de niveau Entreprise/Fournisseur de services. |
Retours
| Nom | Chemin d’accès | Type | Description |
|---|---|---|---|
|
Valeur
|
averageHandlingTime.value | integer |
0 |
|
Valeur
|
expectedWaitTime.value | integer |
0 |
|
Valeur
|
averageSpeedOfAnswer.value | integer |
14 622 |
|
Valeur
|
longestWaitTime.value | integer |
5005 |
|
Valeur
|
numCallsInQueue.value | integer |
1 |
|
Nombre d’agents affectés
|
numAgentsAssigned | integer |
1 |
|
Nombre d’agents affectés
|
numAgentsStaffed | integer |
1 |
|
Nombre d’agents employés inactifs
|
numStaffedAgentsIdle | integer |
0 |
|
Nombre d’agents en personnel indisponibles
|
numStaffedAgentsUnavailable | integer |
0 |
|
ID de l’événement
|
eventId | string |
795db7d3-1461-48dd-8a33-65cfdc9dab00 |
|
ID utilisateur/cible du Centre d’appels
|
targetId | string |
BluIPCCDemo@bluip.com |
Modification de l’état ACD de l’agent du centre d’appels
Réagir au changement d’état ACD (Distribution automatique des appels) d’un agent du centre d’appels.
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
ID d’utilisateur
|
userId | string |
Abonnement au niveau de l’utilisateur. |
|
|
ID de groupe
|
groupId | string |
Abonnements au niveau du groupe. |
|
|
ID du fournisseur de services/d’entreprise
|
enterpriseId | string |
Abonnements de niveau Entreprise/Fournisseur de services. |
Retours
| Nom | Chemin d’accès | Type | Description |
|---|---|---|---|
|
État
|
state | string |
Disponible, connexion, déconnexion, non disponible, Wrap-Up |
|
Valeur
|
stateTimestamp.value | integer |
1568212016997 |
|
Horodatage de connexion
|
signInTimestamp | integer |
1568212016997 |
|
Durée totale disponible
|
totalAvailableTime | integer |
17, etc. |
|
Code indisponible
|
unavailableCode | integer |
1, 2, 3, 4, etc. |
|
Valeur
|
averageWrapUpTime.value | integer |
0 |
|
ID de l’événement
|
eventId | string |
37bacb10-82a5-47ba-8a6f-f9335433e584 |
|
ID utilisateur/cible
|
targetId | string |
user@bluip.com |
Résumé des messages vocaux
Réagir aux messages de messagerie vocale nouveaux ou supprimés.
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
ID d’utilisateur
|
userId | string |
Abonnement au niveau de l’utilisateur. |
|
|
ID de groupe
|
groupId | string |
Abonnements au niveau du groupe. |
|
|
ID du fournisseur de services/d’entreprise
|
enterpriseId | string |
Abonnements de niveau Entreprise/Fournisseur de services. |
Retours
| Nom | Chemin d’accès | Type | Description |
|---|---|---|---|
|
Nouveaux messages
|
newMessages | integer |
1, 2, 3, etc. |
|
Anciens messages
|
oldMessages | integer |
1, 2, 3, etc. |
Sur Ne pas déranger la modification
Réagir au changement d’état DND d’un utilisateur.
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
ID d’utilisateur
|
userId | string |
Abonnement au niveau de l’utilisateur. |
|
|
ID de groupe
|
groupId | string |
Abonnements au niveau du groupe. |
|
|
ID du fournisseur de services/d’entreprise
|
enterpriseId | string |
Abonnements de niveau Entreprise/Fournisseur de services. |
Retours
| Nom | Chemin d’accès | Type | Description |
|---|---|---|---|
|
Active
|
active | boolean |
true, false |
|
Anneaux De démarrage
|
ringSplash | boolean |
true, false |
|
ID de l’événement
|
eventId | string |
d6986908-461e-40b9-85ca-e717851f776c |
|
ID utilisateur/cible
|
targetId | string |
user@bluip.com |
Événement à l’appel
Lorsque quelque chose arrive à un appel.
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
ID d’utilisateur
|
userId | string |
Abonnement au niveau de l’utilisateur. |
|
|
ID de groupe
|
groupId | string |
Abonnements au niveau du groupe. |
|
|
ID du fournisseur de services/d’entreprise
|
enterpriseId | string |
Abonnements de niveau Entreprise/Fournisseur de services. |
|
|
Type
|
type | string |
Type spécifique d’événement d’appel. |
Retours
| Nom | Chemin d’accès | 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 |
|
État du hook
|
hookStatus | string |
Off-Hook, On-Hook |
|
ID de l’événement
|
eventId | string |
d5e21e5d-7f54-4db3-8351-4302e8dbf941 |
|
ID utilisateur/cible
|
targetId | string |
user@bluip.com |
|
Événement
|
event | string |
Appel avancé |
|
ID d’appel
|
callId | string |
callhalf-31126219817:0 |
|
ID de suivi externe
|
extTrackingId | string |
129987974:2 |
|
ID d’appel réseau
|
networkCallId | string |
2002829250_115291504@207.223.XX.XXX |
|
Personnalité
|
personality | string |
Terminator, Originator |
|
État
|
state | string |
Alertes, actives, détenues, détachées |
|
Heure de début
|
startTime | integer |
1568204580687 |
|
Nom
|
remoteParty.name | string |
Jordan Smith |
|
Texto
|
remoteParty.address.#text | string | |
|
Code pays
|
remoteParty.address.countryCode | string |
1 |
|
NPA
|
remoteParty.address.npa | string |
818-XXX-XXXX |
|
NXX
|
remoteParty.address.nxx | string |
XXX-867-XXXX |
|
Type d’appel
|
remoteParty.callType | string |
Réseau, groupe |
|
ID d’utilisateur
|
remoteParty.userId | string |
user@bluip.com |
|
Texto
|
remoteParty.userDN.#text | string | |
|
Code pays
|
remoteParty.userDN.countryCode | string |
1, 44, etc. |
|
Type
|
endpoint.type | string |
AccessEndpoint |
|
Adresse de l’enregistrement
|
endpoint.addressOfRecord | string |
user@bluip.com |
|
Apparence
|
appearance | integer |
1, 2, etc. |
|
Autoriser la réponse
|
allowAnswer | string | |
|
Temps de réponse
|
answerTime | integer |
1568204585231 |
|
Contrôles d’enregistrement autorisés
|
allowedRecordingControls | string |
none, pause, resume |
|
Classification de la sécurité
|
securityClassification | string |
Classifié, non classé |
|
Enregistré
|
recorded | string | |
|
État d’enregistrement
|
recordingState | string |
Démarré, suspendu |
|
Autoriser la récupération
|
allowRetrieve | string | |
|
Heure tenue
|
heldTime | integer |
1568204589829 |
|
Durée totale tenue
|
totalHeldTime | integer |
4172 |
|
Call
|
call | array of |
Tableau d’appels lorsque plusieurs appels sont assosiés. |
|
Heure détachée
|
detachedTime | integer |
1568204605894 |
|
Heure de publication
|
releaseTime | integer |
1568204620298 |
|
Publication d’une partie
|
releasingParty | string |
localRelease, remoteRelease |
|
Texto
|
redirect.address.#text | string | |
|
Code pays
|
redirect.address.countryCode | string |
1, 44, etc. |
|
Reason
|
redirect.reason | string |
transférer |
|
Heure de redirection
|
redirect.redirectTime | integer |
1568204605894 |
Définitions
objet
Il s’agit du type 'object'.