> ## Documentation Index
> Fetch the complete documentation index at: https://doc.convo.co.in/llms.txt
> Use this file to discover all available pages before exploring further.
# Convo Businesses and Projects: Account Structure Guide
> Learn how Convo organizes WhatsApp accounts into Businesses and Projects, how each Project maps to a phone number, and how to find your IDs.
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:
| Property | Description |
| ---------------- | ----------------------------------------------------------------------------------- |
| `project_id` | Unique identifier for this Project. Required in all Project API calls. |
| `wa_number` | The WhatsApp phone number attached to this Project (with country code, no `+`). |
| `plan` | The subscription plan active on this Project (e.g., `BASIC`, `PRO`, `ENTERPRISE`). |
| `subscription` | Detailed subscription object including renewal dates and features. |
| `mau_quota` | Maximum number of Monthly Active Users allowed under the current plan. |
| `credit_balance` | Remaining WhatsApp Conversation Credits (WCC) available for outbound conversations. |
| `sandbox` | Boolean flag indicating whether the Project is in sandbox mode. |
### Project Status Values
| Status | Meaning |
| ----------- | --------------------------------------------------------------------------- |
| `ACTIVE` | The Project is fully operational and can send and receive messages. |
| `PENDING` | The Project has been created but setup or verification is incomplete. |
| `SUSPENDED` | The Project has been temporarily suspended, usually due to a billing issue. |
| `STOPPED` | The Project has been manually stopped. No messages can be sent or received. |
| `ARCHIVED` | The Project has been archived and is no longer in active use. |
**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:
| Field | Description |
| ------------------- | ----------------------------------------------------------------------------------------------------------------- |
| `wa_display_name` | The business display name shown to your contacts in WhatsApp. |
| `wa_quality_rating` | Meta's quality rating for your number: `low`, `medium`, or `high`. A low rating can restrict your messaging tier. |
| `wa_messaging_tier` | Your current daily messaging limit tier (see table below). |
| `wa_about` | The "About" text shown on your WhatsApp Business profile. |
| `wa_display_image` | URL of the profile picture shown for your WhatsApp Business number. |
### Messaging Tiers
| Tier | Daily Message Limit |
| -------- | ------------------------ |
| `tier_1` | 1,000 messages per day |
| `tier_2` | 10,000 messages per day |
| `tier_3` | 100,000 messages per day |
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:
Open the Convo dashboard and navigate to the Project you want to work with. The URL will contain your `project_id`:
```text theme={null}
https://app.convo.com/projects//dashboard
```
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 Mode**
When 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.