What's Next?

Learning Roadmap

Now that you have your bot successfully running, mastering WhatsBotCord is just a matter of understanding its core architectural components.

We heavily recommend reading through the documentation in the following sequence. This order ensures you grasp the foundational abstractions before moving to the advanced testing, broadcasting APIs, and enterprise architecture patterns.

Stage 1: The Core Foundation

These are the fundamental building blocks of reading messages and designing robust commands.

1. Bot Configuration Understand the main Bot framework and its high-level lifecycle configuration.

2. WhatsApp IDs Understand @s.whatsapp.net, @lid, and @g.us identifiers natively to route data correctly.

3. Command Arguments Learn exactly how arguments are parsed from incoming messages and injected into your code.

4. Chat Context Master the IChatContext interface, the core wrapper isolating state within specific chat threads.

Stage 2: Interaction

Once you understand how a command is structured and how IDs map out, learn how to interact fluidly with the users typing them.

5. Sending Methods Explore all available methods for dispatching rich media, raw strings, and reactions.

6. Receiving Methods Learn how to halt command execution to dynamically wait for user replies, multimedia, or confirmations.

7. Built-in Helpers Discover built-in utilities for deep WhatsApp metadata extraction without manual regex.

Stage 2.5: Explore Real Command Examples

If you prefer to learn by reading actual code, jump straight into these hands-on command examples to see how everything ties together:

Receiving User Input Example Step-by-step tutorial on building a command that waits for a user to reply with an image.

Cancelling Commands Example Examples showing how to gracefully handle cancellations when waiting for inputs.

Commands Examples Real world examples showing how to build interactive commands using text, multimedia, and selections.

ChatMock Examples Review real-world testing suites demonstrating rigorous validation architectures for your commands.

Stage 3: Advanced APIs & Testing

Ready to break out of simple text commands? Dive into global broadcasting logic and headless execution.

8. Additional API Access the raw socket state to broadcast webhook alerts globally, entirely independent from ChatContext.

9. Testing & ChatMock Simulate environments systematically and validate logic offline without QR scans using mock injections.

Stage 4: Practical Guides & Tutorials

When you are ready to build real-world applications, these guides cover common scenarios and powerful middleware interceptors.

Events & Lifecycle Hook into the socket's lifecycle to detect connections, disconnections, and command errors.

Middleware & Plugins Intercept messages before they reach commands to apply global rate limits, bans, or logging.

Tags & Groups Learn how to target specific users in groups and handle administrative operations.