Saltar al contenido principal

Integraciones - Web Phone

Voipstudio ofrece un widget de teléfono web WebRTC alojado que se puede integrar fácilmente en cualquier aplicación HTML. Es una forma sencilla de habilitar la telefonía VoIP en sistemas CRM personalizados y en otras aplicaciones web.

Instalación​

web-softphone.png

Figura 78.1 Web Softphone

El teléfono web de Voipstudio está disponible en https://voipstudio.com/webphone/ - para añadirlo a su propio sitio web, utilice la etiqueta iframe como se muestra a continuación:

<iframe id="webphone" src="https://voipstudio.com/webphone/" height="600" width="400" allow="microphone" title="VoIPstudio Web Phone"></iframe>

Con esto, el widget Web Softphone quedará integrado en la página web.

Realizar y recibir llamadas​

Para empezar a realizar y recibir llamadas con Voipstudio Web Softphone, inicie sesión con su dirección de email y contraseña de Voipstudio. A continuación, introduzca con el teclado el número que desea marcar y haga clic en el botón Call.

API de JavaScript​

Voipstudio WebPhone incluye una API de JavaScript fácil de usar, con métodos que permiten controlar el softphone desde código de terceros. La instancia de WebPhone también emite eventos que cualquier aplicación web puede utilizar para añadir fácilmente funciones de telefonía VoIP.

Para utilizar la API de JavaScript, además de añadir el elemento IFRAME como se ha descrito arriba, añada también lo siguiente a la sección <head> de su página:

<script type="text/javascript" src="https://voipstudio.com/webphone/api.js"></script>

A continuación, se puede inicializar una instancia de WebSoftphone como se muestra:

var webPhone = __webphone.init(document.getElementById('webphone'));

Eventos​

La instancia de WebSoftphone emite los eventos que se describen a continuación:

  • ready: la instancia de WebSoftphone está lista para usarse; además, están disponibles los siguientes datos:
    • para un usuario con la sesión iniciada: {"logged":true,"userId":10002,"userToken":"abcdef9dcec5185987654321"}
    • para un softphone sin autenticar: {"logged":false}
  • login: el usuario ha iniciado sesión correctamente en WebSoftphone:
    • datos del evento: {"userId":10002,"userToken":"abcdef9dcec5185987654321"}
  • logout: el usuario ha cerrado la sesión de WebSoftphone

Además, se emiten los siguientes eventos cuando cambia el estado de una llamada:

  • initial: se está conectando una llamada saliente

  • ringing: está sonando una llamada entrante

  • accepted: se ha conectado una llamada entrante o saliente

  • hangup: ha finalizado una llamada entrante o saliente

  • hold: la llamada se ha puesto en espera

  • unhold: la llamada se ha recuperado de la espera

  • callstate: evento general de cambio de estado de llamada; se emite con cualquiera de los eventos de llamada descritos arriba

Métodos​

Se pueden ejecutar los siguientes métodos en la instancia de WebSoftphone:

  • WebSoftphone.login(email, password, successCalback, failureCallback): inicia sesión con email y contraseña y ejecuta successCalback o failureCallback
  • WebSoftphone.logout(): cierra la sesión de WebSoftphone
  • WebSoftphone.call(number): realiza una llamada saliente a number
  • WebSoftphone.answer(): contesta una llamada entrante que está sonando
  • WebSoftphone.hangup(): finaliza la llamada
  • WebSoftphone.hold(): pone la llamada en espera
  • WebSoftphone.unhold(): recupera la llamada en espera
  • WebSoftphone.mute(): silencia la entrada del micrófono
  • WebSoftphone.unmute(): reactiva la entrada del micrófono
  • WebSoftphone.wrapUpClose: cierra el panel de wrap-up de la cola

Puede encontrar una implementación de demostración que funciona en GitHub.