Wazzup Templates

Knowledge Base

Knowledge Base

Wazzup Templates

Wazzup allows you to create message templates. These help sales people respond to customers faster by eliminating the need to repeatedly type out replies to common questions.

This section covers working with Wazzup templates: creating, retrieving, editing, and deleting them.

When using the methods listed below, include the end‑customer's client_access_token (obtained via simplified authorization or OAuth) in the request header: Authorization: Bearer client_access_token

List of Methods

POST /v2/templates/wz — Create a Wazzup template
GET /v2/templates/wz — Retrieve a list of Wazzup templates
GET /v2/templates/wz/{template_id} — Retrieve a template by template_id
PATCH /v2/templates/wz/{template_id} — Edit a Wazzup template
DELETE /v2/templates/wz/{template_id} — Delete a Wazzup template

You can also manage templates using the Wazzup iframe

Create a Template

This method allows you to create a new template that can be used on any connected channel.

Method POST /v2/templates/wz

Request structure

POST /v2/templates/wz
│
├── name *
├── text *
├── order *
└── files[]
    ├── name
    ├── mimetype
    ├── size
    ├── sha1
    └── link

Body parameter. Required marked with *	Type	Description
`name`*	`string`	Template name
`text`*	`string`	Template body text
`order`*	`number`	Sort order
`files`	`array(object) files`	Template attachments. You can provide either a URL to an external file or a file in Wazzup storage format (sha1 + metadata). If a URL is provided, the file will be downloaded to Wazzup storage.

files (object)

Body parameter. Required marked with *	Type	Description
`name`	`string`	File name
`mimetype`	`string`	File type
`size`	`string`	File size
`sha1`	`string`	File hash
`link`	`string`	External file URL

Example: creating a template with an attachment:

curl -L 'https://tech.wazzup24.com/v2/templates/wz' \
-H 'Authorization: Bearer <client_access_token>' \
-H 'Content-Type: application/json' \
-d '{
"name":"greeting",
"text":"Hello!",
"order": 0,
"files": [
{
"name": "file.png",
"mimetype": "image/png",
"size": 28710,
"sha1": "70e2f9fe526e4a26859976958bc4b6e4"
}
]
}'

Response example:

{
"data": {
"guid": "ee747414-3529-4583-8dbb-d1a3403fa9e4",
"name": "greeting",
"text": "Hello!",
"files": [
{
"name": "file.png",
"sha1": "123123asdasdq",
"size": 28710,
"mimetype": "image/png"
}
],
"order": 0,
"details": {},
"tags": null
},
"meta": {
"timestamp": 1759495003
}
}

Result: A Wazzup template has been created with template_id: ee747414-3529-4583-8dbb-d1a3403fa9e4.

Retrieve a list of Wazzup Templates

Method GET /v2/templates/wz

Example:

curl -L 'https://tech.wazzup24.com/v2/templates/wz?limit=50&offset=0' \
-H 'Authorization: Bearer <client_access_token>'

Response example:

{
"data": [
{
"guid": "56c9f72b-8364-4b56-a3de-8a492c3f1b6c",
"name": "Greeting62577",
"text": "Hello, and thank you for reaching out. Our manager will get back to you shortly.",
"files": [
{
"name": "photo_2024-12-27_12-41-22.jpg",
"sha1": "854ae7b846a51bc345b1205d36f8ffa2f6e5ced0",
"size": 127102,
"mimetype": "image/jpeg"
}
],
"order": 2,
"details": {},
"tags": null
},
{
"guid": "c76a63e0-1e48-4824-8ebf-d4bc050e8510",
"name": "greeting 4",
"text": "Hi, my name is Alina. Feel free to reach out to me with any questions!",
"files": [
{
"name": "ÐÐ¾Ð½ÐµÑÐ¾ÑÐºÐ° - Ð¡ÐµÐ»ÑÑÐ°ÑÐ¼.mp3",
"sha1": "8067ec9283f415e6e186becec9c2d67943e005a4",
"size": 7641843,
"mimetype": "audio/mpeg"
},
{
"name": "Testing at Google.pdf",
"sha1": "4c26e5a24bcacec380375b6bd1183f8db5c8f6ae",
"size": 7880921,
"mimetype": "application/pdf"
}
],
"order": 0,
"details": {},
"tags": null
}
],
"meta": {
"timestamp": 1759493859
}
}

Result: A list of Wazzup templates has been created for the end‑customer account.

Retrieve a Template by ID

Method GET /v2/templates/wz/{template_id}

Path Parameters
template_id — Wazzup template ID

Example:

curl -L 'https://tech.wazzup24.com/v2/templates/wz/48caeea3-a930-4598-98b7-949afc3b8dd6' \
-H 'Authorization: Bearer <client_access_token>'

Response example:

{
"data": {
"guid": "56c9f72b-8364-4b56-a3de-8a492c3f1b6c",
"name": "Greeting62577",
"text": "Hello, and thank you for reaching out. Our manager will get back to you shortly.",
"files": [
{
"name": "photo_2024-12-27_12-41-22.jpg",
"sha1": "854ae7b846a51bc345b1205d36f8ffa2f6e5ced0",
"size": 127102,
"mimetype": "image/jpeg"
}
],
"order": 2,
"details": {},
"tags": null
},
"meta": {
"timestamp": 1759494286
}
}

Result: If a template with the specified template_id exists, it is returned in the response.

Edit a Wazzup Template

Method PATCH /v2/templates/wz/{template_id}

Path Parameters
template_id — Wazzup template ID

Example:

curl -L -X PATCH 'https://tech.wazzup24.com/v2/templates/wz/48caeea3-a930-4598-98b7-949afc3b8dd6' \
-H 'Authorization: Bearer <client_access_token>' \
-H 'Content-Type: application/json' \
-d '{
"name":"greeting 3",
"text":"Hi, my name is Alina. Feel free to reach out to me with any questions! Have a great day)",
"order": 0,
"files":[
{
"name":"hi.mp4",
"mimetype":"video/mp4",
"size":2548020,
"sha1":"123123asdasd"
}]}'

Response example:

{
"data": {
"guid": "48caeea3-a930-4598-98b7-949afc3b8dd6",
"name": "greeting 3",
"text": "Hi, my name is Alina. Feel free to reach out to me with any questions! Have a great day)",
"files": [
{
"name": "hi.mp4",
"sha1": "123123asdasd",
"size": 2548020,
"mimetype": "video/mp4"
}
],
"order": 0,
"details": {},
"tags": null
},
"meta": {
"timestamp": 1759495044
}
}

Result: The specified Wazzup template (template_id: 48caeea3-a930-4598-98b7-949afc3b8dd6) has been updated.

Delete a Wazzup Template

Method DELETE /v2/templates/wz/{template_id}

Path Parameters
template_id — Wazzup template ID

Example:

curl -L -X DELETE 'https://tech.wazzup24.com/v2/templates/wz/48caeea3-a930-4598-98b7-949afc3b8dd6' \
-H 'Authorization: Bearer <client_access_token>'

Response example:

{
"data": null,
"meta": {
"timestamp": 1759485643
}
}

Result: Template template_id: 48caeea3-a930-4598-98b7-949afc3b8dd6 has been deleted.