Skip to main content
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.
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.
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
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
Assigning the app to the system user with Manage app turned on
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, 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
5

Choose when it expires

Pick Never, then Next.
Token expiry with Never selected
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
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), and press Connect.
The Token created box with a Copy button
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
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.
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

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
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.
The key must be made for the same app whose ID you pasted. Generate it again and choose that app in step 4.
The system user does not have your WhatsApp account yet. Follow Fix: WhatsApp does not show that ID to this token, then make a new key.
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.