Wagenius Docs → WhatsApp Cloud API Setup
Open Wagenius →

What You'll Need

Make sure you have these ready before starting the setup. It takes about 5 minutes to gather everything.

Facebook / Meta Account

A personal Facebook account to log into Meta Developer Portal

Business Name & Details

Your company name and a contact email address

Phone Number

A phone number not already connected to WhatsApp (or use Meta's free test number)

Wagenius Account

An active Wagenius CRM account with admin access

Business Verification (Optional)

Required only if you want to upgrade to a production-grade account

ℹ️
Good news! Meta provides a free test phone number so you can test everything before connecting your real business number. You can start right away without any business verification.

Complete Setup Guide

Follow each step carefully. Screenshots are included at every stage to guide you visually.

1

Create a Meta Developer Account

Go to developers.facebook.com and log in with your Facebook account. If this is your first time, you'll be asked to register as a developer — just follow the quick prompts.

🔗
Visit developers.facebook.com and click "Get Started" or log in with your existing Facebook account.
You're done when: You can see the Meta Developers dashboard and the "My Apps" section in the top navigation.
2

Create a Meta App

From your Meta Developer dashboard, navigate to My Apps and click the green "Create App" button in the top-right corner.

developers.facebook.com/apps/
Meta Apps Dashboard - Create App
Click Here ↗

When prompted to choose an app type, scroll down and select "Other", then choose "Business" as the app type. Give your app a name (e.g. "MyBusiness WA") and enter your contact email.

developers.facebook.com/apps/creation/
Create App Form
Fill App Name & Email
Click Next ↓
⚠️
Select "Business" as app type. This is important — other app types may not include the WhatsApp product option.
3

Add WhatsApp Product to Your App

After creating the app, open it from your apps list. You'll see the app dashboard. Look for the "Customize the Connect with customers through WhatsApp use case" and click on it to get started.

developers.facebook.com/apps/ → Select Your App
Select App
Click Your App Card
App Dashboard
App Dashboard WhatsApp Use Case
Click WhatsApp Use Case
4

Start Using WhatsApp API

You'll be taken to the WhatsApp Business Platform overview. Click "Start using the API" button to enter the API setup. This is where you'll connect your business account and phone number.

Quickstart → WhatsApp Business Platform
Start using the API
Click This Button ↗
Meta will create a free Test WhatsApp Business Account for you automatically. You can use this to test everything before adding your real number.
5

Generate Your Access Token

In the API Setup page, you'll see an "Access Token" section at the top. Click "Generate access token" — this creates a temporary token you can use immediately. For production use, you'll need a permanent token (covered in the next step).

API Setup Page
Generate Access Token and Copy Credentials
① Generate Token Here
② Phone Number ID
③ WhatsApp Phone Number & Business Account ID
⚠️
The generated token is temporary (expires in ~24 hours). For a permanent token, you need to create a System User in Meta Business Manager. Instructions below.
HOW TO CREATE A PERMANENT TOKEN
1.
Go to business.facebook.com
2.
Navigate to Settings → Users → System Users
3.
Click "Add" → Set role to "Admin"
4.
Click "Generate New Token" → Select your App
5.
Enable whatsapp_business_messaging permission
6.
Copy the token — this is your permanent token!
6

Copy Your Credentials

From the API Setup page, copy these three critical values. You'll need all three to configure Wagenius in the next step.

📞 Phone Number ID
994094020461198

Found below the phone number selector on the API Setup page

🏢 WhatsApp Business Account ID
227017153508824

Listed next to the Phone Number ID on the same page

🔑 Access Token
EAAMrXm5cJQBRG8h6sIZBzWo409wuBvtvxBwtGh...

Generated from the Generate access token button

🚨
Never share your Access Token publicly. Treat it like a password. If compromised, generate a new one immediately from Meta Business Manager.
7

Configure Wagenius CRM

Now log into your Wagenius dashboard and navigate to your WhatsApp Account Settings. Paste the credentials you copied in the previous step.

preview.wstacks.com/wagenius/user/whatsapp-account/setting/1
Wagenius WhatsApp Settings
Fill All 4 Fields
WhatsApp Number Your connected phone number
WhatsApp Business Account ID From Meta API Setup → WABA ID
WhatsApp Phone Number ID From Meta API Setup → Phone ID
App ID From Meta API Setup → App ID
Meta Access Token The token you generated

After filling in all fields, click the orange "Submit" button to save your configuration.

Success tip: If the fields turn green or you see a success message, your credentials were accepted. Move on to the webhook setup!
8

Set Up Your Webhook

Webhooks allow Meta to send message notifications to Wagenius in real-time. Go back to Meta Developer Dashboard → your app → Configuration tab in the left sidebar.

App → Use Cases → Customize → Configuration
Webhook Configuration
Enter Callback URL & Verify Token
Click Verify and Save ↗
🔗 Callback URL
https://yourdomain.com/webhook

Get this from your Wagenius admin settings

🔐 Verify Token
your_verify_token_here

Set any secure string — must match in both places

After entering both values, click "Verify and save". Meta will ping your webhook URL to confirm it's working.

Recommended Webhook Fields to Subscribe:

messages
Subscribe
message_deliveries
Subscribe
message_reads
Subscribe
message_echoes
Subscribe
⚠️
Make sure your Wagenius server is live and accessible publicly before verifying. The verify token must match exactly (case-sensitive).
9

Test Sending Your First Message

Go back to the API Setup page and use the "Send and receive messages" section. Select a recipient number in the "To" field and click "Send message".

📱
For testing, Meta lets you send messages to up to 5 phone numbers for free without any business verification. Add your own number to test!
EXAMPLE API TEST (Optional - Using cURL)
curl -X POST \
  'https://graph.facebook.com/v25.0/YOUR_PHONE_ID/messages' \
  -H 'Authorization: Bearer YOUR_TOKEN' \
  -H 'Content-Type: application/json' \
  -d '{"messaging_product":"whatsapp","to":"RECIPIENT_NUMBER","type":"template","template":{"name":"hello_world","language":{"code":"en_US"}}}'
🎉
Setup complete! If you received a test message, your WhatsApp Cloud API is fully connected to Wagenius. Start managing customer conversations from your inbox!

Still Need Help?

Our support team is ready to help you get connected. Choose the option that works best for you.

🎫

Support Ticket

Create a support ticket and our team will respond as soon as possible. Track and manage your issues easily inside Wagenius.

Create Ticket
📧

Email Support

Send us a detailed message and we'll get back to you within 24 hours.

Send Email
📚

Full Documentation

Browse our complete knowledge base for all features and advanced settings.

Browse Docs
🚀

Ready to get started?

Join thousands of businesses using Wagenius to manage WhatsApp conversations at scale.

Open Wagenius Dashboard →