> ## Documentation Index
> Fetch the complete documentation index at: https://www.sip.tg/llms.txt
> Use this file to discover all available pages before exploring further.
# Configuración del Softphone
export const bot = {
ACTIVATE_TARIFF_PLAN: "Activate subscription",
ADDRESS: "Address",
ADDRESS_PORT: "Address:port",
ADMIN_ASSIGN: "Assign administrator",
APPLY: "Apply",
ARBITRARY_CHECK: "Messages processing",
AUTORENEW: "Auto renewal",
AUTOREPLY: "Autoreply",
BACK: "Back",
BACK_TO_PAYMENT: "Back to payment",
BALANCE_TRANSFER: "Transfer",
BILLING: "Billing",
BTN_CHARGE_REDIRECT: "Confirm charge",
BTN_EMPTY_BOT: "Inline bot",
BTN_TARIFF_NEW: "Activate",
CALLBACK_CHECK: "Callback",
CALLBACK_SWITCH_OFF: "Switch off Callback mode",
CALLBACK_SWITCH_ON: "Switch on Callback mode",
CALLER_NAME: "Caller name",
CALLER_PHONE: "Caller phone",
CANCEL: "Cancel",
COMMENT: "Comment",
CONFIGURE_ACCOUNT_ALLOW_EVERYBODY: "Allow calls from all users",
CONFIGURE_ACCOUNT_ALLOW_P2P: "Allow P2P calls from everybody",
CONFIGURE_ACCOUNT_DISALLOW_GROUPS: "Disallow adding to groups",
CONFIGURE_ACCOUNT_OFF_OTHER_SESSIONS_CALLS: "Disable calls on other devices",
COUNTRY: "Country",
DELETE: "Delete",
DESCRIPTION: "Description",
DIAL_RULES: "Dial Rules",
DOC_BTN_PROVIDE: "Provide documentation",
DOMAIN: "Domain",
DTMF_METHODS: "DTMF Methods",
FIELD_VALUE: "Field:Value",
FORMATS: "Audio Codecs",
FW_ADD: "Add phone number",
FW_ADD_OTHER: "Other number",
FW_ADD_SELF: "Telegram number",
FW_ANTISPAM: "Anti-spam",
FW_BACK: "Back",
FW_BONUS_PROGRAM: "Referral program",
FW_CANCEL: "Cancel",
FW_DELETE: "Delete",
FW_NAME: "Name",
FW_NO: "No",
FW_PHONE_FORWARDING: "Remind number",
FW_RECORDER_CHAT: "Chat for recordings",
FW_RECORDER_CHECKBOX: "Call recording",
FW_SELECT_COUNTRY: "Choose country (region)",
FW_SHARE_PHONE: "Send phone number",
FW_TELL_FRIENDS: "Tell friends",
FW_YES: "Yes",
GATEWAY_IN_RESET: "Reset Password",
GATEWAY_IN_SHOW: "Show Account",
GATEWAY_OUT_NUMBER: "Number on PBX",
GENERATE_NEW: "Generate new",
GIVE_ACCESS: "Give the access",
GIVE_PHONE_NUMBER: "Give phone number",
HELP: "Help",
INLINE_QUERY: "Inline query",
INVOICE_BANK_IGNORE_CURRENT_RATE: "Ignore currency rate",
KEYPAD_IN: "DTMF In",
KEYPAD_OUT: "DTMF Out",
KEYS_GET: "Get Keys",
KEYS_RESET: "Reset Keys",
LEARN_ABOUT: "Learn about SIP.TG",
LINES: "Lines",
LINES_CHECK: "Lines",
LOGIN: "Login",
MANUAL: "Manual",
MODE_GATEWAY: "Gateway mode",
MODE_SOFTPHONE: "Softphone mode",
NAME: "Name",
NEW: "New",
NEW_IN: "🆕 PBX→SIP․TG",
NEW_IP: "🆕 IP⇿IP",
NEW_OUT: "🆕 SIP․TG→PBX",
NO: "No",
PARALLEL_DECLINE: "Decline",
PARALLEL_END: "End",
PARALLEL_SWITCH: "Switch",
PARALLEL_TRANSFER: "Transfer",
PASSWORD: "Password",
PAYER: "Payer",
PAYSYSTEM_BTN_VERIFY: "Specify country of residence",
PAYSYSTEM_DOCS_PROVIDE: "Provide documents",
PAYSYSTEM_METHOD: "Payment method",
PAY_TARIFF: "Pay",
PROLONG: "Renew",
PROMO_BUTTON_EMPTY: "Discount code",
RECONNECT: "🔄 Reconnect",
RECORDER_ACTIVATE: "🔴 Start recording",
RECORDER_ACTIVATE_FAILED: "⚠️ Start recording",
RECORDER_CHAT: "Chat for recordings",
RECORDER_CHECKBOX: "Call recording",
RECORDER_DEACTIVATE: "🟥 Stop recording",
RECORDER_DEACTIVATE_RECONNECTING: "⌛ Stop recording",
RECORDER_LOCKED: "🔒 Recording locked",
REDIAL: "Redial",
REDIAL_CHECK: "Redial",
REGISTRAR: "Proxy",
REPEAT: "Repeat",
SELECT_BOT: "Select bot",
SELECT_CHANNEL: "Select channel",
SELECT_CHAT: "Select chat",
SELECT_USER: "Select user",
SERVER_FROM_TEMPLATE: "Settings templates",
SESSION_BILLER_CHECK: "Use a shared subscription",
SESSION_CONFIGURE_ACCOUNT: "Configure Telegram account",
SESSION_LOGIN: "Connect",
SESSION_LOGOUT: "Disconnect",
SETTINGS: "Settings",
START_CALLING: "Go to calls",
SUPPORT: "Support",
SWITCH_OFF: "Switch off",
SWITCH_ON: "Switch on",
TAKE: "Take",
TARIFF_ACTIVATE_CHANGE_USER: "Change customer",
TARIFF_ACTIVATE_USER: "Activate for customer",
TARIFF_ACTIVATE_YOURSELF: "Activate yourself",
TAX_ADDRESS: "Address",
TAX_BUSINESS: "Business",
TAX_NAME: "Buyer",
TAX_NUMBER: "Tax number",
TERMINATE_SESSION: "Terminate the session",
TERMS_AGREE: "Agree with Terms and Conditions",
TG_STORAGE_OFFICIAL: "✅ SIP․TG Sessions Storage",
TRANSFER: "Transfer",
TRANSFER_BACK: "Transfer back",
TRUSTED_IPS: "Trusted IPs",
UNLINK: "Unlink",
USER: "User",
VERIFY_ROUTE_BAD: "👎 No, it's spam",
VERIFY_ROUTE_GOOD: "👍 Yes, all good",
VERIFY_ROUTE_RECOVER: "Recover incoming calls",
WORKER_AUTO: "Auto",
YES: "Yes"
};
## Roles de propietario y usuario de la cuenta SIP
**Propietario de la cuenta SIP** — un usuario de Telegram que crea una cuenta SIP en el bot [@siptg\_bot](https://t.me/siptg_bot?start=utm_docs). El propietario tiene control total sobre la creación, eliminación y modificación de los ajustes de las cuentas SIP, y también puede asignar cuentas a otros usuarios.
**Usuario de la cuenta SIP** — una persona a quien el propietario ha asignado una cuenta SIP. Puede usar la cuenta para hacer y recibir llamadas, pero no puede cambiar los ajustes de la propia cuenta.
La suscripción para el softphone debe activarse en la cuenta de Telegram del **Propietario**. La suscripción del usuario no tiene efecto en las cuentas SIP que pertenecen a otros propietarios!
## Principio de interacción con los botones de configuración
La mayoría de los ajustes se muestran directamente en los botones en forma de valores actuales. Para cambiar estos ajustes, simplemente presione el botón correspondiente e introduzca un nuevo valor según lo solicite el bot.
Sin embargo, algunos botones funcionan de manera diferente:
* **Worker**: al presionarlo, aparece una lista de servidores Worker disponibles. Seleccione el servidor deseado de la lista para asignarlo.
* **Botones con casillas de verificación**: como "Grabación de llamadas", funcionan como interruptores. Una pulsación activa o desactiva la opción.
* **{bot.RECORDER_CHAT}**: al presionarlo por primera vez, aparecerá un botón adicional para seleccionar un chat. Al presionar este botón, verá una lista de chats y canales disponibles para su selección. Elija un chat adecuado para que las grabaciones de llamadas se guarden allí.
* **{bot.USER}**: al presionarlo por primera vez, aparecerá un botón adicional para seleccionar un usuario. Al presionar este botón, puede seleccionar otro usuario de Telegram al que se le asignará esta cuenta SIP.
* **Protocolo de conexión (UDP/TCP/TLS)**: cada pulsación cambia al siguiente protocolo disponible.
## Configuración paso a paso
* Inicie el bot [@siptg\_bot](https://t.me/siptg_bot?start=utm_docs).
* Vaya a la sección `/softphone`.
* Presione el botón **{bot.NEW}** para crear una nueva cuenta SIP.
* Introduzca el nombre de usuario y la contraseña recibidos de su proveedor de telefonía IP o PBX SIP.
No utilice su nombre de usuario y contraseña simultáneamente en varios programas (widgets, otros softphones, teléfonos físicos). Esto puede provocar la pérdida de llamadas entrantes y está relacionado con las particularidades del protocolo SIP. Para cada programa (dispositivo) debe crear una cuenta SIP separada en su PBX.
* Especifique el dominio (dirección del servidor SIP).
* Si es necesario, especifique un Registrar Proxy separado (servidor de registro).
* La configuración preparada del operador de telefonía IP también se puede seleccionar del catálogo, al cual se puede acceder mediante el botón **{bot.SERVER_FROM_TEMPLATE}**.
* Seleccione el protocolo de transporte: UDP, TCP o TLS.
* Seleccione y configure los códecs de audio compatibles con su proveedor.
* Configure el método de transmisión de señales DTMF (RFC2833, INFO, inband).
* Establezca reglas para transformar números para llamadas salientes.
* Compruebe en la cuenta del proveedor SIP/PBX que la cuenta está registrada.
* Pruebe una llamada saliente (envíe un número al chat [@siptg](https://t.me/siptg)).
* Si todo está bien, pruebe una llamada entrante (al número de la cuenta SIP).
* Para errores de autorización o problemas, consulte [Solución de problemas](/es/docs/softphone/problems).
* Si es necesario, para que las llamadas no vayan a usted sino a otro empleado, asigne un usuario de Telegram a esta cuenta SIP (botón **{bot.USER}**).
* Ahora todas las llamadas irán al empleado, y usted recibirá notificaciones si hay algún problema con la cuenta SIP.
* **{bot.RECORDER_CHECKBOX}**: habilite la opción y seleccione un chat para almacenar las grabaciones.
* **{bot.DIAL_RULES}**: para cambiar el formato del número marcado (por ejemplo, +7 → 8).
Algunos ajustes surten efecto después de presionar el botón **{bot.APPLY}**, o después de 5 minutos. Después de completar los pasos, la cuenta se activará y estará lista para funcionar.
## Configuraciones disponibles
La elección de códecs afecta la calidad y compatibilidad de la comunicación de voz. Se admiten códecs Opus, alaw, mulaw, GSM y otros.
DTMF es necesario para interactuar con menús de voz. Los métodos disponibles son RFC2833 (recomendado), INFO e inband.
Puede activar o desactivar la grabación automática de llamadas, y también seleccionar un chat o canal separado para guardar las grabaciones de audio.
Permite asignar cuentas SIP a otros usuarios de Telegram, dándoles la capacidad de usar cuentas para llamadas sin acceso a la configuración.
Le permite seleccionar el servidor que se conectará a la PBX o al proveedor de telefonía.
Hay 4 tipos de servidores:
| Tipo de servidor | Descripción | Designación |
| ------------------------------------------------------- | -------------------------------------------------------------------------------------------- | ----------- |
| Servidores públicos de SIP.TG | Servidores principales respaldados por SIP.TG | ✅ |
| Servidores públicos de otros usuarios | Servidores de acceso público alojados por otros usuarios | 🌐 |
| Servidores públicos de operadores de telecomunicaciones | Disponibles con algunas Plantillas de configuración, proporcionados por proveedores externos | 📡 |
| Servidores privados | Sus propios servidores, disponibles solo para sus cuentas SIP | 🔑 |
En una suscripción gratuita, solo están disponibles algunos de los servidores públicos de SIP.TG.
Permiten transformar el número para una llamada saliente antes de enviarlo al proveedor SIP o PBX, así como eliminar cuentas SIP inadecuadas de la solicitud de selección de línea para una llamada (por ejemplo, si prefiere hacer llamadas a diferentes países a través de diferentes cuentas SIP).
Consulte la descripción detallada en la sección [Transformación de números salientes](#dialing-rules).
## Transformación de números salientes
A veces, para las llamadas salientes, es necesario cambiar automáticamente el número marcado para cumplir con los requisitos del proveedor SIP o PBX (por ejemplo, reemplazar el primer "8" con "+7" o eliminar espacios y paréntesis). En SIP.TG, esto se configura usando **Reglas de transformación** en la configuración de la cuenta SIP.
Si su proveedor acepta números en cualquier formato o está utilizando una **Plantilla de configuración** predefinida, es probable que no necesite reglas de reescritura. Antes de realizar cambios, consulte los requisitos para el formato de número con su proveedor SIP o dentro de la PBX.
Hay 2 tipos de reglas:
* **Reglas con "="** — reemplazo de parte del número.\
Si se encuentra la parte izquierda de la regla (expresión regular), se reemplaza con la parte derecha.
* **Reglas sin "="** — filtro (máscara).\
Si el número no coincide con la expresión regular, la regla interrumpe el procesamiento y no se realiza la llamada.
Todas las reglas están separadas por espacios y se aplican en secuencia. Tan pronto como el número deja de coincidir con una regla de filtro (sin "="), no se permite el uso de la cuenta SIP para llamar a ese número. Cada regla de reemplazo (con el signo "=") cambia el número antes de que sea verificado por las siguientes reglas de filtro.
### Edición de reglas en el bot
1. En el bot [@siptg\_bot](https://t.me/siptg_bot?start=utm_docs), vaya a la sección `/softphone`.
2. Seleccione la cuenta SIP deseada, presione el botón **{bot.DIAL_RULES}**.
3. Introduzca una o más reglas, separándolas con espacios.
4. Confirme los cambios.
5. Compruebe con una llamada de prueba que los números se transforman correctamente.
Todas las reglas funcionan bajo el principio de "izquierda a derecha". Tenga en cuenta que agregar demasiados filtros o reemplazos ambiguos puede llevar a resultados inesperados. Para escenarios complejos, pruebe con un par de números reales.
### Ejemplos
Consideremos la tarea: marcamos números como "8 (926) 123-45-67", pero el proveedor requiere "7XXXXXXXXXX".
Supongamos que necesitamos eliminar todos los símbolos que no sean dígitos y convertir el prefijo 8 en 7.
Aquí hay dos reglas (escritas con un espacio):
```text theme={null}
[^+*#\w]= ^8=7
```
**La primera** elimina todos los caracteres excepto dígitos, letras, más y algunos caracteres especiales (\*, #, \_).\
**La segunda** reemplaza el primer dígito 8 con 7.
Ahora si el usuario introduce `8 (926) 123-45-67`, después de la primera regla la cadena se convertirá en `89261234567`, y después de la segunda — `79261234567`.
Si necesita permitir llamadas salientes solo a números móviles rusos (que comienzan con 79 y luego 9 dígitos), use una regla de filtro:
```text theme={null}
^79\d{9}$
```
Sin el signo "=". Si el número no coincide con `^79\d{9}$`, no se utilizará la cuenta SIP.
A veces necesita descartar todo si el usuario ingresó accidentalmente un número no válido. Puede usar una regla de reemplazo a vacío:
```text theme={null}
.*=
```
Esto hará que cualquier número sea reemplazado por una cadena vacía. Si una cadena vacía no es adecuada para el operador, la llamada no se realizará.
Si encuentra problemas o errores, consulte [Solución de problemas](/es/docs/softphone/problems).