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

# Troubleshooting

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

For the correct operation of the Softphone in Telegram, you need to:

* Have an active **Softphone** subscription in the [@siptg\_bot](https://t.me/siptg_bot?start=utm_docs).
* Make sure that in Telegram privacy settings, voice calls are allowed from "Everyone" or at least from **@siptg**.
* Correctly specify the SIP server address (with the necessary port if it's non-standard), login, and password in the bot.
* If necessary, configure audio codecs and "Dialing Rules" so that they meet the requirements of your PBX or SIP provider.

<a id="faq" />

## Frequently Asked Questions

<AccordionGroup>
  <Accordion title="How does Softphone differ from Gateway?">
    **Softphone** — is when you use Telegram as a SIP client (linking to any SIP operator).

    **Gateway** — is when you connect a Telegram account to a PBX so that Telegram calls are processed by the PBX.
  </Accordion>

  <Accordion title="Can I receive regular mobile calls simultaneously?">
    Yes. Voice stream through Telegram is an internet channel, it doesn't interfere with your GSM calls.
  </Accordion>

  <Accordion title="How to enable call recording?">
    When creating an account, activate the **{bot.RECORDER_CHECKBOX}** checkbox. Available on a paid subscription (5 EUR/month per account). If necessary, you can select a separate channel/chat where audio files will be saved.
  </Accordion>

  <Accordion title="Can I temporarily disable incoming calls?">
    Yes. In the `/softphone` section of the [@siptg\_bot](https://t.me/siptg_bot?start=utm_docs) bot, open the SIP account and click **{bot.SWITCH_OFF}**.
  </Accordion>

  <Accordion title="How to assign a SIP account to another person?">
    In the [@siptg\_bot](https://t.me/siptg_bot?start=utm_docs) bot, open the settings of the desired account, click **{bot.USER}** and select your colleague's Telegram profile. Now all incoming calls will go to them, and you will remain the Owner.
  </Accordion>

  <Accordion title="Can I have two or more active SIP accounts on one Telegram?">
    Yes, if your "Softphone" subscription allows the required number of accounts. You can create several SIP accounts. For outgoing calls, a request to select an account will appear before each call.
  </Accordion>

  <Accordion title="Do I need to manually specify the SIP port (e.g., :5062)?">
    If you have a non-standard port on the operator or PBX side, specify it in the **{bot.DOMAIN}** or **{bot.REGISTRAR}** field with a colon (for example: `sip.example.com:5062`). For the standard 5060, it's not necessary to specify.
  </Accordion>
</AccordionGroup>

<a id="all" />

## Problems and Debugging

Below is an expanded list of problems that our users have encountered.

<AccordionGroup>
  <Accordion title="Not receiving incoming calls">
    **Symptoms**

    * No information about the incoming call appears in Telegram.

    **Possible causes**

    * Voice calls are prohibited at the level of your Telegram account.
    * The SIP account is being used in parallel on another device (in another Softphone, in a widget for calls through the browser, etc.).
    * The connection between your Telegram account and our **@siptg** was lost.

    **Solution**

    1. Check the settings in Telegram: make sure that in the "Privacy and Security → "Voice Calls" section, the "Everyone" option is selected.
    2. Update the SIP account password on the SIP provider or PBX side, and specify the new password for the account in the `/softphone` section of the [@siptg\_bot](https://t.me/siptg_bot?start=utm_docs).
    3. Open the chat with [@siptg](https://t.me/siptg?text=👋) and send any message.
  </Accordion>

  <Accordion title="Incoming and Callback calls are received but are dropped before or immediately after answering">
    **Symptoms**

    * When an incoming (or Callback) call arrives, the user doesn't have time to answer it, and in the **@siptg** chat it's shown with the status "Rejected call".
    * As a result, all incoming calls are automatically rejected on all devices linked to the Telegram account.
    * SIP log shows the error `486 User declined the call`.

    **Possible causes**

    * On one of the devices, the Telegram application is "stuck" in an active call state, although there are no signs of an active call.
    * During an incoming call, you're talking through another application or via mobile connection, and Telegram doesn't have access to the device's microphone.
    * You're trying to make a test call to yourself. For example, while making a call via mobile connection (thereby blocking the microphone), the call comes in through Telegram, and due to the other active call, the new Telegram call is rejected.

    **Solution**

    1. Identify the problematic device: each of your devices must be disconnected from the internet in turn until the incoming calls stop dropping. After that, the problematic device needs to be restarted or the Telegram application should be completely unloaded from memory on it.
    2. Make a test call involving two different devices, and ensure that your Telegram account is not used on the second device.
    3. If the problem repeats, collect logs from the problematic device for further analysis and troubleshooting. See [Getting Log Files from Telegram](https://telegra.ph/Telegram-App-Logs-11-02) for details.
  </Accordion>

  <Accordion title="Outgoing call does not go through (Callback mode)">
    When you send a number to the chat, the bot tries to call you back (callback). If you don't accept the incoming call in Telegram, the outgoing call won't happen.

    **What to do**:

    * Enable call notifications in Telegram.
    * Check that calls are allowed from **@siptg**.
    * Confirm the incoming call within 60 seconds.
  </Accordion>

  <Accordion title="No sound or we can't be heard (one-way audio)">
    This is most often related to codec incompatibility or UDP traffic blocking.

    **Solution**

    1. In the [@siptg\_bot](https://t.me/siptg_bot?start=utm_docs) bot in the `/softphone` section, select the SIP account, click **{bot.FORMATS}** and set a short list, for example: `opus,alaw,mulaw`.

       If necessary, specify a specific audio codec (for example, only `alaw` or `mulaw`).
    2. If the call is coming from abroad or through mobile internet, try another Worker server.
  </Accordion>

  <Accordion title="The call is dropped after 2 minutes">
    This is due to the free subscription. To remove the restriction — activate the Softphone subscription. See more at [Subscriptions Overview](/en/docs/subscriptions/pricing).
  </Accordion>

  <Accordion title="Strong delay when talking">
    This is most often due to an unstable internet connection between the Telegram user and our server.

    **Solution**

    1. Allow peer-to-peer calls in Telegram settings:
       ☰ → Settings → Privacy and Security → Calls → Peer-to-peer → Always Allow → Add Users → **@siptg**
    2. Change the connection type and device; try calling from your computer via Wi-Fi.
    3. In the [@siptg\_bot](https://t.me/siptg_bot?start=utm_docs) bot in the `/softphone` section, select the SIP account, click **Worker** and choose another server that is closer in geographical location.
  </Accordion>

  <Accordion title="Call is dropped after a few seconds after answering / No sound after answering the call">
    **Symptoms**

    * During an outgoing or incoming call, the subscriber can't be heard, or the sound suddenly disappears.
    * The call drops within 5-10 seconds.

    **Possible causes**

    * Unsuitable or conflicting audio codec.
    * The provider or PBX doesn't accept the current set of codecs, or Telegram doesn't have time to negotiate the audio stream parameters.
    * Incorrect RTP settings or errors in voice packet transmission.

    **Solution**

    1. In the [@siptg\_bot](https://t.me/siptg_bot?start=utm_docs) bot in the `/softphone` section, select the SIP account, click **{bot.FORMATS}** and set a short list, for example: `opus,alaw,mulaw`.

       If necessary, specify a specific audio codec (for example, only `alaw` or `mulaw`).
    2. Check the Worker server and firewall settings.
  </Accordion>

  <Accordion title="Error 'No lines for call' or 'No lines available for call'">
    **Symptoms**

    * When trying to make an outgoing call, the bot reports that there are no available lines.
    * Possibly, a code error appears in the logs indicating line unavailability.

    **Possible causes**

    * Incorrectly configured "Dialing Rules" that exclude correct numbers.
    * Exceeded the number of active SIP accounts allowed by the subscription.
    * Errors in SIP account parameters (incorrect login, server, or password).

    **Solution**

    1. Check the current rules: in the `/softphone` section of the [@siptg\_bot](https://t.me/siptg_bot?start=utm_docs) select the SIP account. To reset the dialing rules, click **{bot.DIAL_RULES}** and enter the value `=`.
    2. Make sure that the total number of SIP accounts corresponds to the paid subscription.
    3. Try to restart the SIP account: in the `/softphone` section of the [@siptg\_bot](https://t.me/siptg_bot?start=utm_docs) click **{bot.SWITCH_OFF}** and then **{bot.SWITCH_ON}**.
  </Accordion>

  <Accordion title="Error 'Amount of fail calls is exceeded' or 'SIP account has disallowed settings'">
    **Symptoms**

    * The bot reports that the limits of unsuccessful calls have been exceeded or that the current SIP account is not allowed by the tariff.
    * Calls don't go through due to exceeding established limits.

    **Possible causes**

    * The user has independently activated a SIP account without linking it to the administrated subscription.
    * Internal limitations of the tariff plan have been exceeded (for example, the number of unsuccessful attempts).
    * SIP accounts are incorrectly distributed or activated.

    **Solution**

    1. Check that the SIP account is enabled and linked in the `/softphone` section of the bot.
    2. Compare the number of active accounts with the data in the `/subscriptions` section.
    3. If the account was activated independently, contact support to reconfigure it for administration.
  </Accordion>

  <Accordion title="Error '503 Account is not running' / The account is labeled ⚠️ in the settings">
    **Symptoms**

    * When I try to call, an error appears that the account is not started and the call does not start.
    * In the `/softphone` section, the account is marked with the ⚠️ icon, and in the settings, the Domain / Proxy / Template fields have such an icon.

    **Possible causes**

    * Temporary outage in the SIP.TG infrastructure: no communication between Manager and Worker servers.
    * Temporary outage on the side of the telephony provider or PBX: no communication between Worker and PBX/provider servers.

    **Solution**

    1. Change the Worker server to a different one in the `/softphone` section of the bot.
    2. Wait for the connection to be restored.

    Usually errors of this type are recovered automatically after a short time.
  </Accordion>

  <Accordion title="Error 'Invalid parameters (params)' when enabling an account">
    **Symptoms**

    * When enabling a SIP account, the error "Invalid parameters (params)" appears. The account remains not connected.

    **Possible causes**

    * Required connection parameters are not specified: **{bot.LOGIN}**, **{bot.PASSWORD}**, and **{bot.DOMAIN}**.
    * The selected **Settings Template** doesn't contain a preset value for **{bot.DOMAIN}** and **{bot.REGISTRAR}** for connection.

    **Solution**

    1. Set the correct value for the **{bot.DOMAIN}** and **{bot.REGISTRAR}** parameters (if it's different), and re-enable the SIP account.
  </Accordion>

  <Accordion title="Error 'Time out (timeout)' when enabling an account">
    **Symptoms**

    * When enabling a SIP account, after some waiting the error "Time out (timeout)" appears. The account remains not connected.

    **Possible causes**

    * Incorrect SIP server address specified.
    * Firewall is active on the SIP server.
    * SIP server accepts requests on a non-standard port.
    * The server's DNS name returns an incorrect IP address or multiple IP addresses.
    * The server's DNS name returns an IPv6 address, but the SIP server is running only on IPv4.

    **Solution**

    1. Set the correct value for the **{bot.DOMAIN}** and **{bot.REGISTRAR}** parameters (if it's different), and re-enable the SIP account.
    2. For **{bot.REGISTRAR}**, specify the IP address explicitly, leaving **{bot.DOMAIN}** pointing to the DNS name.
    3. Check the receipt of SIP packets using the `sngrep` or `tcpdump` utilities.
    4. Check the Firewall rules. Set up automatic updates of the whitelist IP addresses from the file `https://files.sip.tg/fw.txt`.
  </Accordion>

  <Accordion title="Automatic call recording doesn't work">
    **Symptoms**

    * Call recording only works if it's enabled manually during each call.
    * Call recording stops after 15 seconds.

    **Possible causes**

    * The **{bot.RECORDER_CHECKBOX}** setting is not enabled in the SIP account settings.
    * When paying for the "Softphone" subscription, the "Call Recording" option was not added.

    **Solution**

    1. Check the status of the SIP account settings. See [Configuring the Softphone](/en/docs/softphone/settings) for details.
    2. Add the "Call Recording" option in the subscription settings. See [Softphone Subscription](/en/docs/subscriptions/pricing#softphone) for details.
  </Accordion>

  <Accordion title="In SIP account settings I only have 2 buttons: Switch off and Delete">
    **Symptoms**

    * In the `/softphone` section of the bot, there are no buttons with account settings ({bot.LOGIN}, {bot.PASSWORD}, {bot.DOMAIN}, {bot.REGISTRAR}, Worker, {bot.DIAL_RULES}, {bot.DTMF_METHODS}, {bot.FORMATS}). There are only **{bot.SWITCH_OFF}** and **{bot.DELETE}** buttons.

    **Possible causes**

    * You are a User of the SIP account, but not the Owner.

    **Solution**

    1. Contact the owner of the SIP account with a request to change your settings.

    See [Owner and User roles for SIP account](/en/docs/softphone/settings#roles) for more details.
  </Accordion>

  <Accordion title="SIP errors: 403, 404, 408, 503, 603...">
    * **403 Forbidden**: incorrect password/login, or the provider has blocked you.
    * **404 Not Found**: incorrect SIP domain or subscriber number not found.
    * **408 Request Timeout**: the provider is not responding, try another Worker or check the firewall.
    * **503 Service Unavailable**: the operator is experiencing temporary problems or Telegram limits have been exceeded (Too Many Requests).
    * **603 Declined**: the call is rejected by the operator or the called party.
  </Accordion>

  <Accordion title="Other rare problems and recommendations">
    * **Telegram limitations with mass calls**:\
      With a large number of outgoing calls, the system may issue `503 Too Many Requests` or `408 Timeout of waiting RPC result` errors. The solution is to reduce the speed of dialing.
    * **Problems with DTMF**:\
      If button presses are not recognized when interacting with the voice menu (IVR), change the DTMF transmission method in the settings (for example, switch from `inband` to `RFC2833` or `INFO`).
    * **Problems with registration on the Worker server**:\
      Sometimes SIP registration doesn't occur because the Worker server doesn't respond or the IP address isn't on the "whitelist". The solution is to check network settings and add the necessary IPs to the whitelist.
    * **Conflicts when independently updating settings**:\
      If users independently change SIP account parameters (for example, audio codecs, dialing rules), this can lead to errors in mass management. Centralized administration through a common "admin" account is recommended.
  </Accordion>
</AccordionGroup>

<Info>
  If the described actions didn't help, ask for assistance. See [How to Get Help](/en/docs#help) for details.
</Info>