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

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}
- para un usuario con la sesión iniciada:
login: el usuario ha iniciado sesión correctamente en WebSoftphone:- datos del evento:
{"userId":10002,"userToken":"abcdef9dcec5185987654321"}
- datos del evento:
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 ejecutasuccessCalbackofailureCallbackWebSoftphone.logout(): cierra la sesión de WebSoftphoneWebSoftphone.call(number): realiza una llamada saliente anumberWebSoftphone.answer(): contesta una llamada entrante que está sonandoWebSoftphone.hangup(): finaliza la llamadaWebSoftphone.hold(): pone la llamada en esperaWebSoftphone.unhold(): recupera la llamada en esperaWebSoftphone.mute(): silencia la entrada del micrófonoWebSoftphone.unmute(): reactiva la entrada del micrófonoWebSoftphone.wrapUpClose: cierra el panel de wrap-up de la cola
Puede encontrar una implementación de demostración que funciona en GitHub.