Rcs Template
Rcs Template
API Endpoint
http://portal.thundersms.com/api/v2/
View Template
View all the Templates list.
GET
{endpoint}rcs/templates
PARAMETERS
| name |
optional |
value |
| filter[id] |
Yes |
The id is template id |
| filter[name] |
Yes |
The name is template name |
| filter[type] |
Yes |
The type is template type EX: (text, media. . ) |
| filter[status] |
Yes |
(0 is Draft), (1 is Approved) ,(2 is Pending) |
Example Request
curl -X GET \
'{endpoint}rcs/templates' \
-H 'Accept: application/json' \
-H 'Authorization: Bearer 5b02112fb7xxxxxxxxx'
Kindly replace the token with your respective access_token and other params.
Example Response
{
"status": "OK",
"code": 200,
"message": "Templates List",
"data": [
{
"id": "2cf9e59f-d4f1-47ba-81d3-a288f31ca164",
"name": "text_template",
"number": "91861xxxxxxx",
"type": "text",
"category": "Account",
"language": "English",
"payload": "{\"type\":\"text\",\"payload\":
{\"text\":\"Hi,This is Rcs text template message.\",\"language\":\"en\"}}",
"status": 1,
"is_conversation": 1,
"created_at": "2023-20-08T10:41:30.000000Z",
"updated_at": "2023-20-08T10:41:30.000000Z"
}
],
"links": {
"first": "{endpoint}rcs/templates?page=1",
"last": "{endpoint}rcs/templates?page=1",
"prev": null,
"next": null
},
"meta": {
"current_page": 1,
"from": 1,
"last_page": 1,
"links": [
{
"url": null,
"label": "« Previous",
"active": false
},
{
"url": "{endpoint}rcs/templates?page=1",
"label": "1",
"active": true
},
{
"url": null,
"label": "Next »",
"active": false
}
],
"path": "{endpoint}rcs/templates",
"per_page": 15,
"to": 1,
"total": 1
}
}
Show Template
Show the Template list.
GET
{endpoint}rcs/templates/{template_id}
Example Request
curl -X GET \
'{endpoint}rcs/templates/2cf9e59f-d4f1-47ba-81d3-a288f31ca164' \
-H 'Accept: application/json' \
-H 'Authorization: Bearer 5b02112fb7xxxxxxxxx'
Kindly replace the template_id.
Example Response
{
"status": "OK",
"code": 200,
"message": "Templates List",
"data": {
"id": "2cf9e59f-d4f1-47ba-81d3-a288f31ca164",
"name": "text_template",
"number": "91861xxxxxxx",
"type": "text",
"category": "Account",
"language": "English",
"payload": "{\"type\":\"text\",\"payload\":
{\"text\":\"Hi,This is Rcs text template message.\",
\"language\":\"en\"}}",
"status": 1,
"is_conversation": 1,
"created_at": "2023-20-08T10:41:30.000000Z",
"updated_at": "2023-20-08T10:41:30.000000Z"
}
}
Create Templates
POST
{endpoint}rcs/templates
REQUIRED PARAMETERS
| name |
description |
Type |
Required |
| type |
values are like text, interactive, media . . |
string |
Yes |
| name |
name should be a alphanumeric |
string,integer |
Yes |
| category |
template category names |
string |
Yes |
| language |
Example : eu, en_US |
string |
Yes |
| number |
agent number Ex:(91861xxxxxxxx) |
string or integer |
Yes |
| is_conversation |
value is (1 auto approve) or (0 admin will approve), default(0) |
integer |
Yes |
Text Type
PARAMETERS
| name |
description |
Type |
Required |
| payload.text |
content message with variables(optional) like {{name}} . . |
string |
Yes |
| payload.body_params |
replaces the variables values Ex: [‘name’] |
array |
No |
Example Request
curl -X POST \
'{endpoint}rcs/templates' \
-H 'authorization: Bearer 5b02112fb7xxxxxxxxx' \
-H 'content-type: application/json' \
-d '{
"type": "text",
"name": "text123",
"language": "en",
"category": "marketing",
"number": "91861xxxxxxx",
"is_conversation": 1,
"payload": {
"text" : "Hi, This is Rcs test message."
}
}'
Example Response
{
"status": "OK",
"code": 200,
"message": "Template created successfully.",
"data": {
"id": "3b58b499-e184-4cdf-9226-8ddae27e0821",
"name": "text123",
"number": "91861xxxxxxx",
"alias": "text123",
"type": "text",
"category": "Marketing",
"language": "English",
"payload": "{\"type\":\"text\",\"payload\":
{\"text\":\"Hi, This is Rcs test message.\"}}",
"status": 1,
"is_conversation": 1,
"created_at": "2023-02-23T05:56:58.000000Z",
"updated_at": "2023-02-23T05:56:58.000000Z"
}
}
Interactive Type
PARAMETERS
| name |
description |
Type |
Required |
| payload.body |
body text message |
object |
Yes |
| payload.header |
optional |
object |
No |
| payload.footer |
optional |
object |
No |
| payload.choices |
optional |
object |
No |
| payload.choices.replies |
optional |
object |
Yes |
Example Request
curl -X POST \
'{endpoint}rcs/templates' \
-H 'authorization: Bearer 5b02112fb7xxxxxxxxx' \
-H 'content-type: application/json' \
-d '{
"type": "interactive",
"name": "text12311",
"language": "en",
"category": "marketing",
"number": "91861xxxxxxx",
"payload": {
"header": {
"type": "text",
"payload": {
"text": "header text"
}
},
"body": {
"type": "text",
"payload": {
"text": "do you like rcs?"
}
},
"footer": {
"type": "text",
"payload": {
"text": "footer text"
}
},
"choices": {
"replies": [
{
"type": "text",
"payload": {
"text": "yes",
"content": "yes"
}
},
{
"type": "text",
"payload": {
"text": "no",
"content": "No"
}
}
]
}
}
}'
Example Response
{
"status": "OK",
"code": 200,
"message": "Template created successfully.",
"data": {
"id": "232b8245-17f4-4808-acf9-6f43dc7f3af2",
"name": "text12311",
"number": "91861xxxxxxx",
"alias": "text12311",
"type": "interactive",
"category": "Marketing",
"language": "English",
"payload": "{\"type\":\"interactive\",\"payload\":
{\"header\":{\"type\":\"text\",\"payload\":{\"text\":\"header text\"}},
\"body\":{\"type\":\"text\",\"payload\":{\"text\":\"do you like rcs?\"}},
\"footer\":{\"type\":\"text\",\"payload\":{\"text\":\"footer text\"}},
\"choices\":{\"replies\":
[{\"type\":\"text\",\"payload\":{\"text\":\"yes\",\"content\":\"yes\"}},
{\"type\":\"text\",\"payload\":{\"text\":\"no\",\"content\":\"No\"}}]}}}",
"status": 1,
"created_at": "2023-02-23T05:58:34.000000Z",
"updated_at": "2023-02-23T05:58:34.000000Z"
}
}
Media Type
PARAMETERS
| name |
description |
Type |
Required |
| payload.type |
image, video, audio or document |
string |
Yes |
| payload.payload |
payload object |
object |
Yes |
| payload.payload.url |
proper link url |
string |
Yes |
| payload.payload.filename |
optional |
string |
No |
| payload.payload.caption |
optional |
string |
No |
Example Request
curl -X POST \
'{endpoint}rcs/templates' \
-H 'authorization: Bearer 5b02112fb7xxxxxxxxx' \
-H 'content-type: application/json' \
-d '{
"type": "media",
"name": "media123",
"language": "en",
"category": "marketing",
"number": "91861xxxxxxx",
"payload": {
"type": "image",
"payload": {
"url": "https://picsum.photos/id/237/200/300",
"filename": "filename",
"caption": "caption"
}
}
}'
Example Response
{
"status": "OK",
"code": 200,
"message": "Template created successfully.",
"data": {
"id": "9f57036a-475b-4d25-8434-bdf23b7e680b",
"name": "media123",
"number": "91861xxxxxxx",
"alias": "media123-1",
"type": "media",
"category": "Marketing",
"language": "English",
"payload": "{\"type\":\"image\",\"payload\":
{\"url\":\"https:\\/\\/picsum.photos\\/id\\/237\\/200\\/300\",
\"filename\":\"filename\",\"caption\":\"caption\"}}",
"status": 1,
"created_at": "2023-02-23T06:01:03.000000Z",
"updated_at": "2023-02-23T06:01:03.000000Z"
}
}
Card Type
PARAMETERS
| name |
description |
Type |
Required |
| payload.title |
cart title |
string |
Yes |
| payload.description |
cart description |
string |
Yes |
| payload.body |
card body |
object |
Yes |
| payload.body.type |
only type value is image |
string |
Yes |
| payload.body.payload |
payload object |
object |
No |
| payload.body.payload.url |
proper link url |
string |
Yes |
| payload.body.payload.height |
Height of the card SHORT [112 DP], MEDIUM [168 DP], TALL[264 DP] |
string |
Yes |
| payload.choices |
optional |
object |
No |
| payload.choices.replies |
optional |
object |
No |
| payload.choices.actions |
optional |
object |
No |
Example Request
curl -X POST \
'{endpoint}rcs/templates' \
-H 'authorization: Bearer 5b02112fb7xxxxxxxxx' \
-H 'content-type: application/json' \
-d '{
"type": "card",
"name": "card_demo",
"language": "en",
"category": "marketing",
"number": "91861xxxxxxx",
"payload": {
"title": "This is the card title",
"description": "This is the card description",
"body": {
"type": "image",
"payload": {
"url": "https://domain-name.com/your_image_path.png",
"height": "TALL"
}
},
"choices": {
"replies": [
{
"type": "text",
"payload": {
"text": "yes",
"content": "yes"
}
},
{
"type": "text",
"payload": {
"text": "No",
"content": "no"
}
}
],
"actions": [
{
"type": "url",
"payload": {
"title": "Click Here",
"url": "https://example.com"
}
},
{
"type": "dial",
"payload": {
"title": "Click Here",
"phone_number": "+91901995xxxx"
}
},
{
"type": "location",
"payload": {
"latitude": 12.912985,
"longitude": 77.599505
}
}
]
}
}
}'
Example Response
{
"status": "OK",
"code": 200,
"message": "Template created successfully.",
"data": {
"id": "5565ef13-8843-4f02-94f2-9a510140dadd",
"name": "card_demo",
"number": "91861xxxxxxx",
"alias": "card-demo",
"type": "card",
"category": "Marketing",
"language": "English",
"payload": "{\"type\":\"card\",\"payload\":
{\"title\":\"This is the card title\",
\"description\":\"This is the card description\",\"body\":{\"type\":\"image\",\"payload\":
{\"url\":\"https:\\/\\/domain-name.com\\/your_image_path.png\",
\"height\":\"TALL\"}},\"choices\":{\"replies\":[{\"type\":\"text\",\"payload\":
{\"text\":\"yes\",\"content\":\"yes\"}},
{\"type\":\"text\",\"payload\":{\"text\":\"No\",\"content\":\"no\"}}],
\"actions\":[{\"type\":\"url\",\"payload\":{\"title\":\"Click Here\",\"url\":
\"https:\\/\\/example.com\"}},{\"type\":\"dial\",\"payload\":
{\"title\":\"Click Here\",\"phone_number\":\"+91901995xxxx\"}},
{\"type\":\"location\",\"payload\":{\"latitude\":12.912985,\"longitude\":77.599505}}]}}}",
"status": 1,
"created_at": "2023-02-23T06:02:38.000000Z",
"updated_at": "2023-02-23T06:02:38.000000Z"
}
}
Carousel Type
PARAMETERS
| name |
description |
Type |
Required |
| payload.cards |
cards id values |
string |
Yes |
Example Request
curl -X POST \
'{endpoint}rcs/templates' \
-H 'authorization: Bearer 5b02112fb7xxxxxxxxx' \
-H 'content-type: application/json' \
-d '{
"type": "carousel",
"name": "carousel_demo",
"language": "en",
"category": "marketing",
"number": "91861xxxxxxx",
"payload": {
"cards": [
"5565ef13-8843-4f02-94f2-9a510140dadd"
]
}
}'
Example Response
{
"status": "OK",
"code": 200,
"message": "Template created successfully.",
"data": {
"id": "2e84cd9e-9ee1-453b-9a73-a7caf8c29ff2",
"name": "carousel_demo",
"number": "91861xxxxxxx",
"alias": "carousel-demo",
"type": "carousel",
"category": "Marketing",
"language": "English",
"payload": "{\"type\":\"carousel\",\"payload\":[{\"title\":\"This is the card title\",
\"description\":\"This is the card description\",\"body\":
{\"type\":\"image\",\"payload\":{\"url\":\"https:\\/\\/domain-name.com\\/your_image_path.png\",
\"height\":\"TALL\"}},\"choices\":{\"replies\":[{\"type\":\"text\",
\"payload\":{\"text\":\"yes\",\"content\":\"yes\"}},{\"type\":\"text\",
\"payload\":{\"text\":\"No\",\"content\":\"no\"}}],
\"actions\":[{\"type\":\"url\",\"payload\":{\"title\":\"Click Here\",
\"url\":\"https:\\/\\/example.com\"}},{\"type\":\"dial\",\"payload\":{\"title\":
\"Click Here\",\"phone_number\":\"+91901995xxxx\"}},
{\"type\":\"location\",\"payload\":{\"latitude\":12.912985,\"longitude\":77.599505}}]}}],
\"cards\":[\"5565ef13-8843-4f02-94f2-9a510140dadd\"]}",
"status": 1,
"created_at": "2023-02-23T06:08:46.000000Z",
"updated_at": "2023-02-23T06:08:46.000000Z"
}
}
Update Templates
PUT
{endpoint}rcs/templates/{template_id}
PARAMETERS
| name |
description |
Type |
Required |
| template id |
created template id |
string |
Yes |
| type |
values are like text, interactive, media . . |
string |
Yes |
| name |
created template name (can not be change) |
string |
Yes |
| category |
template category (can be change) |
string |
Yes |
| language |
example : eu, en_US (can be change) |
string |
Yes |
| number |
agent number Ex:(91861xxxxxxxx) (can be change) |
string or integer |
Yes |
| payload |
payload content (can be change) |
object |
Yes |
Example Request
curl -X PUT \
'{endpoint}rcs/templates/3b58b499-e184-4cdf-9226-8ddae27e0821' \
-H 'authorization: Bearer 5b02112fb7xxxxxxxxx' \
-H 'content-type: application/json' \
-d '{
"type": "text",
"name": "text123",
"language": "en",
"category": "marketing",
"number": "91861xxxxxxx",
"payload": {
"text" : "Hi, This is Rcs update test message."
}
}'
Example Response
{
"status": "OK",
"code": 200,
"message": "Template updated successfully.",
"data": {
"id": "3b58b499-e184-4cdf-9226-8ddae27e0821",
"name": "text123",
"number": "91861xxxxxxx",
"alias": "text123",
"type": "text",
"category": "Marketing",
"language": "English",
"payload": "{\"type\":\"text\",\"payload\":{\"text\":\"Hi, This is Rcs update test message.\"}}",
"status": 1,
"created_at": "2023-02-23T05:56:58.000000Z",
"updated_at": "2023-02-23T06:27:29.000000Z"
}
}
Delete Templates
DELETE
{endpoint}rcs/templates/{id}
Replace the {id} with the actual id of the template that you would like to delete.
Example Request
curl -X DELETE \
{endpoint}rcs/templates/7d77d0ef-63df-4ffb-83d6-xxxxxxxx \
-H 'Accept: application/json' \
-H 'Authorization: Bearer 5b02112fb7xxxxxxxxx'
Example Response
{
"status": "OK",
"code": 200,
"message": "Template Successfully Deleted",
"data": []
}
