Skip to main content
Uzz.Ai
Blog UzzAIGetting Started

How to Connect Your WhatsApp Business to UzzApp

Complete step-by-step guide to connect your WhatsApp Business number to UzzApp using the Official Meta API.

05/03/2026•8 min•Por Equipe Uzz.Ai
Role para descobrir a jornada completa
How to Connect Your WhatsApp Business to UzzApp

To start using UzzApp, you need to connect your WhatsApp Business number to the platform using the Official Meta API (WhatsApp Business API). This process involves setting up an application in Meta Developers, obtaining the required credentials and registering them in UzzApp.

Prerequisites

Before you begin, make sure you have: (1) A verified Meta Business Suite account. (2) A dedicated phone number for WhatsApp Business — it cannot be a number already in use on personal WhatsApp. (3) Access to the Meta Developers dashboard (developers.facebook.com). (4) Your UzzApp login credentials.

Follow the steps below in order. The process takes an average of 20 to 40 minutes the first time.

Step 1 — Create the App in Meta Developers

  1. 1Go to developers.facebook.com and sign in with your Meta Business account.
  2. 2Click "My Apps" → "Create App".
  3. 3Select the "Business" type and give your app a name (e.g., "UzzApp MyBusiness").
  4. 4After creating, go to "Add Product" and add the "WhatsApp" product.
  5. 5Select or create a WhatsApp Business account linked to your Meta Business.
App creation screen in Meta Developers
Meta Developers Dashboard — Business app creation

Step 2 — Get the Credentials

  1. 1In the app dashboard, go to WhatsApp → API Setup.
  2. 2Copy the "Temporary Access Token" (starts with EAA...) — you will need to generate a Permanent Token later.
  3. 3Note the "Phone Number ID".
  4. 4Note the "WhatsApp Business Account ID" (WABA ID).
  5. 5In App Settings → Basic, copy the "App Secret".

Permanent vs. Temporary Token

The temporary token expires in 24 hours and is for testing only. For production, you must generate a Permanent Token via a System User in Meta Business Suite. Go to: Meta Business Suite → Settings → System Users → Generate Token.

Step 3 — Configure Credentials in UzzApp

  1. 1Access your UzzApp dashboard and go to Settings → Credentials (Vault).
  2. 2Enter the Access Token (META_ACCESS_TOKEN).
  3. 3Enter the Phone Number ID (META_PHONE_NUMBER_ID).
  4. 4Enter the App Secret (META_APP_SECRET).
  5. 5Set a custom Verification Token (META_VERIFY_TOKEN) — can be any secure text, e.g., "my-company-2026".
  6. 6Save the credentials. They are automatically encrypted with AES-256.
Credentials configuration screen in UzzApp
UzzApp Dashboard → Settings → Credentials

Step 4 — Configure the Webhook in Meta

  1. 1Back in Meta Developers, go to WhatsApp → Configuration.
  2. 2In the "Webhooks" section, click "Configure Webhooks".
  3. 3In the Callback URL field, enter: https://chat.uzzai.com.br/api/webhook/YOUR_CLIENT_ID
  4. 4In the Verification Token field, enter exactly the same text you defined in the previous step (META_VERIFY_TOKEN).
  5. 5Click "Verify and Save". Meta will make a request to UzzApp to confirm.
  6. 6After verifying, enable subscriptions: messages and message_status_updates.

How to find your Client ID

Your Client ID is your company's unique identifier in UzzApp. You can find it at: Settings → My Account → Client ID. It is in UUID format (e.g., 550e8400-e29b-41d4-a716-446655440000).

Step 5 — Test the Connection

  1. 1Send a text message to the configured WhatsApp number.
  2. 2Access the UzzApp Dashboard → Conversations and check if the message appeared.
  3. 3If the message appeared, the connection is working correctly.
  4. 4If it did not appear, check that the webhook is active and the access token is valid.

Number in production

During development, Meta limits message sending to only 5 registered test numbers. To release the number for production and send to any contact, you need to go through the business verification process in Meta Business Suite and configure the number for production.

Connection done? Next step

Now configure your AI assistant and complete the initial platform setup.

Initial Setup →