> ## 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.

# Gateway features overview

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"
};

<Warning>
  To use the Gateway, you must have your own Telegram account for this purpose. SIP.TG does not register Telegram accounts for its users.
</Warning>

**Gateway** is a mode that allows you to connect your Telegram account to a phone PBX (office or cloud-based) to forward voice calls **to** and **from** Telegram.

This means any call to your Telegram account is handled by the PBX, and for outbound calls from the PBX, the same Telegram account can be used as the “caller number”.

<Check>
  **When it's useful**: if you have a sales or support team working via PBX and want to make and receive calls through a Telegram account (not a bot) — to stay closer to your audience in the messenger.
</Check>

<a id="use-cases" />

### Key Use Cases

* **Business Telegram account** — use a single company Telegram account that can receive many simultaneous calls via PBX.
* **Support and sales** — route Telegram calls through your PBX to a call center, specific employee, or team.
* **Outbound calling** — agents make calls from the company’s “Telegram number” instead of their personal ones.
* **Any CRM integration** — if it works with your PBX, it works with your CRM module, auto-dialer, or analytics.

<a id="how-it-works" />

## How It Works

1. Connect your Telegram account in the `/gateway` section of the [@siptg\_bot](https://t.me/siptg_bot?start=utm_docs) (this creates a virtual “SIP.TG → Telegram” device).
2. Configure the connection method with your PBX (PBX→SIP.TG, SIP.TG→PBX, or IP⇿IP).
3. For incoming calls, a user "rings" your Telegram account — but the call is routed to your PBX.
4. For outgoing calls, your PBX connects to the Telegram account, which then initiates a call to the target Telegram user.

<Info>
  See [PBX SIP connection setup](/en/docs/gateway/pbx#general) for more on the three connection methods.
</Info>

<a id="setup-flow" />

## General Setup Flow

<Steps>
  <Step title="Prepare your Telegram account">
    * Choose a Telegram account that will be used to receive and make calls. You can either create a new account for the Gateway or use an existing one.
    * Make sure in Telegram privacy settings that calls are allowed from everyone (or at least from the users you need).
  </Step>

  <Step title="Create a session in @siptg_bot">
    * Go to [@siptg\_bot](https://t.me/siptg_bot?start=utm_docs) and run the `/gateway` command.
    * Click **{bot.SESSION_LOGIN}** and select the session storage where the access key for the Telegram account will be saved.
    * Enter the phone number of the Telegram account and wait for the verification code from Telegram’s official service.
    * Once authorized, a virtual "gateway session" will be created.
  </Step>

  <Step title="Connect to your PBX">
    * Choose your connection method: PBX→SIP.TG, SIP.TG→PBX, or IP⇿IP.
    * For PBX→SIP.TG: get the SIP login and password from the bot and enter them in your PBX settings as an external SIP trunk.
    * For SIP.TG→PBX: enter your PBX SIP account credentials (login, password, server address) in the bot.
    * For IP⇿IP: provide your PBX IP address and confirm with a test call if needed.
  </Step>

  <Step title="Verify and Test">
    * Check that the trunk is registered in your PBX (or that the IP-to-IP connection is active).
    * Make a test incoming call to the Telegram account and ensure it reaches the PBX.
    * Try making an outbound call from the PBX to Telegram.
    * Set up routing rules (IVR, voice menu) inside the PBX as needed.
  </Step>
</Steps>

<a id="next-steps" />

## Next Steps

* [Telegram Integration](/en/docs/gateway/telegram) — defining roles, linking SIP.TG with your Telegram account, privacy, P2P, blocking other devices, message handling.
* [PBX Integration](/en/docs/gateway/pbx) — choosing and configuring the connection method (PBX→SIP.TG, SIP.TG→PBX, IP⇿IP); subscriber ID types and dialing behavior.
* [Troubleshooting](/en/docs/gateway/problems) — if something goes wrong.

<Tip>
  The Gateway is a powerful tool for integrating Telegram with traditional telephony. For help, see [How to Get Help](/en/docs#help).
</Tip>
