Principio de ajuste del Gateway
en el lateral PBX

La configuración en el lado PBX (o el módulo de telefonía CRM) se realiza después de conectar la sesión a la cuenta de telegramas deseada en el lado @siptg_bot y elegir cómo comunicarse con PBX.

La instalación en PBX consta de dos pasos fundamentales:
  • Conexión de un troncal SIP
  • Configuración del encaminamiento de llamadas

A diferencia de los números de teléfono estándar, cuando se llama desde Telegram se puede utilizar uno de los tres valores (identificación de usuario, nombre de usuario, número de teléfono de la cuenta) como identificador de llamada, y para las llamadas salientes debes respetar una serie de restricciones de Telegram para protegerte contra el spam.

Puedes probar el progreso de tus llamadas con la tarifa gratuita, pero tiene una serie de restricciones en las llamadas. Puedes eliminar la restricción durante 1 semana activando el plan de prueba por 100 rublos. Después de probar el sistema, deberá activar uno de los planes de pago para poder utilizarlo.

Ver también funciones para configurar el Gateway con diferentes sistemas CRM.

Paso 1: Conectar un troncal SIP

Un troncal SIP es una línea para recibir y realizar llamadas, los troncales se utilizan para conectar números de telefonía estándar a PBX . En el caso de una pasarela de Telegram, el número para recibir y realizar llamadas será la cuenta de Telegram a la que llaman los usuarios de Telegram y en cuyo nombre se les puede devolver la llamada.

Todos los SIP modernosPBX tienen la capacidad de conectar números (troncales) de forma independiente. En el caso de algunos virtuales PBX , la conexión de una nueva troncal puede requerir el envío de la correspondiente solicitud al servicio de soporte, pero en general se trata de un sencillo procedimiento estándar.

Dependiendo del PBX específico y del método utilizado de comunicación con los servidores SIP.TG (que se selecciona en el bot, uno de tres) el procedimiento de conexión de la troncal es diferente.

Con el método de registro PBX->SIP. PBX TG (el más sencillo y el más utilizado) debe especificar los parámetros estándar (servidor, login, contraseña) en el lado de PBX . Debe obtener los parámetros en @siptg_bot bajo /gateway cuando elija el método de registro correspondiente.

Con el método de registro SIP.TG->PBX debe obtener los datos de la cuenta SIP (dirección PBX, login, contraseña), que más tarde especificará en @siptg_bot bajo /gateway para conectar la troncal.

Con el método de comunicación IP-IP en el lado de @siptg_bot debe especificar la dirección PBX, el número a llamar en el lado PBX (y opcionalmente field:value), luego hacer la llamada desde PBX a la dirección y puerto recibidos de @siptg_bot bajo /gateway para el método de comunicación apropiado.

A veces puede que tenga que especificar explícitamente en@siptg_bot para el método de comunicación apropiado el Worker-servidor utilizado (en el país deseado, o el suyo propio), el protocolo de comunicación (UDP, TCP, TLS), el conjunto de códecs utilizados, el método de señalización DTMF.

Por favor, consulte las instrucciones @siptg_bot

--
Después de conectar con éxito el tronco en PBX interfaz y bot debe ser marcado como activo y listo para trabajar. Una vez configurado el enrutamiento básico de llamadas, se pueden realizar las primeras llamadas de prueba.

Comprobación del funcionamiento de la troncal VoIP entre Telegram y SIPPBX
Configuración del cortafuegos en el lateral PBX
Si está utilizando el Firewall para proteger su PBX, asegúrese de que las direcciones actuales de nuestros servidores Worker desde los que se conecta a PBX están en la lista blanca.

Todas las direcciones IP de nuestros servidores están listadas en el archivo:
https://www.sip.tg/fw.txt

La red de servidores Worker se actualiza ocasionalmente e informamos de ello en el canal de noticias @siptg_news (recomendamos a los administradores que se suscriban a él).
Sobre la infraestructura de los servidores de trabajo


La infraestructura de servidores de SIP.TG Worker es segura, los servidores se pueden escalar rápidamente si es necesario y están ubicados en diferentes zonas geográficas.

Si es necesario, se puede especificar un servidor Worker específico para todas las cuentas SIP vinculadas, incluidas las ubicadas en sus propios servidores.

Para utilizar su propio servidor Worker (o varios), instale y configure el módulo adecuado y, a continuación, especifíquelo en los ajustes de conexión (en los planes gratuitos esta opción NO estádisponible
IP bloquea PBX por contraseña incorrecta
Especifique cuidadosamente los detalles de conexión a los servidores SIP.TG. Tenemos activada la protección por contraseña, por lo que la dirección IP PBX puede ser bloqueada durante un periodo de tiempo arbitrario si se conecta a los servidores de SIP.TG sin la opción de registro activada, con un nombre de usuario o contraseña incorrectos, desde una IP no fiable y similares.

Paso 2: Configurar el encaminamiento de llamadas

Las llamadas entrantes y salientes de los usuarios de Telegram entre el Gateway y PBX son las mismas independientemente de cómo se conecte el Gateway a PBX.

Cuando entra una llamada de un usuario de Telegram a la cuenta del Gateway en PBX , se envía el número y el nombre de la persona que llama, mientras que para una llamada saliente basta con especificar el número de usuario en alguno de los formatos permitidos (userid, nombre de usuario, teléfono).
Llamadas entrantes a PBX desde Telegram

Después de conectar un troncal SIP para llamadas, recuerda especificar cuál de los usuarios de PBX (empleados) recibirá las llamadas entrantes desde él.

Después de configurar el destinatario de las llamadas entrantes, puedes hacer una llamada de prueba a la cuenta de Telegram conectada al Gateway para asegurarte de que las llamadas entrantes pasan.

¡Importante! La llamada de prueba debe hacerse desde el dispositivo donde la cuenta del Gateway no está conectada. Una llamada llegará tanto a PBX como a todos los dispositivos con cuenta de pasarela conectada.

Si hay un retardo de colgado en PBX , puede que se reciba una llamada desde la aplicación Telegram, pero entonces no llegará a través de PBX .

Para realizar llamadas sólo a PBX , desactive la aceptación de llamadas en otros dispositivos con cuenta de pasarela conectada. Esto se hace en los ajustes de Telegram para la cuenta de Gateway(☰ → Ajustes → Notificación y sonidos → Llamadas → Aceptar llamadas en este dispositivo).

Cualquier función de llamada de voz disponible en PBX es aplicable a las llamadas de Gateway: grabación de llamadas, transferencia y retención de llamadas, menú de voz, llamada de grupo, soufling, etc.

Preste atención a qué Caller-ID la llamada entrante vendrá con, corresponde a la configuración establecida en el lado de @siptg_bot (usuario-id, nombre de usuario o número de teléfono de la cuenta + prefijo o sufijo utilizado).

El campo Caller-Name, que puede contener uno o varios valores disponibles sobre el usuario del telegrama llamante (nombre, nombre de usuario, Teléfono), también se envía a PBX desde el Gateway.

Más información sobre la configuración de los valores Caller-ID y Caller-Name enviados (paso 5).

Llamadas salientes de PBX a Telegram

Para realizar llamadas salientes a través de una línea Gateway conectada (troncal a telegrama), en la configuración de PBX suele ser necesario especificar explícitamente cuáles de los usuarios de PBX (empleados) están autorizados a hacerlo.

Dependiendo del sistema utilizado, los usuarios de PBX pueden seleccionar explícitamente la línea saliente para la llamada en sus softphones (terminales de trabajo), o la selección de línea sólo puede tener lugar automáticamente basándose en el prefijo o sufijo del número del usuario llamado.

Uno de los tres valores puede ser utilizado como número de usuario para llamarlos en Telegram:
  • user-id interno (normalmente utilizado con un prefijo de * o 0, u otra característica, tiene una longitud arbitraria, de 5 a 20 dígitos, disponible para todos los usuarios)
  • número de teléfono del usuario vinculado a la cuenta de Telegram (10 dígitos, puede ocultarse mediante la configuración de privacidad)
  • nombre de usuario en Telegram (sin @ al principio, sólo letras latinas y números, puede no estar configurado, soportado por algunos PBX)
Comprobación del funcionamiento de la troncal VoIP entre Telegram y SIPPBX
Recomendamos utilizar user-id como Caller-ID y el número llamado con un prefijo de 0 o *, este es el método más universal. Sin embargo, recuerda que el user-id no puede utilizarse para llamar primero al usuario si todavía no ha habido una correspondencia mutua con él. Si aún así necesitas llamar a un usuario fuera de tu lista de contactos, utiliza su número de teléfono (si no está oculto) o su nombre de usuario (si tu PBX lo permite).

Prefijo Pro antes de Caller-ID (user-id o número de teléfono) . Para distinguir telegram user-ID (user-id o número de teléfono de la cuenta) de los números de teléfono normales en los registros PBX y/o sistemas CRM, es conveniente anteponerles un prefijo al lado de @siptg_bot al configurar la comunicación con PBX (recomendamos utilizar el símbolo * o 0). Si estableces un prefijo para el Identificador de Llamadas, es importante guardarlo en el número del usuario llamado cuando hagas una llamada saliente a Telegram a través de la línea Gateway conectada.

La forma más fácil de probar las llamadas salientes a Telegram es hacer una llamada de vuelta a una llamada entrante (importante que el prefijo antes del número coincida, si fue establecido).

Ten especial cuidado cuando llames a usuarios desconocidos. Cualquier usuario puede quejarse de spam si tu llamada es inesperada. Si se recibe un número significativo de quejas, la cuenta del Gateway puede ser temporalmente restringida o bloqueada por los algoritmos de Telegram.


Telegram restringe las llamadas salientes
Si aún no ha habido correspondencia con el usuario, puedes llamarle primero sólo por su nombre de usuario (puede no estar configurado para la cuenta), o por el número de teléfono de la cuenta (puede estar oculto por la configuración de privacidad).

El número de llamadas diarias a usuarios que aún no están en tu lista de contactos es muy limitado (varias docenas de llamadas al día).

Si la intensidad de las llamadas es demasiado alta, puedes conseguir que se prohíban temporalmente las llamadas desde Telegram (duran unas 24 horas).

Las llamadas desde cuentas de usuario sólo se permiten si ya ha habido algún tipo de correspondencia mutua previa con el usuario, o si el usuario ha realizado la primera llamada a la cuenta de la pasarela.

Los usuarios de Telegram pueden prohibir las llamadas entrantes de voz desde cuentas que no estén en su lista de contactos (o cualquier llamada) en sus preferencias en absoluto.
Retraso de llamadas en Telegram
Es posible que se produzcan retrasos al llamar a un usuario desconectado. Esto se debe a una característica de Telegram que se describe a continuación.

Los operadores de redes celulares pueden saber fácilmente si un usuario está conectado. Telegram trabaja más. Un usuario obtiene el estado "En línea" si se cumplen tres condiciones: la aplicación se está ejecutando, el teléfono está activo y el propio teléfono está desbloqueado. De lo contrario, el usuario se considera desconectado.

La tecnología Push ayuda a forzar la conexión del usuario. Recibe una notificación de una llamada entrante de Telegram y en ese momento obtiene el estado en línea, aunque no haya iniciado sesión en la aplicación. Este enfoque ayuda a la aplicación a conservar la batería de manera significativa.

No hay límite de tiempo entre la realización de una llamada y la recepción de una notificación Push. Si el teléfono no está conectado, es posible que el usuario no reciba la notificación. Por lo tanto, la definición del tiempo de espera para que el usuario aparezca en la red depende de las tareas de la pasarela y debe configurarse en el lado de su PBX virtual.

El valor actual del tiempo de espera es de 15 segundos.
Acerca de la protección de Telegram contra las llamadas de inundación
Cuando hay una gran carga en los servidores de Telegram, puede activarse la protección contra inundaciones. Para ello, se introduce una restricción artificial en el uso de todas o algunas llamadas a la API de Telegram.

Si el retraso de la restricción es de hasta 5 segundos, esta solicitud a la API se repite automáticamente. De lo contrario, la solicitud finalizará con un error, que se transmite a SIP como código 503 Service Unavailable.

De acuerdo con RFC 3261 también se transmitirá una cabecera Retry-After que contiene un valor en segundos tras el cual se puede volver a enviar la solicitud.
Si las llamadas entrantes a la cuenta Gateway se interrumpen inmediatamente
La mayoría de las veces esto ocurre porque la llamada de prueba se realiza desde el mismo dispositivo en el que está conectada la cuenta de la pasarela. La llamada no puede ser aceptada, porque la llamada ya es saliente desde el mismo dispositivo, y por lo tanto la llamada se corta.

Para evitar que esto suceda, puede prohibir la recepción de llamadas en la configuración de la cuenta de Gateway en el dispositivo desde el que se realizan las llamadas de prueba.

Esta configuración se realiza en los ajustes de la aplicación Telegram aquí:
☰ → Ajustes → Notificación y sonidos → Llamadas → Aceptar llamadas en este dispositivo.

Ver también


Cómo configurar el modo Gateway para recibir y realizar llamadas a través de la cuenta única de Telegram de la empresa

Lo que ven los usuarios cuando llaman a una única cuenta de Telegram a través de SIP.TG, conjunto de funciones a su disposición (DTMF, respuesta automática, selección de línea, botón de devolución de llamada, indicación del número de extensión y devolución de llamada).

Limitaciones y particularidades de hacer llamadas de voz en Telegram a través de la pasarela SIP.TG

Pasarela SIP.TG para la integración de Telegram Calls con sistemas CRM, recibiendo llamadas entrantes y realizando llamadas salientes a usuarios de Telegram vía PBX

Opciones de pago de la pasarela SIP.TG para la transferencia de llamadas entre Telegram y la telefonía SIP

Finalidad, ventajas, instalación y configuración de servidores Worker propios para SIP.TG

Finalidad, ventajas, instalación y configuración de su propio almacén de sesiones de Telegram para SIP.TG

El quid del problema con la librería tg2sip (libtgvoip) con los clientes de Telegram en Android y la solución propuesta desde SIP.TG