Solución de problemas
Para el correcto funcionamiento del Softphone en Telegram, necesita:
- Tener una suscripción activa de Softphone en @siptg_bot.
- Asegurarse de que en la configuración de privacidad de Telegram, las llamadas de voz estén permitidas para “Todos” o al menos para @siptg.
- Especificar correctamente la dirección del servidor SIP (con el puerto necesario si es no estándar), nombre de usuario y contraseña en el bot.
- Si es necesario, configurar los códecs de audio y las “Reglas de marcación” para que cumplan con los requisitos de su PBX o proveedor SIP.
Preguntas frecuentes
Softphone — es cuando se utiliza Telegram como cliente SIP (enlazando con cualquier operador SIP).
Gateway — es cuando se conecta una cuenta de Telegram a una PBX para que las llamadas de Telegram sean procesadas por la PBX.
Sí. El flujo de voz a través de Telegram es un canal de internet, no interfiere con sus llamadas GSM.
Al crear una cuenta, active la casilla “Grabación de llamadas”. Disponible con una suscripción de pago (5 EUR/mes por cuenta). Si es necesario, puede seleccionar un canal/chat separado donde se guardarán los archivos de audio.
Sí. En la sección /softphone del bot @siptg_bot, abra la cuenta SIP y haga clic en “Desactivar”.
En el bot @siptg_bot, abra la configuración de la cuenta deseada, haga clic en “Usuario” y seleccione el perfil de Telegram de su colega. Ahora todas las llamadas entrantes irán a ellos, y usted seguirá siendo el Propietario.
Sí, si su suscripción de “Softphone” permite el número requerido de cuentas. Puede crear varias cuentas SIP. Para llamadas salientes, aparecerá una solicitud para seleccionar una cuenta antes de cada llamada.
Si tiene un puerto no estándar en el lado del operador o PBX, especifíquelo en el campo “Dominio” o “Proxy” con dos puntos (por ejemplo: sip.example.com:5062). Para el estándar 5060, no es necesario especificarlo.
Problemas y depuración
A continuación se presenta una lista ampliada de problemas que nuestros usuarios han encontrado.
Síntomas
- No aparece información sobre la llamada entrante en Telegram.
Posibles causas
- Las llamadas de voz están prohibidas a nivel de su cuenta de Telegram.
- La cuenta SIP se está utilizando en paralelo en otro dispositivo (en otro Softphone, en un widget para llamadas a través del navegador, etc.).
- Se perdió la conexión entre su cuenta de Telegram y nuestro @siptg.
Solución
- Verifique la configuración en Telegram: asegúrese de que en la sección “Privacidad y seguridad → “Llamadas de voz”, esté seleccionada la opción “Todos”.
- Actualice la contraseña de la cuenta SIP en el lado del proveedor SIP o PBX, y especifique la nueva contraseña para la cuenta en la sección
/softphonedel @siptg_bot. - Abra el chat con @siptg y envíe cualquier mensaje.
Síntomas
- Cuando llega una llamada entrante (o Callback), el usuario no tiene tiempo para responder, y en el chat @siptg se muestra con el estado “Llamada rechazada”.
- Como resultado, todas las llamadas entrantes se rechazan automáticamente en todos los dispositivos vinculados a la cuenta de Telegram.
Posibles causas
- En uno de los dispositivos, la aplicación Telegram está “bloqueada” en un estado de llamada activa, aunque no hay signos de una llamada activa.
- Durante una llamada entrante, está hablando a través de otra aplicación o vía conexión móvil, y Telegram no tiene acceso al micrófono del dispositivo.
- Está intentando hacer una llamada de prueba a sí mismo. Por ejemplo, mientras realiza una llamada mediante conexión móvil (bloqueando así el micrófono), la llamada entra a través de Telegram, y debido a la otra llamada activa, la nueva llamada de Telegram se rechaza.
Solución
- Identifique el dispositivo problemático: cada uno de sus dispositivos debe desconectarse de internet por turnos hasta que las llamadas entrantes dejen de caerse. Después de eso, el dispositivo problemático debe reiniciarse o la aplicación Telegram debe descargarse completamente de la memoria.
- Realice una llamada de prueba que involucre dos dispositivos diferentes, y asegúrese de que su cuenta de Telegram no se use en el segundo dispositivo.
- Si el problema se repite, recopile registros del dispositivo problemático para un análisis y solución de problemas adicionales. Vea Getting Log Files from Telegram para más detalles.
Cuando envía un número al chat, el bot intenta llamarle (callback). Si no acepta la llamada entrante en Telegram, la llamada saliente no se realizará.
Qué hacer:
- Active las notificaciones de llamadas en Telegram.
- Verifique que las llamadas estén permitidas desde @siptg.
- Confirme la llamada entrante dentro de 60 segundos.
Esto está relacionado con mayor frecuencia con la incompatibilidad de códecs o el bloqueo del tráfico UDP.
Solución
-
En el bot @siptg_bot en la sección
/softphone→ Configurar cuenta SIP → Códecs de audio, establezca una lista corta, por ejemplo:opus,alaw,mulaw.Si es necesario, especifique un códec de audio específico (por ejemplo, solo
alawomulaw). -
Si la llamada proviene del extranjero o a través de internet móvil, pruebe con otro servidor Worker.
Esto se debe a la suscripción gratuita. Para eliminar la restricción — active la suscripción de Softphone. Vea más en Descripción general de suscripciones.
Esto se debe con mayor frecuencia a una conexión a internet inestable entre el usuario de Telegram y nuestro servidor.
Solución
- Permita llamadas peer-to-peer en la configuración de Telegram: ☰ → Configuración → Privacidad y seguridad → Llamadas → Peer-to-peer → Permitir siempre → Añadir usuarios → @siptg
- Cambie el tipo de conexión y dispositivo; intente llamar desde su computadora a través de Wi-Fi.
- En el bot @siptg_bot en la sección
/softphone→ Configurar cuenta SIP → Worker seleccione otro servidor que esté más cerca en ubicación geográfica.
Síntomas
- Durante una llamada saliente o entrante, no se puede escuchar al abonado, o el sonido desaparece repentinamente.
- La llamada se cuelga dentro de 5-10 segundos.
Posibles causas
- Códec de audio inadecuado o conflictivo.
- El proveedor o PBX no acepta el conjunto actual de códecs, o Telegram no tiene tiempo para negociar los parámetros del flujo de audio.
- Configuración incorrecta de RTP o errores en la transmisión de paquetes de voz.
Solución
-
En el bot @siptg_bot en la sección
/softphone→ Configurar cuenta SIP → Códecs de audio, establezca una lista corta, por ejemplo:opus,alaw,mulaw.Si es necesario, especifique un códec de audio específico (por ejemplo, solo
alawomulaw). -
Verifique la configuración del servidor Worker y el firewall.
Síntomas
- Al intentar realizar una llamada saliente, el bot informa que no hay líneas disponibles.
- Posiblemente, aparece un error de código en los registros que indica la no disponibilidad de línea.
Posibles causas
- “Reglas de marcación” configuradas incorrectamente que excluyen números correctos.
- Excedido el número de cuentas SIP activas permitidas por la suscripción.
- Errores en los parámetros de la cuenta SIP (inicio de sesión incorrecto, servidor o contraseña).
Solución
- Verifique y, si es necesario, restablezca las reglas de marcación ingresando el valor
=en la configuración de la cuenta SIP. - Asegúrese de que el número total de cuentas SIP corresponda a la suscripción pagada.
- Intente reiniciar la cuenta SIP a través del comando
/softphoneen el bot @siptg_bot.
Síntomas
- El bot informa que se han excedido los límites de llamadas fallidas o que la cuenta SIP actual no está permitida por la tarifa.
- Las llamadas no pasan debido a exceder los límites establecidos.
Posibles causas
- El usuario ha activado independientemente una cuenta SIP sin vincularla a la suscripción administrada.
- Se han excedido las limitaciones internas del plan tarifario (por ejemplo, el número de intentos fallidos).
- Las cuentas SIP están incorrectamente distribuidas o activadas.
Solución
- Verifique que la cuenta SIP esté habilitada y vinculada en la sección
/softphonedel bot. - Compare el número de cuentas activas con los datos en la sección
/subscriptions. - Si la cuenta se activó independientemente, contacte con soporte para reconfigurarla para administración.
Síntomas
- Al intentar llamar, aparece un error que indica que la cuenta no está iniciada y la llamada no comienza.
- En la sección
/softphone, la cuenta está marcada con el icono ⚠️, y en la configuración, los campos Dominio / Proxy / Plantilla tienen ese icono.
Posibles causas
- Interrupción temporal en la infraestructura de SIP.TG: no hay comunicación entre los servidores Manager y Worker.
- Interrupción temporal del lado del proveedor de telefonía o PBX: no hay comunicación entre los servidores Worker y PBX/proveedor.
Solución
- Cambie el servidor Worker a uno diferente en la sección
/softphonedel bot. - Espere a que se restaure la conexión.
Normalmente, los errores de este tipo se recuperan automáticamente después de un breve tiempo.
Síntomas
- Al habilitar una cuenta SIP, aparece el error “Parámetros inválidos (params)”. La cuenta permanece sin conectar.
Posibles causas
- No se especificaron los parámetros de conexión requeridos: Login, Password y Domain.
- La Plantilla de configuración seleccionada no contiene un valor preestablecido para Domain y Proxy para la conexión.
Solución
- Establezca el valor correcto para los parámetros Domain y Proxy (si es diferente), y vuelva a habilitar la cuenta SIP.
Síntomas
- Al habilitar una cuenta SIP, después de esperar un tiempo aparece el error “Tiempo de espera agotado (timeout)”. La cuenta permanece sin conectar.
Posibles causas
- Dirección del servidor SIP incorrecta.
- Firewall activo en el servidor SIP.
- El servidor SIP acepta solicitudes en un puerto no estándar.
- El nombre DNS del servidor devuelve una dirección IP incorrecta o múltiples direcciones IP.
- El nombre DNS del servidor devuelve una dirección IPv6, pero el servidor SIP solo está ejecutándose en IPv4.
Solución
- Establezca el valor correcto para los parámetros Domain y Proxy (si es diferente), y vuelva a habilitar la cuenta SIP.
- Para Proxy, especifique la dirección IP explícitamente, dejando Domain apuntando al nombre DNS.
- Verifique la recepción de paquetes SIP usando las utilidades
sngrepotcpdump. - Verifique las reglas del Firewall. Configure actualizaciones automáticas de la lista blanca de direcciones IP desde el archivo
https://files.sip.tg/fw.txt.
Síntomas
- La grabación de llamadas solo funciona si se habilita manualmente durante cada llamada.
- La grabación de llamadas se detiene después de 15 segundos.
Posibles causas
- La configuración de “Grabación de llamadas” no está habilitada en la configuración de la cuenta SIP.
- Al pagar la suscripción de “Softphone”, no se agregó la opción “Grabación de llamadas”.
Solución
- Verifique el estado de la configuración de la cuenta SIP. Vea Configuración del Softphone para más detalles.
- Agregue la opción “Grabación de llamadas” en la configuración de la suscripción. Vea Suscripción de Softphone para más detalles.
Síntomas
- En la sección
/softphonedel bot, no hay botones con la configuración de la cuenta (Login, Password, Domain, Proxy, Worker, Reglas de marcación, DTMF, Códecs de audio). Solo hay botones de Desactivar y Eliminar.
Posibles causas
- Usted es un Usuario de la cuenta SIP, pero no el Propietario.
Solución
- Contacte al propietario de la cuenta SIP con una solicitud para cambiar su configuración.
Vea Roles de Propietario y Usuario para cuenta SIP para más detalles.
Síntomas
- Después de finalizar una llamada, Telegram continúa mostrando un estado de llamada activa.
- No se aceptan nuevas llamadas entrantes, y la llamada activa impide realizar llamadas posteriores.
Posibles causas
- Retraso en la transmisión de la notificación de finalización de llamada a través de la red de Telegram.
- Problema con la aplicación cliente de Telegram (especialmente en Android) donde la aplicación no actualiza el estado de la llamada.
Solución
- Actualice Telegram a la última versión.
- Cierre completamente la aplicación y reiníciela o reinicie su dispositivo.
- Si el problema ocurre regularmente, recopile registros y contacte al grupo público para obtener soporte.
Síntomas
- Cualquier número saliente no pasa - la llamada se bloquea inmediatamente con un error (por ejemplo, 404).
- Al marcar un número, aparece un mensaje de que el número no cumple con las reglas.
Posibles causas
- Expresiones regulares configuradas incorrectamente que bloquean números correctos.
- El cambio manual del campo “Reglas de marcación” ha llevado a la exclusión de todos los números.
Solución
- Restablezca la configuración de las reglas de marcación ingresando el valor
=en el campo correspondiente. - Si es necesario, use reglas RegExp correctas para la transformación de números, probándolas primero.
- Verifique los registros de la PBX para mensajes sobre números no soportados.
Síntomas
- Al enviar un número en un chat con el bot, aparece el mensaje “Realizar una llamada saliente”, pero la llamada no llega si el usuario no responde a tiempo.
- La marcación saliente “cuelga” esperando una devolución de llamada.
Posibles causas
- El modo Callback está habilitado, y el usuario no tiene tiempo para responder a la llamada de retorno del bot.
- En la configuración de Telegram, las llamadas entrantes desde el bot están prohibidas.
Solución
- Si no se requiere Callback, desactívelo en la sección
/softphone. - Si la función es necesaria, asegúrese de que la configuración de Telegram permita recibir llamadas desde la cuenta @siptg.
- 403 Forbidden: contraseña/inicio de sesión incorrecto, o el proveedor lo ha bloqueado.
- 404 Not Found: dominio SIP incorrecto o número de abonado no encontrado.
- 408 Request Timeout: el proveedor no responde, pruebe otro Worker o verifique el firewall.
- 503 Service Unavailable: el operador está experimentando problemas temporales o se han excedido los límites de Telegram (Too Many Requests).
- 603 Declined: la llamada es rechazada por el operador o por la parte llamada.
Si tiene habilitado “recibir llamadas solo de contactos” en Telegram, la cuenta @siptg no podrá llamarle.
- Habilite “Aceptar llamadas de todos” (Menú → Configuración → Privacidad → Llamadas de voz).
- O agregue @siptg a la lista “Permitir siempre”.
Esto sucede cuando el servicio cambia el servidor Worker, pero su PBX “recuerda” la dirección IP anterior.
- Asegúrese de que todos los servidores IP Worker de SIP.TG estén en la lista blanca del lado de la PBX (vea la lista en el archivo https://files.sip.tg/fw.txt).
- Verifique si el período de registro de la cuenta ha expirado. La PBX puede requerir una re-registración más frecuente.
- Limitaciones de Telegram con llamadas masivas:
Con un gran número de llamadas salientes, el sistema puede emitir errores503 Too Many Requestso408 Timeout of waiting RPC result. La solución es reducir la velocidad de marcación. - Problemas con DTMF:
Si las pulsaciones de botones no se reconocen al interactuar con el menú de voz (IVR), cambie el método de transmisión DTMF en la configuración (por ejemplo, cambie deinbandaRFC2833oINFO). - Problemas con el registro en el servidor Worker:
A veces el registro SIP no ocurre porque el servidor Worker no responde o la dirección IP no está en la “lista blanca”. La solución es verificar la configuración de red y agregar las IP necesarias a la lista blanca. - Conflictos al actualizar independientemente la configuración:
Si los usuarios cambian independientemente los parámetros de la cuenta SIP (por ejemplo, códecs de audio, reglas de marcación), esto puede provocar errores en la gestión masiva. Se recomienda la administración centralizada a través de una cuenta común de “administrador”.
Si las acciones descritas no ayudaron, solicite asistencia. Vea Cómo obtener ayuda para más detalles.