> ## 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: WhatsApp Business API and Messaging Platform

> Convo is a WhatsApp Business API platform for sending messages, managing contacts, running campaigns, and receiving real-time event webhooks.

Convo is a WhatsApp Business API platform that gives you programmatic access to WhatsApp messaging through a clean, RESTful API. Whether you're sending transactional notifications, running broadcast campaigns, managing your contact list, or reacting to inbound messages via real-time webhooks, Convo provides the infrastructure and tooling to build production-grade WhatsApp integrations — without managing the complexity of the WhatsApp Business API yourself.

<CardGroup cols={2}>
  <Card title="Quick Start" icon="bolt" href="/quickstart">
    Authenticate and send your first WhatsApp message in under 5 minutes.
  </Card>

  <Card title="Authentication" icon="lock" href="/authentication">
    Learn about API keys, headers, and how to secure your credentials.
  </Card>

  <Card title="Send Messages" icon="message" href="/guides/send-first-message">
    Explore text, template, media, and interactive message types.
  </Card>

  <Card title="API Reference" icon="code" href="/api-reference/overview">
    Full reference for every endpoint, parameter, and response schema.
  </Card>
</CardGroup>

## Key Concepts

Understanding the core building blocks of Convo will help you navigate the API and the dashboard effectively.

* **Business** — The top-level account entity in Convo. Every account has a unique `business_id` that groups all projects, contacts, and billing under one umbrella.
* **Project** — A project is linked to a single WhatsApp phone number and belongs to a Business. Most API calls are scoped to a `project_id`. You can have multiple projects under one Business.
* **Contact** — A WhatsApp user you interact with. Contacts are identified by their phone number (in E.164 format, e.g. `917089379345`) and can be enriched with custom attributes.
* **Template** — A pre-approved message format registered with Meta. Templates are required when you initiate a conversation with a user outside an open 24-hour service window.
* **Campaign** — A bulk messaging job that sends a template message to a list of contacts at a scheduled or immediate time.
* **Webhook** — An HTTP callback that Convo sends to your server when events occur — such as a message being delivered, read, or replied to.

## API Base URL

All API requests are made to the following base URL:

```text theme={null}
https://connect.api-wa.co/project-apis/v1/
```

Endpoints are appended to this base URL. For example, to send a message to a specific project, the full URL is:

```text theme={null}
https://connect.api-wa.co/project-apis/v1/project/{project_id}/messages
```

## Rate Limits

API rate limits depend on two factors:

* **Your Convo plan** — higher-tier plans allow more API calls per minute.
* **Your WhatsApp messaging tier** — Meta assigns a messaging tier to each WhatsApp Business number based on volume history. This tier determines how many unique users you can message per 24-hour period.

If you exceed a rate limit, the API returns an HTTP `429 Too Many Requests` response. We recommend implementing exponential backoff in your integration. Contact [Convo support](https://convo.com) if you need higher throughput limits for your use case.

<Note>
  Outbound messages to users you haven't previously spoken with require an approved **Message Template**. Free-form text messages can only be sent within an open 24-hour customer service window — initiated when a user messages you first. See the [Send Messages guide](/guides/send-first-message) for details.
</Note>