Connecting a WhatsApp Account to NIZU

This guide walks you through linking your WhatsApp Cloud API to the NIZU WhatsApp plugin. The process covers four stages: creating a Meta app, adding a phone number, configuring a WebHook, and generating a permanent access token.

Prerequisites

Before you begin, make sure you have:

• A Facebook for Developers account
• A WhatsApp-enabled phone number
• Access to your NIZU dashboard as administrator

Step 1 — Create a Meta App

Go to the Meta Developers website

Click on Login

1. Go to Facebook for Developers and open the My Apps tab.
2. Click Create App.
3. Read the important legal and terms of service and confirm with Create App.
4. Fill in the following fields:
   • App Name — a name for your app
   • App Contact Email — your contact email
   • Business Account — optional; link an existing Business account if needed
5. Use cases select Business messaging -> Connect with customers through WhatsApp using the checkbox
6. Select your business from the portfolio (preferably those that have the Business verification complete)
7. Ensure that there are No requirements identified between that business portfolio and WhatsApp
8. Review all information, and click on Create App and confirm with your Facebook password.

Once the app is created, you'll land on the App Dashboard page.

6. Once there Take the tour in order to get familiar with the Meta App dashboard (Don't worry you can't do anything dangerous at this point) 
7. Scroll down to the WhatsApp section and click Set up. You can add a payment method now or return to it later.

Step 2 — Add a Phone Number

1. In the left sidebar, go to API Setup or click on Start using the API.
2. Click on Select recipient phone number -> Manage Phone numbers.
3. In the modal, fill in your WhatsApp Business profile details:
   • Display Name
   • Timezone
   • Category
   • Business Description (optional)
4. Click Next.
5. Enter your phone number and choose a verification method — text message or phone call.
6. Click Next and complete the verification.

Step 3 — Configure the Webhook

1. From API Setup, click the Configure WebHooks link (Step 3 on the page).
2. On the Configuration page, click Edit in the WebHook section.
3. Retrieve your WebHook credentials from NIZU:
   • In the NIZU sidebar, go to WhatsBoost → Connect Account.
   • Copy the WebHook Callback URL and the Verify Token.
4. Paste them into the respective fields on the Facebook Developer Configuration page.
5. Click Verify and Save.
6. Click Manage to open the WebHook fields modal. Subscribe to the messages field and click Done.
7. Click Save Changes.
8. Enable Live Mode using the toggle.

Step 4 — Generate a Permanent Access Token

A permanent (system user) token is required so your bot stays connected without expiring.

1. From API Setup, click See the overview page (Step 5).
2. On the overview page, open Business Settings from the menu.
3. In the left sidebar, select System Users and click Add.
4. Enter a name for the system user, assign a role (Employee or Admin), and click Create System User.
5. Select the new user, then click Add Assets.
   • Under Select Asset Type, choose Apps.
   • Select your app and grant Full Control.
   • Click Save Changes.
6. Click Generate New Token.
   • Select your app from the dropdown.
   • Enable the following permissions:
     • business_management
     • catalog_management
     • whatsapp_business_messaging
     • whatsapp_business_management
   • Click Generate Token.
7. Copy and save the token somewhere secure — it won't be shown again.

Step 5 — Connect Your Account in NIZU

1. In the NIZU sidebar, go to WhatsApp → Connect WhatsApp.
2. Retrieve your WhatsApp Business Account ID:
   • Go to Business Settings → WhatsApp Accounts in the left sidebar.
   • Copy the ID shown.
3. Enter your Access Token and WhatsApp Business Account ID in the connection form.
4. Click Connect.

A success message confirms the account is linked. ????