Añadir llamadas del navegador con Webphone SDK

Usa el SDK actual, conserva credenciales permanentes en el servidor y prueba llamadas de forma segura.

Empezar con el paquete y referencia compatibles

Abre Documentación API → Webphone SDK. Descarga el paquete web o recursos documentados y sigue ejemplos de la misma versión. Lee avisos de seguridad antes de integrar una copia antigua. Es un SDK web, no un reemplazo de llamadas móviles nativas.

El desarrollador debe preparar una aplicación HTTPS autenticada, identidad SIP permitida, permisos de micrófono y recursos del SDK actual. El SDK Playground ayuda a comprobar cuenta y navegador, pero hace llamadas reales que pueden cobrar.

Mantener credenciales permanentes en el servidor

1. Usa el ejemplo de token gestionado como punto de partida normal en producción.
2. El backend autentica al usuario y comprueba qué identidad IllyVoIP puede usar.
3. Solicita la autorización temporal del navegador con la clave API. Devuelve solo los datos requeridos por el SDK, nunca la clave permanente.
4. Inicializa el SDK con esos datos y el ejemplo actual. Gestiona caducidad, cierre y errores, en vez de crear sesiones repetidamente.

No aceptes identidades arbitrarias de navegadores sin autenticar ni permitas tokens para otras cuentas. No pongas claves API o contraseñas SIP en JavaScript público, repositorios, URL o capturas. El modo SIP directo es avanzado, no justifica secretos permanentes en el frontend.

Mostrar la preparación al usuario

Muestra conectando, listo, entrante, activo, terminado y fallido mediante eventos documentados. Solicita micrófono con acción clara, permite elegir audio si se admite y muestra el rechazo de permiso. Un teclado visible no prueba registro ni un registro prueba audio bidireccional.

No supongas que el SDK resuelve toda tu política multidispositivo. Sigue el ciclo de conexión/desconexión y muestra conflictos. Una sesión terminada no debe parecer activa. Borra el estado del teléfono de la cuenta al salir e inicializa la identidad autorizada del nuevo usuario, no la anterior en caché.

Hacer una pequeña prueba de aceptación

Con permiso, prueba una saliente y entrante, responder/finalizar, audio y controles expuestos de espera, teclado o transferencia. Prueba permisos denegados, pérdida de red, cierre/cambio de cuenta y comportamiento multidispositivo. Sigue diagnósticos y regiones actuales; cambiar de región no promete mantener una llamada interrumpida.

Usa destinos propios autorizados, revisa tarifas y no consideres gratuitas las pruebas repetidas. No recojas ni envíes grabaciones sin avisos y autorización necesarios.

Diagnosticar por etapa

Si falla la autorización, revisa respuesta backend y permisos de identidad sin registrar secretos. Si falla señalización, comprueba región y compatibilidad de red/navegador. Si falta audio conectado, mira dispositivos, permisos y acceso multimedia. Guarda versiones SDK/navegador, error sin datos privados, hora/zona y referencia pública para soporte.

La referencia API determina métodos, datos y duración de tokens. Consulta Inicio rápido API para acceso y manejo seguro de peticiones.