Telefonía Xtended Serv Interf (versión preliminar)
Integre con el sistema de telefonía de BluIP para llevar la llamada al siguiente nivel. Interfaz de servicio Xtended de telefonía (XSI).
Este conector está disponible en los siguientes productos y regiones:
| Service | Class | Regions |
|---|---|---|
| Copilot Studio | Premium | Todas las regiones de Power Automate excepto las siguientes: - Gobierno de EE. UU. (GCC) - Gobierno de EE. UU. (GCC High) - China Cloud operado por 21Vianet - Departamento de Defensa de EE. UU. (DoD) |
| Aplicaciones lógicas | Estándar | Todas las regiones de Logic Apps excepto las siguientes: - Regiones de Azure Government - Regiones de Azure China - Departamento de Defensa de EE. UU. (DoD) |
| Power Apps | Premium | Todas las regiones de Power Apps excepto las siguientes: - Gobierno de EE. UU. (GCC) - Gobierno de EE. UU. (GCC High) - China Cloud operado por 21Vianet - Departamento de Defensa de EE. UU. (DoD) |
| Power Automate | Premium | Todas las regiones de Power Automate excepto las siguientes: - Gobierno de EE. UU. (GCC) - Gobierno de EE. UU. (GCC High) - China Cloud operado por 21Vianet - Departamento de Defensa de EE. UU. (DoD) |
| Contacto | |
|---|---|
| Nombre | Compatibilidad con BluIP |
| URL | https://support.bluip.com |
| Correo Electrónico | developers@bluip.com |
| Metadatos del conector | |
|---|---|
| Publicador | BluIP, Inc. |
| Sitio web | https://www.bluip.com/ |
| Directiva de privacidad | https://www.bluip.com/company/legal/privacy-policy |
| Categorías | Productividad; Comunicación |
Telefonía Xtended Serv Interf
Integre con el sistema de telefonía de BluIP para llevar la llamada al siguiente nivel. Interfaz de servicio Xtended de telefonía (XSI).
Requisitos previos
Una cuenta de usuario, grupo, empresa o administrador del sistema de BluIP.
Documentación de la API
Obtención de credenciales
Póngase en contacto con el equipo de soporte técnico de BluIP para obtener una cuenta de demostración o detalles sobre su cuenta actual.
Creación de una conexión
El conector admite los siguientes tipos de autenticación:
| Predeterminado | Parámetros para crear una conexión. | Todas las regiones | No se puede compartir |
Predeterminado
Aplicable: Todas las regiones
Parámetros para crear una conexión.
Esta conexión no se puede compartir. Si la aplicación de energía se comparte con otro usuario, se pedirá a otro usuario que cree explícitamente una nueva conexión.
| Nombre | Tipo | Description | Obligatorio |
|---|---|---|---|
| Nombre de usuario | securestring | Nombre de usuario de MasterAccess (usuario, grupo, empresa o administrador del sistema) | Cierto |
| Contraseña | securestring | Contraseña de MasterAccess | Cierto |
Limitaciones
| Nombre | Llamadas | Período de renovación |
|---|---|---|
| Llamadas API por conexión | 100 | 60 segundos |
Acciones
| Alternar el estado de ACD del agente |
Cambie el estado de ACD del agente. |
| Alternar grabación de llamadas |
Alternar el estado de grabación de llamadas. |
| Finalización de la llamada |
Colgar/Finalizar una llamada. |
| Nueva llamada |
Realizar una llamada |
| Obtener llamadas de usuario |
Obtener llamadas de usuario. |
| Obtener perfil de usuario |
Obtener el perfil de usuario. |
| Respuesta de llamada |
Responda a una llamada. |
| Solicitud sin formato |
Envíe una solicitud sin procesar. Busque más recursos en: https://labxsp1.masteraccess.com/com.broadsoft.xsi-actions/test/v2.0/ |
| Suspensión de llamadas |
Ponga una llamada en espera. |
| Transferencia de una llamada |
Transferir una llamada. |
| Transferir llamada al correo de voz |
Transferir la llamada al correo de voz. |
Alternar el estado de ACD del agente
Cambie el estado de ACD del agente.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Estado de ACD del agente
|
agentACDState | True | string |
Estado de ACD del agente |
|
Id. de usuario
|
userID | string |
Id. de usuario |
Alternar grabación de llamadas
Alternar el estado de grabación de llamadas.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Acción
|
action | True | string | |
|
Id. de llamada
|
callId | True | string | |
|
Id. de usuario
|
userId | True | string |
Devoluciones
- response
- object
Finalización de la llamada
Colgar/Finalizar una llamada.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Id. de usuario
|
userId | string |
Identificador de usuario de BluIP. |
|
|
Id. de llamada
|
callId | True | string |
Identificador de llamada de una llamada. |
Nueva llamada
Realizar una llamada
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Id. de usuario
|
userID | string |
Identificador de usuario de BluIP. |
|
|
Número de teléfono
|
address | True | string |
Número de teléfono. |
Obtener llamadas de usuario
Obtener llamadas de usuario.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Id. de usuario
|
userId | True | string |
Identificador de usuario de BluIP. |
Devoluciones
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
|
array of object | ||
|
Id. de llamada
|
callId | string |
Por ejemplo: callhalf-29519312843:0 |
|
URI
|
uri | string |
Por ejemplo: /v2.0/user/user@provider.com/calls/callhalf-29519312843:0 |
Obtener perfil de usuario
Obtener el perfil de usuario.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Id. de usuario
|
userId | True | string |
service@provider.com |
Devoluciones
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
Id. de usuario
|
details.userId | string |
user@bluip.com |
|
Nombre
|
details.firstName | string |
Jordania |
|
Apellido
|
details.lastName | string |
Díaz |
|
Apellidos de Hirangana
|
details.hiranganaLastName | string |
Díaz |
|
Nombre de Hirangana
|
details.hiranganaFirstName | string |
Jordania |
|
Apellido
|
details.nameDialingName.nameDialingLastName | string |
Díaz |
|
Nombre
|
details.nameDialingName.nameDialingFirstName | string |
Jordania |
|
Identificador de grupo
|
details.groupId | integer | |
|
Proveedor de servicios/Id. de empresa
|
details.serviceProvider | string | |
|
Number
|
details.number | integer | |
|
Extension
|
details.extension | integer | |
|
Móvil
|
additionalDetails.mobile | string | |
|
Id. de Yahoo
|
additionalDetails.yahooId | string | |
|
Buscapersonas
|
additionalDetails.pager | string | |
|
Dirección de correo electrónico
|
additionalDetails.emailAddress | string | |
|
Title
|
additionalDetails.title | string | |
|
Ubicación
|
additionalDetails.location | string | |
|
Departamento
|
additionalDetails.department | string | |
|
IM&P
|
additionalDetails.impId | string | |
|
La contraseña expira días
|
passwordExpiresDays | integer | |
|
FAC URI
|
fac | string | |
|
URI de registros
|
registrations | string | |
|
URI de lista de programación
|
scheduleList | string | |
|
URI de cambio de contraseña del portal
|
portalPasswordChange | string | |
|
Código de país
|
countryCode | string |
Respuesta de llamada
Responda a una llamada.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Id. de usuario
|
userId | string |
Identificador de usuario de BluIP. |
|
|
Id. de llamada
|
callId | string |
Llame al identificador de llamada. |
Solicitud sin formato
Envíe una solicitud sin procesar. Busque más recursos en: https://labxsp1.masteraccess.com/com.broadsoft.xsi-actions/test/v2.0/
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Id. de usuario
|
userId | True | string |
Identificador de usuario de BluIP. |
|
Recurso o ruta de acceso
|
path | True | string |
Elija un recurso o escriba la ruta de acceso a un recurso. |
|
Carga
|
payload | string |
Deje vacío en "GET" o incluya la carga útil en los datos "PUT". |
|
|
Aceptar
|
Accept | string |
Aceptar |
Suspensión de llamadas
Ponga una llamada en espera.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Id. de usuario
|
userId | string |
Identificador de usuario de BluIP. |
|
|
Id. de llamada
|
callId | True | string |
Identificador de llamada de una llamada. |
Transferencia de una llamada
Transferir una llamada.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Id. de usuario
|
userId | string |
Identificador de usuario de BluIP. |
|
|
Id. de llamada
|
callId | True | string |
Identificador de llamada de una llamada. |
|
Número de teléfono
|
address | True | string |
Número de teléfono al que se va a transferir. |
Transferir llamada al correo de voz
Transferir la llamada al correo de voz.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Id. de usuario
|
userId | string |
Identificador de usuario de BluIP. |
|
|
Id. de llamada
|
callId | True | string |
Identificador de llamada de una llamada. |
Desencadenadores
| Al no molestar el cambio |
Reaccionar ante el cambio de estado DND de un usuario. |
| En el cambio de cola del centro de llamadas |
Reaccionar a las llamadas en una cola del centro de llamadas. |
| En el cambio de estado de ACD del agente del centro de llamadas |
React to a call center agent's ACD (Automatic Call Distribution) state change. |
| En el cambio de supervisión del centro de llamadas |
React to call center average wait time, calls vs. agent count, etc. |
| Evento On Call |
Cuando ocurre algo con una llamada. |
| Resumen de mensajes de correo de voz |
Reaccionar a mensajes de correo de voz nuevos o eliminados. |
| Suscripción de eventos sin procesar |
Eventos. |
Al no molestar el cambio
Reaccionar ante el cambio de estado DND de un usuario.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Id. de usuario
|
userId | string |
Suscripción de nivel de usuario. |
|
|
Identificador de grupo
|
groupId | string |
Suscripciones de nivel de grupo. |
|
|
Identificador del proveedor de servicios o de empresa
|
enterpriseId | string |
Suscripciones de nivel de proveedor de servicios o de empresa. |
Devoluciones
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
Active
|
active | boolean |
verdadero, falso |
|
Salpicadura de anillo
|
ringSplash | boolean |
verdadero, falso |
|
Id. del evento
|
eventId | string |
d6986908-461e-40b9-85ca-e717851f776c |
|
Id. de usuario o destino
|
targetId | string |
user@bluip.com |
En el cambio de cola del centro de llamadas
Reaccionar a las llamadas en una cola del centro de llamadas.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Identificador de grupo
|
groupId | string |
Suscripciones de nivel de grupo. |
|
|
Identificador del proveedor de servicios o de empresa
|
enterpriseId | string |
Suscripciones de nivel de proveedor de servicios o de empresa. |
Devoluciones
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
Id. de llamada
|
callId | string |
callhalf-31139148485:0 |
|
Id. de seguimiento externo
|
extTrackingId | string |
130080177:2 |
|
Nombre
|
remoteParty.name | string |
Jordan Smith |
|
Mensaje de texto
|
remoteParty.address.#text | string | |
|
Código de país
|
remoteParty.address.countryCode | string |
1, 44, etc. |
|
Tipo de llamada
|
remoteParty.callType | string |
Red, grupo |
|
Agregar hora
|
addTime | integer |
1568213984179 |
|
Nombre de ACD
|
acdName | string |
Centro de llamadas de demostración de BluIP |
|
Mensaje de texto
|
acdNumber.#text | string | |
|
Código de país
|
acdNumber.countryCode | string |
1, 44, etc. |
|
Prioridad de ACD
|
acdPriority | string |
3-Bajo |
|
Agregar tiempo en el cubo de prioridad
|
addTimeInPriorityBucket | integer |
1568213984179 |
|
Tipo
|
type | string |
ACDCallAbandonedEvent, ACDCallAddedEvent, ACDCallOfferedToAgentEvent, ACDWhisperStartedEvent,Available, Sign-In, Sign-Out, Unavailable, Wrap-UpACDCallAnsweredByAgentEvent |
|
Id. del evento
|
eventId | string |
0b5bc6c2-bc74-4234-93f9-2945aca8b215 |
|
Id. de usuario o destino del Centro de llamadas
|
targetId | string |
BluIPCCDemo@bluip.com |
|
Responder al identificador de usuario o destino
|
answeringUserId | string |
user@bluip.com |
|
Id. de llamada de respuesta
|
answeringCallId | string |
callhalf-31139148489:0 |
|
Quitar hora
|
removeTime | integer |
1568213990637 |
En el cambio de estado de ACD del agente del centro de llamadas
React to a call center agent's ACD (Automatic Call Distribution) state change.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Id. de usuario
|
userId | string |
Suscripción de nivel de usuario. |
|
|
Identificador de grupo
|
groupId | string |
Suscripciones de nivel de grupo. |
|
|
Identificador del proveedor de servicios o de empresa
|
enterpriseId | string |
Suscripciones de nivel de proveedor de servicios o de empresa. |
Devoluciones
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
Estado
|
state | string |
Disponible, inicio de sesión, cierre de sesión, no disponible, Wrap-Up |
|
Importancia
|
stateTimestamp.value | integer |
1568212016997 |
|
Marca de tiempo de inicio de sesión
|
signInTimestamp | integer |
1568212016997 |
|
Tiempo total disponible
|
totalAvailableTime | integer |
17, etc. |
|
Código no disponible
|
unavailableCode | integer |
1, 2, 3, 4, etc. |
|
Importancia
|
averageWrapUpTime.value | integer |
0 |
|
Id. del evento
|
eventId | string |
37bacb10-82a5-47ba-8a6f-f9335433e584 |
|
Id. de usuario o destino
|
targetId | string |
user@bluip.com |
En el cambio de supervisión del centro de llamadas
React to call center average wait time, calls vs. agent count, etc.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Identificador de grupo
|
groupId | string |
Suscripciones de nivel de grupo. |
|
|
Identificador del proveedor de servicios o de empresa
|
enterpriseId | string |
Suscripciones de nivel de proveedor de servicios o de empresa. |
Devoluciones
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
Importancia
|
averageHandlingTime.value | integer |
0 |
|
Importancia
|
expectedWaitTime.value | integer |
0 |
|
Importancia
|
averageSpeedOfAnswer.value | integer |
14 622 |
|
Importancia
|
longestWaitTime.value | integer |
5005 |
|
Importancia
|
numCallsInQueue.value | integer |
1 |
|
Número de agentes asignados
|
numAgentsAssigned | integer |
1 |
|
Número de agentes empleados
|
numAgentsStaffed | integer |
1 |
|
Número de agentes con personal inactivo
|
numStaffedAgentsIdle | integer |
0 |
|
Número de agentes con personal no disponible
|
numStaffedAgentsUnavailable | integer |
0 |
|
Id. del evento
|
eventId | string |
795db7d3-1461-48dd-8a33-65cfdc9dab00 |
|
Id. de usuario o destino del Centro de llamadas
|
targetId | string |
BluIPCCDemo@bluip.com |
Evento On Call
Cuando ocurre algo con una llamada.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Id. de usuario
|
userId | string |
Suscripción de nivel de usuario. |
|
|
Identificador de grupo
|
groupId | string |
Suscripciones de nivel de grupo. |
|
|
Identificador del proveedor de servicios o de empresa
|
enterpriseId | string |
Suscripciones de nivel de proveedor de servicios o de empresa. |
|
|
Tipo
|
type | string |
Tipo específico de evento de llamada. |
Devoluciones
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
Tipo
|
type | string |
CallAnsweredEvent, CallBargedInEvent, CallCollectingEvent, CallHeldEvent, HookStatusEvent, CallMonitoredEvent, CallOriginatedEvent, CallOriginatingEvent, CallPickedUpEvent, CallReceivedEvent, CallRecordingPausedEvent, CallRecordingResumedEvent, CallRecordingStartedEvent, CallRecordingStartingEvent, CallRecordingStoppedEvent, CallRedirectedEvent, CallReleasedEvent, CallReleasingEvent, CallRetrievedEvent, CallTransferredEvent, CallUpdatedEvent |
|
Estado del enlace
|
hookStatus | string |
Off-Hook, On-Hook |
|
Id. del evento
|
eventId | string |
d5e21e5d-7f54-4db3-8351-4302e8dbf941 |
|
Id. de usuario o destino
|
targetId | string |
user@bluip.com |
|
Event
|
event | string |
Llamada avanzada |
|
Id. de llamada
|
callId | string |
callhalf-31126219817:0 |
|
Id. de seguimiento externo
|
extTrackingId | string |
129987974:2 |
|
Identificador de llamada de red
|
networkCallId | string |
2002829250_115291504@207.223.XX.XXX |
|
Personalidad
|
personality | string |
Terminador, originador |
|
Estado
|
state | string |
Alertas, activas, mantenidas, desasociadas |
|
Hora de comienzo
|
startTime | integer |
1568204580687 |
|
Nombre
|
remoteParty.name | string |
Jordan Smith |
|
Mensaje de texto
|
remoteParty.address.#text | string | |
|
Código de país
|
remoteParty.address.countryCode | string |
1 |
|
NPA
|
remoteParty.address.npa | string |
818-XXX-XXXX |
|
NXX
|
remoteParty.address.nxx | string |
XXX-867-XXXX |
|
Tipo de llamada
|
remoteParty.callType | string |
Red, grupo |
|
Id. de usuario
|
remoteParty.userId | string |
user@bluip.com |
|
Mensaje de texto
|
remoteParty.userDN.#text | string | |
|
Código de país
|
remoteParty.userDN.countryCode | string |
1, 44, etc. |
|
Tipo
|
endpoint.type | string |
AccessEndpoint |
|
Dirección del registro
|
endpoint.addressOfRecord | string |
user@bluip.com |
|
Aspecto
|
appearance | integer |
1, 2, etc. |
|
Permitir respuesta
|
allowAnswer | string | |
|
Tiempo de respuesta
|
answerTime | integer |
1568204585231 |
|
Controles de grabación permitidos
|
allowedRecordingControls | string |
none, pause, resume |
|
Clasificación de seguridad
|
securityClassification | string |
Clasificado, sin clasificar |
|
Grabado
|
recorded | string | |
|
Estado de grabación
|
recordingState | string |
Iniciado, en pausa |
|
Permitir recuperar
|
allowRetrieve | string | |
|
Tiempo de celebración
|
heldTime | integer |
1568204589829 |
|
Tiempo total mantenido
|
totalHeldTime | integer |
4172 |
|
Call
|
call | array of |
Matriz de llamadas cuando hay más de una llamada assosiada. |
|
Hora desasociada
|
detachedTime | integer |
1568204605894 |
|
Hora de lanzamiento
|
releaseTime | integer |
1568204620298 |
|
Fiesta de lanzamiento
|
releasingParty | string |
localRelease, remoteRelease |
|
Mensaje de texto
|
redirect.address.#text | string | |
|
Código de país
|
redirect.address.countryCode | string |
1, 44, etc. |
|
Motivo
|
redirect.reason | string |
transferencia |
|
Hora de redirección
|
redirect.redirectTime | integer |
1568204605894 |
Resumen de mensajes de correo de voz
Reaccionar a mensajes de correo de voz nuevos o eliminados.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Id. de usuario
|
userId | string |
Suscripción de nivel de usuario. |
|
|
Identificador de grupo
|
groupId | string |
Suscripciones de nivel de grupo. |
|
|
Identificador del proveedor de servicios o de empresa
|
enterpriseId | string |
Suscripciones de nivel de proveedor de servicios o de empresa. |
Devoluciones
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
Nuevos mensajes
|
newMessages | integer |
1, 2, 3, etc. |
|
Mensajes antiguos
|
oldMessages | integer |
1, 2, 3, etc. |
Suscripción de eventos sin procesar
Eventos.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Id. de usuario
|
userId | string |
Suscripción de nivel de usuario. |
|
|
Identificador de grupo
|
groupId | string |
Suscripciones de nivel de grupo. |
|
|
Identificador del proveedor de servicios o de empresa
|
enterpriseId | string |
Suscripciones de nivel de proveedor de servicios o de empresa. |
|
|
Event
|
event | True | string |
Evento al que suscribirse. |
|
Tipo
|
type | string |
Tipo específico de evento: CallAnsweredEvent, CallReceivedEvent |
Devoluciones
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
Id. de usuario o destino
|
targetId | string |
Usuario de destino del evento. |
|
Event
|
event | string |
Tipo de evento. |
|
Id. del evento
|
eventId | string |
Identificador de evento. |
|
Tipo
|
type | string |
Tipo de evento. |
Definiciones
objeto
Este es el tipo 'objeto'.