Interacción con Telegram
Para que el modo Gateway funcione, necesita conectar una cuenta regular de Telegram a través de la cual pasarán las llamadas. Dos roles están involucrados en este proceso: la sesión y el administrador.
Roles de Cuentas de Sesión y Administrador
- Cuenta de sesión — una cuenta de Telegram que se utilizará como origen y receptor de llamadas. Conectada como dispositivo virtual a SIP.TG.
- Cuenta de administrador — una cuenta de Telegram que interactúa con @siptg_bot y gestiona la sesión: conecta la sesión, puede cambiar configuraciones, conectar SIP-PBX y recibir notificaciones de error.
La misma cuenta de Telegram puede utilizarse en ambos roles. Sin embargo, en un entorno corporativo, se recomienda separarlos.
Conexión de Sesión Paso a Paso
Elección de una Cuenta de Telegram
Elija una cuenta de Telegram que se utilizará como gateway. Asegúrese de que no se utilice para llamadas personales o correspondencia.
Conexión a @siptg_bot
Vaya a @siptg_bot y ejecute el comando /gateway
. Haga clic en el botón “Conectar”.
Elección del Almacenamiento de Sesión
Especifique dónde se almacenará la sesión:
- Almacenamiento en la Nube SIP.TG — simple, rápido y seguro.
- Almacenamiento propio — para empresas con requisitos de privacidad aumentados. Para más detalles, consulte Almacenamiento de Sesión de Telegram.
Introducción del número de teléfono y confirmación
Introduzca el número de teléfono de la cuenta de Telegram seleccionada. Se le enviará un código desde la cuenta oficial de Telegram, que debe introducirse en el bot para la autorización.
Si la autenticación de dos factores (2FA) está habilitada en la cuenta, se iniciará un proceso seguro de recuperación: Telegram enviará un correo electrónico al correo vinculado para restablecer la contraseña. Esto se hace para evitar transmitir su contraseña en texto plano.
Aplicación de Configuraciones de Telegram a la Cuenta
Inmediatamente después de conectar la sesión, el bot ofrecerá aplicar configuraciones recomendadas. Estas mejoran la fiabilidad y comodidad de recibir llamadas:
- Desactivar llamadas en otros dispositivos — elimina conflictos cuando una llamada llega simultáneamente a varios lugares. Permite usar la sesión de Telegram como canal solo para llamadas, y otros dispositivos — para correspondencia.
- Permitir llamadas de todos los usuarios — importante, ya que por defecto las llamadas de números desconocidos son bloqueadas por la configuración de Telegram y no llegarán a la PBX.
- Permitir llamadas P2P de todos — si es compatible, permite a Telegram transmitir audio directamente, sin reenvío a través de servidores, mejorando la calidad de la llamada y reduciendo los retrasos.
- Prohibir agregar a grupos — reduce el riesgo de recibir notificaciones innecesarias no relacionadas con tareas de llamadas.
Algunos parámetros de Telegram solo pueden cambiarse 24 horas después de conectar la cuenta. Si recibe un error — inténtelo de nuevo más tarde.
Configuraciones de Sesión SIP.TG
Captura de pantalla con configuraciones de sesión de Telegram
DTMF entrada y DTMF salida
DTMF entrada y DTMF salida
Estos parámetros habilitan o deshabilitan el uso del teclado DTMF en diferentes direcciones de llamada:
- DTMF entrada — se utiliza para llamadas entrantes de Telegram (dirección Telegram → SIP);
- DTMF salida — se utiliza para llamadas salientes a Telegram desde su PBX (dirección SIP → Telegram).
El teclado DTMF permite:
- interactuar con el menú de voz de la PBX (IVR);
- introducir números internos;
- mostrar información sobre el empleado que llama cuando se llama a un usuario de Telegram.
El teclado se activa deslizando hacia arriba durante una conversación. Los modos de transmisión compatibles (RFC2833, inband, SIP INFO) se cambian en la configuración de conexión SIP y deben coordinarse con la configuración de la PBX.
Rellamada y selección de línea
Rellamada y selección de línea
Habilita o deshabilita los botones “Rellamar” y “Líneas” para los usuarios de Telegram que interactúan con la cuenta de gateway. Los botones aparecen en el chat después de que finaliza la llamada.
Al hacer clic en el botón “Rellamar” se inicia una llamada al número interno en la PBX que se utilizó durante la conversación anterior, permitiendo conectar al usuario con un empleado o departamento específico.
El botón “Líneas” funciona aproximadamente igual con la única diferencia de que antes de iniciar la llamada, muestra las líneas conectadas a través de las cuales se puede realizar una llamada.
Procesamiento de mensajes
Procesamiento de mensajes
Habilita o deshabilita la capacidad de reaccionar a mensajes de texto que llegan a la cuenta de Telegram de la sesión. Cuando está habilitado, se abren funciones adicionales:
-
Callback — después de enviar cualquier mensaje al chat, el usuario recibirá una llamada entrante desde el gateway con la conexión subsiguiente al número enviado en el mensaje (o el número predeterminado; el comportamiento se configura en la configuración de la línea SIP).
-
Inline-bot — si no se encuentra una cuenta SIP adecuada para llamar para el mensaje, puede procesarse a través de un inline-bot externo.
-
Respuesta automática — se envía una plantilla predefinida para cada mensaje, por ejemplo:
Esta cuenta es solo para llamadas. Para correspondencia, use @support_bot.
Estas funciones pueden habilitarse por separado y el comportamiento puede configurarse dependiendo de la situación.
Inline-bot
Inline-bot
Puede conectar su propio inline-bot que se utilizará para procesar mensajes entrantes. Esto es especialmente útil en casos donde el mensaje no puede asociarse con un número de teléfono o no se requiere una llamada. El inline-bot puede:
- responder con una plantilla;
- recopilar solicitudes;
- integrarse con sistemas externos como Helpdesk, CRM, etc.
Adicionalmente, puede establecer el formato de la solicitud inline que se pasará al bot. Esto permite estructurar la solicitud del usuario para un procesamiento más preciso.
Acciones avanzadas
Acciones avanzadas
- Desvincular / Transferir — permite eliminar derechos de administrador de la cuenta actual o transferirlos a otro usuario de Telegram (ver Roles de Cuentas de Sesión y Administrador).
- Compartir suscripción — extender la suscripción del administrador a esta sesión (ver Roles de Cuentas de Sesión y Administrador y Cuentas Adicionales de Telegram).
- Desconectar — eliminar completamente el dispositivo virtual, reiniciar la sesión y opcionalmente borrar los parámetros de conexión SIP.