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

# Get your WhatsApp access key from Meta

> Step by step, with screenshots: create a Meta system user, give it your app and WhatsApp account, and copy the access key that lets your Workser AI agents answer customers on WhatsApp.

Workser needs one thing from Meta to answer your customers on WhatsApp: an **access key** (Meta calls it an *access token*). It is how Workser sends your AI agent's replies from your number. This page shows how to make it in about 5 minutes.

> [!NOTE]
>
> Just trying it out? On your app's **WhatsApp → API Setup** page, Meta shows a temporary access token that works for 24 hours. You can paste that into Workser to test. For a number that keeps answering customers, make the permanent key below.

**Before you start**, you need a Meta Business app with WhatsApp added, and a WhatsApp account, both in the same Meta business portfolio. You open everything below from [Meta Business Settings](https://business.facebook.com/settings/system-users).

**1. Create a system user**

In Business Settings, open **Users → System users** and press **Add**. Name it anything you like, set the role to **Employee**, and press **Create system user**.

![The Create system user box in Meta Business Settings with the role set to Employee](https://mintcdn.com/workser/5cETDbavx-B7PwTo/images/whatsapp-meta/1-create-system-user.png?fit=max\&auto=format\&n=5cETDbavx-B7PwTo\&q=85\&s=92ef921b6edb2a932328d373af41ac65)

Employee is enough. It gives the key access only to what you assign in the next two steps.

**2. Give it your app**

Click the system user you just made, then press **Assign assets**. Open the **Apps** tab, tick your app, turn on **Manage app**, and press **Assign assets**.

![The system user page with the Assign assets and Generate token buttons](https://mintcdn.com/workser/5cETDbavx-B7PwTo/images/whatsapp-meta/2-generate-token-button.png?fit=max\&auto=format\&n=5cETDbavx-B7PwTo\&q=85\&s=fc5862fdd96cab5a39e8c2cc43ba69d0)

![Assigning the app to the system user with Manage app turned on](https://mintcdn.com/workser/5cETDbavx-B7PwTo/images/whatsapp-meta/3-assign-app.png?fit=max\&auto=format\&n=5cETDbavx-B7PwTo\&q=85\&s=7e34a925a040cfd9f7deefeb7d1cef75)

**3. Give it your WhatsApp account**

Press **Assign assets** again. This time open the **WhatsApp accounts** tab (not "Messaging accounts"), tick your WhatsApp account, turn on full control, and press **Assign assets**. If that tab shows nothing to tick, assign it from the other side: [give the system user your WhatsApp account](https://docs.workser.ai/ai-workforce/whatsapp-assign-account.md), with screenshots.

Workser checks this when you connect. A key that is not allowed to message for your WhatsApp account is refused with “WhatsApp does not show that ID to this token”.

**4. Press Generate token and pick your app**

On the system user, press **Generate token**. Choose your app in the list and press **Next**.

![Choosing the app to generate a token for](https://mintcdn.com/workser/5cETDbavx-B7PwTo/images/whatsapp-meta/4-select-app.png?fit=max\&auto=format\&n=5cETDbavx-B7PwTo\&q=85\&s=d478d450a7626e300cefcc4d630deb94)

**5. Choose when it expires**

Pick **Never**, then **Next**.

![Token expiry with Never selected](https://mintcdn.com/workser/5cETDbavx-B7PwTo/images/whatsapp-meta/5-expiry.png?fit=max\&auto=format\&n=5cETDbavx-B7PwTo\&q=85\&s=26538fd9aa34dd0120bd021b654ab23c)

Meta suggests 60 days. A key that expires makes your AI agent stop replying until you paste a new one, so Never is the safe choice for a live number. If you pick 60 days, put a reminder in your calendar.

**6. Tick the two WhatsApp permissions**

Tick **whatsapp\_business\_messaging** and **whatsapp\_business\_management**, then press **Continue**. The extra `whatsapp_business_manage_events` is optional.

![Selecting the whatsapp\_business\_messaging and whatsapp\_business\_management permissions](https://mintcdn.com/workser/5cETDbavx-B7PwTo/images/whatsapp-meta/6-permissions.png?fit=max\&auto=format\&n=5cETDbavx-B7PwTo\&q=85\&s=2a14d7f33988326e0d3fd6e31fcfd82d)

**7. Copy the key into Workser**

Press **Copy**. Meta shows the key only once, so paste it into the **Access key** field in Workser right away, together with your app ID, app secret, number ID and business account ID ([where to find each ID](https://docs.workser.ai/ai-workforce/whatsapp-business-account-id.md)), and press **Connect**.

![The Token created box with a Copy button](https://mintcdn.com/workser/5cETDbavx-B7PwTo/images/whatsapp-meta/7-copy-token.png?fit=max\&auto=format\&n=5cETDbavx-B7PwTo\&q=85\&s=696af92eb744991ae310cb096aad5af6)

Workser stores it encrypted and never shows it again. If you lose it, make a new one the same way.

## When it works

Workser shows **Connected** with your number's name. This is what it looks like for Meta's free test number.

![Workser's WhatsApp setup showing Connected as the test number, with the remaining steps listed below](https://mintcdn.com/workser/PXViWAmz27CKU0jT/images/whatsapp-meta/h-connected.png?fit=max\&auto=format\&n=PXViWAmz27CKU0jT\&q=85\&s=d729fca5a9344f6b5e4685eefd437300)

The list under **Connected** shows what is left before customers get answers. Switch your Meta app to **Live** (Workser shows how). Until it is Live, Meta delivers no messages to Workser, not even from your own phone or with Meta’s test number.

> [!TIP]
>
> Meta asks for a **Privacy policy URL** before it lets you publish. Use the privacy page of your own business website. No website yet? Ask Workser Code to build a one-page site with a privacy policy for your business and put it online, then paste its link into Meta (**App settings → Basic**).

Then send your WhatsApp number a message from your own phone and press **Check for messages**. A real message that gets an answer is the proof that it works.

## If something goes wrong

> [accordion] Meta says “No permissions available”
>
> The system user has no role on your app yet. Close the box, go back to step 2, give the system user your app with **Manage app** turned on, then press **Generate token** again.
>
> ![The No permissions available message when generating a token](https://mintcdn.com/workser/5cETDbavx-B7PwTo/images/whatsapp-meta/x-no-permissions.png?fit=max\&auto=format\&n=5cETDbavx-B7PwTo\&q=85\&s=dc77de9e107721872e30b89ec16a11fa)

> [accordion] My app is not in the Apps list
>
> The app still belongs to your personal developer account. In Business Settings open **Accounts → Apps → Add → Connect an app ID**, enter your app ID, and approve it. Then repeat step 2.

> [accordion] Workser says the key is for a different app
>
> The key must be made for the same app whose ID you pasted. Generate it again and choose that app in step 4.

> [accordion] Workser says “WhatsApp does not show that ID to this token”
>
> The system user does not have your WhatsApp account yet. Follow [Fix: WhatsApp does not show that ID to this token](https://docs.workser.ai/ai-workforce/whatsapp-assign-account.md), then make a new key.

> [accordion] Workser says the key is missing a permission or cannot message for the account
>
> Check step 3 (the WhatsApp account with full control) and step 6 (both WhatsApp permissions ticked). Then make a new key and connect again.

Back to [linking chat apps](https://docs.workser.ai/ai-workforce/chat-apps.md).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.