Skip to content

FAQ

Jump to bottom
github-actions[bot] edited this page May 19, 2024 · 12 revisions

1. I am getting Error 403 all the time

Cause

If you see this error you where blocked from using the TGTG API. It is usually caused by a too high request rate. Since tools like this scanner violate the terms and conditions of TGTG they try to detect the corresponding request patterns and block them. These bans are usually temporary.

Possible Solutions

  1. Make sure you are using the latest version of the tgtg-scanner.
  2. Increase the sleepTime (config.ini) or SLEEP_TIME (environment variable) between API requests.
  3. Make sure you don't run multiple instances of the tgtg-scanner at the same time.
  4. Try using a different IP. Most ISP provide a new IP when you reconnect your internet connection.
  5. Wait some time. In most cases the error disappears after 24h.

2. How do I set up the tgtg-scanner in the Synology DSM Docker app?

Create the container as described in the official documentation Creating a Container. Set up the environment as described in the docker-compose.yml. You don't have to set up any volumes. The container will create a volume for persistent storage of your tgtg credentials by itself.

If you see the error ERROR SAVING CREDENTIALS! - [ERRNO 13] in your log (#310), the scanner has no permission to write the token files into the /token directory. To fix the permission run chown 1001:1001 /volume1/docker/tgtg/tokens on your Synology. You may need to adjust the path according to your setup.

3. How do I create a Telegram Bot?

You can create a new bot using @BotFather. Simply start a conversation with @BotFather and send /newbot. You will receive an API token for the bot. Enter this token in your config. On the next start, the scanner will help you obtain the chat_id.

For more information about the @BotFather please refer to the official documentation: https://core.telegram.org/bots#6-botfather

4. How does the reservation feature work?

Currently, the reservation feature only works with the telegram bot included in the telegram notifier. At the moment the bot cannot buy a magic bag. It can only reserve a magic bag and hold it for up to 5 minutes. After this time or when you cancel the reservation the bag will be available again.

To buy the magic bag you have to cancel the reservation with the telegram bot, which makes the item available again. Now you can click and buy it in the official TGTG app.

The bot implements the following commands.

  • \reserve: Lists all your favorite magic bags. Clicking on each of the items will trigger a reservation for one bag as soon as it is available. For each time you click on the item, an additional magic bag will be added.
  • \reservations: Lists all magic bags you activated with \reserve that have not yet been triggered. Click to cancel the reservation for the next available bag.
  • \orders: Lists all triggered and active reservations. Click to cancel the reservation.
  • \cancelall: Cancel all active reservations.

5. Docker compose files

Using Docker compose or Portainer special characters ($, {}, ...) in environment variables need to be escaped.

Working example TELEGRAM_BODY using variables:

- 'TELEGRAM_BODY=*$${{display_name}}*\n*Pickup*: $${{pickupdate}}\n*Order*: $${{link}}'
Clone this wiki locally