> ## Documentation Index
> Fetch the complete documentation index at: https://mavrodi.org/llms.txt
> Use this file to discover all available pages before exploring further.

# Troubleshooting Common Issues in InviteBot

> Step-by-step solutions for common problems with the InviteBot Telegram bot, Intents, Help Requests, Orders, payment details, and MAVRO balance.

This guide walks you through the most common issues participants encounter and how to resolve them. If none of the steps below solve your problem, the [Getting Help](#getting-help) section at the bottom explains how to reach your Guider or support team.

## Bot Issues

### Bot not responding to commands

<Steps>
  <Step title="Check your internet connection">
    Make sure your device has an active connection. Try opening a webpage or another app to confirm.
  </Step>

  <Step title="Restart Telegram">
    Close the Telegram app completely and reopen it, then try the command again.
  </Step>

  <Step title="Wait a few minutes">
    Occasionally the bot may be briefly unavailable due to maintenance. Wait 2–5 minutes and try again.
  </Step>

  <Step title="Contact support if the issue persists">
    If the bot still does not respond after several minutes, use `/support` to report the issue to technical support.
  </Step>
</Steps>

***

### Commands returning errors

<Steps>
  <Step title="Verify the command spelling">
    Commands are case-sensitive and must start with `/`. Check the [commands reference](/participants/commands) to confirm the exact spelling.
  </Step>

  <Step title="Check your account status and permissions">
    Some commands are only available to participants with specific statuses or after completing certain actions (for example, creating a Help Request requires a confirmed Order first).
  </Step>

  <Step title="Try again in a few minutes">
    Transient errors sometimes resolve on their own. Wait briefly and retry.
  </Step>

  <Step title="Contact support if the error repeats">
    If the same error keeps appearing, contact support with `/support` and include the command you used and the error message you received.
  </Step>
</Steps>

***

### Missing keyboard buttons

Send `/start` to the bot. This command restores the main keyboard with all standard action buttons.

***

### Not receiving Order notifications

<Steps>
  <Step title="Check Telegram notification settings">
    Open Telegram settings and make sure notifications are enabled for the bot chat.
  </Step>

  <Step title="Make sure you haven't blocked the bot">
    If you have blocked the bot in Telegram, it cannot send you messages. Unblock it in your Telegram contacts or chat settings.
  </Step>

  <Step title="Verify your Intents are active">
    Orders are only issued against active Intents. Use `/intents` to check that you have at least one Intent in **Active** status.
  </Step>

  <Step title="Ask your Guider to check your status">
    Your Guider can verify whether your account is set up correctly to receive Orders.
  </Step>
</Steps>

***

## Intents & Requests

### Can't create a Help Request

There are a few reasons why the bot may block a new Help Request:

<Steps>
  <Step title="Check that you have completed an Order first">
    For a standard Help Request, you must have provided help first — meaning at least one Order issued from your Intents must have been completed and confirmed.
  </Step>

  <Step title="Check that you have active payment details">
    You must have at least one active payment method on file. Use `/accounts` to review your details. If none are active, add one with `/account_add`.
  </Step>

  <Step title="Check whether you already have an active request">
    Only one active Help Request is allowed at a time. Use `/asks` to check. If a request is still active, wait for it to complete before creating a new one.
  </Step>
</Steps>

***

### Help Request stuck in "New" for more than 3 days

Contact your Guider directly. Your Guider reviews new Help Requests, and if more than 3 days have passed without a decision, a message to them is the right next step. Find your Guider's contact via `/start`.

***

### Intent not approved after 3 or more days

Write to your Guider. They review Intent submissions and can tell you whether a decision is pending or if any changes are needed before approval.

***

## Orders

### Sent money but can't find the "Transfer completed" button

Use the direct Order lookup command to open the Order:

```
/o_12345
```

Replace `12345` with your actual Order number. The Order card will appear with the action buttons, including **"Transfer completed"**.

***

### Recipient not confirming receipt

<Steps>
  <Step title="Preserve your transfer proof">
    Take a screenshot of the completed transfer and note the transaction ID or reference number. Keep this evidence — you may need it later.
  </Step>

  <Step title="Contact your Guider">
    Reach out to your Guider and provide them with the Order number and your transfer proof. Your Guider will contact the recipient and mediate the situation.
  </Step>

  <Step title="Allow time for escalation">
    If the recipient still does not confirm after your Guider's intervention, the Guider can escalate the dispute further within the system.
  </Step>
</Steps>

<Warning>
  Do not mark the transfer as failed or try to reverse it on your own. Always go through your Guider when a recipient is not confirming.
</Warning>

***

## Payment Details

### `/account_add` not working

Follow the bot's prompts step by step — the command is interactive and expects you to respond to each question in sequence. Read each message carefully and reply with the requested information (payment type, card number or wallet address, etc.). If you skip a step or send an unexpected reply, start the process again with `/account_add`.

***

### Wrong card number entered

You cannot edit a saved payment detail directly. To fix a wrong entry:

<Steps>
  <Step title="Add the correct details">
    Use `/account_add` to add the correct card number or payment detail.
  </Step>

  <Step title="Ask your Guider to deactivate the old entry">
    Contact your Guider and ask them to deactivate the incorrect entry. This prevents senders from accidentally using the wrong details.
  </Step>
</Steps>

***

## MAVRO & Balance

### `/balance` shows nothing

The `/balance` command is only available in **MAVRO-mode projects**. If you are in such a project and the balance is empty:

* Wait a moment and try `/balance` again — the data may be loading.
* If the balance remains empty, contact your Guider to confirm that your account is correctly set up for MAVRO tracking in this project.

***

### Can't convert MAVRO

If the **CONVERT** button does not appear on a position, or the conversion is blocked, check the following:

* **Position is in reserve** — this means the MAVRO is linked to an active Help Request. Wait until the Help Request is completed or cancelled, and the MAVRO will become available again.
* **Position is frozen** — frozen MAVRO cannot be converted. Contact your Guider for information about when the freeze will be lifted.

***

## Getting Help

If none of the steps above resolve your issue, use the following escalation path:

| Contact                                          | When to use                                                |
| ------------------------------------------------ | ---------------------------------------------------------- |
| **Your Guider** — `/start` to find their contact | First point of contact for any process or account question |
| `/lost`                                          | If your Guider has not responded for **3 or more days**    |
| `/100`                                           | To escalate to a Centurion if your Guider is unreachable   |
| `/support`                                       | For technical problems with the bot or web cabinet         |

<Note>
  Your Guider handles most questions about Intents, Help Requests, Orders, and account status. Technical support (`/support`) is for bot errors and technical failures.
</Note>