ChakraHQ APIs
HomeSign In
HomeSign In
  1. Pass Through APIs
  • API Keys
  • Response Format
  • Whatsapp
    • Inbound Events Webhook
    • How to figure out pluginId and whatsappPhoneNumberId
    • Pass Through APIs
      • WhatsApp Messages API (pass-through)
        POST
      • Send WhatsApp session message
        POST
      • Create WhatsApp Message Template (pass-through)
        POST
      • List WhatsApp Message Templates (pass-through)
        GET
      • Update WhatsApp Message Template (pass-through)
        POST
      • Fetch Whatsapp Media API
        GET
      • Show Whatsapp Media Attachments API
        GET
    • Send Whatsapp Template Message For Process
      POST
    • Send Whatsapp Template Message For A Phone Number
      POST
    • Upload Public Media
      POST
    • Show Whatsapp Media API
      GET
    • Create a lead
      POST
    • List previous messages for a phone number
      POST
  • Platform
    • Process
      • Fetch Process By Id
      • List Processes
      • Create Process
      • Update Process
      • Update Process By Primary Key
      • Delete Process
      • Delete Process By Primary Key Value
      • Bulk Create Process API
      • Bulk Update Process API
    • Task
      • Create Task API
    • User
      • List Users API
      • List Users API (V2)
      • Fetch User API
      • Fetch User API (V2)
      • Update User API
    • Photo
      • Fetch Photo API
      • Upload Photo API
      • Upload Photo API With Id
    • Background Job
      • Fetch Background Job
      • Fetch Background Job Entries API
    • Fetch Config
      GET
  1. Pass Through APIs

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. This API will allow you to
send WhatsApp template messages
send WhatsApp session messages
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
copy-plugin-id

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
screenshot-of-whatsapp-phone-number-id

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
{
	"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
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
Request Request Example
Shell
JavaScript
Java
Swift
cURL
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-10-13 08:11:43
Previous
How to figure out pluginId and whatsappPhoneNumberId
Next
Send WhatsApp session message
Built with