Aracılığıyla paylaş

Telefon Xtended Serv Interf (Önizleme)

Aramanızı bir üst düzeye çıkarmak için BluIP'in telefon sistemiyle tümleştirin. Telefon Xtended Hizmet Arabirimi (XSI).

Bu bağlayıcı aşağıdaki ürün ve bölgelerde kullanılabilir:

Hizmet Class Bölgeler
Copilot Studio Premium Aşağıdakiler dışında tüm Power Automate bölgeleri :
     - ABD Kamu (GCC)
     - US Government (GCC High)
     - 21Vianet tarafından işletilen Çin Bulutu
     - ABD Savunma Bakanlığı (DoD)
Logic Apps Standart Aşağıdakiler dışında tüm Logic Apps bölgeleri :
     - Azure Kamu bölgeleri
     - Azure Çin bölgeleri
     - ABD Savunma Bakanlığı (DoD)
Power Apps Premium Aşağıdakiler dışında tüm Power Apps bölgeleri :
     - ABD Kamu (GCC)
     - US Government (GCC High)
     - 21Vianet tarafından işletilen Çin Bulutu
     - ABD Savunma Bakanlığı (DoD)
Power Automate Premium Aşağıdakiler dışında tüm Power Automate bölgeleri :
     - ABD Kamu (GCC)
     - US Government (GCC High)
     - 21Vianet tarafından işletilen Çin Bulutu
     - ABD Savunma Bakanlığı (DoD)
İletişim
İsim BluIP Desteği
URL https://support.bluip.com
E-posta developers@bluip.com
Bağlayıcı Meta Verileri
Publisher BluIP, Inc.
Web sitesi https://www.bluip.com/
Gizlilik ilkesi https://www.bluip.com/company/legal/privacy-policy
Kategoriler Verimli -lik; İletişim

Telefon Xtended Serv Interf

Aramanızı bir üst düzeye çıkarmak için BluIP'in telefon sistemiyle tümleştirin. Telefon Xtended Hizmet Arabirimi (XSI).

Pre-requisites

BluIP kullanıcı, grup, kuruluş veya sistem yöneticisi hesabı.

API belgeleri

https://support.bluip.com

Kimlik bilgilerini alma

Demo hesabı veya geçerli hesabınızla ilgili ayrıntılar için BluIP'in destek ekibine başvurun.

Bağlantı oluşturma

Bağlayıcı aşağıdaki kimlik doğrulama türlerini destekler:
Varsayılan Bağlantı oluşturmak için parametreler. Tüm bölgeler Paylaşılamaz

Temerrüt

Geçerli: Tüm bölgeler

Bağlantı oluşturmak için parametreler.

Bu, paylaşılabilir bir bağlantı değildir. Power app başka bir kullanıcıyla paylaşılıyorsa, başka bir kullanıcıdan açıkça yeni bağlantı oluşturması istenir.

İsim Türü Description Gerekli
Kullanıcı adı securestring MasterAccess Kullanıcı Adı (Kullanıcı, Grup, Kuruluş veya Sistem Yöneticisi) Doğru
Şifre securestring MasterAccess Parolası Doğru

Azaltma Sınırları

Name Çağrılar Yenileme Dönemi
Bağlantı başına API çağrıları 100 60 saniye

Eylemler

Aracı ACD Durumunu Değiştir

Aracı ACD Durumu'na geçin.
Arama Kaydını Aç/Kapat

Arama kayıt durumunu değiştirme.
Arama Sonu

Askıda kalma/Aramayı sonlandırma.
Arama Yanıtı

Bir aramayı yanıtlayın.
Aramayı Aktarma

Aramayı aktarma.
Aramayı Sesli Mesaja Aktarma

Aramayı sesli mesaja aktar.
Beklemeye Alma Çağrısı

Aramayı beklemeye alma.
Ham İstek

Ham istek gönderin. Daha fazla kaynağı şu konumda bulabilirsiniz: https://labxsp1.masteraccess.com/com.broadsoft.xsi-actions/test/v2.0/
Kullanıcı Profili Al

Kullanıcı profilini alın.
Kullanıcı Çağrıları Alma

Kullanıcı çağrıları alın.
Yeni Arama

Arama yap

Aracı ACD Durumunu Değiştir

İşlem Kimliği:
toggle.AgentACDState

Aracı ACD Durumu'na geçin.

Parametreler

Name Anahtar Gerekli Tür Description
Aracı ACD Durumu
 agentACDState True string

Aracı ACD Durumu
Kullanıcı kimliği
 userID string

Kullanıcı kimliği

Arama Kaydını Aç/Kapat

İşlem Kimliği:
call.recording

Arama kayıt durumunu değiştirme.

Parametreler

Name Anahtar Gerekli Tür Description
Eylem
 action True string
Arama Kimliği
 callId True string
Kullanıcı kimliği
 userId True string

Döndürülenler

response
object

Arama Sonu

İşlem Kimliği:
call.End

Askıda kalma/Aramayı sonlandırma.

Parametreler

Name Anahtar Gerekli Tür Description
Kullanıcı kimliği
 userId string

BluIP Kullanıcı Kimliği.
Arama Kimliği
 callId True string

Aramanın arama kimliği.

Arama Yanıtı

İşlem Kimliği:
call.Answer

Bir aramayı yanıtlayın.

Parametreler

Name Anahtar Gerekli Tür Description
Kullanıcı kimliği
 userId string

BluIP Kullanıcı Kimliği.
Arama Kimliği
 callId string

Arama Kimliği.

Aramayı Aktarma

İşlem Kimliği:
call.Transfer

Aramayı aktarma.

Parametreler

Name Anahtar Gerekli Tür Description
Kullanıcı kimliği
 userId string

BluIP Kullanıcı Kimliği.
Arama Kimliği
 callId True string

Aramanın arama kimliği.
Telefon Numarası
 address True string

Aktaracak telefon numarası.

Aramayı Sesli Mesaja Aktarma

İşlem Kimliği:
call.TransfertoVoicemail

Aramayı sesli mesaja aktar.

Parametreler

Name Anahtar Gerekli Tür Description
Kullanıcı kimliği
 userId string

BluIP Kullanıcı Kimliği.
Arama Kimliği
 callId True string

Aramanın arama kimliği.

Beklemeye Alma Çağrısı

İşlem Kimliği:
call.Hold

Aramayı beklemeye alma.

Parametreler

Name Anahtar Gerekli Tür Description
Kullanıcı kimliği
 userId string

BluIP Kullanıcı Kimliği.
Arama Kimliği
 callId True string

Aramanın arama kimliği.

Ham İstek

İşlem Kimliği:
raw

Ham istek gönderin. Daha fazla kaynağı şu konumda bulabilirsiniz: https://labxsp1.masteraccess.com/com.broadsoft.xsi-actions/test/v2.0/

Parametreler

Name Anahtar Gerekli Tür Description
Kullanıcı kimliği
 userId True string

BluIP Kullanıcı Kimliği.
Kaynak/Yol
 path True string

Bir kaynak seçin veya kaynağın yolunu girin.
Yük
 payload string

"GET" için boş bırakın veya "PUT" verilerine yük ekleyin.
Kabul etmek
 Accept string

Kabul etmek

Kullanıcı Profili Al

İşlem Kimliği:
user.profile

Kullanıcı profilini alın.

Parametreler

Name Anahtar Gerekli Tür Description
Kullanıcı kimliği
 userId True string

service@provider.com

Döndürülenler

Name Yol Tür Description
Kullanıcı kimliği
 details.userId string

user@bluip.com
İlk İsim
 details.firstName string

Ürdün
Soyadı
 details.lastName string

Smith
Hirangana Soyadı
 details.hiranganaLastName string

Smith
Hirangana Adı
 details.hiranganaFirstName string

Ürdün
Soyadı
 details.nameDialingName.nameDialingLastName string

Smith
İlk İsim
 details.nameDialingName.nameDialingFirstName string

Ürdün
Grup Kimliği
 details.groupId integer
Hizmet Sağlayıcısı/Kurumsal Kimlik
 details.serviceProvider string
Sayı
 details.number integer
Extension
 details.extension integer
Cep telefonu
 additionalDetails.mobile string
Yahoo Kimliği
 additionalDetails.yahooId string
Çağrı cihazı
 additionalDetails.pager string
E-posta Adresi
 additionalDetails.emailAddress string
Başlık
 additionalDetails.title string
Yer
 additionalDetails.location string
Departman
 additionalDetails.department string
Anlık İleti &P
 additionalDetails.impId string
Parolanın Süresi Dolan Günler
 passwordExpiresDays integer
FAC URI
 fac string
Kayıt URI'si
 registrations string
Zamanlama Listesi URI'si
 scheduleList string
Portal Parola Değişikliği URI'sini
 portalPasswordChange string
Ülke Kodu
 countryCode string

Kullanıcı Çağrıları Alma

İşlem Kimliği:
user.calls

Kullanıcı çağrıları alın.

Parametreler

Name Anahtar Gerekli Tür Description
Kullanıcı kimliği
 userId True string

BluIP Kullanıcı Kimliği.

Döndürülenler

Name Yol Tür Description
array of object
Arama Kimliği
 callId string

Örn: callhalf-29519312843:0
URI
 uri string

Örneğin: /v2.0/user/user@provider.com/calls/callhalf-29519312843:0

Yeni Arama

İşlem Kimliği:
call.New

Arama yap

Parametreler

Name Anahtar Gerekli Tür Description
Kullanıcı kimliği
 userID string

BluIP Kullanıcı Kimliği.
Telefon Numarası
 address True string

Telefon numarası.

Tetikleyiciler

Arama Olayında

Bir aramaya bir şey olduğunda.
Ham Olay Aboneliği

Etkinlikler.
Rahatsız Etmeyin Değişikliğinde

Kullanıcının DND durum değişikliğine tepki verme.
Sesli MesajDa Özeti

Yeni veya kaldırılan sesli mesaj iletilerine tepki verme.
Çağrı Merkezi Aracısı ACD Durum Değişikliğinde

Çağrı merkezi aracısının ACD (Otomatik Çağrı Dağıtımı) durum değişikliğine tepki verme.
Çağrı Merkezi İzleme Değişikliğinde

Çağrı merkezi ortalama bekleme süresine, aramalara ve aracı sayısına vb. tepki verme.
Çağrı Merkezi Kuyruk Değişikliğinde

Çağrı merkezi kuyruğundaki çağrılara tepki verme.

Arama Olayında

İşlem Kimliği:
events.call

Bir aramaya bir şey olduğunda.

Parametreler

Name Anahtar Gerekli Tür Description
Kullanıcı kimliği
 userId string

Kullanıcı düzeyi aboneliği.
Grup Kimliği
 groupId string

Grup düzeyi abonelikler.
Kurumsal/Hizmet Sağlayıcısı Kimliği
 enterpriseId string

Kurumsal/Hizmet Sağlayıcısı düzeyi abonelikleri.
Türü
 type string

Belirli bir çağrı olayı türü.

Döndürülenler

Name Yol Tür Description
Türü
 type string

CallAnsweredEvent, CallBargedInEvent, CallCollectingEvent, CallHeldEvent, HookStatusEvent, CallMonitoredEvent, CallOriginatedEvent, CallOriginatingEvent, CallPickedUpEvent, CallReceivedEvent, CallRecordingPausedEvent, CallRecordingResumedEvent, CallRecordingStartedEvent, CallRecordingStartingEvent, CallRecordingStoppedEvent, CallRedirectedEvent, CallReleasedEvent, CallReleasingEvent, CallRetrievedEvent, CallTransferredEvent, CallUpdatedEvent
Kanca Durumu
 hookStatus string

Kancalı, Kancalı
Olay Kimliği
 eventId string

d5e21e5d-7f54-4db3-8351-4302e8dbf941
Kullanıcı/Hedef Kimliği
 targetId string

user@bluip.com
Event
 event string

Gelişmiş Arama
Arama Kimliği
 callId string

callhalf-31126219817:0
Dış İzleme Kimliği
 extTrackingId string

129987974:2
Ağ Çağrısı Kimliği
 networkCallId string

2002829250_115291504@207.223.XX.XXX
Kişilik
 personality string

Sonlandırıcı, Kaynak
Devlet
 state string

Uyarı, Etkin, Tutulan, Ayrılmış
Başlangıç Saati
 startTime integer

1568204580687
İsim
 remoteParty.name string

Jordan Smith
Metin
 remoteParty.address.#text string

+18188675309
Ülke Kodu
 remoteParty.address.countryCode string

1
NPA
 remoteParty.address.npa string

818-XXX-XXXX
NXX
 remoteParty.address.nxx string

XXX-867-XXXX
Arama Türü
 remoteParty.callType string

Ağ, Grup
Kullanıcı kimliği
 remoteParty.userId string

user@bluip.com
Metin
 remoteParty.userDN.#text string

+17026904400; ext=4400
Ülke Kodu
 remoteParty.userDN.countryCode string

1, 44 vb.
Türü
 endpoint.type string

AccessEndpoint
Kaydın Adresi
 endpoint.addressOfRecord string

user@bluip.com
Görünüş
 appearance integer

1, 2 vb.
Yanıta İzin Ver
 allowAnswer string
Yanıt Süresi
 answerTime integer

1568204585231
İzin Verilen Kayıt Denetimleri
 allowedRecordingControls string

none, pause, resume
Güvenlik Sınıflandırması
 securityClassification string

Sınıflandırılmış, Sınıflandırılmamış
Kaydedilen
 recorded string
Kayıt Durumu
 recordingState string

Başlatıldı, Duraklatıldı
Alma İzin Ver
 allowRetrieve string
Tutulan Süre
 heldTime integer

1568204589829
Toplam Tutulan Süre
 totalHeldTime integer

4172
Call
 call array of

Birden fazla çağrı ilişkilendirildiğinde çağrı dizisi.
Ayrılan Zaman
 detachedTime integer

1568204605894
Sürüm Zamanı
 releaseTime integer

1568204620298
YayınLayan Taraf
 releasingParty string

localRelease, remoteRelease
Metin
 redirect.address.#text string

+18188675309
Ülke Kodu
 redirect.address.countryCode string

1, 44 vb.
Reason
 redirect.reason string

aktarmak
Yeniden Yönlendirme Zamanı
 redirect.redirectTime integer

1568204605894

Ham Olay Aboneliği

İşlem Kimliği:
events

Etkinlikler.

Parametreler

Name Anahtar Gerekli Tür Description
Kullanıcı kimliği
 userId string

Kullanıcı düzeyi aboneliği.
Grup Kimliği
 groupId string

Grup düzeyi abonelikler.
Kurumsal/Hizmet Sağlayıcısı Kimliği
 enterpriseId string

Kurumsal/Hizmet Sağlayıcısı düzeyi abonelikleri.
Event
 event True string

Abone olunacak olay.
Türü
 type string

Belirli olay türü: CallAnsweredEvent, CallReceivedEvent

Döndürülenler

Name Yol Tür Description
Kullanıcı/Hedef Kimliği
 targetId string

Olay hedefi kullanıcısı.
Event
 event string

Olay türü.
Olay Kimliği
 eventId string

Olay kimliği.
Türü
 type string

Olay türü.

Rahatsız Etmeyin Değişikliğinde

İşlem Kimliği:
events.doNotDisturb

Kullanıcının DND durum değişikliğine tepki verme.

Parametreler

Name Anahtar Gerekli Tür Description
Kullanıcı kimliği
 userId string

Kullanıcı düzeyi aboneliği.
Grup Kimliği
 groupId string

Grup düzeyi abonelikler.
Kurumsal/Hizmet Sağlayıcısı Kimliği
 enterpriseId string

Kurumsal/Hizmet Sağlayıcısı düzeyi abonelikleri.

Döndürülenler

Name Yol Tür Description
Aktif
 active boolean

doğru, yanlış
Halka Sıçraması
 ringSplash boolean

doğru, yanlış
Olay Kimliği
 eventId string

d6986908-461e-40b9-85ca-e717851f776c
Kullanıcı/Hedef Kimliği
 targetId string

user@bluip.com

Sesli MesajDa Özeti

İşlem Kimliği:
events.voicemail

Yeni veya kaldırılan sesli mesaj iletilerine tepki verme.

Parametreler

Name Anahtar Gerekli Tür Description
Kullanıcı kimliği
 userId string

Kullanıcı düzeyi aboneliği.
Grup Kimliği
 groupId string

Grup düzeyi abonelikler.
Kurumsal/Hizmet Sağlayıcısı Kimliği
 enterpriseId string

Kurumsal/Hizmet Sağlayıcısı düzeyi abonelikleri.

Döndürülenler

Name Yol Tür Description
Yeni İletiler
 newMessages integer

1, 2, 3 vb.
Eski İletiler
 oldMessages integer

1, 2, 3 vb.

Çağrı Merkezi Aracısı ACD Durum Değişikliğinde

İşlem Kimliği:
events.callCenterAgent

Çağrı merkezi aracısının ACD (Otomatik Çağrı Dağıtımı) durum değişikliğine tepki verme.

Parametreler

Name Anahtar Gerekli Tür Description
Kullanıcı kimliği
 userId string

Kullanıcı düzeyi aboneliği.
Grup Kimliği
 groupId string

Grup düzeyi abonelikler.
Kurumsal/Hizmet Sağlayıcısı Kimliği
 enterpriseId string

Kurumsal/Hizmet Sağlayıcısı düzeyi abonelikleri.

Döndürülenler

Name Yol Tür Description
Devlet
 state string

Kullanılabilir, Oturum Açma, Oturum Kapatma, Kullanılamıyor, Wrap-Up
Değer
 stateTimestamp.value integer

1568212016997
Oturum Açma Zaman Damgası
 signInTimestamp integer

1568212016997
Toplam Kullanılabilir Süre
 totalAvailableTime integer

17, vb.
Kullanılamayan Kod
 unavailableCode integer

1, 2, 3, 4 vb.
Değer
 averageWrapUpTime.value integer

0
Olay Kimliği
 eventId string

37bacb10-82a5-47ba-8a6f-f9335433e584
Kullanıcı/Hedef Kimliği
 targetId string

user@bluip.com

Çağrı Merkezi İzleme Değişikliğinde

İşlem Kimliği:
events.callCenterMonitoring

Çağrı merkezi ortalama bekleme süresine, aramalara ve aracı sayısına vb. tepki verme.

Parametreler

Name Anahtar Gerekli Tür Description
Grup Kimliği
 groupId string

Grup düzeyi abonelikler.
Kurumsal/Hizmet Sağlayıcısı Kimliği
 enterpriseId string

Kurumsal/Hizmet Sağlayıcısı düzeyi abonelikleri.

Döndürülenler

Name Yol Tür Description
Değer
 averageHandlingTime.value integer

0
Değer
 expectedWaitTime.value integer

0
Değer
 averageSpeedOfAnswer.value integer

14622
Değer
 longestWaitTime.value integer

5005
Değer
 numCallsInQueue.value integer

1
Atanan Aracı Sayısı
 numAgentsAssigned integer

1
PersonelLi Aracı Sayısı
 numAgentsStaffed integer

1
Boşta Çalışan Aracı Sayısı
 numStaffedAgentsIdle integer

0
Kullanılamayan PersonelLi Aracı Sayısı
 numStaffedAgentsUnavailable integer

0
Olay Kimliği
 eventId string

795db7d3-1461-48dd-8a33-65cfdc9dab00
Çağrı Merkezi Kullanıcı/Hedef Kimliği
 targetId string

BluIPCCDemo@bluip.com

Çağrı Merkezi Kuyruk Değişikliğinde

İşlem Kimliği:
events.callCenterQueue

Çağrı merkezi kuyruğundaki çağrılara tepki verme.

Parametreler

Name Anahtar Gerekli Tür Description
Grup Kimliği
 groupId string

Grup düzeyi abonelikler.
Kurumsal/Hizmet Sağlayıcısı Kimliği
 enterpriseId string

Kurumsal/Hizmet Sağlayıcısı düzeyi abonelikleri.

Döndürülenler

Name Yol Tür Description
Arama Kimliği
 callId string

callhalf-31139148485:0
Dış İzleme Kimliği
 extTrackingId string

130080177:2
İsim
 remoteParty.name string

Jordan Smith
Metin
 remoteParty.address.#text string

+18188675309
Ülke Kodu
 remoteParty.address.countryCode string

1, 44 vb.
Arama Türü
 remoteParty.callType string

Ağ, Grup
Saat Ekle
 addTime integer

1568213984179
ACD Adı
 acdName string

BluIP Tanıtım Çağrı Merkezi
Metin
 acdNumber.#text string

+17026904381
Ülke Kodu
 acdNumber.countryCode string

1, 44 vb.
ACD Önceliği
 acdPriority string

3-Düşük
Öncelik Demetine Zaman Ekleme
 addTimeInPriorityBucket integer

1568213984179
Türü
 type string

ACDCallAbandonedEvent, ACDCallAddedEvent, ACDCallOfferedToAgentEvent, ACDWhisperStartedEvent,Available, Sign-In, Sign-Out, Available, Wrap-UpACDCallAnsweredByAgentEvent
Olay Kimliği
 eventId string

0b5bc6c2-bc74-4234-93f9-2945aca8b215
Çağrı Merkezi Kullanıcı/Hedef Kimliği
 targetId string

BluIPCCDemo@bluip.com
Kullanıcı/Hedef Kimliğini Yanıtlama
 answeringUserId string

user@bluip.com
Arama Kimliği Yanıtleniyor
 answeringCallId string

callhalf-31139148489:0
Saati Kaldır
 removeTime integer

1568213990637

Tanımlar

object

Bu , 'object' türüdür.