# Convo

## Docs

- [Convo: WhatsApp Business API and Messaging Platform](https://doc.convo.co.in/introduction.md): Convo is a WhatsApp Business API platform for sending messages, managing contacts, running campaigns, and receiving real-time event webhooks.
- [Get Started with the Convo WhatsApp API in Minutes](https://doc.convo.co.in/quickstart.md): Learn how to authenticate and send your first WhatsApp message using the Convo REST API, no SDK required, just a few curl commands.
- [Convo API Authentication: Keys, Headers, and Security](https://doc.convo.co.in/authentication.md): Convo uses API key authentication via HTTP headers. Learn how to obtain your credentials and pass them correctly on every request.
- [Convo Businesses and Projects: Account Structure Guide](https://doc.convo.co.in/concepts/business-and-projects.md): Learn how Convo organizes WhatsApp accounts into Businesses and Projects, how each Project maps to a phone number, and how to find your IDs.
- [How Convo Manages WhatsApp Contacts and Attributes](https://doc.convo.co.in/concepts/contacts.md): Contacts represent your WhatsApp subscribers. Learn how Convo stores contact data, supports custom attributes, and manages opt-in status.
- [WhatsApp Message Templates: Creation and Management](https://doc.convo.co.in/concepts/templates.md): Message Templates are pre-approved messages required for initiating WhatsApp conversations. Learn how to create, manage, and send templates via Convo.
- [Convo Campaign Types: API Campaigns and Broadcasts](https://doc.convo.co.in/concepts/campaigns.md): Convo supports API campaigns for triggered per-contact messaging and Broadcast campaigns for bulk sends. Learn how each type works and when to use them.
- [Webhooks: Real-Time Event Notifications in Convo](https://doc.convo.co.in/concepts/webhooks.md): Convo webhooks push real-time event notifications to your server when messages are sent, delivered, read, or new contacts are created.
- [Sending WhatsApp Messages with the Convo Project API](https://doc.convo.co.in/guides/send-first-message.md): Learn how to send text, image, video, audio, document, and interactive WhatsApp messages programmatically using the Convo messaging API endpoints.
- [Create and Send WhatsApp Template Messages in Convo](https://doc.convo.co.in/guides/template-messages.md): Learn how to create, submit for approval, and send WhatsApp Business Message Templates with dynamic parameters, media headers, and interactive buttons.
- [Build and Send API-Triggered Campaigns with Convo](https://doc.convo.co.in/guides/api-campaigns.md): Learn how to build always-on API campaigns that send personalized WhatsApp templates to contacts one at a time, with delivery and engagement tracking.
- [Set Up and Send WhatsApp Commerce Catalogues in Convo](https://doc.convo.co.in/guides/catalogue-commerce.md): Connect your product catalogue to WhatsApp, add products, and send interactive shopping messages to customers using Convo's catalogue API.
- [Set Up Convo Webhooks for Real-Time WhatsApp Events](https://doc.convo.co.in/guides/webhook-setup.md): Configure Convo webhooks to receive real-time push notifications for WhatsApp message events, contact updates, and campaign replies on your server.
- [Convo REST API Reference: Overview and Auth Guide](https://doc.convo.co.in/api-reference/overview.md): Complete reference for the Convo REST API. Base URL, authentication headers, response formats, error codes, and pagination explained.
- [GET /business/{business_id} — Retrieve Business Profile](https://doc.convo.co.in/api-reference/business/get-business.md): GET /business/{business_id} — Retrieve your Convo business account details. Returns display name, email, company, timezone, and linked project IDs.
- [GET /project/{project_id} — Retrieve Project Details](https://doc.convo.co.in/api-reference/project/get-project.md): GET /project/{project_id} — Fetch all details of a Convo project, including WhatsApp number, plan, MAU usage, quality rating, and billing info.
- [POST /project/{project_id}/messages — Send Message](https://doc.convo.co.in/api-reference/messages/send-message.md): POST /project/{project_id}/messages — Send text, image, video, audio, document, template, and interactive WhatsApp messages to any phone number.
- [Retrieve a WhatsApp Message — Status and Timestamps](https://doc.convo.co.in/api-reference/messages/get-message.md): GET /project/{project_id}/messages/{message_id} — Retrieve full details of a sent or received WhatsApp message including delivery status and timestamps.
- [POST /project/{project_id}/contact — Create Contact](https://doc.convo.co.in/api-reference/contacts/create-contact.md): POST /project/{project_id}/contact — Add a new contact to your Convo project. New contacts are automatically opted in for WhatsApp notifications.
- [GET /project/{project_id}/contact — Fetch Contact](https://doc.convo.co.in/api-reference/contacts/get-contact.md): Retrieve a Convo contact by their mobile number (FetchContact action) or by their contact ID. Returns the full contact profile and attributes.
- [PATCH /project/{project_id}/contact/{id} — Update Contact](https://doc.convo.co.in/api-reference/contacts/update-contact.md): PATCH /project/{project_id}/contact/{id} — Update a contact's name, custom attributes, opt-in status, or blocked status in Convo.
- [POST /project/{project_id}/wa_template — Submit Template](https://doc.convo.co.in/api-reference/templates/submit-template.md): POST /project/{project_id}/wa_template — Submit a new WhatsApp Message Template for approval. Supports text, image, video, file, and carousel types.
- [GET /project/{project_id}/wa_template — List Templates](https://doc.convo.co.in/api-reference/templates/list-templates.md): GET /project/{project_id}/wa_template — Retrieve a paginated list of WhatsApp Message Templates in your project, with optional cursor-based pagination.
- [GET /project/{project_id}/wa_template/{id} — Get Template](https://doc.convo.co.in/api-reference/templates/get-template.md): GET /project/{project_id}/wa_template/{id} — Retrieve a single WhatsApp Message Template by its ID, including approval status and rejection reason.
- [DELETE /project/{project_id}/wa_template/{id} — Remove](https://doc.convo.co.in/api-reference/templates/delete-template.md): DELETE /project/{project_id}/wa_template/{id} — Permanently delete a WhatsApp Message Template. Review WhatsApp deletion policies before proceeding.
- [Create an API Campaign Tied to a WhatsApp Template](https://doc.convo.co.in/api-reference/campaigns/create-campaign.md): Create an API campaign that links an approved WhatsApp Message Template to a reusable, named campaign for programmatic per-contact sends.
- [Send a WhatsApp Message Using an Existing API Campaign](https://doc.convo.co.in/api-reference/campaigns/send-campaign.md): Trigger a per-contact WhatsApp campaign send with dynamic template parameters, optional media, custom attributes, and contact tagging for enrichment.
- [POST /project/{project_id}/campaigns — List Campaigns](https://doc.convo.co.in/api-reference/campaigns/list-campaigns.md): POST /project/{project_id}/campaigns — Retrieve a list of API, Broadcast, or all campaigns in your project with pagination support.
- [Retrieve the Full Details of a Single API Campaign](https://doc.convo.co.in/api-reference/campaigns/get-campaign.md): Retrieve all details of a specific API campaign by its ID, including the linked WhatsApp template, current status, and message payload.
- [Retrieve Daily Campaign Analytics for a Date Range](https://doc.convo.co.in/api-reference/campaigns/campaign-analytics.md): Retrieve day-by-day campaign analytics over a date range, with sent, delivered, read, failed, and reply message counts for each day.
- [Retrieve Campaign Audience and Delivery Status Data](https://doc.convo.co.in/api-reference/campaigns/campaign-audience.md): List campaign recipients with their delivery status, filtered by category (SENT, READ, FAILED) and paginated with cursor-based navigation.
- [List All Active Webhook Subscriptions for a Project](https://doc.convo.co.in/api-reference/webhooks/list-webhooks.md): Retrieve all webhook subscriptions in your Convo project, optionally filtered by Custom App name, with topics and delivery URLs.
- [Retrieve the Full Details of a Webhook Subscription](https://doc.convo.co.in/api-reference/webhooks/get-webhook.md): GET /project/{project_id}/webhook/{webhook_id} — Retrieve details of a specific webhook subscription, including its URL, topics, and shared secret.
- [Permanently Delete a Registered Webhook Subscription](https://doc.convo.co.in/api-reference/webhooks/delete-webhook.md): DELETE /project/{project_id}/webhook/{webhook_id} — Remove a webhook subscription and stop receiving notifications at that endpoint.
- [Create a New Product Catalogue for WhatsApp Commerce](https://doc.convo.co.in/api-reference/catalogue/create-catalogue.md): POST /project/{project_id}/create-catalog — Create a new product catalogue linked to your WhatsApp Business account for commerce messaging.
- [GET /project/{project_id}/get-catalog — List Catalogues](https://doc.convo.co.in/api-reference/catalogue/get-catalogue.md): Retrieve a paginated list of all product catalogues linked to your Convo project, with optional pagination and product-count filters.
- [GET /project/{project_id}/sync-catalog — Sync Catalogue](https://doc.convo.co.in/api-reference/catalogue/sync-catalogue.md): GET /project/{project_id}/sync-catalog — Synchronize your business Meta catalogues with your Convo project to pull in latest catalogue data.
- [Connect or Disconnect a Meta Catalogue to Your WABA](https://doc.convo.co.in/api-reference/catalogue/connect-catalogue.md): Connect or disconnect a Meta product catalogue to your WhatsApp Business Account (WABA) and control its visibility and cart settings.
- [Add a New Product to an Existing Convo Catalogue](https://doc.convo.co.in/api-reference/catalogue/create-product.md): POST /project/{project_id}/create-product — Add a new product to an existing Convo catalogue with name, price, image, and inventory details.
- [List and Paginate Products in a Convo Catalogue](https://doc.convo.co.in/api-reference/catalogue/get-products.md): GET /project/{project_id}/get-catalog-products — Retrieve a paginated list of products in a specific catalogue, with status and availability details.
- [POST /project/{project_id}/get-media — Fetch Media by ID](https://doc.convo.co.in/api-reference/media/get-media.md): Download a media file from WhatsApp by its media ID, supporting arraybuffer, JSON, text, and stream response formats for flexible use.