Przejdź do głównej zawartości

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​

web-softphone.png

Figure 78.1 Web Softphone

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}
  • login: użytkownik pomyślnie zalogował się do WebSoftphone:
    • dane zdarzenia: {"userId":10002,"userToken":"abcdef9dcec5185987654321"}
  • 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łanie successCalback lub failureCallback
  • WebSoftphone.logout(): wylogowanie z WebSoftphone
  • WebSoftphone.call(number): wykonanie połączenia wychodzącego na numer number
  • WebSoftphone.answer(): odebranie dzwoniącego połączenia przychodzącego
  • WebSoftphone.hangup(): zakończenie połączenia
  • WebSoftphone.hold(): zawieszenie połączenia
  • WebSoftphone.unhold(): wznowienie zawieszonego połączenia
  • WebSoftphone.mute(): wyciszenie mikrofonu
  • WebSoftphone.unmute(): wyłączenie wyciszenia mikrofonu
  • WebSoftphone.wrapUpClose: zamknięcie panelu wrap-up kolejki

Działającą przykładową implementację znajdziesz na GitHubie.