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

# Notifications

> Stay informed with real-time alerts via Telegram and Web Push

Never miss an update from your bot! GrabMyGig offers multiple notification channels to keep you informed about accepted offers and bot status.

<Frame>
  <img src="https://mintcdn.com/grabmygig/JoVmNBHctRQz5r5w/images/settings/notifications/notifications.png?fit=max&auto=format&n=JoVmNBHctRQz5r5w&q=85&s=4b0a8a16e5b37c0fdeb99f8f28110153" alt="Notifications Settings" width="673" height="669" data-path="images/settings/notifications/notifications.png" />
</Frame>

***

## Notification Channels

GrabMyGig supports two notification methods:

<Frame>
  <img src="https://mintcdn.com/grabmygig/JoVmNBHctRQz5r5w/images/settings/notifications/telegram-and-web-push.png?fit=max&auto=format&n=JoVmNBHctRQz5r5w&q=85&s=124fd2cfcaffba2a95cda058c2b57a1f" alt="Telegram and Web Push Notifications" width="658" height="578" data-path="images/settings/notifications/telegram-and-web-push.png" />
</Frame>

<CardGroup cols={2}>
  <Card title="Telegram" icon="telegram">
    Instant notifications directly to your Telegram app. Works on all devices.
  </Card>

  <Card title="Web Push" icon="bell">
    Browser notifications on your computer or mobile device. No app required.
  </Card>
</CardGroup>

***

## Setting Up Telegram Notifications

Telegram is the most reliable way to receive instant notifications, even when you're not near a computer.

<Steps>
  <Step title="Open Telegram Bot">
    Open [GrabMyGig Bot](https://t.me/GrabMyGigBot) on Telegram or search for **@GrabMyGigBot**.
  </Step>

  <Step title="Start the Bot">
    Send `/start` to the bot to activate it and receive your unique Chat ID.
  </Step>

  <Step title="Copy Your Chat ID">
    The bot will reply with your Chat ID. Copy this number.
  </Step>

  <Step title="Enter Chat ID in Settings">
    Go to **Settings** → **Notifications** and paste your Telegram Chat ID.
  </Step>

  <Step title="Enable Notifications">
    Toggle ON the notification types you want to receive via Telegram.
  </Step>
</Steps>

<Tip>
  Test your Telegram connection by clicking the **Test** button after entering your Chat ID.
</Tip>

***

## Setting Up Web Push Notifications

Web Push notifications work directly in your browser - no additional apps needed!

### Video Tutorial

<iframe width="100%" height="400" src="https://www.youtube.com/embed/lnu71Aygp40" title="Web Push Setup Tutorial" frameBorder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture" allowFullScreen />

### Step-by-Step Setup

<Steps>
  <Step title="Allow Browser Notifications">
    When prompted, click **Allow** to enable notifications from GrabMyGig.
  </Step>

  <Step title="Enable Web Push in Settings">
    Go to **Settings** → **Notifications** and toggle ON **Web Push**.
  </Step>

  <Step title="Keep Browser Open">
    Web Push works best when you have the GrabMyGig tab open or the browser running in the background.
  </Step>
</Steps>

<Warning>
  Make sure your browser allows notifications. Check your browser settings if you don't see the permission prompt.
</Warning>

***

## Notification Types

Choose which events you want to be notified about:

| Notification       | Description                                        |
| ------------------ | -------------------------------------------------- |
| **Offer Accepted** | When the bot successfully grabs a gig for you      |
| **Offer Missed**   | When a matching offer was taken by someone else    |
| **Bot Started**    | When your bot is activated                         |
| **Bot Stopped**    | When your bot is paused or stopped                 |
| **Errors**         | When the bot encounters issues that need attention |

<Info>
  We recommend enabling at least **Offer Accepted** notifications so you know when to head to a pickup location.
</Info>

***

## Telegram vs Web Push

| Feature         | Telegram                    | Web Push                |
| --------------- | --------------------------- | ----------------------- |
| **Reliability** | ⭐⭐⭐ Excellent               | ⭐⭐ Good                 |
| **Mobile**      | ✅ Works everywhere          | ⚠️ Requires browser     |
| **Offline**     | ✅ Receives when back online | ❌ Requires browser open |
| **Setup**       | Requires Telegram app       | No app needed           |
| **Speed**       | Instant                     | Instant                 |

<Tip>
  For the best experience, we recommend setting up **both** Telegram and Web Push. Use Telegram as your primary channel and Web Push as a backup.
</Tip>

***

## Troubleshooting

<AccordionGroup>
  <Accordion title="Not receiving Telegram notifications">
    * Verify your Chat ID is correct
    * Make sure you started the bot with `/start`
    * Check that you haven't blocked the bot
    * Try the **Test** button to verify the connection
  </Accordion>

  <Accordion title="Not receiving Web Push notifications">
    * Check browser notification permissions
    * Make sure notifications aren't blocked for the site
    * Try refreshing the page and re-enabling
    * Some browsers require the tab to be open
  </Accordion>

  <Accordion title="Notifications are delayed">
    * Check your internet connection
    * Telegram notifications should be instant
    * Web Push may have slight delays depending on your browser
  </Accordion>
</AccordionGroup>

***

## Next Steps

<CardGroup cols={2}>
  <Card title="Account Settings" icon="user" href="/settings/account">
    Manage your Roadie connection and subscription.
  </Card>

  <Card title="Search Settings" icon="magnifying-glass" href="/settings/search">
    Configure what offers the bot should accept.
  </Card>
</CardGroup>