Skip to main content

Step 1: Access Meta’s Application Panel

  1. Go to Meta for Developers
  2. Log in with your Facebook/Meta account
Meta for Developers homepage

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
Meta Apps Dashboard

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”
Application details form

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”
Application use cases

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
Select application type

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
System users Once the application is created:
  1. Configure the WhatsApp product in your application
  2. Access the WhatsApp Business API configuration
Assign permissions 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. Generate token

Step 7: Access API Configuration

  1. Go to API Configuration
Meta Business Manager
  1. Go to WhatsApp Manager
Meta Business Manager
  1. Click the three dots (options menu)
Important requirement: You must have a phone number associated with the account before continuing
  1. Select “Manage account settings”
Meta Business Manager

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”
Permission review Permission review

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
Permission review Permission review Permission review

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 Permission review

Step 11: Generate the Permanent Token

Finally, we will generate the permanent token:
  1. Return to the “System Users” section
Permission review
  1. Click “Generate token” for the user you created
Permission review

Token Configuration:

  1. Select application: Choose the app you created previously
  2. Click “Next”
Permission review
  1. Configure expiration: Select “Never” to create a permanent token
Permission review
  1. Assign permissions: Select all necessary permissions for WhatsApp Business API
Permission review
  1. 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:

# 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 to receive messages
  2. Implement message sending

Additional Resources

I