How to Register a Business Phone Number with Hibot (WhatsApp Business API)

Bot Automation
Apr 6
3 min read

To start sending and receiving messages using Hibot – WhatsApp Official API, you must first register your business phone number.

In this guide, we’ll walk you through the complete process—from preparation to API registration—so you can get up and running بسرعة and without confusion.

🚀 Why Registration is Important

Registering your business phone number connects it to the WhatsApp Cloud API, allowing you to:

Send and receive WhatsApp messages
Enable automation and chatbots
Use templates and notifications
Scale customer communication

⚠️ Important: Registration can only be done via API. It cannot be completed through WhatsApp Manager or the dashboard alone.

✅ Before You Register

Make sure you complete these steps first:

Add your phone number to your WhatsApp Business Account
Verify ownership of the number (via SMS or voice)
Keep your Phone Number ID ready

Once these are done, you’re ready for API registration using Hibot.

📲 When Do You Need to Register?

You’ll need to register your business phone number in the following cases:

1. New Account Setup

When setting up WhatsApp API for the first time, registration is required to activate your number.

2. Display Name Change

If you update your business display name:

Wait until it is approved
Then re-register your phone number via API

⚠️ Re-registering before approval will have no effect.

🔄 Special Case: Number Migration

If you are migrating from the On-Premises API to Cloud API, additional steps are required before registration.

Make sure to complete the migration process before attempting to register your number with Hibot.

⚙️ Register Your Phone Number via API

To register your verified number, you need to make a POST request to the registration endpoint.

Required Parameters:

messaging_product → Set to "whatsapp"
pin → Your 6-digit two-step verification PIN

Optional Parameter:

data_localization_region → Choose where your data is stored (e.g., IN for India, DE for Germany)

🔐 Two-Step Verification (PIN)

During registration, you must define or provide a 6-digit PIN.

If PIN already exists → Enter existing PIN
If not → Create a new PIN

💡 This PIN is required for security and future actions like re-registration.

🌍 Data Localization (Optional)

Hibot allows you to store your data in specific regions for compliance and performance.

Examples:

India → IN
Germany → DE
Singapore → SG
UAE → AE

⚠️ Once enabled:

You cannot directly change or disable it
You must deregister and register again

⏱️ API Limits You Should Know

To prevent misuse, there are limits on registration attempts:

Maximum 10 requests per number
Time window: 72 hours

If exceeded:

You’ll receive an error
Registration will be blocked temporarily

🔑 Authentication Requirements

All API calls must be authenticated using an access token.

With Hibot, you can use:

Access tokens from your API setup
System user tokens with required permissions

Required permissions:

whatsapp_business_management
whatsapp_business_messaging

🔄 How to Deregister a Phone Number

If needed, you can deregister your phone number.

What happens after deregistration:

The number stops working with WhatsApp API
Local data storage (if enabled) is removed
You must re-register to use it again

⚠️ Important Limitations

You cannot deregister a number if it's being used in both Cloud API and WhatsApp Business App
Deregistration does NOT delete message history
Only disables API usage

📈 Best Practices for Smooth Registration

Always verify your number before API calls
Store your PIN securely
Avoid multiple failed attempts
Use correct region settings if enabling data localization

🎯 Final Thoughts

Registering your business phone number is a crucial step in setting up Hibot – WhatsApp Official API.

Once completed, you unlock:

Seamless messaging
Automation capabilities
Scalable customer engagement