Connect
WhatsApp connects through the WhatsApp Business Platform on Meta. You authorize Modiva against your WhatsApp Business account to send and receive messages.
Before you start
- A WhatsApp Business account set up in Meta Business.
- A registered WhatsApp Business phone number.
- Admin access to the Business account during connect.
Step-by-step setup
- 1
Sign in to Modiva
Log in at modiva.ai and open the Dashboard. You need a Modiva account before you can connect any platform — creating one takes a minute and no credit card is required for the free tier.
The Modiva dashboard — your home for connections, posts and analytics. - 2
Open Connections → New connection
In the left sidebar choose Connections, then click New connection. You'll see the full catalogue of platforms grouped by category (Social and Ads).
The connection picker. Use the search box or category filter to find your platform. - 3
Select WhatsApp
Click the WhatsApp card. Modiva redirects you to WhatsApp's official sign-in and permission screen — your password is entered on WhatsApp, never on Modiva.
Click Connect on the WhatsApp card to start the secure OAuth flow. - 4
Authorize Modiva on WhatsApp
Review the permissions Modiva is requesting and approve them. If you manage more than one account, page or profile, pick the one you want Modiva to manage.
WhatsApp's consent screen. Approve the requested scopes to continue. - 5
You're connected
WhatsApp now sends you back to Modiva and the connection appears with a green Connected status. From here it's available to every MCP key and API call in your workspace.
A healthy connection shows a green dot and the connected account name.
Permissions Modiva requests
When you connect WhatsApp, Modiva asks only for the access it needs to run the tools you use. You can revoke it any time from WhatsApp or by disconnecting in Modiva.
- Send and receive WhatsApp business messages
- Manage your WhatsApp Business account
Troubleshooting & FAQ
Where is my WhatsApp password stored?
Nowhere. You sign in on the provider's own site and Modiva only receives a scoped access token, which is encrypted at rest with AES-256-GCM. Modiva never sees your password.
My connection says Expired or Error — what do I do?
Open Connections, find the platform and click Reconnect (or Refresh token). Providers periodically expire tokens or revoke them when you change your password; reconnecting re-runs the consent screen and restores access.
How do I disconnect?
Open Connections, click the WhatsApp row and choose Disconnect. Modiva deletes the stored token immediately. You can also revoke Modiva from inside WhatsApp's own app settings.
Do I need a Meta Business account?
Yes. WhatsApp messaging runs on the WhatsApp Business Platform, which requires a Meta Business account with a verified business phone number.
Need help with WhatsApp?
Fin can answer follow-up questions and walk you through any step.
