Integracje - Web Phone
Voipstudio oferuje hostowany widżet telefonu internetowego WebRTC, który można łatwo osadzić w dowolnej aplikacji HTML. To prosty sposób na udostępnienie telefonii VoIP we własnych systemach CRM i innych aplikacjach internetowych.
Instalacja

Telefon internetowy Voipstudio jest dostępny pod adresem https://voipstudio.com/webphone/ - aby dodać go do własnej strony internetowej, użyj znacznika iframe jak poniżej:
<iframe id="webphone" src="https://voipstudio.com/webphone/" height="600" width="400" allow="microphone" title="VoIPstudio Web Phone"></iframe>
W efekcie widżet Web Softphone zostanie osadzony na stronie internetowej.
Wykonywanie i odbieranie połączeń
Aby zacząć wykonywać i odbierać połączenia w Voipstudio Web Softphone, zaloguj się za pomocą adresu e-mail i hasła do Voipstudio. Następnie wprowadź na klawiaturze numer, pod który chcesz zadzwonić, i kliknij przycisk Call.
JavaScript API
Voipstudio WebPhone zawiera proste w użyciu JavaScript API z metodami pozwalającymi sterować softphone'em z kodu innych aplikacji. Instancja WebPhone emituje też zdarzenia, które dowolna aplikacja internetowa może wykorzystać, aby łatwo dodać funkcje telefonii VoIP.
Aby korzystać z JavaScript API, oprócz dodania elementu IFRAME w sposób opisany powyżej dodaj również poniższy kod do sekcji <head> swojej strony:
<script type="text/javascript" src="https://voipstudio.com/webphone/api.js"></script>
Następnie można zainicjować instancję WebSoftphone w następujący sposób:
var webPhone = __webphone.init(document.getElementById('webphone'));
Zdarzenia
Instancja WebSoftphone emituje następujące zdarzenia:
ready: instancja WebSoftphone jest gotowa do użycia, dodatkowo dostępne są następujące dane:- dla zalogowanego użytkownika:
{"logged":true,"userId":10002,"userToken":"abcdef9dcec5185987654321"} - dla niezalogowanego softphone'a:
{"logged":false}
- dla zalogowanego użytkownika:
login: użytkownik pomyślnie zalogował się do WebSoftphone:- dane zdarzenia:
{"userId":10002,"userToken":"abcdef9dcec5185987654321"}
- dane zdarzenia:
logout: użytkownik wylogował się z WebSoftphone
Dodatkowo, gdy zmienia się stan połączenia, emitowane są następujące zdarzenia:
-
initial: trwa łączenie połączenia wychodzącego -
ringing: dzwoni połączenie przychodzące -
accepted: połączenie przychodzące lub wychodzące zostało nawiązane -
hangup: połączenie przychodzące lub wychodzące zostało zakończone -
hold: połączenie zostało zawieszone -
unhold: połączenie zostało wznowione -
callstate: zbiorcze zdarzenie zmiany stanu połączenia, emitowane przy każdym z opisanych wyżej zdarzeń
Metody
Na instancji WebSoftphone można wywołać następujące metody:
WebSoftphone.login(email, password, successCalback, failureCallback): logowanie za pomocą adresu e-mail i hasła oraz wywołaniesuccessCalbacklubfailureCallbackWebSoftphone.logout(): wylogowanie z WebSoftphoneWebSoftphone.call(number): wykonanie połączenia wychodzącego na numernumberWebSoftphone.answer(): odebranie dzwoniącego połączenia przychodzącegoWebSoftphone.hangup(): zakończenie połączeniaWebSoftphone.hold(): zawieszenie połączeniaWebSoftphone.unhold(): wznowienie zawieszonego połączeniaWebSoftphone.mute(): wyciszenie mikrofonuWebSoftphone.unmute(): wyłączenie wyciszenia mikrofonuWebSoftphone.wrapUpClose: zamknięcie panelu wrap-up kolejki
Działającą przykładową implementację znajdziesz na GitHubie.