Skip to main content
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.

Quick Start

Authenticate and send your first WhatsApp message in under 5 minutes.

Authentication

Learn about API keys, headers, and how to secure your credentials.

Send Messages

Explore text, template, media, and interactive message types.

API Reference

Full reference for every endpoint, parameter, and response schema.

​
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:
Endpoints are appended to this base URL. For example, to send a message to a specific project, the full URL is:

​
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 if you need higher throughput limits for your use case.
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 for details.