> ## Documentation Index > Fetch the complete documentation index at: https://docs.hurrypayments.com/llms.txt > Use this file to discover all available pages before exploring further. # Telegram notifications > Get every sale, decline, refund or incident from your Hurry account on Telegram, instantly, through your own bot. The **Telegram notifications** section lets you receive every sale, decline, refund or incident from your Hurry account on your phone as a push notification. Alerts arrive through **your own Telegram bot**: the bot is yours and only you (or your team) read its messages. You'll find this section in the side menu, under **Account > Telegram notifications**. ![Telegram notifications header with the How it works block and sample alerts](https://mintcdn.com/hurrypay/B05XlQD1B5DYmi_R/images/telegram/tg-como-funciona.jpg?fit=max\&auto=format\&n=B05XlQD1B5DYmi_R\&q=85\&s=2f50587ab1591df85848fac91fd67fbb) *** ## How it works The setup has three steps: 1. **Create a bot** in Telegram with @BotFather (1 minute). 2. **Link it** to your chat or to a team group by tapping **Start** with your code. 3. **Choose what to receive**, the language and quiet mode. From there, Hurry takes care of the rest: every sale, decline and refund reaches your phone instantly. For example: * 💸 **New sale: €49.90** · My Store · Order #1042 · Visa •••• 4242 * ❌ **Payment declined: €89.00** · Card declined (insufficient\_funds) * 📊 **Yesterday's summary** · 12 sales · \$1,240.00 · +18% > [!NOTE] > > The bot token is stored encrypted and never leaves Hurry. You can revoke it at any time from @BotFather. Until you complete the setup, you'll see the status **Not configured** at the top right. *** ## Step 1: create your bot A Telegram bot is free and is created from the app itself. **1. Open @BotFather** Open Telegram and go to **@BotFather**, the official bot for creating bots. From Hurry you can use the **Open @BotFather** link. **2. Create the bot** Type `/newbot` and send it. **3. Give it a name** For example, `My store alerts`. **4. Choose a username** It must be unique and end in `bot`, for example `mystore_alerts_bot`. **5. Copy the token** BotFather replies with the bot token (something like `123456789:AAH...`). Copy all of it. **6. Save it in Hurry** Paste the token into the **Bot token** field and click **Save bot**. Hurry validates it with Telegram when you save it. ![Step 1 Create your bot with the BotFather instructions and the Bot token field](https://mintcdn.com/hurrypay/B05XlQD1B5DYmi_R/images/telegram/tg-crea-bot.jpg?fit=max\&auto=format\&n=B05XlQD1B5DYmi_R\&q=85\&s=1315889a15dbc1b2b32b9aab4ddf2412) > [!TIP] > > If you lose the token, you can request a new one in @BotFather with `/token`. *** ## Step 2: link your chat This step unlocks once you've saved the bot token in step 1. To link it, open your bot in Telegram and tap **Start** with the code Hurry shows you (the same as typing `/start CODE`). From then on, alerts are sent to that chat. ### Receive alerts in a group If you want your team to receive them, link a group instead of your private chat: 1. Create a group in Telegram and add the bot. 2. Type `/start CODE` in the group, or paste the group ID manually. All group members will see the alerts. > [accordion] Prefer to enter the chat ID manually? > > For groups or channels, add the bot to the group and paste its ID into Hurry (it's a negative number). You can look it up with bots such as @userinfobot or @getidsbot. Then click **Link this chat**. *** ## Step 3: choose what to receive Turn on only the alerts you want to see on your phone. The CRM bell notifications stay the same: Telegram is just one more channel. ![Step 3 Choose what to receive with the Sales, Platform and account, Risk and Summary toggles](https://mintcdn.com/hurrypay/B05XlQD1B5DYmi_R/images/telegram/tg-elige-que-recibir.jpg?fit=max\&auto=format\&n=B05XlQD1B5DYmi_R\&q=85\&s=d2ff67087a4686a3df1ebcba7b1b9b2d) ### Sales | Alert | What it notifies you about | | :- | :- | | Sale charged | Every successful charge: amount, store, order, customer and card. | | Checkout started | Someone reached the payment step and left their email. Can be noisy. | | Payment declined | Card declined, 3DS failed or gateway decline, with the reason. | | Abandoned cart | When the scanner detects an abandoned checkout. | | Refund | Refunds made from Hurry, by your AI or from the gateway dashboard. | ### Risk | Alert | What it notifies you about | | :- | :- | | Dispute or chargeback | Chargebacks, bank inquiries and fraud warnings, and whether they're won or lost. | ### Platform and account | Alert | What it notifies you about | | :- | :- | | Gateways | Stripe blocks charges, automatic rotation, archived prices. | | Balance and plan | Low balance, zero balance, suspension, reactivation and validated top-ups. | | Bulk charges | Batch finished, stopped or failed, with its totals. | | Support | Replies to your tickets and notices from the Hurry team. | | Other Hurry alerts | Everything else that reaches the bell (domains, SSL...). | ### Summary | Alert | What it notifies you about | | :- | :- | | Daily summary | One message a day with yesterday's figures, at the time you choose. | *** ## Alert settings Below the toggles you have these options: ![Only sales from, Message language, Time zone and Daily summary time options](https://mintcdn.com/hurrypay/B05XlQD1B5DYmi_R/images/telegram/tg-opciones.jpg?fit=max\&auto=format\&n=B05XlQD1B5DYmi_R\&q=85\&s=c930d731735549bd792c002946ade638) * **Only sales from**: minimum amount, in USD, to receive sale alerts. Leave it empty or at 0 to receive all sales. * **Message language**: Spanish, English, Italian or French. * **Time zone**: used for quiet mode and for the daily summary time. * **Daily summary time**: at this time you receive two messages: yesterday's summary (compared with the day before) and today's figures up to that time (compared with yesterday at the same time). It includes sales, declines, refunds and disputes. For it to work, also turn on **Daily summary** in the toggles. ### Quiet mode Set a time window with **From** and **To**. During those hours nothing is sent and, when the window ends, you receive everything accumulated in a single message. Click **No quiet mode** to turn it off. ![Quiet mode with the From and To fields and the Save preferences button](https://mintcdn.com/hurrypay/B05XlQD1B5DYmi_R/images/telegram/tg-modo-silencio.jpg?fit=max\&auto=format\&n=B05XlQD1B5DYmi_R\&q=85\&s=d4eee788f8cdf87c41a39b7db4de8ead) When you're done, click **Save preferences**. *** ## Send a message and recent sends In **Send a message** you can type some text and click **Send**: it reaches your chat through the bot. It's a quick way to check everything works. Your AI can also send you messages if you've connected it from [Connect with AI](https://docs.hurrypayments.com/en/connect-with-ai-mcp.md). In **Recent sends** you see the history of messages sent by the bot. Click **Refresh** to update it. If a send fails, the reason appears here. ![Send a message and Recent sends blocks](https://mintcdn.com/hurrypay/B05XlQD1B5DYmi_R/images/telegram/tg-mensaje-envios.jpg?fit=max\&auto=format\&n=B05XlQD1B5DYmi_R\&q=85\&s=f2286ebaf9e59eced22f4b862ca5c11d) *** ## Frequently asked questions > [accordion] I'm not receiving anything > > Check that the main notifications toggle is on, that the chat is still linked and that you haven't blocked the bot in Telegram. Click **Send test message**: if it fails, the reason appears in **Recent sends**. > [accordion] Can my team receive it too? > > Yes. Create a group in Telegram, add the bot and link the group (type `/start CODE` there, or paste the group ID manually). All members will see the alerts. > [accordion] What happens if my token leaks? > > Whoever has the token can post as your bot, but can't see your Hurry data. Go to @BotFather, request `/revoke` and save the new token in Hurry. > [accordion] Does this replace the CRM notifications? > > No. The CRM bell stays the same. Telegram is just one more channel you can turn off whenever you want. This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.