How to Pair Your Firebox WhatsApp Bot

Learn how to connect your WhatsApp account to a Firebox Bot using a pairing code.

Introduction

Firebox WhatsApp Bot is a WhatsApp automation platform designed to provide powerful tools, automation, AI features, media utilities, group management, and other useful features directly through WhatsApp.

The bot is designed to be easy to connect and use. An active Firebox token is required to generate a WhatsApp pairing code.

Getting Started

Getting started with Firebox WhatsApp Bot is simple:

Choose a Plan → Complete Payment → Receive Token → Enter Token → Enter WhatsApp Number → Generate Pairing Code → Pair WhatsApp

After pairing is completed successfully, your WhatsApp account can be used with the Firebox Bot.

Token Plans

Firebox uses time-based tokens to control access to pairing-code generation.

7 Day Plan

Price: KSh 29

Duration: 7 days

14 Day Plan

Price: KSh 49

Duration: 14 days

30 Day Plan

Price: KSh 99

Duration: 30 days

Getting Your Token

To get a Firebox WhatsApp Bot token:

1. Open the WhatsApp Bot page.
2. Select your preferred token plan.
3. Complete the required payment.
4. After successful payment, your token will be generated.
5. Copy and securely store your token.
6. Enter the token on the bot page to continue with pairing.

Your token should be kept private because it provides access to token-protected bot functionality.

Pairing Your WhatsApp Bot

An active token is required before you can generate a pairing code.

Step 1 — Enter Your Token

Open the Firebox WhatsApp Bot page and enter your active token.

The system will verify the token before allowing you to continue.

Step 2 — Enter Your WhatsApp Number

Enter the WhatsApp phone number you want to connect to the bot.

Make sure the number is correct and uses the appropriate country code.

Step 3 — Generate a Pairing Code

After your token and phone number have been accepted, request a pairing code.

The pairing code is generated for the WhatsApp number you provided.

Step 4 — Open WhatsApp

Open WhatsApp on the phone containing the account you want to connect.

Go to:

Settings → Linked Devices → Link a Device

Step 5 — Complete Pairing

Follow the WhatsApp instructions and enter the pairing code when requested.

After successful pairing, the WhatsApp account will be connected to the Firebox Bot.

Pairing Requirements

Before starting the pairing process, make sure:

- You have an active Firebox token.
- Your WhatsApp number is correct.
- You have access to the WhatsApp account.
- Your WhatsApp application is updated.
- Your phone has an active internet connection.
- You follow the WhatsApp linked-device instructions correctly.

Token Expiration

Every token has a fixed validity period based on the plan purchased.

When the token expires, it can no longer be used for token-protected actions such as generating a new pairing code.

To continue using token-protected features, purchase a new token plan and use the newly generated token.

Bot Dashboard

The Firebox WhatsApp Bot dashboard provides a central place for managing and monitoring your bot.

Depending on the features enabled for your account, the dashboard may provide access to information such as:

- Bot connection status
- WhatsApp session information
- Token status
- Pairing tools
- Bot controls
- Available bot features
- Session management

Bot Commands

Firebox WhatsApp Bot provides commands for accessing different bot features.

Commands are organized into categories to make it easier to discover and use available functionality.

Only commands currently implemented and enabled by the bot should be used.

Main Menu

The Main Menu provides access to the bot's available features and command categories.

Use the menu to discover supported functionality without having to remember every command.

AI

The AI category provides access to supported artificial intelligence features.

Depending on the current bot implementation, AI functionality may include conversational interactions, questions and answers, content assistance, or other AI-powered tools.

Download

The Download category provides supported media and content downloading functionality.

Use the available download commands according to the supported platforms and media types.

Availability may depend on the current bot implementation and the source being requested.

Search

The Search category provides tools for searching supported information and online content.

Use the available search commands to find information through WhatsApp.

Group

The Group category contains features designed for WhatsApp groups.

These features may help with group-related tasks and automation where supported.

Admin

The Admin category contains commands that require group administrator permissions.

Admin features should only be used when the bot and the requesting user have the required permissions.

Owner

The Owner category contains restricted controls intended for the bot owner.

Owner commands should not be assumed to be available to normal users or group administrators.

Media

The Media category provides tools for working with supported media content.

Available functionality depends on the features currently implemented in the bot.

Sticker

The Sticker category provides supported sticker-related functionality.

Users can access available sticker tools through the corresponding bot commands.

Fun

The Fun category contains entertainment and interactive features designed for casual use.

Available commands may change as new features are added.

Tools

The Tools category contains general-purpose utilities provided by the bot.

These tools can be used for supported tasks that do not belong to another specific category.

Information

The Information category provides commands for retrieving supported information about the bot, users, groups, or other available data.

Utility

The Utility category contains useful general-purpose commands and helper features.

Settings

The Settings category contains supported configuration and preference controls.

Available settings depend on the current bot implementation and user permissions.

Status

The Status category provides supported status and diagnostic information.

Use available status commands to check information about the bot or its current operation.

Command Permissions

Some commands require specific permissions.

User Commands

These commands are available to normal users.

Admin Commands

These commands require the user to have appropriate group administrator permissions.

Owner Commands

These commands are restricted to the bot owner.

The required permission may vary depending on the command.

Reply-Based Commands

Some bot features can be used by replying to an existing WhatsApp message.

When a supported command is used as a reply, the bot can use the referenced message as the input for that feature.

Only features that support reply-based interaction should be used this way.

Bot Responses

The bot may respond with text, media, buttons, menus, or other supported interactive elements depending on the command and feature being used.

The response format may vary between commands.

Managing Your Session

After successfully pairing WhatsApp, the bot operates through the connected WhatsApp session.

Keep your connected WhatsApp account secure and avoid sharing access to your account or session with unauthorized people.

If session-management controls are available in the dashboard, use them to monitor and manage your connection.

Multiple Sessions

If multiple WhatsApp sessions are supported by your Firebox Bot setup, each session should be managed separately.

Always verify which WhatsApp number is being paired before generating a pairing code.

Troubleshooting

Token Not Working

If your token is rejected:

1. Check that you entered the token correctly.
2. Make sure there are no extra spaces.
3. Confirm that the token has not expired.
4. Make sure the token was successfully generated after payment.
5. Try entering the token again.

Token Expired

An expired token cannot be used to generate a new pairing code.

Purchase a new token plan and use the newly generated token.

Pairing Code Not Generated

If a pairing code cannot be generated:

1. Confirm that your token is active.
2. Check that your WhatsApp number is correct.
3. Confirm that the number includes the correct country code.
4. Try again after a short period.
5. If the issue continues, contact Firebox Support.

Pairing Code Not Working

If WhatsApp does not accept the pairing code:

- Make sure you are using the latest generated code.
- Do not reuse an old code.
- Confirm that you are pairing the correct WhatsApp number.
- Make sure your WhatsApp application has an active internet connection.
- Generate a new pairing code if necessary.

WhatsApp Pairing Failed

If pairing fails, verify your number and repeat the pairing process.

Make sure you are following:

Settings → Linked Devices → Link a Device

If the problem continues, check whether WhatsApp is currently allowing new linked-device connections.

Bot Not Responding

If the bot stops responding:

1. Check your internet connection.
2. Check the bot connection status.
3. Confirm that the WhatsApp session is still connected.
4. Try sending a supported command.
5. Check the dashboard for available status information.

Commands Not Working

Make sure:

- The command is supported.
- You are using the correct command format.
- Your account has the required permissions.
- The bot is online.
- The required input is provided.

Security

Never share your Firebox token publicly.

Do not post your token in:

- Public chats
- GitHub repositories
- Screenshots
- Social media
- Public websites
- Source-code files

Treat your token as a private credential.

Account and WhatsApp Security

Only connect WhatsApp accounts that you are authorized to use.

Never provide your WhatsApp verification information, authentication credentials, or private account information to other people.

Always review your WhatsApp Linked Devices if you suspect that an unauthorized device has been connected.

API Access

If API functionality is enabled for your Firebox WhatsApp Bot setup, API documentation should be followed according to the currently available endpoints and authentication requirements.

API endpoints, parameters, request formats, response formats, and authentication methods may vary as the platform develops.

Only use API endpoints documented by Firebox.

Updates

Firebox WhatsApp Bot is continuously improved with new features, fixes, and performance updates.

Commands, features, and available functionality may change over time.

Check the latest Firebox documentation for current information before relying on a specific command or feature.

Support

If you cannot resolve an issue using this documentation, contact Firebox Support.

When reporting a problem, provide:

- A clear description of the issue
- The feature or command you were using
- Any error message displayed
- The steps that caused the problem
- Relevant screenshots when necessary

Never send your private token or WhatsApp credentials when requesting support.

Important Notice

Firebox WhatsApp Bot features and commands may change as new versions are released.

This documentation should be used together with the current Firebox Bot interface and available command list.