About Select Structured Messages
This structured message provides a list from which the customer can pick some elements. See Channel capabilities to know on which channel you can use this structured message.
Request Example
curl -X POST "https://[YOUR DOMAIN].api.digital.ringcentral.com/1.0/contents"
{
"source_id": "<source_id>",
"in_reply_to_id": "<in_reply_to_id>",
"body": "What do you wish?",
"structured_content": {
"type": "select",
"items": [
{
"title": "Option 1",
"payload": "first_option"
},
{
"title": "Option 2",
"payload": "second_option"
},
{
"title": "Option 3"
}
]
}
}
Primary Parameters
| API Property | Type | Description |
|---|---|---|
source_id |
String | Optional. ID of the source. Most interactions are in reply to a message being sent to the agent. In these cases, the source ID is not required. |
in_reply_to_id |
String | ID of the message being replied to. |
body |
String | The select structured message body. If the device does not support structured messages, this field will be sent as the message. |
structured_content |
Object | Payload of the structured message. |
| Structured Content Settings | ||
structured_content.type |
String | Type of the structured message. Must be "select". |
structured_content.items |
Array | An array of items representing the options presented to the customer. A maximum of 13 items is supported. |
| Item Settings | ||
structured_content.items.title |
String | The title of the item. Limited to 80 characters. |
structured_content.items.payload |
String | Optional. Payload that will be returned with the structured response. Limited to 1000 characters. Can only contain ASCII characters. |
Example: Apple Messages for Business (Quick Replies)
The following example uses Apple Messages for Business with quick replies.
JSON Body
{
"source_id": "<source_id>",
"in_reply_to_id": "<in_reply_to_id>",
"body": "What do you wish?",
"structured_content": {
"type": "select",
"items": [
{
"title": "Option 1",
"payload": "first_option",
},
{
"title": "Option 2",
"payload": "second_option"
},
{
"title": "Option 3"
}
]
}
}
Example: Facebook Messenger (Quick Replies)
The following example uses Facebook Messenger with quick replies.
JSON Body
{
"source_id": "<source_id>",
"in_reply_to_id": "<in_reply_to_id>",
"body": "What do you wish?",
"structured_content": {
"type": "select",
"items": [
{
"title": "Option 1",
"payload": "first_option",
"attachment_id": "<attachment_id>",
"attachment_fallback_id": "<attachment_id>",
},
{
"title": "Option 2",
"payload": "second_option"
},
{
"title": "Option 3"
}
]
}
}
Properties Unique to this Channel
Primary parameters are used by default, however, some parameters are unique or overwritten by parameters specific to this example.
| API Property | Type | Description |
|---|---|---|
structured_content.items.title |
String | The title of the item. Truncated to 20 characters. |
structured_content.items.attachment_id |
String | Optional. Existing attachment id used to decorate the item in the list. Supports private attachments. Upload attachments for you own custom images. |
structured_content.items.attachment_fallback_id |
String | Optional. Fallback in case the attachment related to the attachment_id doesn’t meet the source requirements. Must be public. Only jpg, jpeg, png formats. Maximum size of 5 MB. Upload attachments for you own custom images. |
structured_content.items.payload |
String | Automatically gets populated as a random hex if blank. |
Example: Engage Messaging (Quick Replies)
The following example uses Engage Messaging with quick replies.
The Engage Messaging quick replies support both the centering of items and the disabling of the text input:
JSON Body
{
"source_id": "<source_id>",
"in_reply_to_id": "<in_reply_to_id>",
"body": "What do you wish?",
"structured_content": {
"type": "select",
"center_items": true,
"disable_text_input": true,
"items": [
{
"title": "Option 1",
"payload": "first_option"
},
{
"title": "Option 2",
"payload": "second_option"
}
]
}
}
Properties Unique to this Channel
Primary parameters are used by default, however, some parameters are unique or overwritten by parameters specific to this example.
| API Property | Type | Description |
|---|---|---|
structured_content.center_items |
Booelan | Optional. Allows to center the items. False by default. Centers the items when at “true”. Aligns the items on the right when at “false”. |
structured_content.disable_text_input |
Booelan | Optional. Allows to disable the text input when the items are displayed. False by default. Disables the text input when at “true”. Also disables the ability to reply via the push notification on mobile. |
Example: Google Business Messages
Properties Unique to this Channel
Primary parameters are used by default, however, some parameters are unique or overwritten by parameters specific to this example.
| API Property | Specificity |
|---|---|
structured_content.items.title |
Truncated to 25 characters. |
structured_content.items.payload |
Automatically gets populated as a random hex if blank. |
Example: Instagram Messaging (Quick Replies)
The following example uses Instagram Messaging with quick replies.
JSON Body
{
"source_id": "<source_id>",
"in_reply_to_id": "<in_reply_to_id>",
"body": "Please make a choice",
"structured_content": {
"type": "select",
"items": [
{
"title": "Option 1",
"payload": "first_option"
},
{
"title": "Option 2",
"payload": "second_option"
},
{
"title": "Option 3"
}
]
}
}
Properties Unique to this Channel
Primary parameters are used by default, however, some parameters are unique or overwritten by parameters specific to this example.
| API Property | Type | Description |
|---|---|---|
structured_content.items.title |
String | The title of the item. Truncated to 20 characters. |
structured_content.items.payload |
String | Automatically gets populated as a random hex if blank. |