> ## Documentation Index
> Fetch the complete documentation index at: https://www.docs.wazap.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# Get WhatsApp Business API Permanent Token

> Step-by-step guide to generate a permanent token for Meta's WhatsApp Business API

## Step 1: Access Meta's Application Panel

1. Go to [Meta for Developers](https://developers.facebook.com/)
2. Log in with your Facebook/Meta account

<img src="https://mintcdn.com/jose-68ff064d/YneEzgNOeH7A9VcW/images/token-tutorial/meta1.png?fit=max&auto=format&n=YneEzgNOeH7A9VcW&q=85&s=7340facdcb4e84ae87ae76e14500c6e8" alt="Meta for Developers homepage" width="2880" height="1642" data-path="images/token-tutorial/meta1.png" />

## Step 2: Access the Apps Dashboard

1. Once in Meta for Developers, access the Apps dashboard
2. Click **"Create App"** in the top right corner

<img src="https://mintcdn.com/jose-68ff064d/YneEzgNOeH7A9VcW/images/token-tutorial/meta.png?fit=max&auto=format&n=YneEzgNOeH7A9VcW&q=85&s=cfdcc2dc5cd45780023c8380f95bc537" alt="Meta Apps Dashboard" width="2880" height="1726" data-path="images/token-tutorial/meta.png" />

## Step 3: Complete Application Details

1. **App name**: Enter a descriptive name for your application
2. **Contact email**: Provide a valid email for notifications
3. Click "Next"

<img src="https://mintcdn.com/jose-68ff064d/YneEzgNOeH7A9VcW/images/token-tutorial/meta4.png?fit=max&auto=format&n=YneEzgNOeH7A9VcW&q=85&s=2eff888569cfc74f8a360390a42e0739" alt="Application details form" width="2880" height="1636" data-path="images/token-tutorial/meta4.png" />

## Step 4: Configure Use Cases

1. In the "Looking for something else?" section, select the **"Other"** option
   * This will allow you to choose from all available permissions, functions, and products
   * This is the recommended option for integrating WhatsApp Business API

2. Click "Next"

<img src="https://mintcdn.com/jose-68ff064d/YneEzgNOeH7A9VcW/images/token-tutorial/meta5.png?fit=max&auto=format&n=YneEzgNOeH7A9VcW&q=85&s=c4fe30b35a771a955b127ec4307cf091" alt="Application use cases" width="1102" height="1442" data-path="images/token-tutorial/meta5.png" />

## Step 5: Select Application Type

1. Select the **"Business"** application type
2. This type allows you to manage business assets like WhatsApp, Messenger, and Instagram

<img src="https://mintcdn.com/jose-68ff064d/YneEzgNOeH7A9VcW/images/token-tutorial/meta6.png?fit=max&auto=format&n=YneEzgNOeH7A9VcW&q=85&s=6a4e903ca17c2807529f11abc05e6084" alt="Select application type" width="2876" height="1642" data-path="images/token-tutorial/meta6.png" />

## Step 6: Final Application Configuration

In this step you will complete the creation of your application:

1. **Application name**: Confirm or update your app name
2. **Email**: Verify that the contact email is correct
3. **Business portfolio**: Assign an existing business portfolio or create a new one
   * **Important**: A business portfolio is required to obtain a permanent token
   * If you don't have one, you can create it during this process

<img src="https://mintcdn.com/jose-68ff064d/YneEzgNOeH7A9VcW/images/token-tutorial/meta7.png?fit=max&auto=format&n=YneEzgNOeH7A9VcW&q=85&s=7cdd673d8b30892d97076275427eb03a" alt="System users" width="2878" height="1644" data-path="images/token-tutorial/meta7.png" />

Once the application is created:

1. Configure the WhatsApp product in your application
2. Access the WhatsApp Business API configuration

<img src="https://mintcdn.com/jose-68ff064d/YneEzgNOeH7A9VcW/images/token-tutorial/meta9.png?fit=max&auto=format&n=YneEzgNOeH7A9VcW&q=85&s=5941d4db3cfd6a6ed409af7d3024b84d" alt="Assign permissions" width="2880" height="1638" data-path="images/token-tutorial/meta9.png" />

After adding WhatsApp, you will be directed to the API configuration:

1. **Configure webhooks**: Define the URL where you will receive notifications
2. **Add phone number**: Register your business number
3. **Add payment method**: Configure billing

**Note**: If you didn't select a business portfolio previously, you will need to assign it in this step. Click "Continue" to proceed.

<img src="https://mintcdn.com/jose-68ff064d/YneEzgNOeH7A9VcW/images/token-tutorial/meta8.png?fit=max&auto=format&n=YneEzgNOeH7A9VcW&q=85&s=144c6f96527bc63f843c5757e61d7436" alt="Generate token" width="2874" height="1638" data-path="images/token-tutorial/meta8.png" />

## Step 7: Access API Configuration

1. Go to **API Configuration**

<img src="https://mintcdn.com/jose-68ff064d/YneEzgNOeH7A9VcW/images/token-tutorial/meta20.png?fit=max&auto=format&n=YneEzgNOeH7A9VcW&q=85&s=13a497543c30fd4848c01a371ed2c74c" alt="Meta Business Manager" width="2879" height="1544" data-path="images/token-tutorial/meta20.png" />

2. Go to **WhatsApp Manager**

<img src="https://mintcdn.com/jose-68ff064d/YneEzgNOeH7A9VcW/images/token-tutorial/meta10.png?fit=max&auto=format&n=YneEzgNOeH7A9VcW&q=85&s=b5191ff3390ccf228e4cb42cd90f4d20" alt="Meta Business Manager" width="2878" height="1640" data-path="images/token-tutorial/meta10.png" />

3. Click the **three dots** (options menu)

**Important requirement**: You must have a phone number associated with the account before continuing

4. Select **"Manage account settings"**

<img src="https://mintcdn.com/jose-68ff064d/YneEzgNOeH7A9VcW/images/token-tutorial/meta11.png?fit=max&auto=format&n=YneEzgNOeH7A9VcW&q=85&s=2074e756b01d0512959525e849d08499" alt="Meta Business Manager" width="2874" height="1724" data-path="images/token-tutorial/meta11.png" />

## Step 8: Create a System User

1. Go to the **"System Users"** section
2. Create a new system user with **"Administrator"** role
3. Click **"Create system user"**

<img src="https://mintcdn.com/jose-68ff064d/YneEzgNOeH7A9VcW/images/token-tutorial/meta12.png?fit=max&auto=format&n=YneEzgNOeH7A9VcW&q=85&s=c294e60819f12503d8b4955e9c06af60" alt="Permission review" width="2874" height="1638" data-path="images/token-tutorial/meta12.png" />

<img src="https://mintcdn.com/jose-68ff064d/YneEzgNOeH7A9VcW/images/token-tutorial/meta13.png?fit=max&auto=format&n=YneEzgNOeH7A9VcW&q=85&s=769d076829322f96a5448d3e9d1d5499" alt="Permission review" width="2874" height="1646" data-path="images/token-tutorial/meta13.png" />

## Step 9: Configure WhatsApp Account Access

In this step we will assign permissions to the system user:

1. Go to the **"WhatsApp Account"** section
2. Click **"Assign person"**
3. Select the system user you created
4. Assign **"Full control"** to the system user
5. Click **"Assign"** to confirm permissions

<img src="https://mintcdn.com/jose-68ff064d/YneEzgNOeH7A9VcW/images/token-tutorial/meta21.png?fit=max&auto=format&n=YneEzgNOeH7A9VcW&q=85&s=c47516ddb8ebda84712973dc0a02ba7c" alt="Permission review" width="2878" height="1642" data-path="images/token-tutorial/meta21.png" />

<img src="https://mintcdn.com/jose-68ff064d/YneEzgNOeH7A9VcW/images/token-tutorial/meta22.png?fit=max&auto=format&n=YneEzgNOeH7A9VcW&q=85&s=0d42eb384a2e2d68b154d1fdda6857cb" alt="Permission review" width="2568" height="1466" data-path="images/token-tutorial/meta22.png" />

<img src="https://mintcdn.com/jose-68ff064d/YneEzgNOeH7A9VcW/images/token-tutorial/meta14.png?fit=max&auto=format&n=YneEzgNOeH7A9VcW&q=85&s=8a999d60a52aa3e80e24921ceb973986" alt="Permission review" width="2878" height="1638" data-path="images/token-tutorial/meta14.png" />

## Step 10: Configure Application Access

Repeat the permission assignment process for the application:

1. Go to the **"Apps"** section
2. Select your application
3. Assign **"Full control"** to the system user
4. Click **"Assign"** to confirm

   <img src="https://mintcdn.com/jose-68ff064d/YneEzgNOeH7A9VcW/images/token-tutorial/meta15.png?fit=max&auto=format&n=YneEzgNOeH7A9VcW&q=85&s=d44af2a097536c4d794c99ae9c581bba" alt="Permission review" width="2878" height="1640" data-path="images/token-tutorial/meta15.png" />

## Step 11: Generate the Permanent Token

Finally, we will generate the permanent token:

1. Return to the **"System Users"** section

<img src="https://mintcdn.com/jose-68ff064d/YneEzgNOeH7A9VcW/images/token-tutorial/meta12.png?fit=max&auto=format&n=YneEzgNOeH7A9VcW&q=85&s=c294e60819f12503d8b4955e9c06af60" alt="Permission review" width="2874" height="1638" data-path="images/token-tutorial/meta12.png" />

2. Click **"Generate token"** for the user you created

<img src="https://mintcdn.com/jose-68ff064d/YneEzgNOeH7A9VcW/images/token-tutorial/meta28.png?fit=max&auto=format&n=YneEzgNOeH7A9VcW&q=85&s=b9990e8d78afabca0913b6a5085d34b9" alt="Permission review" width="2880" height="1642" data-path="images/token-tutorial/meta28.png" />

### Token Configuration:

3. **Select application**: Choose the app you created previously
4. Click **"Next"**

<img src="https://mintcdn.com/jose-68ff064d/YneEzgNOeH7A9VcW/images/token-tutorial/meta17.png?fit=max&auto=format&n=YneEzgNOeH7A9VcW&q=85&s=411624f29b62080d0d3768aacd4d875a" alt="Permission review" width="1510" height="1048" data-path="images/token-tutorial/meta17.png" />

5. **Configure expiration**: Select **"Never"** to create a permanent token

<img src="https://mintcdn.com/jose-68ff064d/YneEzgNOeH7A9VcW/images/token-tutorial/meta18.png?fit=max&auto=format&n=YneEzgNOeH7A9VcW&q=85&s=daed09517d3bdaae9a24f71405aa419a" alt="Permission review" width="1402" height="1004" data-path="images/token-tutorial/meta18.png" />

6. **Assign permissions**: Select all necessary permissions for WhatsApp Business API

<img src="https://mintcdn.com/jose-68ff064d/YneEzgNOeH7A9VcW/images/token-tutorial/meta19.png?fit=max&auto=format&n=YneEzgNOeH7A9VcW&q=85&s=1c9c3f19de76a82f2ee5461a7e499f4d" alt="Permission review" width="1456" height="1074" data-path="images/token-tutorial/meta19.png" />

7. Click **"Generate token"**

## Congratulations! Your Permanent Token has been Generated

Once you click "Generate token", Meta will process your request and generate your permanent WhatsApp Business API token.

### Final Steps:

1. **Copy the token**: A modal window will appear with your token. Copy it completely.
2. **Save the token securely**:
   * Save it in a password manager
   * Write it down in a secure place
   * Configure it as an environment variable in your project

**⚠️ CRITICAL!** This token will only be shown ONCE. If you lose it, you will have to generate a new one.

### Example of how to save the token:

```bash theme={null}
# In your .env file
WHATSAPP_TOKEN=YOUR_TOKEN_HERE
PHONE_NUMBER_ID=YOUR_PHONE_NUMBER_ID
```

Your permanent token is ready to use and will not expire unless you regenerate it manually.

## Important Considerations

### Token Security

* **Never** share your permanent token publicly
* Store it in environment variables
* Use it only in your application's backend
* Consider rotating the token periodically for security

### Rate Limits

* Permanent tokens have the same limits as temporary ones
* Meta applies limits per user, application, and phone number

## Next Steps

Once you have your permanent token configured:

1. [Configure webhooks](/webhooks/overview) to receive messages
2. [Implement message sending](/messages/overview)

## Additional Resources

* [Official WhatsApp Business API Documentation](https://developers.facebook.com/docs/whatsapp/cloud-api)
