Telegram Casual Bot

icon

@KingCasualBot

Help group: @kingcasualbotayuda

GitHub Repo

Donors

The bot can continue to work thanks to donations from people who help from Patreon .

If you make a donation you can make the groups of which you are the creator become premium for a certain time.

Honor Ball

Honor Ball

Zeldabalca, Tina Arroyo, ChampPs, LucasOnrubia, Ochomas and Pokémon Go Tarragona

Ultra Ball

Ultra Ball

SurbitonTolworthPoGo and jillo71

Documentation for users

1. Events

The main functionality available in groups and channels is an event list which can be requested with the command /events.

A notification is also sent when an event begins or ends.

Event channels:


2. Pokémon Battles

This feature allows you to organize Pokémon battles such as Max Battles or Raids.

2.1 How to create a Pokémon Battle list?

2.1.1. Telegram location

Max Battle

Max Battle Telegram location example
  1. Send the power spot location from the Telegram share menu
  2. Reply to the message with the command: /maxbattle Pokémon name HH:MM Power Spot name

Raid

Raid Telegram location example
  1. Send the gym location from the Telegram share menu
  2. Reply to the message with the command: /raidbattle Pokémon name HH:MM Gym name

Max Battle

Use the command: /maxbattle campfire_link HH:MM Power Spot name

Raid

Use the command: /raidbattle campfire_link Pokémon name HH:MM Gym name

2.1.3. Only command

For power spots that have been added to the bot by an admin, a list can be created without the need to send a location or use a Campfire link.

Max Battle

If the power spot has been added use the command: /maxbattle Pokémon name HH:MM Power Spot name

NOTE: if the option Allow Power Spot without location is enabled, Max Battles can be organized even if the gym has not been added to the bot.

Raid

If the gym has been added use the command: /raidbattle Pokémon name HH:MM Gym name

NOTE: if the option Allow gym without location is enabled, Raids can be organized even if the gym has not been added to the bot.

2.1.4. Screenshot

In order to create a list in this way, the group must have at least 200 members or be premium and requires that the power spot in the screenshot has been added to the bot by an admin.

Max Battle

Max Battle screenshot example

Send an image accompanied by the following text: maxbattle HH:MM

Raid

Raid screenshot example

Send an image accompanied by the following text: raidbattle HH:MM


2.2 Organizer commands (or admin)

Commands only for the organizer or group admins that can be used to modify or update a Pokémon Battle message.

2.2.1. Change Pokémon

To change the Pokémon reply to a Pokémon Battle message using the following command: /pokemon Pokémon name.

2.2.2. Change time or date

To change the time reply to a Pokémon Battle message using the following command: /time HH:MM.

To change the time to a later day reply to a Pokémon Battle message using the following command: /time DD/HH:MM.

Where DD has to be a day later than the current day.

2.2.3. Change Power Spot name or Gym

Max Battle

To change the name of the Power Spot reply to a Pokémon Battle message using the following command: /powerspot Power Spot name.

Raid

To change the name of the Gym reply to a Pokémon Battle message using the following command: /gym Gym name.

NOTE: If the Power Spot name corresponds to a Power Spot that has been added to the bot by an admin, the location is also updated. If there is a match with more than one Power Spot or the Power Spot is not found only the name is changed.

2.2.4. Change location

To change the location of the Power Spot reply to a Pokémon Battle message with a Telegram location.

Alternatively, you can reply to a Pokémon Battle message using the following command: /locationcasual campfire_link.

2.2.5. Add a note
Pokémon Battle note example

To add a note to the end of a list reply to a Pokémon Battle message using the following command: /notecasual Note text.

2.2.6. Refloat a message

To make a Pokémon Battle message appear last in the group reply to the message using the following command: /refloat.

2.2.7. Delete a message

To delete a Pokémon Battle message reply to the message using the following command: /delete.

2.2.8. Close a message

To end a Pokémon Battle message reply to the message using the following command: /close.


2.3 Admin commands

Commands only for group admins that can be used to modify or update a Pokémon Battle message.

2.3.1. Refloat all messages

To make all Pokémon Battle messages appear last in the group use the following command: /refloatallcasual.


2.4 Set Pokémon Battle time relatively

In Pokémon Battle Commands where the time is specified as HH:MM you can also use the format +MMm. With this format, the time in the list will be MM minutes past the current time.

Examples:

/maxbattle campfire_link +60m Power Spot name

/maxbattle Machamp +30m Power Spot name

/time +20m

Screenshot of raid along with raidbattle +15m


3. Register and profile

You can register and add your friend code to enhance the experience when using the Pokémon Battles feature.

Register

By private message to @KingCasualBot, use the command /register for more info.

Friend code

Once registered, by private message to @KingCasualBot, use the command /friendcode for more info.

Profile

To view the Pokémon GO data provided during registration, write by private message to @KingCasualBot and use the command /profile.


4. Commands

Casual Bot will answer to some phrases such as:

  1. info eggs / raids / research tasks / shiny [Link eggs] | [Link raids] | [Link research tasks] | [Link shiny] : info about eggs, raids, research tasks or shiny.
    Example: info eggs .

The commands that have a link can be put in a message so that if someone clicks it, they will send the information by private message.


5. PVP/PVE commands

  1. /casualdex Pokémon (pve) : info about a Pokémon.

    The parameters in brackets are optional.

    • pve: show moves stats for PVE.
    Brackets do not have to be included. casualdex
  2. /raidcounters Pokémon (shadows) (text) : best counters for a raid Pokémon.

    The parameters in brackets are optional.

    • shadows: include shadow Pokémon.
    • text: returns the text version.
    Brackets do not have to be included. raidcounters
  3. /pokemoncodes Pokémon [league (basic) (min IV) (friendship)] : codes to filter a Pokémon.

    The parameters in square brackets are optional and are used to obtain a code for PVP. If you want to get this code you need to include the league (the rest of the parameters are optional).

    • league: great, ultra or master.
    • basic: include if you want the code for the first evolutionary phase.
    • min IV: combination of minimum IVs to be taken into account in the calculations (example: 0/0/0). Format: min# (where # is a number between 0 and 14).
    • friendship: do the calculations up to level 51 instead of 50.
    Square brackets and brackets do not have to be included. pokemoncodes
  4. /pokemonpvp Pokémon (league) (IVa/IVd/IVhp) (min IV) (min level) (friendship) (extra) : PVP-related info about a Pokémon.

    The parameters in brackets are optional.

    • league: great, ultra or master.
    • IVa/IVd/IVhp: combination of IVs to be checked.
    • min IV: combination of minimum IVs to be taken into account in the calculations (example: 0/0/0). Format: min# (where # is a number between 0 and 14).
    • min level: minimum level to be taken into account in the calculations. Format: level# (where # is a number between 1 and 51).
    • friendship: do the calculations up to level 51 instead of 50.
    • extra: shows more information.
    Brackets do not have to be included. pokemonpvp
  5. /moveinfo move : detailed info of a move.

    • move: Pokémon move.
    moveinfo
  6. /elitefast and /elitecharged : list of fast and charged moves that are only available using elite TM. These commands are only available by private message .
  7. /gbleagues : information about GO Battle League.

Documentation for admins

1. Settings

To access the bot's settings put the command /settings@KingCasualBot.

1.1. Enable or disable the bot

Allows you to enable or disable the bot. When disabled, the following remains active:

  • Commands only available to administrators.
  • Anti Spam
  • Press button to talk
  • Welcome message

1.2. General settings

1.2.1. Commands

To enable or disable the commands option.

1.2.2. PVP/PVE commands

To enable or disable the PVP/PVE commands option.

1.2.3. Delete common messages

If this option is activated, Casual Bot will delete messages such as "someone else join", "if more people go I'll join", "I'm about to join", etc.

1.2.4. Delete friend codes

With this option messages containing friend codes will be deleted. Screenshots are included (except for oddly cropped ones).

You can put a message when Casual Bot deletes a friend code using the command /fctextcasual followed by the message you want to put .

To delete the message put /fctextcasual - .

To get the current message use the command /getfctextcasual .

1.2.5. Anti Spam

Casual Bot will delete spam messages and ban the member who sent the message.

1.2.6. Press button to talk

With this option when a new member enters the group he/she will have to answer a question by pressing a button. The message has a delay of 1 second so that in the case of having another bot with a welcome message, it's displayed first.

If you've a welcome message configured with another bot and you want to use this option, it's better to configure the welcome message with Casual Bot as it would only show it if the new member presses the correct button.

press button to talk

1.3. Events

If you've not activated the events, it'll ask you to activate it. After doing this (or if you already had it enabled), you can enable or disable the command /events , the daily notification (at 8:50 am) with the event list or notifications when an event begins or ends.

To be able to modify these settings the group must have at least 11 members.


1.4. News

Allows messages sent across different news channels to be forwarded to the group.

To be able to modify these settings the group must have at least 11 members.


1.5. Timers

Allow some messages to be deleted after the specified time.


1.6. Nightly notifications

It allows to configure the behavior of some messages that are sent from 1:00 to 7:59.

✅: send with sound
🔇: send without sound
❌: don't send


1.7. Time zone

Allows you to change the group's time zone. This is used to receive notifications of events and alerts at the correct time.


1.8. Language

Allows you to change the language of the bot.


2. Pokémon Battles

If enabled, Max Battles or Raids can be organized. Go to Pokémon Battles (user) for more info.

In normal groups up to 7 Pokémon Battles can be organized simultaneously. In premium groups this limit increases to 12.

To be able to modify these settings the group must have at least 15 members.

To access the Pokémon Battles settings enter the following command /settings@KingCasualBot and press on "💥 Pokémon Battles".

The following settings can be changed in this menu:

  • Enable Max Battles: allows you to organize Max Battles
  • Enable Raid Battles: allows you to organize Raids
  • Image recognition: allows you to organize Pokémon Battles using screenshots. The group has to have at least 50 members or be premium. Go to screenshots for more info.
  • Automatic refloat: to make all Pokémon Battle messages appear last in the group every 5 minutes when there are less than 30 minutes left before the meeting time
  • Dynamax extra trainers: in Max Battles against Dynamax Pokémon increases the limit of trainers from 20 to 40
  • Allow Power Spot without location: allows you to organize Max Battles without indicating a location
  • Allow gym without location: allows you to organize Raids without indicating a location

2.1. Add a Power Spot or Gym

Power Spots or Gyms can be added to the bot in order to create Pokémon Battles by only command or using screenshots.

Add a Power Spot

To add a Power Spot use the following command /addpowerspot campfire_link Power Spot name.

Add a Gym

To add a gym use the following command /addgym campfire_link Gym name.

Add Power Spots or Gyms with the same name

If you have 2 or more Power Spots with the same name, you can distinguish between them by using the following command: /addpowerspot campfire_link Power Spot name -info Text to differentiate.

Example for 3 Power Spots with common name "Pepito Supermarkets":

/addpowerspot campfire_link1 Pepito Supermarkets -info Street Something

/addpowerspot campfire_link2 Pepito Supermarkets -info Round Square

/addpowerspot campfire_link3 Pepito Supermarkets

If a Max Battle is organized for these Power Spots it will be asked to choose which is the correct one:

Pokémon Battle example multiple POI

Equivalently, if you have 2 or more Gyms with the same name, you can distinguish between them by using the following command: /addgym campfire_link Gym name -info Text to differentiate.


2.2. Power Spots or Gyms list

Max Battle example Power Spots list

To obtain a list of previously added Power Spots use the following command: /listpowerspots.

To obtain a list of previously added Gyms use the following command: /listgyms.

The number next to each Power Spot or Gym is an identifier that can be used to delete it.


2.3. Delete Power Spot or Gym

To delete a Power Spot or Gym it is necessary to know its identifier (see previous section). Once you know its identifier, use the following command: /deletepowerspot power_spot_id to delete a Power Spot or /deletegym gym_id to delete a Gym.


2.4. Import / export Power Spots or Gyms

To be able to import or export Power Spots it is necessary to have the option activated Enable Max Battles.

To be able to import or export Gyms it is necessary to have the option activated Enable Raid Battles.

2.4.1. Import gyms Detective Pikachu

To import gyms from @detectivepikachubot you first need to get a CSV file from Google Sheet. To do this follow these steps:

  1. Go to the sheet with the gyms
  2. Press "File"
  3. Press "Download"
  4. Press "Comma Separated Values (.csv)"
Import gyms Pikachu. Download CSV

Once you have that CSV file, send the file including as description importgymspikachu.

Import gyms Pikachu. Import CSV
2.4.2. Export Power Spots or Gyms

To export the Power Spots of a group use the command /exportpowerspots.

To export the gyms of a group use the following command /exportgyms.

The message with the CSV is first attempted to be sent privately and if it cannot be sent, it is sent to the group.

2.4.3. Import Power Spots or Gyms

To import a CSV file with the same format as an export, send the file to the group including the description importpowerspots (to import Power Spots) o importgyms (to import Gyms).

Importar gimnasios Pikachu. Importar CSV

The import file only needs to include rows with modifications or new Power Spots or gyms. If any unmodified rows are included, they should be identified as duplicates.


3. Buttons

Buttons can be included in alerts , message when deleting a friend code and welcome message .

You also can use the command /casualbuttons so that the bot returns a message with buttons.

Format:

"Button text" = "https://link.com"

To put more than one button in the same row, put a comma. Example:

"Text 1" = "https://link1.com", "Text 2" = "https://link2.com"

Example:

Text
"Button text" = "https://link.com"


4. Alerts

You can send messages periodically. There is a limit of 10 alerts and they're configured with the command /alertcasual .

Command example:

/alertcasual 1 2019/10/14-12 3 10-18 Alert text

Help:

1: alert number (can be a number between 1 and 10)

2019/10/14-12: reference date with the format: year/month/day-hour

3: frequency in hours with which the alert is repeated

10-18: time period in which the alert is sent


4.1. Pin an alert

If you want Casual Bot to pin the alert it sends you can use the parameters pinnotify (notifies group members) or pin .

Example: /alertcasual 1 2019/10/14-12 3 10-18 pinnotify Alert text .


4.2. Get an alert

If you've an alert and want to edit it you can get the content of the alert (what you put with the command /alertcasual ). To do this use the command /getalert followed by the alert number. Example: /getalert 1

If you want to see all the group's alerts write /getalert all .


4.3. Delete an alert

To remove an alert, write the command /alertcasual followed by the alert number and then -. Example: /alertcasual 1 - .


4.4 Image in alerts [PREMIUM]

Instructions for adding an image to an alert:

  1. Send an image to the group.
  2. Quote the image and put the following command: /alertimagecasual #

Instructions for deleting an image from an alert:

  1. Write: /alertimagecasual # -

In both cases # refers to the alert number.


5. Welcome message

To add a welcome message use the command /welcomecasual followed by the welcome message .

Example: /welcomecasual Hello casual .

To delete the welcome message put /welcomecasual - .

To check the current welcome message put /getwelcomecasual .


5.1 Image in welcome message [PREMIUM]

Instructions for adding a welcome image:

  1. Send an image to the group.
  2. Quote the image and put the following command: /welcomeimagecasual

Instructions for deleting a welcome image:

  1. Write: /welcomeimagecasual -

6. HTML tags in messages

HTML tags can be added in alerts , message when deleting a friend code , welcome message and with the command /casualbotones .

Tags:

  • Bold: <b>text</b>
  • Italics: <i>text</i>
  • Underline: <u>text</u>
  • Strikethrough: <s>text</s>
  • Monospace: <code>text</code>

7. Text substitution in messages

Text substitution can be done in message when deleting a friend code and welcome message .

Tags:

  • New member's name: {user_name} .
  • New member's id: {user_id} .
  • New member's name and id: {user_name_id} .
  • Group name: {chat_title} .

8. Topics

Telegram allows you to configure a group in topics separating the conversations in different sections.

Replies to messages sent by members of a group are sent to the same topic from which the member sent the message.

For a bot to be able to send messages to a closed topic, it must be an admin with the "Manage topics" permission.


8.1 Set forwarding topic (events and news)

The messages forwarded by the bot from channels (events and news) do not have a origin topic and therefore you have to decide which topic to forward these messages to. By default they are sent to the general topic.

To set up a different topic to forward messages to, put the following command in the topic you want to use: /setfwtopiccasual

To delete the the forwarding topic put in any topic /setfwtopiccasual -.


8.2 Set friend codes topic

If you have activated the delete friend codes, a topic can be set up in which these types of messages are not deleted.

To set a topic for friend codes, put the following command in the topic you want to use: /setfctopiccasual

To delete the the friend codes topic put in any topic /setfctopiccasual -.


8.3 Set Pokémon Battles topic

If you have activated the Pokémon Battles, a topic can be set up in which Pokémon Battles messages can only be sent there.

To set a topic for Pokémon Battles, put the following command in the topic you want to use: /setpbtopiccasual

To delete the the Pokémon Battles topic put in any topic /setpbtopiccasual -.

Premium groups

If you make a donation from Patreon you can make the groups of which you are the creator become premium for a certain time.

NOTE: banned or restricted groups will not benefit from the advantages of premium groups.

Advantages of premium groups:

  • Extra priority when receiving events and news.
  • Be able to activate events and news in groups with few members.
  • 25 alerts can be configured instead of 10.
  • An image can be set in the welcome message.
  • 12 Pokémon Battles can be organized simultaneously.
  • Organize Pokémon Battles with screenshot if the group has less than 50 members.

Tables with info

Below are some tables with additional info about the bot.

1. Features

Legend:
✅: available
❌: not available
? : disabled by default
+XX👨‍👩‍👧‍👦: only groups with at least XX members

Feature Private Groups
Event command ?
+11👨‍👩‍👧‍👦
Daily notification (events) ?
+11👨‍👩‍👧‍👦
Notification of event started/finished ?
+11👨‍👩‍👧‍👦
Pokémon Battles ?
+15👨‍👩‍👧‍👦
Casual GO ?
+15👨‍👩‍👧‍👦
Commands ?
PVP/PVE commands ?
Settings
News ?
+11👨‍👩‍👧‍👦
Alerts
Delete common messages ?
Delete friend codes ?
Anti Spam ?
Press button to talk ?
Welcome message

2. Required permissions

⚠️ If the group has slow mode activated, it's highly recommended that you add the bot as an admin so that time restrictions are not applied when sending messages.

Feature Permissions
Event command Delete messages (recommended)
Daily notification (events) -
Notification of event started/finished -
Pokémon Battles Delete messages (recommended)
Casual GO Delete messages (recommended)
Commands -
PVP/PVE commands Delete messages (recommended)
Settings Delete messages (recommended)
News -
Alerts -
Pin alerts Pin messages
Delete common messages Delete messages
Delete friend codes Delete messages
Anti Spam Delete messages, ban users
Press button to talk Delete messages (recommended), ban users
Welcome message -
Topic closed Manage topics

F.A.Q.

1. How do I avoid spam?

The bot has 2 options to avoid spam:

The first one is used to ban accounts that are already in the group and send a message that the bot considers as spam.

The second one is to prevent spamming accounts from staying in the group.

2. How to set up a global remote raid group?

  1. In the Pokémon Battles settings enable the options:
    • Enable Raid Battles
    • Allow gym without location
  2. In the Time zone settings set UTC as time zone

    Raid Battle example using UTC time zone:

    Raid Battle using UTC time zone
  3. It's recommended to create Pokémon Battles by indicating the time relatively

Usage Policy

Only users or groups who follow Niantic Terms of Service can use the bot.

If these conditions are breached, the user or group could be banned from being able to use the bot (usually permanently).

Privacy Policy

Last Modified: February 15, 2025

By using KingCasualBot, you acknowledge that you have read and understood this Privacy Policy and agree to its contents.

1. Data collected

The bot collects the following data when interacting with it:

(i) Telegram user's ID

This is used for:

  • Determine if the user is banned from using the bot
  • Determine if the user is a spam user
  • Store data asociated to the user related to Casual GO and Pokémon Battles (if the user has used these features)

(ii) Telegram username

Only collected when the user uses Pokémon Battles feature and used for:

(iii) Pokémon GO data provided when the user registered with the bot

Only collected when the user registers with the bot and used for:

(iv) User interactions

Only collected the ones used for:

2. How is the data stored?

Telegram user's ID, Telegram username and Pokémon GO data are stored in a database and may also be stored in Telegram.

Interactions collected for debugging purposes are stored in log files that are automatically deleted after 7 days.

The rest of the data collected is stored in Telegram.

3. How has access to the data collected?

Bot's admins have access to the data collected.

4. Your rights

A request can be sent to the support group to exercise any of the rights contemplated: access, rectification, deletion, limitation of treatment and data portability.

Keep in mind that to fulfill the rights of deletion, your Telegram account will be marked as banned. Therefore, your Telegram user's ID will still be stored to acknowledge this.