Whatsapp Messages API (pass-through)

POST

https://api.chakrahq.com/v1/ext/plugin/whatsapp/{pluginId}/api/{whatstappApiVersion}/{whatsappPhoneNumberId}/messages

The following API allows you to invoke the whatsapp messages api directly. The complete documentation for this api can be found here

Please note that chakra provides only a thin wrapper on top of the original whatsapp API.

How to figure out the pluginId

In the WhatsApp setup page, locate the 3 dots icon next to the save button, on the top right corner

Click the same and click the "Copy Plugin Id" button

The plugin id is now copied, you can paste it where you need it

How to figure out the whatsappPhoneNumberId

In the WhatsApp Setup page click on the Gear icon next to "📞 WhatsApp Phone Numbers"

In the drawer that opens you will find the Meta ID of each phone number in the phone number column

Detailed documentation

The request payload can be found in the Whatsapp cloud api documentation
Whatsapp cloud api documentation for session messages - WhatsApp Cloud API Guide
Whatsapp cloud api postman collection - Postman Collection

Request

Authorization

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Path Params

Body Params application/json

Examples

Send template messageSend session message textSend session message - imageSend session message - list

{
	"messaging_product": "whatsapp",
	"recipient_type": "individual",
	"to": "919901258433",
	"type": "template",
	"template": {
		"name": "hello_world",
		"language": {
			"policy": "deterministic",
			"code": "en_US"
		},
		"components": [
			{
				"type": "body",
				"parameters": []
			}
		]
	}
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

cURL

Send template messageSend session message textSend session message - imageSend session message - list

curl --location --request POST 'https://api.chakrahq.com/v1/ext/plugin/whatsapp/d83e1d23-50b8-4d87-8f92-842a0ac516f6/api/v19.0//messages' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data-raw '{
	"messaging_product": "whatsapp",
	"recipient_type": "individual",
	"to": "919901258433",
	"type": "template",
	"template": {
		"name": "hello_world",
		"language": {
			"policy": "deterministic",
			"code": "en_US"
		},
		"components": [
			{
				"type": "body",
				"parameters": []
			}
		]
	}
}'

Responses

🟢200Success

application/json

Body

Example

{
	"_data": {
		"whatsappMessageId": "wamid.HBgMOTE5OTAxMjU4NDMzFQIAERgSREM5NDZGMjRFNzc1QUFDOEExAA=="
	}
}

Modified at 2025-08-21 08:05:37

Update WhatsApp Message Template (pass-through)

Fetch Whatsapp Media API