Znx Wapify

ENDPOINTS V1 (BY NUMBER)

Send Text Message
Send Media
Send Voice Note
Send Document
Send Button Message

ENDPOINTS V2 (BY JID)

Send Text Message (JID)
Send Media (JID)
Send Voice Note (JID)
Send Document (JID)
Send Button Message (JID)

POST/v1/text

Send Text Message

Sends a plain text message.

Headers

Key	Description
`x-znx-token`	Your bot instance token. (Required)

Body Parameters (application/json)

Parameter	Type	Status	Description
`number`	`string`	Required	Recipient number with country code (e.g., 62812xxxx).
`text`	`string`	Required	The message content.

Example (cURL)

curl -X POST '__BASE_URL__/v1/text' \
  --header 'x-znx-token: __YOUR_TOKEN__' \
  --header 'Content-Type: application/json' \
  --data-raw '{
    "number": "6281234567890",
    "text": "Hello, this is a test message."
  }'

POST/v1/media

Send Media

Sends a media file from a URL.

Headers

Key	Description
`x-znx-token`	Your bot instance token. (Required)

Body Parameters (application/json)

Parameter	Type	Status	Description
`number`	`string`	Required	Recipient number.
`url`	`string`	Required	Public URL of the image/video.
`caption`	`string`	Optional	Caption for the media.

Notes

Supported types: image, video.

Example (cURL)

curl -X POST '__BASE_URL__/v1/media' \
  --header 'x-znx-token: __YOUR_TOKEN__' \
  --header 'Content-Type: application/json' \
  --data-raw '{
    "number": "6281234567890",
    "url": "https://i.imgur.com/example.jpeg",
    "caption": "This is an image."
  }'

POST/v1/voice

Send Voice Note

Sends an audio file as a voice note.

Headers

Key	Description
`x-znx-token`	Your bot instance token. (Required)

Body Parameters (application/json)

Parameter	Type	Status	Description
`number`	`string`	Required	Recipient number.
`url`	`string`	Required	Public URL of the audio file.

Notes

Audio will be sent as a Push-to-Talk (PTT) message.

Example (cURL)

curl -X POST '__BASE_URL__/v1/voice' \
  --header 'x-znx-token: __YOUR_TOKEN__' \
  --header 'Content-Type: application/json' \
  --data-raw '{
    "number": "6281234567890",
    "url": "https://example.com/audio.mp3"
  }'

POST/v1/file

Send Document

Sends a file as a document.

Headers

Key	Description
`x-znx-token`	Your bot instance token. (Required)

Body Parameters (application/json)

Parameter	Type	Status	Description
`number`	`string`	Required	Recipient number.
`url`	`string`	Required	Public URL of the file.
`filename`	`string`	Required	File name with extension.
`caption`	`string`	Optional	Optional caption.

Example (cURL)

curl -X POST '__BASE_URL__/v1/file' \
  --header 'x-znx-token: __YOUR_TOKEN__' \
  --header 'Content-Type: application/json' \
  --data-raw '{
    "number": "6281234567890",
    "url": "https://example.com/document.pdf",
    "filename": "report.pdf"
  }'

POST/v1/button

Send Button Message

Sends a message with interactive buttons.

Headers

Key	Description
`x-znx-token`	Your bot instance token. (Required)

Body Parameters (application/json)

Parameter	Type	Status	Description
`number`	`string`	Required	Recipient number.
`text`	`string`	Required	Main text content.
`button`	`string`	Required	JSON string of button objects.
`media`	`string`	Optional	Optional image URL for header.

Notes

Button parameter example: '[{"text": "Option 1", "command": ".opt1"}]'
This feature may not work on WhatsApp Business accounts.

Example (cURL)

curl -X POST '__BASE_URL__/v1/button' \
  --header 'x-znx-token: __YOUR_TOKEN__' \
  --header 'Content-Type: application/json' \
  --data-raw '{
    "number": "6281234567890",
    "text": "Select an option:",
    "button": "[{\"text\":\"Option A\",\"command\":\".opt-a\"}]"
  }'

POST/v2/text

Send Text Message (JID)

Sends a plain text message using a JID.

Headers

Key	Description
`x-znx-token`	Your bot instance token. (Required)

Body Parameters (application/json)

Parameter	Type	Status	Description
`jid`	`string`	Required	Recipient JID (e.g., 62812xxxx@s.whatsapp.net or xxxxx-xxxx@g.us).
`text`	`string`	Required	The message content.

Example (cURL)

curl -X POST '__BASE_URL__/v2/text' \
  --header 'x-znx-token: __YOUR_TOKEN__' \
  --header 'Content-Type: application/json' \
  --data-raw '{
    "jid": "6281234567890@s.whatsapp.net",
    "text": "Hello, this is a test message."
  }'

POST/v2/media

Send Media (JID)

Sends a media file from a URL using a JID.

Headers

Key	Description
`x-znx-token`	Your bot instance token. (Required)

Body Parameters (application/json)

Parameter	Type	Status	Description
`jid`	`string`	Required	Recipient JID.
`url`	`string`	Required	Public URL of the image/video.
`caption`	`string`	Optional	Caption for the media.

Notes

Supported types: image, video.

Example (cURL)

curl -X POST '__BASE_URL__/v2/media' \
  --header 'x-znx-token: __YOUR_TOKEN__' \
  --header 'Content-Type: application/json' \
  --data-raw '{
    "jid": "6281234567890@s.whatsapp.net",
    "url": "https://i.imgur.com/example.jpeg",
    "caption": "This is an image."
  }'

POST/v2/voice

Send Voice Note (JID)

Sends an audio file as a voice note using a JID.

Headers

Key	Description
`x-znx-token`	Your bot instance token. (Required)

Body Parameters (application/json)

Parameter	Type	Status	Description
`jid`	`string`	Required	Recipient JID.
`url`	`string`	Required	Public URL of the audio file.

Notes

Audio will be sent as a Push-to-Talk (PTT) message.

Example (cURL)

curl -X POST '__BASE_URL__/v2/voice' \
  --header 'x-znx-token: __YOUR_TOKEN__' \
  --header 'Content-Type: application/json' \
  --data-raw '{
    "jid": "6281234567890@s.whatsapp.net",
    "url": "https://example.com/audio.mp3"
  }'

POST/v2/file

Send Document (JID)

Sends a file as a document using a JID.

Headers

Key	Description
`x-znx-token`	Your bot instance token. (Required)

Body Parameters (application/json)

Parameter	Type	Status	Description
`jid`	`string`	Required	Recipient JID.
`url`	`string`	Required	Public URL of the file.
`filename`	`string`	Required	File name with extension.
`caption`	`string`	Optional	Optional caption.

Example (cURL)

curl -X POST '__BASE_URL__/v2/file' \
  --header 'x-znx-token: __YOUR_TOKEN__' \
  --header 'Content-Type: application/json' \
  --data-raw '{
    "jid": "6281234567890@s.whatsapp.net",
    "url": "https://example.com/document.pdf",
    "filename": "report.pdf"
  }'

POST/v2/button

Send Button Message (JID)

Sends a message with interactive buttons using a JID.

Headers

Key	Description
`x-znx-token`	Your bot instance token. (Required)

Body Parameters (application/json)

Parameter	Type	Status	Description
`jid`	`string`	Required	Recipient JID.
`text`	`string`	Required	Main text content.
`button`	`string`	Required	JSON string of button objects.
`media`	`string`	Optional	Optional image URL for header.

Notes

Button parameter example: '[{"text": "Option 1", "command": ".opt1"}]'
This feature may not work on WhatsApp Business accounts.

Example (cURL)

curl -X POST '__BASE_URL__/v2/button' \
  --header 'x-znx-token: __YOUR_TOKEN__' \
  --header 'Content-Type: application/json' \
  --data-raw '{
    "jid": "6281234567890@s.whatsapp.net",
    "text": "Select an option:",
    "button": "[{\"text\":\"Option A\",\"command\":\".opt-a\"}]"
  }'