To get your WhatsApp integration running, you need to navigate Meta's developer ecosystem. The process involves creating a dedicated app, linking it to your business, and generating a permanent credential for your bot to use. Let's walk through the exact steps to get from a new app to a working test environment.

Your first step is to register a new app within the Meta for Developers dashboard. Think of this app as the central hub for your WhatsApp configuration and API settings. During the setup, you'll select "Business" as the app type, which unlocks the necessary tools for commercial integrations.

Once the app exists, you must link it to your Meta Business Portfolio. This is a critical step that formally associates your app with your company's official presence on the platform. It grants the app permissions to act on behalf of your business and is a prerequisite for generating the right kind of credentials.

With the app connected to your business, you can now add the WhatsApp product. From your app's dashboard, navigate to the "Add products" section and select WhatsApp. This will provision the necessary API configuration panels and guide you through the next steps.

This is also where you will create a System User. A System User is a special, non-personal identity created within your Business Portfolio specifically for server-to-server API calls. Unlike a token tied to a human admin's account, a System User token is permanent and won't expire, which is mandatory for production bots.

After adding the WhatsApp product to your app, Meta automatically provides a free test number. This number is not tied to a real SIM card and is used exclusively for development and testing within the API environment.

This test number is powerful but has limitations. It can only send messages to a maximum of five phone numbers that you have explicitly verified and added to a whitelist. You can add your own number and the numbers of your development team by navigating to the API Setup panel in your app's WhatsApp dashboard. You'll need to enter each number and then confirm it by entering a verification code sent via SMS.

Once your test number is active and you've whitelisted a recipient number, you have everything you need to start sending your first API calls. You will use your permanent System User token for authentication, the test number's Phone Number ID as the sender, and the whitelisted recipient's number as the destination.

With these pieces in place, you are ready to start building and testing your integration.