Skip to main content
Admin access to the Meta business portfolio that owns your Meta app and WhatsApp Business Account is required.

Create a system user

A system user represents your business rather than a person, so its token keeps working without anyone signing in again.

1

Open System users

Sign in to Meta Business Settings and open Users > System users.

  • Click Add.
The System users page in Business Settings with System users and the Add button highlighted
2

Accept the policy if prompted

The first time you add a system user, Meta asks you to accept its non-discrimination policy on behalf of your system users. Read it and click I Accept.

The non-discrimination policy dialog with the I Accept button highlighted
3

Name the system user and choose its role

In Create system user, enter a name and choose the role.

  • System user name: StackOne Integration
  • System user role: Admin
  • Click Create system user.
The Create system user dialog with the System user name, System user role, and Create system user controls highlighted

Give the system user access to your WhatsApp account

The system user can only act on the WhatsApp Business Account and Meta app assigned to it.

1

Open the WhatsApp account

In Business Settings, open Accounts > WhatsApp accounts.

  • Select your WhatsApp account.
  • Click Assign people.
The WhatsApp accounts page with the menu item, the selected account, and the Assign people button highlighted
2

Grant full access

In Add people and set permissions, select your system user (it is labeled (System user)).

  • Under Full access, turn on Everything.
  • Click Assign.
The Add people and set permissions dialog with a system user selected, the Everything toggle, and the Assign button highlighted
3

Open your Meta app

In Business Settings, open Accounts > Apps.

  • Select your Meta app.
  • Click Assign people.
The Apps page in Business Settings with the Apps menu item, the selected app, and the Assign people button highlighted
4

Assign the app to the system user

In Add people and set permissions, select your system user (it is labeled (System user)).

  • Give it full access to the app.
  • Click Assign.
The Add people and set permissions dialog for the app with a system user row and the Assign button highlighted

Add the app permissions

The token can only include permissions that are added to your Meta app.

1

Check the permissions

In your app on Meta for Developers, open Use cases.

  • Click Customize next to Connect on WhatsApp.
  • In the sidebar, under Other tools, select Permissions and features.
  • Check that the WhatsApp permissions show Ready for testing.
  • For any that shows Add instead, click Add.
The Permissions and features page with the three required permissions, an Add button, and the menu item highlighted

Generate the access token

The access token gives the connection the system user’s access to the WhatsApp Cloud API.

1

Select the app

In Users > System users, select your system user.

  • Click Generate token.
  • In Select app, choose your Meta app.
  • Click Next.
The Generate token dialog on the Select app step with the app selector and the Next button highlighted
2

Set the token expiry

Under Token expiry, choose how long the token lasts.

  • Select Never for a token that does not expire, or 60 days (recommended) if you will rotate it.
  • Click Next.
The Set expiry step with the 60 days and Never options and the Next button highlighted
3

Assign the permissions

Enables actions: Add Assigned User, Approve Join Requests, Block Users, Check Call Permissions, Configure Conversational Automation, Create Business User, Create Flow, Create Group, Create Message Template, Create Schedule, Create WhatsApp Business Account Phone Number, Delete Flow, Delete Group, Delete Group Invite Link, Delete Media, Delete Message Template, Deprecate Flow, Deregister Phone Number, Download Media, Edit Message Template, Get Active Groups, Get Assigned Users, Get Blocked Users, Get Business Profile, Get Business User, Get Client WhatsApp Business Accounts, Get First Business User, Get Flow, Get Group, Get Group Invite Link, Get Join Requests, Get Message History, Get Message Template, Get Message Templates, Get Owned WhatsApp Business Accounts, Get Phone Number, Get Schedules, Get Subscribed Apps, Get Unified Organization, Get Unified Role, Get Unified User, Get WhatsApp Business Account, Get WhatsApp Business Account Phone Numbers, List Business Users, List Flow Assets, List Flows, List Pending Users, List System Users, List Unified Organizations, List Unified Resource Types, List Unified Resource Users, List Unified Roles, List Unified Users, List User Businesses, Manage Call, Mark Message As Read, Publish Flow, Register Phone Number, Reject Join Requests, Remove Assigned User, Remove Group Participants, Request Verification Code, Reset Group Invite Link, Retrieve Media URL, Send Audio Message, Send Contact Message, Send Document Message, Send Group Invite Template, Send Group Message, Send Image Message, Send Interactive Message, Send Location Message, Send Reaction, Send Sticker Message, Send Template Message, Send Text Message, Send Video Message, Set Two-Step Verification PIN, Unblock Users, Update Business Profile, Update Flow JSON, Update Flow Metadata, Update Group, Update WhatsApp Business Account, Upload Media, Verify Code

Under Select permissions, select each permission listed.

  • Click Generate token.
  • Copy the Access Token across.
The Assign permissions step with three permissions selected and the Generate token button highlighted

Find your WhatsApp Business Account ID

The WhatsApp Business Account ID (WABA ID) identifies your WhatsApp account.

1

Copy the ID in Business Settings

In Business Settings, open Accounts > WhatsApp accounts.

  • Select your WhatsApp account.
  • Copy the number shown after ID: across to WhatsApp Business Account ID.
The WhatsApp accounts page with the menu item, the selected account, and its ID highlighted

Find your Phone Number ID (optional)

The Phone Number ID is the ID Meta assigns to a business phone number, not the phone number itself.

1

Copy the Phone Number ID

In the WhatsApp account you used for the WABA ID, open the Phone numbers tab.

  • Click the phone number you want to send from.
  • In the Phone profile panel, copy the number shown after ID: across to Phone Number ID.
  • Click Done to close the panel.
The Phone profile panel with the Phone Number ID highlighted

Find your Business Portfolio ID (optional)

The Business Portfolio ID identifies the Meta business portfolio that owns your WhatsApp Business Account.

1

Copy the ID in Business Settings

In Settings, open Business portfolio info.

  • Copy the ID shown for the business across to Business Portfolio ID.

Use your Native Webhook URL

After the account connects, set its Native Webhook URL as the callback URL in your Meta app’s WhatsApp webhook configuration and subscribe to the webhook fields you need, as described in the WhatsApp Business events setup guide.

1

Connect

  • Click Connect.
  • If applicable, the provider will redirect you to a sign-in or authorization page. Complete the provider’s authorization flow.
  • Once authorization is successful, you will see a confirmation popup.
2

Use Actions

Connect an AI platform to the linked account’s actions. See AI Platforms.Other ways to call actions are listed in Protocols & SDKs.

Next Steps

Webhooks setup

Configure receiving Events for WhatsApp Business into StackOne.