> ## 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.
# Interacción con Telegram
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"
};
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](https://t.me/siptg_bot?start=utm_docs) 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
Elija una cuenta de Telegram que se utilizará como gateway. Asegúrese de que no se utilice para llamadas personales o correspondencia.
Vaya a [@siptg\_bot](https://t.me/siptg_bot?start=utm_docs) y ejecute el comando `/gateway`. Haga clic en el botón **{bot.SESSION_LOGIN}**.
Especifique dónde se almacenará la sesión:
* **{bot.TG_STORAGE_OFFICIAL}** — 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](/es/docs/additional/modules#storage).
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:
* **{bot.CONFIGURE_ACCOUNT_OFF_OTHER_SESSIONS_CALLS}** — 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.
* **{bot.CONFIGURE_ACCOUNT_ALLOW_EVERYBODY}** — 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.
* **{bot.CONFIGURE_ACCOUNT_ALLOW_P2P}** — 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.
* **{bot.CONFIGURE_ACCOUNT_DISALLOW_GROUPS}** — 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
Estos parámetros habilitan o deshabilitan el uso del teclado DTMF en diferentes direcciones de llamada:
* **{bot.KEYPAD_IN}** — se utiliza para llamadas entrantes de Telegram (dirección Telegram → SIP);
* **{bot.KEYPAD_OUT}** — 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.
Habilita o deshabilita los botones **{bot.REDIAL}** y **{bot.LINES}** 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 **{bot.REDIAL}** 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 número se envía a la PBX sin aplicar reglas de transformación de número.
El botón **{bot.LINES}** 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. El número se envía a la PBX después de aplicar las reglas de transformación de número de la cuenta SIP seleccionada.
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:
* **{bot.CALLBACK_CHECK}** — 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).
* **{bot.BTN_EMPTY_BOT}** — si no se encuentra una cuenta SIP adecuada para llamar para el mensaje, puede procesarse a través de un inline-bot externo.
* **{bot.AUTOREPLY}** — 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.
* **{bot.UNLINK}** / **{bot.ADMIN_ASSIGN}** — 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](#roles)).
* **{bot.SESSION_BILLER_CHECK}** — extender la suscripción del administrador a esta sesión (ver [Roles de Cuentas de Sesión y Administrador](#roles) y [Sesiones adicionales](/es/docs/subscriptions/pricing#gateway)).
* **{bot.SESSION_LOGOUT}** — eliminar completamente el dispositivo virtual, reiniciar la sesión y opcionalmente borrar los parámetros de conexión SIP.
### 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.