WhatsApp API Key Generation Guide

1. Introduction to WhatsApp Business API

The WhatsApp Business API allows medium to large businesses to communicate with their customers at scale. This guide will walk you through the process of setting up your Facebook (Meta) Business account, creating a WhatsApp Business Account, and generating the necessary API keys to integrate with your services, specifically the Lulu Dashboard.

2. Setting Up Your Facebook Account

2.1. Personal Facebook Account (Prerequisite)

You need a personal Facebook account to create and manage a Meta Business Manager account. If you don't have one, create it first.

1. Go to facebook.com and sign up.
2. Ensure your personal account is secure with two-factor authentication (2FA).

2.2. Creating a Meta Business Manager Account

The Meta Business Manager is where you'll manage all your Facebook assets, including your WhatsApp Business Account.

1. Go to business.facebook.com/overview.
2. Click on the "Create Account" button.
3. Enter your business name, your name, and your business email address. Click "Next".
4. Fill in your business details (address, phone number, website). Ensure these details are accurate and match your official business registration.
5. Submit your account.
6. You'll receive an email to verify your business email address. Click the link in the email to complete verification.

You should now have access to your Meta Business Manager dashboard.

3. Navigating Meta Business Manager

3.1. Business Verification

For full API access, your business often needs to be verified by Meta. This is crucial to avoid limitations and potential bans.

1. In your Meta Business Manager, go to "Business Settings".
2. Navigate to "Security Center".
3. Look for "Business Verification" and follow the prompts. You might need to provide official documents like a business license, utility bill, or bank statement.
4. This process can take a few days to a few weeks. Start it as early as possible.

3.2. Adding People and Partners

You can add team members or grant access to partners (like your agency) within Business Manager.

1. In "Business Settings", go to "People" or "Partners".
2. Click "Add" and enter their email address. Assign appropriate roles (e.g., Admin, Employee).

4. Creating Your WhatsApp Business Account (WABA)

This is the core account that will house your WhatsApp phone number and messaging capabilities.

1. In your Meta Business Manager, go to "Business Settings".
2. Under "Accounts", click on "WhatsApp Accounts".
3. Click "Add" and then "Create a new WhatsApp Account".
4. Provide a name for your WhatsApp Business Account (e.g., "YourCompanyName WABA").
5. Select your Meta Business Manager account from the dropdown.
6. Accept the WhatsApp Business Account terms.
7. Now, you'll be prompted to add a phone number.
• Choose the country code.
• Enter a phone number that is NOT currently registered with any WhatsApp Personal or WhatsApp Business app. This number will be exclusively for the API.
• Select a verification method (SMS or Voice Call).
• Enter the verification code you receive.
8. Once verified, your phone number will be linked to your WABA.

5. Generating Your WhatsApp API Keys

To interact with the WhatsApp API, you'll need an Access Token. There are two main types:

• System User Access Token: Long-lived token, ideal for server-to-server integrations. This is what you'll typically use for platforms like Lulu Dashboard.
• User Access Token: Short-lived token, associated with a specific Facebook user. Not recommended for continuous API integrations.

5.1. Creating a System User

1. In your Meta Business Manager, go to "Business Settings".
2. Under "Users", click on "System Users".
3. Click "Add New System User".
4. Give the system user a descriptive name (e.g., "LuluDashboard_Integration_User").
5. Select the "Admin" role (this is important for granting necessary permissions).
6. Click "Create System User".

5.2. Assigning Assets to the System User

The system user needs permissions to manage your WhatsApp Business Account.

1. Select the newly created System User from the list.
2. Click "Add Assets".
3. From the Asset Type dropdown, choose "WhatsApp Accounts".
4. Select your WhatsApp Business Account.
5. Toggle on "Manage Full Control" for the selected WhatsApp Account.
6. Click "Save Changes".

5.3. Generating the Access Token

1. With the System User still selected, click "Generate New Token".
2. Select the specific app you are integrating with (you might need to create a new app if you haven't already under "Apps" in Business Manager). For general API access, select an appropriate app or create one if prompted.
3. Choose an "Expiration" period. For server-to-server, "Never" is common for system user tokens, but use with caution and secure storage.
4. Under "Available Scopes", select the necessary permissions. For WhatsApp API, typically you'll need:
   • whatsapp_business_management
   • whatsapp_business_messaging
5. Click "Generate Token".
6. IMMEDIATELY COPY THE GENERATED TOKEN. THIS TOKEN WILL ONLY BE SHOWN ONCE AND CANNOT BE RETRIEVED LATER.

6. Integrating with Lulu Dashboard

Once you have successfully generated your WhatsApp API key (Access Token) and your WhatsApp Business Account ID, you can feed these into the Lulu Dashboard.

6.1. Locating WhatsApp Business Account ID

You will need your WhatsApp Business Account ID. This can be found:

1. In your Meta Business Manager, go to "Business Settings".
2. Under "Accounts", click on "WhatsApp Accounts".
3. Your WhatsApp Business Account ID will be displayed next to your account name. It's a long string of numbers.

6.2. Adding API Key and WABA ID to Lulu Dashboard

The exact steps may vary slightly based on the Lulu Dashboard's interface, but the general process is as follows:

1. Log in to your Lulu Dashboard account.
2. Navigate to the "Integrations" or "Settings" section, specifically looking for WhatsApp API settings.
3. You will typically find fields for:
   • WhatsApp Business Account ID: Paste the WABA ID you copied.
   • WhatsApp API Access Token: Paste the System User Access Token you generated.
   • Phone Number ID: This is the ID associated with the specific phone number you registered. You can find this in Business Manager under WhatsApp Accounts -> WhatsApp Manager -> Phone Numbers.
4. Save the changes. The Lulu Dashboard should now be configured to use your WhatsApp API.

After saving, the Lulu Dashboard might perform a test to ensure the connection is successful. Look for success messages or error indicators.

7. Adding and Managing Message Templates

WhatsApp Business API requires the use of pre-approved message templates (formerly known as Highly Structured Messages or HSMs) for initiating conversations with customers. You cannot send free-form messages unless it's within a 24-hour customer service window.

7.1. Creating a Message Template in Meta Business Manager

1. In your Meta Business Manager, go to "Business Settings".
2. Under "Accounts", click on "WhatsApp Accounts".
3. Click on your WhatsApp Business Account.
4. Click "WhatsApp Manager" (usually a green button or link). This will open a new tab.
5. In WhatsApp Manager, navigate to "Message Templates".
6. Click "Create Template".
7. Fill in the required details:
   • Category: Choose the most relevant category (e.g., Utility, Marketing, Authentication).
   • Name: A unique, lowercase, alphanumeric name (e.g., order_confirmation, welcome_message).
   • Language: Select the language(s) of your template.
   • Header (Optional): Can be text, media (image/video/document).
   • Body: This is the main content of your message. Use variables like {{1}}, {{2}} for personalized content (e.g., "Hi {{1}}, your order {{2}} has been shipped.").
   • Footer (Optional): Short text at the bottom.
   • Buttons (Optional): Call-to-action or quick reply buttons.
8. Submit the template for review. Meta's review process usually takes a few minutes to a few hours.

8. Safety & Best Practices to Avoid Getting Banned

Adhering to WhatsApp's policies is paramount to maintain your API access.

1. Comply with WhatsApp Business Policy: Read and understand the WhatsApp Business Policy and Commerce Policy. Do not send prohibited content (e.g., illegal products, tobacco, alcohol, adult content, weapons).
2. Get Opt-Ins: You MUST have explicit opt-in from users before sending them messages. This means they've agreed to receive messages from your business on WhatsApp.
3. Send High-Quality Messages: Focus on providing value. Low-quality, spammy, or excessively promotional messages will lead to negative user feedback and potential bans.
4. Monitor Quality Score: In your WhatsApp Manager, monitor your phone number's "Quality Score". A low score indicates issues and can lead to restrictions.
5. Respond Promptly: Respond to customer inquiries within 24 hours to maintain a good customer experience.
6. Secure Your API Key: Store your Access Token securely. Never expose it in client-side code or public repositories.
7. Business Verification: As mentioned, complete Business Verification in Meta Business Manager.
8. Use Approved Templates: For initiating conversations outside the 24-hour window, always use pre-approved message templates.
9. Avoid Spamming: Do not send unsolicited messages, especially immediately after a user opts in. Gradually onboard users and respect their communication preferences.
10. Provide Clear Opt-Out: Make it easy for users to opt-out of receiving messages.