Principio de configuración de la puerta de enlace
en el lado de la centralita
Configuración en el lado de la centralita (o módulo de telefonía). CRM) se realiza después de conectar la sesión a la cuenta de Telegram deseada en el lateral @siptg_bot y elegir un método de comunicación con el PBX.
La configuración del lado de la centralita consta de dos etapas fundamentales:
A diferencia de los números de teléfono estándar, al llamar desde Telegram en calidad Caller-ID puede venir en uno de tres valores (id de usuario, username, número de teléfono de la cuenta) y al realizar llamadas salientes debe cumplir con una serie de restricciones de Telegram para protegerse contra el spam.
Puede probar el flujo de llamadas utilizando el plan gratuito, pero tiene una serie de restricciones de llamadas. Puede eliminar las restricciones durante 1 semana activando la tarifa de prueba por 100 rublos. Después de probar el sistema, deberás conectarte a una de las tarifas pagas para utilizarlo.
ver también Funciones de configuración de la puerta de enlace con varios CRM sistemas.
La configuración del lado de la centralita consta de dos etapas fundamentales:
- Conexión de una troncal SIP
- Configurar el enrutamiento de llamadas
A diferencia de los números de teléfono estándar, al llamar desde Telegram en calidad Caller-ID puede venir en uno de tres valores (id de usuario, username, número de teléfono de la cuenta) y al realizar llamadas salientes debe cumplir con una serie de restricciones de Telegram para protegerse contra el spam.
Puede probar el flujo de llamadas utilizando el plan gratuito, pero tiene una serie de restricciones de llamadas. Puede eliminar las restricciones durante 1 semana activando la tarifa de prueba por 100 rublos. Después de probar el sistema, deberás conectarte a una de las tarifas pagas para utilizarlo.
ver también Funciones de configuración de la puerta de enlace con varios CRM sistemas.
Paso 1: Conexión de una troncal SIP
Una troncal SIP es una línea para recibir y realizar llamadas; mediante troncales, los números de telefonía estándar se conectan al PBX. En el caso de una puerta de enlace 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 nombre de la cual pueden devolver la llamada.
Todos los SIP-PBX modernos tienen la capacidad de conectar números (troncales) de forma independiente. En el caso de algunas centralitas virtuales, conectar una nueva troncal puede requerir enviar la solicitud correspondiente al servicio de soporte, pero en general este es un procedimiento estándar simple.
Dependiendo de la PBX específica y del método de comunicación con los servidores SIP.TG utilizado (que se selecciona en el bot, uno de tres), el procedimiento para conectar la troncal difiere.
Con el método de registro PBX->SIP.TG (el más sencillo y utilizado) en el lado de PBX para la línea troncal conectada, debe especificar los parámetros estándar (servidor, inicio de sesión, contraseña) que se obtienen en @siptg_bot en la sección /gateway al elegir el método de registro adecuado.
Con el método de registro SIP.TG->PBX en el lado de PBX, debe obtener los detalles de la cuenta SIP para conectar la troncal (dirección de PBX, inicio de sesión, contraseña), que luego deben especificarse en @siptg_bot en la sección /gateway para el tipo de comunicación apropiado.
Con método de comunicación IP-IP en el lado @siptg_bot debe especificar la dirección de la PBX, el número a llamar en el lado de la PBX (y opcionalmente el campo: valor), y luego realizar una llamada desde la PBX a la dirección y puerto recibido de @siptg_bot en la sección /gateway para el método de comunicación correspondiente.
A veces puede ser necesario especificar explícitamente @siptg_bot para el método de comunicación correspondiente. Servidor de trabajo utilizado (en el país deseado o en el tuyo propio), Protocolo de comunicación (UDP, TCP, TLS), conjunto de códecs utilizados, método de transmisión de señales DTMF.
Para obtener más detalles, consulte las instrucciones de configuración en el lado @siptg_bot
--
Después de conectar con éxito la troncal en la interfaz PBX y bot, debe marcarse como activa y lista para funcionar. Después de configurar el enrutamiento básico de llamadas, puede realizar sus primeras llamadas de prueba.
Todos los SIP-PBX modernos tienen la capacidad de conectar números (troncales) de forma independiente. En el caso de algunas centralitas virtuales, conectar una nueva troncal puede requerir enviar la solicitud correspondiente al servicio de soporte, pero en general este es un procedimiento estándar simple.
Dependiendo de la PBX específica y del método de comunicación con los servidores SIP.TG utilizado (que se selecciona en el bot, uno de tres), el procedimiento para conectar la troncal difiere.
Con el método de registro PBX->SIP.TG (el más sencillo y utilizado) en el lado de PBX para la línea troncal conectada, debe especificar los parámetros estándar (servidor, inicio de sesión, contraseña) que se obtienen en @siptg_bot en la sección /gateway al elegir el método de registro adecuado.
Con el método de registro SIP.TG->PBX en el lado de PBX, debe obtener los detalles de la cuenta SIP para conectar la troncal (dirección de PBX, inicio de sesión, contraseña), que luego deben especificarse en @siptg_bot en la sección /gateway para el tipo de comunicación apropiado.
Con método de comunicación IP-IP en el lado @siptg_bot debe especificar la dirección de la PBX, el número a llamar en el lado de la PBX (y opcionalmente el campo: valor), y luego realizar una llamada desde la PBX a la dirección y puerto recibido de @siptg_bot en la sección /gateway para el método de comunicación correspondiente.
A veces puede ser necesario especificar explícitamente @siptg_bot para el método de comunicación correspondiente. Servidor de trabajo utilizado (en el país deseado o en el tuyo propio), Protocolo de comunicación (UDP, TCP, TLS), conjunto de códecs utilizados, método de transmisión de señales DTMF.
Para obtener más detalles, consulte las instrucciones de configuración en el lado @siptg_bot
--
Después de conectar con éxito la troncal en la interfaz PBX y bot, debe marcarse como activa y lista para funcionar. Después de configurar el enrutamiento básico de llamadas, puede realizar sus primeras llamadas de prueba.
Configuración de fuegoall en el lado de la centralita
Si estás usando Firewall Para proteger su PBX, asegúrese de que las direcciones actuales de nuestros servidores Worker desde los cuales se conecta al PBX estén incluidas en la lista blanca.
Todas las direcciones IP de nuestros servidores están enumeradas en el archivo:
https://files.sip.tg/fw.txt
A veces la red de servidores Worker se actualiza, informamos sobre esto en el canal de noticias. @siptg_noticias (recomendamos que los administradores se suscriban).
Todas las direcciones IP de nuestros servidores están enumeradas en el archivo:
https://files.sip.tg/fw.txt
A veces la red de servidores Worker se actualiza, informamos sobre esto en el canal de noticias. @siptg_noticias (recomendamos que los administradores se suscriban).
Acerca de la infraestructura del servidor de trabajo
La infraestructura de los servidores de SIP.TG Worker está protegida de forma fiable, los servidores son rápidamente escalables si es necesario y están ubicados en diferentes áreas geográficas.
Si es necesario, puede especificar un servidor de trabajo específico para todas las cuentas SIP vinculadas, incluidas aquellas ubicadas en sus propios servidores.
Para utilizar su propio servidor Worker (o varios), instale y configure el módulo apropiado, luego especifíquelo en la configuración de conexión (esta función NO se proporciona en los planes de tarifas gratuitos).
Obtenga más información sobre cómo instalar sus propios servidores Worker
Si es necesario, puede especificar un servidor de trabajo específico para todas las cuentas SIP vinculadas, incluidas aquellas ubicadas en sus propios servidores.
Para utilizar su propio servidor Worker (o varios), instale y configure el módulo apropiado, luego especifíquelo en la configuración de conexión (esta función NO se proporciona en los planes de tarifas gratuitos).
Obtenga más información sobre cómo instalar sus propios servidores Worker
Bloqueo de direcciones IP de PBX por contraseñas incorrectas
Especifique cuidadosamente los detalles de conexión a los servidores SIP.TG. Hemos activado la protección de fuerza bruta con contraseña, por lo que la dirección IP de la centralita puede bloquearse por un período de tiempo arbitrario si se conecta a servidores SIP.TG sin la opción de registro habilitada, con un inicio de sesión o contraseña incorrectos, desde una IP que no es de confianza, etc.
Paso 2: configurar el enrutamiento de llamadas
Llamadas entrantes y salientes de usuarios. Telegram entre la puerta de enlace y la PBX se producen de la misma manera, independientemente del método de conexión de la puerta de enlace a la PBX.
Cuando hay una llamada entrante de un usuario Telegram el número y el nombre de la persona que llama se transfieren a la cuenta Gateway en la centralita, y para una llamada saliente es suficiente indicar el número de usuario en uno de los formatos aceptables (ID de usuario, username, phone).
Cuando hay una llamada entrante de un usuario Telegram el número y el nombre de la persona que llama se transfieren a la cuenta Gateway en la centralita, y para una llamada saliente es suficiente indicar el número de usuario en uno de los formatos aceptables (ID de usuario, username, phone).
Llamadas entrantes a centralita desde Telegram
Después de conectar la troncal SIP para llamadas, no olvide indicar cuál de los usuarios (empleados) de la central recibirá llamadas entrantes desde ella.
Después de configurar el destinatario de las llamadas entrantes, puede realizar una llamada de prueba a la cuenta de Telegram conectada al Gateway para asegurarse de que las llamadas entrantes se realicen.
¡Importante! Es mejor realizar una llamada de prueba desde un dispositivo donde la cuenta Gateway no esté conectada. La llamada llegará simultáneamente a la centralita y a todos los dispositivos donde esté conectada la cuenta de Telegram Gateway.
Si hay un retraso en la centralita para descolgar el auricular, entonces la llamada se puede recibir desde la aplicación Telegram, pero dicha llamada no pasará por la centralita.
Para que la llamada llegue solo al PBX, debes desactivar las llamadas en otros dispositivos con una cuenta Gateway conectada. Esto se hace en la configuración de la aplicación Telegram para la cuenta Gateway (☰ → Configuración → Notificación y Sonidos → Calls → Aceptar calls en este dispositivo).
Todas las funciones de PBX disponibles para llamadas de voz se aplican a las llamadas a través del Gateway: grabación de llamadas, transferencia y retención de llamadas, menú de voz, llamadas grupales, indicaciones, etc.
Presta atención a qué Caller-ID cuando se recibe una llamada entrante, corresponde a la configuración especificada en el lado @siptg_bot (id de usuario, username o número de teléfono de cuenta + prefijo o sufijo utilizado).
Además, el campo C se transmite a la central desde el Gatewayaller-Name, que puede contener uno o más valores disponibles sobre el usuario de Telegram que llama (nombre, username, Phone).
Más información sobre la configuración de los valores pasados por Caller-ID y Caller-nombre (paso 5)
Después de conectar la troncal SIP para llamadas, no olvide indicar cuál de los usuarios (empleados) de la central recibirá llamadas entrantes desde ella.
Después de configurar el destinatario de las llamadas entrantes, puede realizar una llamada de prueba a la cuenta de Telegram conectada al Gateway para asegurarse de que las llamadas entrantes se realicen.
¡Importante! Es mejor realizar una llamada de prueba desde un dispositivo donde la cuenta Gateway no esté conectada. La llamada llegará simultáneamente a la centralita y a todos los dispositivos donde esté conectada la cuenta de Telegram Gateway.
Si hay un retraso en la centralita para descolgar el auricular, entonces la llamada se puede recibir desde la aplicación Telegram, pero dicha llamada no pasará por la centralita.
Para que la llamada llegue solo al PBX, debes desactivar las llamadas en otros dispositivos con una cuenta Gateway conectada. Esto se hace en la configuración de la aplicación Telegram para la cuenta Gateway (☰ → Configuración → Notificación y Sonidos → Calls → Aceptar calls en este dispositivo).
Todas las funciones de PBX disponibles para llamadas de voz se aplican a las llamadas a través del Gateway: grabación de llamadas, transferencia y retención de llamadas, menú de voz, llamadas grupales, indicaciones, etc.
Presta atención a qué Caller-ID cuando se recibe una llamada entrante, corresponde a la configuración especificada en el lado @siptg_bot (id de usuario, username o número de teléfono de cuenta + prefijo o sufijo utilizado).
Además, el campo C se transmite a la central desde el Gatewayaller-Name, que puede contener uno o más valores disponibles sobre el usuario de Telegram que llama (nombre, username, Phone).
Más información sobre la configuración de los valores pasados por Caller-ID y Caller-nombre (paso 5)
Llamadas salientes desde PBX a Telegram
Para realizar llamadas salientes a través de la línea Gateway conectada (troncal en Telegram), en la configuración de la centralita suele ser necesario indicar explícitamente cuál de los usuarios (empleados) de la centralita tiene el derecho correspondiente.
Dependiendo del sistema utilizado, los usuarios de PBX pueden seleccionar explícitamente una línea saliente para llamar en sus softphones (terminales de trabajo), o la selección de línea solo puede ocurrir automáticamente según el prefijo o sufijo del número del usuario llamado.
Como número de usuario para llamarlo al Telegram puedes usar uno de tres valores:
Para realizar llamadas salientes a través de la línea Gateway conectada (troncal en Telegram), en la configuración de la centralita suele ser necesario indicar explícitamente cuál de los usuarios (empleados) de la centralita tiene el derecho correspondiente.
Dependiendo del sistema utilizado, los usuarios de PBX pueden seleccionar explícitamente una línea saliente para llamar en sus softphones (terminales de trabajo), o la selección de línea solo puede ocurrir automáticamente según el prefijo o sufijo del número del usuario llamado.
Como número de usuario para llamarlo al Telegram puedes usar uno de tres valores:
- ID de usuario interno del usuario. (usualmente se usa con el prefijo * o 0, u otro signo, tiene una longitud arbitraria, de 5 a 20 dígitos, disponible para todos los usuarios)
- número de teléfono del usuario, atado a Telegram-cuenta (10 dígitos, se puede ocultar mediante configuración de privacidad)
- username usuario en Telegram (sin el símbolo @ al principio, solo letras y números latinos, es posible que no se instalen, son compatibles con algunas PBX)
Recomendamos usar ID de usuario como Caller-ID y número llamado con prefijo 0 o *, esta es la forma más universal. Pero vale la pena recordar que no puedes llamar a un usuario primero usando su ID de usuario si aún no has mantenido correspondencia mutua con él. Si aún necesita llamar a un usuario fuera de su lista de contactos, utilice su número de teléfono (si no está oculto) o username (si tu PBX lo permite).
Sobre el prefijo antes de Caller-ID (ID de usuario o número de teléfono). Para distinguir los números de usuario de Telegram (ID de usuario o número de teléfono de cuenta) de los números de teléfono normales en PBX y/o registros CRM Es conveniente que los sistemas les den un prefijo del lado @siptg_bot al configurar la comunicación con la PBX (recomendamos usar el símbolo * o 0). Si se da un prefijo para Caller-ID es importante para guardar en el número del usuario llamado al realizar una llamada saliente a Telegram a través de la línea Gateway conectada.
La forma más sencilla de probar llamadas salientes en Telegram Esto es para devolver una llamada a una llamada entrante anterior (es importante que el prefijo delante del número coincida, si se ha especificado uno).
Tenga especial cuidado al llamar a extraños. Cualquier usuario puede quejarse de spam si su llamada resulta inesperada. Si se recibe una cantidad significativa de quejas, la cuenta Gateway puede verse limitada o bloqueada temporalmente por algoritmos. Telegram.
Sobre el prefijo antes de Caller-ID (ID de usuario o número de teléfono). Para distinguir los números de usuario de Telegram (ID de usuario o número de teléfono de cuenta) de los números de teléfono normales en PBX y/o registros CRM Es conveniente que los sistemas les den un prefijo del lado @siptg_bot al configurar la comunicación con la PBX (recomendamos usar el símbolo * o 0). Si se da un prefijo para Caller-ID es importante para guardar en el número del usuario llamado al realizar una llamada saliente a Telegram a través de la línea Gateway conectada.
La forma más sencilla de probar llamadas salientes en Telegram Esto es para devolver una llamada a una llamada entrante anterior (es importante que el prefijo delante del número coincida, si se ha especificado uno).
Tenga especial cuidado al llamar a extraños. Cualquier usuario puede quejarse de spam si su llamada resulta inesperada. Si se recibe una cantidad significativa de quejas, la cuenta Gateway puede verse limitada o bloqueada temporalmente por algoritmos. Telegram.
Restricciones de Telegram en llamadas salientes
Si aún no ha habido correspondencia con el usuario, puede llamarlo primero solo por su username (puede no estar especificado para la cuenta) o por 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 decenas de llamadas diarias).
Si el volumen de llamadas es demasiado alto, puede obtener una prohibición temporal de llamadas desde Telegram (con una duración aproximada de 24 horas).
Puede llamar a un usuario por ID de usuario solo si ya ha habido algún tipo de correspondencia preliminar mutua con él, o si el usuario fue el primero en realizar una llamada a la cuenta Gateway.
Los usuarios de Telegram pueden usar su configuración para prohibir por completo las llamadas de voz entrantes de cuentas que no están en su lista de contactos (o cualquier llamada).
El número de llamadas diarias a usuarios que aún no están en tu lista de contactos es muy limitado (varias decenas de llamadas diarias).
Si el volumen de llamadas es demasiado alto, puede obtener una prohibición temporal de llamadas desde Telegram (con una duración aproximada de 24 horas).
Puede llamar a un usuario por ID de usuario solo si ya ha habido algún tipo de correspondencia preliminar mutua con él, o si el usuario fue el primero en realizar una llamada a la cuenta Gateway.
Los usuarios de Telegram pueden usar su configuración para prohibir por completo las llamadas de voz entrantes de cuentas que no están en su lista de contactos (o cualquier llamada).
retraso de llamada en Telegram
Es posible que experimentes retrasos al llamar a un usuario sin conexión. Esto se debe a la característica que se describe a continuación. Telegram.
Los operadores de telefonía móvil pueden determinar fácilmente si un usuario está en línea. Telegram funciona más difícil. El usuario recibe el estado "En línea" si se cumplen tres condiciones: la aplicación se está ejecutando, está en estado activo y el teléfono está desbloqueado. De lo contrario, el usuario se considera desconectado.
La tecnología push ayuda a obligar al usuario a conectarse. Recibe una notificación sobre una llamada entrante en Telegram y en ese momento recibe un estado en línea, incluso si no inicia sesión en la aplicación. Este enfoque ayuda a que la aplicación ahorre significativamente energía de la batería.
El tiempo entre llamar y recibir una notificación Push no está regulado. Si el teléfono está desconectado, es posible que el usuario no reciba ninguna notificación. Por lo tanto, determinar el tiempo de espera para que un usuario aparezca en la red depende de las tareas de uso del gateway y debe configurarse del lado de su centralita virtual.
El valor de tiempo de espera actual es de 15 segundos.
Los operadores de telefonía móvil pueden determinar fácilmente si un usuario está en línea. Telegram funciona más difícil. El usuario recibe el estado "En línea" si se cumplen tres condiciones: la aplicación se está ejecutando, está en estado activo y el teléfono está desbloqueado. De lo contrario, el usuario se considera desconectado.
La tecnología push ayuda a obligar al usuario a conectarse. Recibe una notificación sobre una llamada entrante en Telegram y en ese momento recibe un estado en línea, incluso si no inicia sesión en la aplicación. Este enfoque ayuda a que la aplicación ahorre significativamente energía de la batería.
El tiempo entre llamar y recibir una notificación Push no está regulado. Si el teléfono está desconectado, es posible que el usuario no reciba ninguna notificación. Por lo tanto, determinar el tiempo de espera para que un usuario aparezca en la red depende de las tareas de uso del gateway y debe configurarse del lado de su centralita virtual.
El valor de tiempo de espera actual es de 15 segundos.
Acerca de la protección Telegram de llamadas de inundaciones
Cuando hay una gran carga en los servidores. Telegram Es posible que se active la protección contra inundaciones. Para ello se introduce una restricción artificial al uso de todas o algunas llamadas Telegram API.
Si el retraso límite es de hasta 5 segundos, esta solicitud de API se repite automáticamente. De lo contrario, la solicitud finaliza con un error, que se transmite a SIP en forma de código 503 Servicio no disponible.
De acuerdo con RFC 3261, también se enviará un encabezado de reintento.After, que contiene un valor en segundos después del cual se puede reenviar la solicitud.
Si el retraso límite es de hasta 5 segundos, esta solicitud de API se repite automáticamente. De lo contrario, la solicitud finaliza con un error, que se transmite a SIP en forma de código 503 Servicio no disponible.
De acuerdo con RFC 3261, también se enviará un encabezado de reintento.After, que contiene un valor en segundos después del cual se puede reenviar la solicitud.
Si las llamadas entrantes a la cuenta Gateway se cortan inmediatamente
En la mayoría de los casos, esto sucede porque la llamada de prueba se realiza desde el mismo dispositivo donde está conectada la cuenta de la puerta de enlace. No se puede aceptar la llamada porque ya hay una llamada saliente desde el mismo dispositivo y por lo tanto se corta la llamada.
Para evitar que esto suceda, puede prohibir la recepción de llamadas en la configuración de la cuenta Gateway en el dispositivo desde el que se realizan las llamadas de prueba.
Esta configuración se realiza en la configuración de la aplicación Telegram aquí:
☰ → Configuración → Notificación y Sonidos → Calls → Aceptar calls en este dispositivo
Para evitar que esto suceda, puede prohibir la recepción de llamadas en la configuración de la cuenta Gateway en el dispositivo desde el que se realizan las llamadas de prueba.
Esta configuración se realiza en la configuración de la aplicación Telegram aquí:
☰ → Configuración → Notificación y Sonidos → Calls → Aceptar calls en este dispositivo
ver también
Cómo configurar el modo Gateway para recibir y realizar llamadas a través de un único Telegram-cuenta de la compañia
¿Qué ven los usuarios cuando llaman a un solo Telegram-cuenta a través de SIP.TG, un conjunto de funciones disponibles para ellos (DTMF, respuesta automática, selección de línea, botón de devolución de llamada, especificación de un número de extensión y llamada a través de Callespalda)
Limitaciones y características específicas de realizar llamadas de voz en Telegram a través de la puerta de enlace SIP.TG
Características de integración del SIP.TG Gateway para Telegram-llamadas de CRM sistemas, recepción de llamadas entrantes y salientes Telegram- usuarios a través de PBX
Métodos de pago de la pasarela SIP.TG para transferir llamadas entre Telegram y telefonía SIP
Objeto, ventajas, procedimiento para instalar y configurar sus propios servidores Worker para SIP.TG
Finalidad, ventajas, procedimiento para instalar y configurar su propio Almacenamiento de Sesiones Telegram para SIP.TG
La esencia del problema con la biblioteca tg2sip (libtgvoip) con Telegram-clientes para Android y la solución propuesta por SIP.TG