# BIG TIMER BOT Why BIG TIMER BOT? Keeping track of important events, meetings, and tasks can be difficult in group chats. Traditional reminder methods are often insufficient for collaborative environments, leading to missed deadlines and poor coordination. Additionally, Telegram does not offer countdown timers for specific events, such as AMAs or other meetings. The market only provides pinned messages with fixed timers, lacking countdown capabilities. πŸ’‘ **The Solution**: BIG TIMER BOT offers a comprehensive system for setting reminders and countdowns directly in Telegram. It supports one-time and recurring reminders, customizable countdown timers, and natural language processing that understands everyday reminder requests. *** ## Features βœ… **Smart Reminders** β†’ Set one-time or recurring reminders with flexible timing options.\ βœ… **Natural Language Processing** β†’ type your reminder as you would say it naturally.\ βœ… **Toggle Natural Language** β†’ Disable natural language processing when necessary in large groups.\ βœ… **Countdown Timers** β†’ Create visual countdown timers for important events.\ βœ… **Reminder Templates** β†’ Save frequently used reminders for quick reuse.\ βœ… **Snooze Functionality** β†’ Postpone reminders that you're not ready to address.\ βœ… **Follow-up System** β†’ Get nudged if you don't respond to important reminders.\ βœ… **Group & Private Chat Support** β†’ Works in both group chats and private conversations.\ βœ… **Multiple Reminder Management** β†’ View, modify, and delete your active reminders quickly. *** ## How It Works #### Setting Reminders 1️⃣ **Command Method**: Use `/reminder` to start the guided setup process. \ 2️⃣ **Natural Language Method**: Type your reminder as a sentence (e.g., "Remind me to check charts tomorrow at 9am"). \ 3️⃣ **Template Method**: Use saved templates `/usetemplate [name]` for frequent reminders. #### Getting Notifications When a reminder is due, the bot will send a notification with interactive buttons: ``` πŸ”” REMINDER: Check charts [βœ… Done] [⏰ Snooze 1h] [⏰ Snooze 2h] [⏰ Snooze 4h] [⏰ Snooze 8h] ``` If you don't respond within 10 minutes, the bot sends a follow-up notification with more urgent options: ``` ️❗ URGENT REMINDER: Check charts ⚠️ This reminder requires your attention! [❗ IMPORTANT - Mark Done ❗] [⏰ 15min] [⏰ 30min] [⏰ 1h] [⏰ 2h] ``` If you don't respond within 10 minutes, the bot sends a follow-up notification with more urgent options: ``` ‼️ VERY URGENT REMINDER: Check charts ⚠️ This reminder requires your attention! [‼️ IMPORTANT - Mark Done ‼️] [⏰ 15min] [⏰ 30min] [⏰ 1h] [⏰ 2h] ``` If you don't respond within 15 minutes, the bot sends a follow-up notification with more urgent options: ``` ‼️‼️‼️ CRITICAL REMINDER: wake up ⚠️⚠️⚠️ This reminder has never been marked as done! [❗❗❗ IMPORTANT - Mark Done ‼️] [⏰ 1h] [⏰ 2h] ``` If no reply is given, the bot will mark it in the chat as an unfinished event and will close its related loop. 4️⃣ Countdown: Use `/countdown` to start the guided setup process. 5️⃣ Enter a title for your event (e.g., "Team Meeting") 6️⃣ Specify when the event will happen (YYYY-MM-DD HH format) 7️⃣ Confirm your settings to create the countdown #### Countdown Display Once created, the countdown will: * Show a pinned message in the chat that automatically updates in real-time * Display the remaining time until the event in days, hours, minutes, and seconds * Use dynamic formatting that becomes more detailed as the event approaches #### Example Countdown Display ``` ⏱ COUNTDOWN: Team Meeting ⏳ Time Remaining: 1d 4h 23m 15s πŸ“… Event starts at: 2025-03-30 10:00 ``` As the event gets closer, the countdown updates more frequently: * Regular updates every few minutes when the event is days away * Updates every 30 seconds when less than an hour remains * Updates every 10 seconds during the final minute #### When Time's Up Once the countdown reaches zero: ``` 🚨 COUNTDOWN COMPLETE: Team Meeting ⏰ Time's up! This event is happening now! ``` #### 8️⃣ Natural Language Processing The bot can understand natural language reminder requests in your messages. \ \ For example, Simply type a message like: ``` Remind me to check charts tomorrow at 9am If the bot recognizes this as a reminder request, it will respond: I understand you want me to remind you: πŸ“ What: check charts ⏰ When: 2025-05-16 09:00 Is this correct? [Yes, set reminder] [No, cancel] ``` Tap "Yes, set reminder" to confirm ``` βœ… Reminder set! Title: check charts Time: 2025-05-16 09:00 Type: One-time ``` *** ## Getting Started {% stepper %} {% step %} ### Set Invite the Bot Add [**BIG TIMER BOT**](https://t.me/BIG_TIMER_BOT) to your Telegram group or use it in a private chat. {% endstep %} {% step %} ### Minimum Administrative Privileges Required Grant only the minimum necessary permissions to prevent the bot from being deleted or banned by other bots. * The bot will automatically ask for the required permissions. * Add the bot as an admin and confirm. * The bot is at risk without admin rights, such as the ability to delete messages.

Required permissions

{% endstep %} {% step %} ### Start the Bot ``` start@BIG_TIMER_BOT ```

Bot Started

{% endstep %} {% step %} ### Press on /help or type: ``` /help@BIG_TIMER_Bot ```

Help Menu

{% endstep %} {% step %} ### Set up a reminder by pressing on /reminder or type: ``` /reminder@BIG_TIMER_BOT ``` Follow the steps to set up a new remidner

Choose a One-time or Recurring Reminder

{% hint style="info" %} *Mind the space between the day and the hours 2025-03-30(SPACE)12:00* {% endhint %}

One Time or Recurring: How Often?

Review Summary

Confirmed Reminder

{% endstep %} {% step %} ### To view all remidners, press on /list or type: ``` /list@BIG_TIMER_BOT ```

List all saved Reminders

{% endstep %} {% step %} ### To delete existing reminders, press on/deletereminder or type: ``` /deletereminder@BIG_TIMER_BOT ```

Select Reminder to Delete

Reminder Deleted

{% endstep %} {% step %} ### Did you miss a reminder? If you miss a reminder, you shouldn’t worry. The bot will attempt to remind you three times before marking the task or reminder as undone. {% tabs %} {% tab title="Reminder" %}
{% endtab %} {% tab title="First follow up" %}
{% endtab %} {% tab title="Second follow up" %}
{% endtab %} {% tab title="Third follow up" %}

Final Reminder

{% endtab %} {% endtabs %} {% endstep %} {% step %} ### Setup a template by pressing on /template or type: {% hint style="info" %} *The `/template` command in your bot allows users to create reusable reminder templates, enhancing efficiency and consistency. Templates save time by automating the reminder setup process, ensuring that reminders follow a consistent format and reducing the risk of errors. Users can customize their templates to fit specific needs, making the reminder creation process flexible and tailored to individual preferences. By using templates, users can quickly set up reminders without re-entering the exact details each time, streamlining their workflow and maintaining organization.* {% endhint %} ``` /template@BIG_TIMER_BOT ```

Create a template

Choose Recurring Duration

Confirm Template

``` /templates ```

List all templates

{% hint style="info" %} You can press on the template name to use it directly, such as "Use DCA CNCT" or you can type `/usetemplate DCA CNCT` for faster access. {% endhint %}

Faster Access to Set Temapltes

``` /deletetemplate ```

Tap the template you want to delete

Template Deleted

{% endstep %} {% step %} ### Countdown Functions **`/countdown` - Create a countdown timer by following the steps.**

Summary Confirmation

Countdown Confirmation

Pinned Message of the Countdown timer 23 hrs 58 mins 45s

Pinned Message of the Countdown timer 23 hrs 58 mins 5s

{% endstep %} {% step %} ### Would you like to know how long it is until the pinned AMA starts? Besides the timer in the pinned message, you can use the command `/howlong`

/howlong Command

{% endstep %} {% step %} ### **Would you like to delete any of your existing countdowns?** **`/deletecountdown`**

Tap on a Countdown Name to Delete

{% endstep %} {% step %} ### The countdown timer finished.

A message will Appear in the Chat Announcing Event Start

A new Message will be Pinned Announcing "Event is happening.

{% endstep %} {% step %} ### Natural Language Processing The bot can understand natural language reminder requests in your messages.

Examples of Natural Language

**More Natural Language Examples:** * "Remind me about the meeting at 3:30pm" * "Don't forget to call John on 2025-05-15 at 14:00" * "Reminder to pay bills in 3 days" * "Remember to water plants every day at 8am" * "Remind me to go to the gym every Monday at 6pm" * "Wake me up in 30 minutes" * "Remind me to submit report next Friday" {% endstep %} {% step %} ### Settings and Configuration Toggle natural language processing with the `/settings` command:

Toggle On

Toggle OFF

{% hint style="info" %} *The bot will detect reminder requests in regular messages when the feature is ON. When it is OFF, the bot will only respond to direct commands. Due to the high volume of messages in groups, it is advisable to turn off natural language detection in group chats and keep it on in private chats* {% endhint %} {% endstep %} {% endstepper %} *** ## Video Demonstration {% embed url="" %} Bot Demonstration {% endembed %} *** ## **Administration & Management** πŸ“Œ **Removing the Bot** * Any **admin** can remove the bot in the same way they would remove a regular member. *** ## **Troubleshooting & Support** {% hint style="danger" %} **Encountered an error message** {% endhint %}

Error message

This is a communication error message**.** If you encounter it, try retyping the command or simply typing /help and selecting your intended function.\ If the error occurs more than once in the same session, please report it directly to the [developer](https://t.me/MalkaKing). {% hint style="danger" %} #### Reminder Not Triggering {% endhint %} πŸ”Ή**Cause:** * Incorrect time format used. * Time zone issues. * Bot permission issues. **Solution:** βœ… Use the YYYY-MM-DD HH format exactly as shown.\ βœ… Ensure the time is in the future.\ βœ… Check that the bot has proper permissions.\ βœ… Check that the reminder is active using `/list`\ βœ… For testing, create a reminder for just a few minutes from now. {% hint style="danger" %} #### Natural Language Not Working {% endhint %} πŸ”Ή**Cause:** * Natural language processing might be disabled for the group. * Unclear time specification in the message. * Missing key phrases that the bot recognizes. * Use " don't " and not " dont. **Solution:** βœ… Check status with `/nlstatus`\ βœ… Enable through `/settings` if you're a group admin.\ βœ… Include clear time indicators (tomorrow, at 5pm, in 3 hours, etc.).\ βœ… Start your message with trigger phrases like "Remind me," "Remember to," or "Don't forget".\ βœ… If all else fails, use the `/reminder` command instead. **Example Phrases That Work Well:** ``` Remind me to check charts tomorrow at 9am Don't forget to call John on 2025-05-15 at 14:00 Remember to water plants every day at 8am Reminder to pay bills in 3 days ``` {% hint style="danger" %} #### Countdown Timer Not Updating {% endhint %} πŸ”Ή**Cause:** * The bot may not have permission to pin or edit messages. * The message may have been deleted accidentally. * Technical issues with Telegram's API. **Solution:** βœ… Ensure the bot has admin privileges with the ability to pin messages.\ βœ…Check that the countdown message is still visible and pinned.\ βœ…If issues persist, delete the countdown using `/deletecountdown` and create a new one.\ βœ…For very long countdowns, updates happen less frequently until the event gets closer. {% hint style="danger" %} #### Templates Not Showing {% endhint %} πŸ”Ή**Cause:** * Technical issues with Telegram's API. * Template names might be misspelled when using `/usetemplate` **Solution:** βœ… Templates are chat-specific. Create templates in each chat where you need them.\ βœ… Use `/templates` to see all templates available in the current chat.\ βœ… When using `/usetemplate`, make sure to match the template name exactly, including spaces. {% hint style="danger" %} #### Bot Not Responding {% endhint %} πŸ”Ή**Cause:** * The bot might not have proper permissions. * Telegram or server issues. * The bot was removed and re-added without adequate setup. **Solution:** Check that the bot is an admin (required for countdown timers). βœ… Try `/start@BIG_TIMER_BOT` to reinitialize the bot.\ βœ… If in a group, ensure another admin didn't restrict the bot.\ βœ… For persistent issues, try removing and re-adding the bot to the chat.\ βœ… Contact the bot [developer](https://t.me/MalkaKing) or the [BIG Ecosystem](https://t.me/BigEcosystemOfficial) team. {% hint style="danger" %} #### Message "Only group administrators can change this setting" {% endhint %} πŸ”Ή**Cause:** * You're trying to modify settings but don't have admin privileges in the group. **Solution:** βœ… Only group administrators can change bot settings.\ βœ… Ask a group admin to make the change for you.\ βœ… If you should be an admin, check your privileges in the group. *** ## Tips and Best Practices #### For Reminders * Use natural language for quick, simple reminders * Use the `/reminder` command for more precise control * Create templates for reminders you use regularly * Respond to reminder notifications promptly to avoid follow-ups * Use snooze instead of ignoring reminders you can't address immediately #### For Countdowns * Best for events within 2 days due to Telegram API limitations * Pin countdowns in busy groups to ensure visibility * Use descriptive event names for clarity * Delete old countdowns to avoid confusion #### For Templates * Create templates with clear, descriptive names * Use standard naming conventions if sharing with a team * Consider time offsets carefully (60 = 1 hour, 1440 = 1 day) * Update templates periodically as needs change *** ## **Future Improvements** * [ ] Add custom pics to the countdown timer. * [ ] Auto delete messages. * [ ] Integration with calendar apps. * [ ] Expanded recurrence options. * [ ] Priority levels for reminders. * [ ] Reminder Editting. * [ ] Not Completes tasks. * [ ] Integration with other BIG Ecosystem bots. * [ ] Ads integration. *** ## Links πŸ”— **Go to Bot:** [BIG TIMER Bot](https://t.me/BIG_TIMER_BOT) #### πŸ“²Scan Barcode

Scan to Launch the Bot πŸš€

{% hint style="info" %} ***Need Help?** Contact the bot* [*developer*](https://t.me/MalkaKing) *or check the* [*BIG Ecosystem*](https://t.me/BigEcosystemOfficial) *for feature requests or issues.* {% endhint %} --- # Agent Instructions: Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://big-ecosystem-bots.gitbook.io/big-ecosystem-bots-docs/security-and-moderation/big-timer-bot.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.