Skip to main content
Convo uses a two-level hierarchy to organize your WhatsApp presence: a Business sits at the top and can contain multiple Projects, each of which maps to a single WhatsApp phone number. Understanding this structure helps you manage multi-number deployments, billing, and access controls effectively.

​
Business

A Business represents your top-level Convo account. It is the entity that owns your subscription, holds billing information, and acts as the parent for all your Projects. Key properties of a Business:
  • business_id — A unique identifier assigned to your Business. You use this ID when making requests through the Partner API.
  • Billing currency — All invoices and credit purchases are settled in the currency configured for your Business.
  • Timezone — The Business timezone is used for scheduling broadcasts and reporting.
  • Multiple Projects — A single Business can own many Projects, making it straightforward to manage separate WhatsApp numbers for different brands, regions, or use cases under one account.

​
Project

A Project is the operational unit in Convo. Every Project is linked to exactly one WhatsApp Business phone number and carries its own configuration, quota, and credit balance. Key properties of a Project:

​
Project Status Values

MAU vs WCC — what’s the difference?
  • MAU (Monthly Active User) quota counts the number of unique contacts you engage in a given calendar month. Exceeding your MAU quota may require a plan upgrade.
  • WCC (WhatsApp Conversation Credits) are consumed each time you open a new conversation window with a contact. WhatsApp charges per conversation (not per message), and Convo deducts the equivalent credits from your balance.

​
WhatsApp Number Details

Each Project exposes metadata about the WhatsApp Business number it manages:

​
Messaging Tiers

WhatsApp automatically upgrades your tier as you build a positive sending history. Maintaining a high quality rating accelerates this progression.

​
Finding Your IDs

​
project_id

You can locate your project_id in two ways:
1

From the Dashboard URL

Open the Convo dashboard and navigate to the Project you want to work with. The URL will contain your project_id:
2

From the Settings Page

Inside your Project, go to Settings → General. Your project_id is displayed in the Project Information section and can be copied directly.

​
business_id

Your business_id is available in your Account Settings page, accessible from the top-right user menu in the Convo dashboard. It is also returned in the response body when you authenticate via the Partner API.
Sandbox ModeWhen a Project’s sandbox field is true, the linked WhatsApp number has not yet completed Meta’s verification process. In sandbox mode you can explore the API and test integrations, but outbound messages are restricted to a small set of pre-approved test numbers. Once verification is complete, sandbox switches to false and full messaging capabilities become available.