Convovera Messaging API

Authentication

Create a token under WhatsApp Messaging API. Include it with every request:

Authorization: Bearer cv_live_your_token
Accept: application/json
Content-Type: application/json

Tokens are workspace-scoped. Subscription and template-category permissions are enforced on every request.

List approved templates

GET https://convovera.com/api/v1/templates

curl 'https://convovera.com/api/v1/templates' -H 'Authorization: Bearer cv_live_your_token' -H 'Accept: application/json'

Create and submit a template

POST https://convovera.com/api/v1/templates

The template is saved in Convovera and submitted to Meta. Its status is normally PENDING until Meta approves or rejects it.

curl -X POST 'https://convovera.com/api/v1/templates' \
  -H 'Authorization: Bearer cv_live_your_token' \
  -H 'Content-Type: application/json' \
  -d '{"name":"order_update","language":"en_US","category":"UTILITY","body":"Hello 1, order 2 is ready.","sample_values":["Asha","ORD-1001"]}'

Send template message

POST https://convovera.com/api/v1/messages/template

curl -X POST 'https://convovera.com/api/v1/messages/template' -H 'Authorization: Bearer cv_live_your_token' -H 'Content-Type: application/json' -d '{"to":"919876543210","template":"order_update","language":"en_US","parameters":["Asha","ORD-1001"]}'

Successful response

{
  "success": true,
  "http_status": 200,
  "provider_mode": "platform",
  "billing_status": "charged",
  "message_id": 125,
  "whatsapp_message_id": "wamid...",
  "charge": {"amount": 0.5000, "currency": "INR", "wallet_transaction_id": 91, "message_charge_id": 87, "wallet_balance_after": 249.5000}
}

Usage, wallet, and charges

GET https://convovera.com/api/v1/usage

The response includes charged messages, total charges, currency, and current wallet balance.

curl 'https://convovera.com/api/v1/usage' -H 'Authorization: Bearer cv_live_your_token' -H 'Accept: application/json'

Error codes