Interacción con la PBX
La interacción con la PBX se realiza a través de conexiones SIP, que se configuran conjuntamente tanto en el lado de la PBX como en el lado de SIP.TG.
Para crear una conexión SIP en el lado de SIP.TG:
- Inicie el bot @siptg_bot y vaya a la sección
/gateway. - Seleccione la sesión de Telegram que desea conectar a la PBX, o cree una nueva utilizando el botón “Conectar” (para más detalles, consulte Conexión de sesión paso a paso).
- Haga clic en uno de los botones para crear una nueva conexión SIP, correspondiente al tipo de conexión: ”🆕 PBX→SIP․TG”, ”🆕 SIP․TG→PBX” o ”🆕 IP⇿IP”.
Configuración de la conexión SIP a la PBX
La mayoría de los ajustes se muestran directamente en los botones como valores actuales. Para cambiar estos ajustes, simplemente haga clic en el botón correspondiente e ingrese un nuevo valor cuando el bot lo solicite.
Sin embargo, algunos botones funcionan de manera diferente:
- Worker: al hacer clic, aparece una lista de servidores Worker disponibles. Seleccione el servidor deseado de la lista para ver su descripción detallada y asignarlo.
- Botones con marcas de verificación, como “DTMF ent.”, “DTMF sal.”, “Rellamar”, “Líneas”, “Procesamiento de mensajes”, “Callback” y “Compartir suscripción”, funcionan como interruptores. Un clic activa o desactiva la opción.
- Protocolo de conexión (UDP/TCP/TLS): cada clic cambia al siguiente protocolo disponible.
- Mostrar cuenta y Restablecer contraseña: muestran los parámetros de conexión a SIP.TG que deben especificarse en el lado de la PBX.
A continuación se presentan configuraciones específicas para cada tipo de conexión SIP.
PBX → SIP.TG
En este modo, su PBX se registra en SIP.TG como cliente SIP. Usted recibe un nombre de usuario y contraseña SIP del bot y los especifica en su PBX.
Este es el método de conexión más simple y es adecuado para la mayoría de los sistemas (Asterisk, 3CX, FreePBX, etc.).
Captura de pantalla con la configuración de conexión PBX→SIP.TG
SIP.TG → PBX
Aquí, el servidor Worker de SIP.TG se registra en su PBX. En el bot, usted establece los parámetros de su PBX: nombre de usuario, contraseña y dirección.
No olvide agregar las direcciones IP de SIP.TG a la lista blanca en su PBX. Lista actual: files.sip.tg/fw.txt.
Captura de pantalla con la configuración de conexión SIP.TG→PBX
IP ⇿ IP
Ambas partes conocen la dirección IP de la otra. Se utiliza en casos donde el registro es imposible o innecesario (por ejemplo, enrutamiento estático).
Adecuado para usuarios avanzados. Requiere configuración de rutas en el lado de la PBX.
Captura de pantalla con la configuración de conexión IP⇿IP
Tipos de identificadores de llamante
Cada usuario de Telegram puede tener hasta tres tipos de identificadores:
- Número de teléfono, en el que está registrada la cuenta. Siempre está presente, pero por defecto está oculto por la configuración de privacidad para otros usuarios. Con limitaciones significativas, es posible establecer contacto con un usuario por número de teléfono.
- Nombre de usuario (Username) — este es un nombre de usuario alfabético único. Por defecto, no existe, muchos usuarios lo configuran, pero estrictamente hablando, puede estar ausente. Por el contrario, un usuario puede tener varios nombres de usuario coleccionables. Puede establecer contacto con un usuario por nombre de usuario, y las restricciones son mucho más suaves que para el número de teléfono, pero las PBX en la nube a menudo no contemplan el uso de identificadores de llamante no numéricos.
- ID de usuario (User ID) — identificador numérico interno. Siempre presente, nunca cambia, pero es imposible establecer contacto con un usuario solo por ID de usuario — puede usarse solo después de que se haya establecido contacto por uno de los otros métodos.
| Tipo de identificador | Formato | Posibilidad de contacto | Obligatorio | Modificable | Soporte de PBX |
|---|---|---|---|---|---|
| Número de teléfono | numérico | limitada | sí | sí | sí |
| Nombre de usuario | alfabético | sí | no | sí | limitado |
| ID de usuario | numérico | no | sí | no | sí |
La tabla muestra que cada identificador tiene serias limitaciones que impiden su uso en todos los escenarios. SIP.TG admite todos los tipos de identificadores y sus combinaciones, y también permite establecer la prioridad de su uso según sus necesidades.
Telegram → PBX
Para cada conexión SIP, puede establecer reglas para formar el Caller ID, que se transmitirá en el campo From en el mensaje INVITE para llamadas de Telegram → PBX.
Las reglas de formación del Caller ID consisten en varias líneas, con una regla por línea. Cada regla es una cadena de plantilla, en la que {phone}, {username} y {userid} están permitidos como parámetros de plantilla. Al formar el Caller ID final, se utiliza la primera regla, cuyos parámetros de plantilla contienen valores sobre el usuario de Telegram que llama.
Además del Caller ID, el campo From también puede contener el nombre del llamante (Caller Name), cuya formación también puede controlarse mediante reglas similares, pero además de los parámetros enumerados anteriormente, hay dos más:
{name}— nombre mostrado en UTF-8 (puede causar problemas en el lado de la PBX debido a los emojis);{name_ascii}— nombre mostrado convertido a ASCII (opción segura).
PBX → Telegram
Al recibir una solicitud INVITE desde el lado de la PBX, el identificador llamado se interpretará en plena conformidad con el mismo parámetro Caller ID descrito anteriormente. Sin embargo, el algoritmo para determinar el tipo de identificador y cortar prefijos y caracteres extraños en él no parece tan obvio.
Integración con CRM
La integración con CRM generalmente no se implementa directamente con SIP.TG, sino a través de una PBX a la que SIP.TG se conecta como un troncal SIP estándar. El CRM mismo “ve” las llamadas y contactos gracias a las capacidades de la PBX. Como regla general, no es necesario instalar módulos o plugins separados específicamente para SIP.TG en el CRM.
La mayoría de las veces, la interacción se organiza de la siguiente manera:
- Una llamada de Telegram llega a la Pasarela SIP.TG (cuenta de Telegram).
- La Pasarela SIP.TG convierte la llamada a SIP y la pasa a la PBX (a través del troncal SIP).
- La PBX, teniendo el módulo o plugin necesario para la integración con CRM, reconoce la llamada entrante, muestra la tarjeta del cliente, registra la llamada o realiza otras acciones.
- Al final de la conversación, los datos sobre la llamada (por ejemplo, duración, resultado) también se guardan en el CRM.
Cuando se necesita configuración adicional
Campos de encabezado SIP extendidos
Si su CRM forma o espera algunos encabezados específicos (por ejemplo, X-CRM-ID), tales situaciones se resuelven por medio de su PBX (scripts AGI en Asterisk, configuraciones personalizadas en 3CX, etc.). En el lado de SIP.TG, no hay forma de influir directamente en encabezados SIP arbitrarios.
Necesita un CallerID reenviado
En algunos casos, el CRM necesita ver el número de llamada original completo (por ejemplo, para “vincularlo” a un cliente específico). Si la llamada es desde Telegram, entonces el número puede ser cualquier cosa (o estar completamente ausente), y aquí depende de la lógica de su PBX cómo sustituir el CallerID. A veces se agrega una base de datos adicional de correspondencia “ID de Telegram → teléfono del cliente”.
Habilitación de grabación de llamadas en CRM
La grabación de llamadas puede habilitarse tanto en la propia PBX como en el modo “Grabación de llamadas” en el lado de SIP.TG (en el Softphone). Si desea almacenar grabaciones específicamente en el CRM, verifique si su PBX puede transferir archivos de grabación allí. Desde el punto de vista de SIP.TG, esta es una transmisión “transparente” de sonido a través de SIP, y no hay configuraciones adicionales para la grabación.
Consejos adicionales
- Enfoque unificado: todas las configuraciones relacionadas con CRM generalmente se realizan en la interfaz de su PBX. Usted percibe SIP.TG como un operador de telecomunicaciones regular (troncal SIP).
- PBX típicas (Asterisk, 3CX, FreeSWITCH, Yate, Oktell, Panasonic, etc.) tienen plugins o interfaces REST para la integración con CRM. Estudie la documentación de la PBX: lo más probable es que haya un ejemplo listo.
- Escenarios de recepción y enrutamiento de llamadas (IVR, cola de operadores, reenvío automático) — todas estas son funciones comunes de PBX. La Pasarela SIP.TG no limita ni complica tales escenarios: funcionan de la misma manera que con otros troncales SIP.
No complique demasiado. Para “hacer amigos” el CRM con las llamadas de Telegram, es suficiente conectar la Pasarela SIP.TG a su PBX y usar las herramientas estándar de integración CRM que están disponibles en la PBX.
Si encuentra problemas o errores, use la sección Solución de problemas.