Documentación para desarrolladores

SIP

Introducción

Bienvenido al servicio de telefonía SIP de Speaqr. Nuestro servidor SIP te permite realizar llamadas de teléfono con traducción en tiempo real, rompiendo las barreras del idioma en las comunicaciones telefónicas.El servicio utiliza tecnología SIP sobre TLS para garantizar comunicaciones seguras, junto con SRTP para cifrado de audio y el códec μ-law (PCMU) para compatibilidad universal con sistemas de telefonía.Con nuestro servicio SIP podrás integrar las capacidades de traducción de Speaqr directamente en tu centralita, softphone o cualquier sistema compatible con SIP, permitiendo llamadas multilingües sin necesidad de intérpretes físicos.Para usar el servicio SIP necesitas credenciales de acceso válidas. Para obtenerlas ponte en contacto con nosotros a través del formulario de contratación.

Requisitos previos

Antes de configurar tu cliente SIP, asegúrate de cumplir con los siguientes requisitos:

Cliente SIP compatible

Tu cliente SIP debe soportar SIP sobre TLS para señalización segura, SRTP (SDES) para cifrado de audio y el códec μ-law (PCMU) que es obligatorio para compatibilidad con el servicio.Ejemplos de clientes compatibles: Cualquier softphone o centralita con soporte para PJSIP.

Credenciales de acceso

Recibirás un nombre de usuario (ej. nuevo-usuario), una contraseña y el dominio del servidor: sip.speaqr.ai.

Conexión de red

Asegúrate de que los puertos 5061/TCP (para TLS) y 10000-20000/UDP (para SRTP) estén abiertos en tu red o firewall.

Certificados TLS

No necesitas generar certificados adicionales. Nuestro servidor usa un certificado TLS válido. Asegúrate de que tu cliente acepte certificados de confianza estándar.

Configuración del cliente

Configura tu softphone o centralita para conectarse a sip.speaqr.ai con los siguientes parámetros:

Datos de la cuenta

• Nombre de usuario: nuevo-usuario (proporcionado por el administrador)
• Contraseña: Tu contraseña proporcionada
• Dominio/Servidor: sip.speaqr.ai:5061

Configuración de protocolo

• Transporte: TLS
• Puerto: 5061
• Cifrado de media: SRTP (SDES)
• Códecs: Habilita únicamente PCMU (μ-law); desactiva otros códecs

Opciones de red

• Registrar en el servidor: Activa la opción de registro (REGISTER)
• STUN (si estás detrás de NAT): Usa un servidor STUN como stun.l.google.com:19302

Encabezados SIP personalizados

Configura la capacidad de enviar encabezados SIP personalizados (consulta la documentación de tu cliente para añadirlos).Ejemplo: X-Origin: nuevo-usuario, X-Destination: destino

Servicios disponibles

El servidor ofrece dos servicios a través de la aplicación ARI loopback. Usa los siguientes métodos para interactuar con ellos:

Servicio loopback

Envía audio al servidor y recibe el audio procesado (intervenido) por Speaqr.

Cómo usarlo

Marca la extensión loopback en tu cliente SIP.

Encabezados SIP requeridos

• X-Origin: Tu identificador (ej. nuevo-usuario)
• X-Destination: Un identificador para el destino (puede ser cualquier valor relevante, ej. test)

Comportamiento

El servidor responde el audio procesado por la aplicación Speaqr, basado en tu email (obtenido desde la base de datos) y los encabezados.

Servicio call

Realiza una llamada a un número de teléfono físico, con el audio intervenido por Speaqr.

Cómo usarlo

Marca la extensión call en tu cliente SIP.

Encabezados SIP requeridos

• X-Origin: Tu identificador (ej. nuevo-usuario)
• X-Destination: El número de teléfono físico al que deseas llamar (formato internacional, ej. +1234567890)
• X-Dial: Opcional, para especificar un número o destino adicional (ej. +1234567890)

Comportamiento

La llamada se conecta al número especificado, con el audio procesado por Speaqr.

Solución de problemas

Si encuentras dificultades durante la configuración o uso del servicio SIP, revisa las siguientes soluciones:

No se registra la cuenta

• Verifica que el nombre de usuario, contraseña y puerto (5061/TLS) sean correctos
• Asegúrate de que el firewall permita el puerto 5061/TCP
• Si estás detrás de NAT, habilita STUN o contacta al administrador

No hay audio

• Confirma que SRTP esté habilitado y que los puertos RTP (10000-20000/UDP) estén abiertos
• Asegúrate de que solo PCMU esté habilitado como códec

Error al usar servicios loopback o call

• Verifica que los encabezados X-Origin y X-Destination estén correctamente configurados
• Asegúrate de que tu cuenta esté registrada antes de marcar
• Contacta al administrador si la aplicación ARI no responde

Esta página web usa cookies

Las cookies de este sitio web se usan para personalizar el contenido y analizar el tráfico.
Puedes encontrar los detalles de las mismas en la sección Politica de privacidad