WhatsApp Setup Guide
Follow these steps to connect your WhatsApp Business account to GenSmart and start deploying AI agents that respond to your customers on WhatsApp.
Prerequisites: A Meta Business Account and a phone number not currently registered with WhatsApp. GenSmart requires a Starter plan or higher to use WhatsApp.
Manual Setup — Step by Step
- 1Create a Meta Developer App
Go to the Meta for Developers portal and create a new App. Choose "Business" as the app type. developers.facebook.com
You need a Meta Business Account linked to your developer account. If you don't have one, create it first at business.facebook.com. - 2Add the WhatsApp Product
From your app dashboard, click "Add Product" → select WhatsApp → click "Set Up". This creates a WhatsApp Business Account (WABA) sandbox for testing.
- 3Get your Phone Number ID and WABA ID
In the WhatsApp → Getting Started section, find the "Phone number ID" and "WhatsApp Business Account ID". Copy both — you'll need them in GenSmart.
The test number provided by Meta is free to use in sandbox mode. To go live, add and verify your own business phone number. - 4Generate a Permanent Access Token
Go to Meta Business Manager → Settings → System Users. Create a system user with Admin role, assign your app, then click "Generate Token" with scopes: whatsapp_business_messaging and whatsapp_business_management. Business Manager System Users
Temporary tokens expire after 24h. Always use a System User token for production deployments. - 5Connect in GenSmart
Open your agent in the GenSmart dashboard → Channels tab → WhatsApp section → Manual Setup. Enter your Phone Number ID, WABA ID, and Permanent Access Token, then click Connect.
- 6Configure the Webhook in Meta
After connecting, GenSmart shows you a Webhook URL and Verify Token. Go to your Meta app → WhatsApp → Configuration → Webhook. Click "Edit" and paste both values. Subscribe to the "messages" field.
In development you can use ngrok to expose your local server: run "ngrok http 4000" and use the https URL as your webhook base.
Quick Setup with Facebook Login
Open your agent in the GenSmart dashboard and go to the Channels tab.
In the WhatsApp section, click "Connect with Facebook".
Log in with your Facebook account and grant the required permissions.
GenSmart will automatically retrieve your Phone Number ID and WABA ID.
Copy the Webhook URL and Verify Token shown, and configure them in your Meta app.