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
¿En qué se diferencia Softphone de Gateway?
¿En qué se diferencia Softphone de Gateway?
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.
¿Puedo recibir llamadas móviles regulares simultáneamente?
¿Puedo recibir llamadas móviles regulares simultáneamente?
Sí. El flujo de voz a través de Telegram es un canal de internet, no interfiere con sus llamadas GSM.
¿Cómo habilitar la grabación de llamadas?
¿Cómo habilitar la grabación de llamadas?
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.
¿Puedo desactivar temporalmente las llamadas entrantes?
¿Puedo desactivar temporalmente las llamadas entrantes?
Sí. En la sección
/softphone del bot @siptg_bot, abra la cuenta SIP y haga clic en “Desactivar”.¿Cómo asignar una cuenta SIP a otra persona?
¿Cómo asignar una cuenta SIP a otra persona?
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.
¿Puedo tener dos o más cuentas SIP activas en un solo Telegram?
¿Puedo tener dos o más cuentas SIP activas en un solo Telegram?
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.
¿Necesito especificar manualmente el puerto SIP (p. ej., :5062)?
¿Necesito especificar manualmente el puerto SIP (p. ej., :5062)?
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.No se reciben llamadas entrantes
No se reciben llamadas entrantes
Síntomas
- No aparece información sobre la llamada entrante en Telegram.
- 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.
- 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.
Las llamadas entrantes y Callback se reciben pero se cuelgan antes o inmediatamente después de responder
Las llamadas entrantes y Callback se reciben pero se cuelgan antes o inmediatamente después de responder
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.
- En los registros SIP se muestra el error
486 User declined the call.
- 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.
- 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.
La llamada saliente no se realiza (modo Callback)
La llamada saliente no se realiza (modo Callback)
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.
No hay sonido o no nos escuchan (audio unidireccional)
No hay sonido o no nos escuchan (audio unidireccional)
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, soloalawomulaw). - Si la llamada proviene del extranjero o a través de internet móvil, pruebe con otro servidor Worker.
La llamada se cuelga después de 2 minutos
La llamada se cuelga después de 2 minutos
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.
Fuerte retraso al hablar
Fuerte retraso al hablar
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.
La llamada se cuelga después de unos segundos tras responder / No hay sonido después de responder la llamada
La llamada se cuelga después de unos segundos tras responder / No hay sonido después de responder la llamada
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.
- 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.
-
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, soloalawomulaw). - Verifique la configuración del servidor Worker y el firewall.
Error 'No lines for call' o 'No hay líneas disponibles para llamar'
Error 'No lines for call' o 'No hay líneas disponibles para llamar'
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.
- “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).
- 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.
Error 'Amount of fail calls is exceeded' o 'SIP account has disallowed settings'
Error 'Amount of fail calls is exceeded' o 'SIP account has disallowed settings'
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.
- 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.
- 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.
Error '503 Account is not running' / La cuenta está marcada con ⚠️ en la configuración
Error '503 Account is not running' / La cuenta está marcada con ⚠️ en la configuració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.
- 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.
- Cambie el servidor Worker a uno diferente en la sección
/softphonedel bot. - Espere a que se restaure la conexión.
Error 'Invalid parameters (params)' al habilitar una cuenta
Error 'Invalid parameters (params)' al habilitar una cuenta
Síntomas
- Al habilitar una cuenta SIP, aparece el error “Parámetros inválidos (params)”. La cuenta permanece sin conectar.
- 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.
- Establezca el valor correcto para los parámetros Domain y Proxy (si es diferente), y vuelva a habilitar la cuenta SIP.
Error 'Time out (timeout)' al habilitar una cuenta
Error 'Time out (timeout)' al habilitar una cuenta
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.
- 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.
- 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.
La grabación automática de llamadas no funciona
La grabación automática de llamadas no funciona
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.
- 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”.
- 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.
En la configuración de la cuenta SIP solo tengo 2 botones: Desactivar y Eliminar
En la configuración de la cuenta SIP solo tengo 2 botones: Desactivar y Eliminar
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.
- Usted es un Usuario de la cuenta SIP, pero no el Propietario.
- Contacte al propietario de la cuenta SIP con una solicitud para cambiar su configuración.
Errores SIP: 403, 404, 408, 503, 603...
Errores SIP: 403, 404, 408, 503, 603...
- 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.
Otros problemas raros y recomendaciones
Otros problemas raros y recomendaciones
- 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.